Document xterm/256-color palette in help files

diff --git a/game/txt/hlp/cobra_flag.hlp b/game/txt/hlp/cobra_flag.hlp
index b572a4c90fc1a89f8b09fc3b0cadb338a28c6042..797037605df3c6c51d9d92f61a3b4f32a36efbe6 100644 (file)
--- a/game/txt/hlp/cobra_flag.hlp
+++ b/game/txt/hlp/cobra_flag.hlp
@@ -95,7 +95,7 @@ which are available.
   See also the COLOR flag. If COLOR is not set, and ANSI is, you will
   see vt100 ANSI codes, but not color ANSI codes.
 
-  See also: COLOR, ansi(), @config
+  See also: COLOR, ansi(), @config, XTERMCOLOR
 & AUDIBLE
   Flag:  AUDIBLE  (all types)
 
@@ -186,7 +186,272 @@ which are available.
   When set on a player, this flag allows the player to see ANSI color.
   The ANSI flag must also be set.
 
-  See also: ANSI, ansi()
+  See also: ANSI, XTERMCOLOR, ansi()
+& XTERMCOLOR
+  Flag:  XTERMCOLOR  (players)
+
+  When set on a player, this flag allows the player to see the xterm/256-color
+  palette. The ANSI flag must also be set. Available colors are:
+
+    Number  Name
+    0       Black
+    1       Maroon
+    2       Green
+    3       Olive
+    4       Navy
+    5       Purple
+    6       Teal
+    7       Silver
+    8       Grey
+    9       Red
+    10      Lime
+    11      Yellow
+    12      Blue
+    13      Fuchsia
+    14      Aqua
+    15      White
+    16      Grey0
+    17      NavyBlue
+    18      DarkBlue
+    19      Blue3
+    20      Blue3
+    21      Blue1
+    22      DarkGreen
+    23      DeepSkyBlue4
+    24      DeepSkyBlue4
+    25      DeepSkyBlue4
+    26      DodgerBlue3
+    27      DodgerBlue2
+    28      Green4
+    29      SpringGreen4
+    30      Turquoise4
+    31      DeepSkyBlue3
+    32      DeepSkyBlue3
+    33      DodgerBlue1
+    34      Green3
+    35      SpringGreen3
+    36      DarkCyan
+    37      LightSeaGreen
+    38      DeepSkyBlue2
+    39      DeepSkyBlue1
+    40      Green3
+    41      SpringGreen3
+    42      SpringGreen2
+    43      Cyan3
+    44      DarkTurquoise
+    45      Turquoise2
+    46      Green1
+    47      SpringGreen2
+    48      SpringGreen1
+    49      MediumSpringGreen
+    50      Cyan2
+    51      Cyan1
+    52      DarkRed
+    53      DeepPink4
+    54      Purple4
+    55      Purple4
+    56      Purple3
+    57      BlueViolet
+    58      Orange4
+    59      Grey37
+    60      MediumPurple4
+    61      SlateBlue3
+    62      SlateBlue3
+    63      RoyalBlue1
+    64      Chartreuse4
+    65      DarkSeaGreen4
+    66      PaleTurquoise4
+    67      SteelBlue
+    68      SteelBlue3
+    69      CornflowerBlue
+    70      Chartreuse3
+    71      DarkSeaGreen4
+    72      CadetBlue
+    73      CadetBlue
+    74      SkyBlue3
+    75      SteelBlue1
+    76      Chartreuse3
+    77      PaleGreen3
+    78      SeaGreen3
+    79      Aquamarine3
+    80      MediumTurquoise
+    81      SteelBlue1
+    82      Chartreuse2
+    83      SeaGreen2
+    84      SeaGreen1
+    85      SeaGreen1
+    86      Aquamarine1
+    87      DarkSlateGray2
+    88      DarkRed
+    89      DeepPink4
+    90      DarkMagenta
+    91      DarkMagenta
+    92      DarkViolet
+    93      Purple
+    94      Orange4
+    95      LightPink4
+    96      Plum4
+    97      MediumPurple3
+    98      MediumPurple3
+    99      SlateBlue1
+    100     Yellow4
+    101     Wheat4
+    102     Grey53
+    103     LightSlateGrey
+    104     MediumPurple
+    105     LightSlateBlue
+    106     Yellow4
+    107     DarkOliveGreen3
+    108     DarkSeaGreen
+    109     LightSkyBlue3
+    110     LightSkyBlue3
+    111     SkyBlue2
+    112     Chartreuse2
+    113     DarkOliveGreen3
+    114     PaleGreen3
+    115     DarkSeaGreen3
+    116     DarkSlateGray3
+    117     SkyBlue1
+    118     Chartreuse1
+    119     LightGreen
+    120     LightGreen
+    121     PaleGreen1
+    122     Aquamarine1
+    123     DarkSlateGray1
+    124     Red3
+    125     DeepPink4
+    126     MediumVioletRed
+    127     Magenta3
+    128     DarkViolet
+    129     Purple
+    130     DarkOrange3
+    131     IndianRed
+    132     HotPink3
+    133     MediumOrchid3
+    134     MediumOrchid
+    135     MediumPurple2
+    136     DarkGoldenrod
+    137     LightSalmon3
+    138     RosyBrown
+    139     Grey63
+    140     MediumPurple2
+    141     MediumPurple1
+    142     Gold3
+    143     DarkKhaki
+    144     NavajoWhite3
+    145     Grey69
+    146     LightSteelBlue3
+    147     LightSteelBlue
+    148     Yellow3
+    149     DarkOliveGreen3
+    150     DarkSeaGreen3
+    151     DarkSeaGreen2
+    152     LightCyan3
+    153     LightSkyBlue1
+    154     GreenYellow
+    155     DarkOliveGreen2
+    156     PaleGreen1
+    157     DarkSeaGreen2
+    158     DarkSeaGreen1
+    159     PaleTurquoise1
+    160     Red3
+    161     DeepPink3
+    162     DeepPink3
+    163     Magenta3
+    164     Magenta3
+    165     Magenta2
+    166     DarkOrange3
+    167     IndianRed
+    168     HotPink3
+    169     HotPink2
+    170     Orchid
+    171     MediumOrchid1
+    172     Orange3
+    173     LightSalmon3
+    174     LightPink3
+    175     Pink3
+    176     Plum3
+    177     Violet
+    178     Gold3
+    179     LightGoldenrod3
+    180     Tan
+    181     MistyRose3
+    182     Thistle3
+    183     Plum2
+    184     Yellow3
+    185     Khaki3
+    186     LightGoldenrod2
+    187     LightYellow3
+    188     Grey84
+    189     LightSteelBlue1
+    190     Yellow2
+    191     DarkOliveGreen1
+    192     DarkOliveGreen1
+    193     DarkSeaGreen1
+    194     Honeydew2
+    195     LightCyan1
+    196     Red1
+    197     DeepPink2
+    198     DeepPink1
+    199     DeepPink1
+    200     Magenta2
+    201     Magenta1
+    202     OrangeRed1
+    203     IndianRed1
+    204     IndianRed1
+    205     HotPink
+    206     HotPink
+    207     MediumOrchid1
+    208     DarkOrange
+    209     Salmon1
+    210     LightCoral
+    211     PaleVioletRed1
+    212     Orchid2
+    213     Orchid1
+    214     Orange1
+    215     SandyBrown
+    216     LightSalmon1
+    217     LightPink1
+    218     Pink1
+    219     Plum1
+    220     Gold1
+    221     LightGoldenrod2
+    222     LightGoldenrod2
+    223     NavajoWhite1
+    224     MistyRose1
+    225     Thistle1
+    226     Yellow1
+    227     LightGoldenrod1
+    228     Khaki1
+    229     Wheat1
+    230     Cornsilk1
+    231     Grey100
+    232     Grey3
+    233     Grey7
+    234     Grey11
+    235     Grey15
+    236     Grey19
+    237     Grey23
+    238     Grey27
+    239     Grey30
+    240     Grey35
+    241     Grey39
+    242     Grey42
+    243     Grey46
+    244     Grey50
+    245     Grey54
+    246     Grey58
+    247     Grey62
+    248     Grey66
+    249     Grey70
+    250     Grey74
+    251     Grey78
+    252     Grey82
+    253     Grey85
+    254     Grey89
+    255     Grey93
+
+  See also: ANSI, COLOR, ansi()
 & CONNECTED
   Flag:  CONNECTED  (players)
 

diff --git a/game/txt/hlp/cobra_func.hlp b/game/txt/hlp/cobra_func.hlp
index 0437fb36e018ed2467c79a7bc8cd6ffc2812b2d1..c86329f2fa6c8ade9e94efbac91214eb41949095 100644 (file)
--- a/game/txt/hlp/cobra_func.hlp
+++ b/game/txt/hlp/cobra_func.hlp
@@ -474,8 +474,21 @@
         w - white foreground            W - white background
  
   For example, "ansi(fc, Test)" would hilight "Test" in flashing cyan.
+
+  Colors can also be called for by name or xterm color number by using the
+  following format in place of <codes>:
+
+    [foreground][/background]
+
+  Examples:
+    ansi(red/green,Festive Text)
+    ansi(5,Purple Text)
+    ansi(/112,Chartreuse Text)
  
-  See also: ANSI, COLOR 
+  Color names are not case-sensitive. See 'help xtermcolor' for a table of
+  available colors.
+
+  See also: ANSI, COLOR, XTERMCOLOR
 & APOSS()
   aposs(<object>)