[6587] Colors and Styles chapter

[Gavin D. Smith]

Revision: 6587
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6587
Author:   gavin
Date:     2015-08-29 17:39:54 +0000 (Sat, 29 Aug 2015)
Log Message:
-----------
Colors and Styles chapter

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/info-stnd.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-08-29 17:01:54 UTC (rev 6586)
+++ trunk/ChangeLog     2015-08-29 17:39:54 UTC (rev 6587)
@@ -1,5 +1,9 @@
 2015-08-29  Gavin Smith  <address@hidden>
 
+       * doc/info-stnd.texi (Colors and Styles): New chapter.
+
+2015-08-29  Gavin Smith  <address@hidden>
+
        * info/display.h, info/variables.h (RENDITION): Move definition.
        * info/display.c (highlight_searches_p, xref_rendition_p): Remove.
        * info/variables.c (set_variable_to_value): Make highlight-searches=On

Modified: trunk/doc/info-stnd.texi
===================================================================
--- trunk/doc/info-stnd.texi    2015-08-29 17:01:54 UTC (rev 6586)
+++ trunk/doc/info-stnd.texi    2015-08-29 17:39:54 UTC (rev 6587)
@@ -85,6 +85,7 @@
 * Printing Nodes::              How to print out the contents of a node.
 * Miscellaneous Commands::      A few commands that defy categorization.
 * Variables::                   How to change the default behavior of Info.
+* Colors and Styles::           Customize the colors used by Info.
 * Custom Key Bindings::         How to define your own key-to-command bindings.
 * Index::                       Global index.
 @end menu
@@ -2341,6 +2342,88 @@
 @end vtable
 
 
address@hidden Colors and Styles
address@hidden Colors and Styles
+
+You can choose to highlight parts of Info's display, such as 
+cross-references and search matches, using a variety of styles, 
+including colors, boldface and underline.  Here are the variables that 
+are available to do this:
+
address@hidden @code
address@hidden ref-rendition
+Used for cross-references and menu entries.
+
address@hidden hl-ref-rendition
+Used for a cross-references or menu entry when typing @key{RET} would 
+have the effect of following said cross-reference or menu entry.
+
address@hidden match-rendition
+Used for matches from a search command.  (@xref{Searching Commands}.)
address@hidden vtable
+
+Each of these is given in the @file{.infokey} file just as the variables 
+in the previous chapter.  Their values are a comma-separated list of 
+values in the following table:
+
address@hidden @code
address@hidden  black
address@hidden red
address@hidden green
address@hidden yellow
address@hidden blue
address@hidden magenta
address@hidden cyan
address@hidden white
address@hidden Coloured text
+Use the color specified.
+
address@hidden nocolour
address@hidden nocolor
+Turn off any color that was in effect, using the terminal's default color.
+
address@hidden underline
address@hidden nounderline
address@hidden Underlined text
+Turn text underline on or off.
+
address@hidden standout
address@hidden nostandout
+Turn `standout mode' on or off.  Standout mode entails the use of appearance
+modes that make text stand out, and varies between terminals.
+
address@hidden bold
address@hidden regular
address@hidden nobold
address@hidden Bold text
+Turn boldface on or off.
+
address@hidden blink
address@hidden noblink
address@hidden Blinking text
+Make the text blink, or not.
+
address@hidden table
+
+Here is an sample excerpt from an @file{.infokey} file:
+
address@hidden
+#var
+ref-rendition=yellow
+hl-ref-rendition=bold,yellow
+match-rendition=underline,bold,nocolour
address@hidden example
+
address@hidden With this, cross-references are all yellow, and active 
+cross-references are additionally displayed in bold.  Any search
+matches will be shown in bold, and underlined.  Moreover, if there is a 
+search match inside a cross-reference, the @samp{nocolour} rendition 
+style will cancel the yellow colour, leaving the text in the match the 
+terminal's default colour.  (Note, however, that the rendition styles 
+for active cross-references take priority over those for search matches,
+so search matches there will still be displayed in yellow.)
+
+
 @node Custom Key Bindings
 @chapter Customizing Key Bindings and Variables