home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / bx75p3.zip / doc / color.txt < prev    next >
Text File  |  1999-02-23  |  2KB  |  52 lines
  1. About Control-C colors
  2.  
  3. If your client was compiled with #define CONTROL_C_COLORS and you have
  4. /SET CONTROL_C_COLORS ON, then you can use the control-c colors feature.
  5. The general syntax is:
  6.  
  7. color-seq-start := "^C" [number] ["," number]
  8. color-seq-end   := "^C"
  9.  
  10. The first "number" is a positive integer at least 0 and not more than 15.
  11. The colors correspond to the ANSI color schema:
  12.  
  13.     0 - black     1 - red        2 - green    3 - yellow
  14.     4 - blue    5 - magenta    6 - cyan    7 - white
  15.  
  16. The colors 8 through 15 are the corresponding "bold" versions of the colors
  17. above, whatever that may be for your terminal.
  18.  
  19. The "standard" as imposed by mIRC forbids an empty leading value.  This
  20. implementation imposes this draconian restriction.  In fact, it is treated
  21. as an end-of-color delimiter.  So there.
  22.  
  23. If you wish to defeat the color codes, you can have them filtered out by
  24. doing /SET CONTROL_C_COLORS OFF.
  25.  
  26.  
  27. OUR REVISIONS TO THE "STANDARD":
  28.  
  29. The syntax of colors has been modified to:
  30.  
  31. color-seq-start := "\003" + color-term + ["," color-term]
  32. color-term      := ["0" + ["0..9"] | "1" + ["0..5"] ] | ["2..9"] | [""]
  33. color-seq-end   := "\003"
  34.  
  35. Specifically, this implementation guarantees that at least zero and at most
  36. two character will ever be used to construct the color code.  If the first
  37. character is a 0, then the second character will be used if it is a number.
  38. If the first character is a 1, then the second character will be used only if
  39. it is a number at least 0 and at most 5.  A comma following the first color
  40. term will only be "eaten" if it is followed by another valid term.
  41.  
  42. Either the first term or the second term may be empty.  If either term (but
  43. not both) are ommitted, then no change will occur for that modifier.  If both
  44. terms are omitted, the comma must also be omitted, and all color attributes 
  45. will be terminated.
  46.  
  47. It is hoped that this clarification will allow the deterministic use of color
  48. codes (if you always use two digit codes, then you will never have a problem
  49. with the color codes munching too many characters.)
  50.  
  51. -end of file-
  52.