Document the predefined styles.

diff --git a/gettext-tools/doc/ChangeLog b/gettext-tools/doc/ChangeLog
index ac2e7cced0b8e1327dce80b74d77dca3107316ae..3d81f7af57e8ad69bb71b4a2afe0795cd4253218 100644 (file)
--- a/gettext-tools/doc/ChangeLog
+++ b/gettext-tools/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-10-28  Bruno Haible  <bruno@clisp.org>
+
+       * gettext.texi (The --style option): Document the predefined styles.
+       (Style rules): Mark .added, .changed, .removed as not yet implemented.
+
 2007-10-20  Bruno Haible  <bruno@clisp.org>
 
        * gettext.texi (Java): Mention the hello-java-qtjambi example.

diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 5637435ea4b74898e792a454f5ef6eaf0e4aa63d..28e5598584945491956ae1fb4b8091df4555af02 100644 (file)
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -4756,6 +4756,30 @@ preferred style for PO files.
 The default style file is @file{$prefix/share/gettext/styles/po-default.css},
 where @code{$prefix} is the installation location.
 
+A few style files are predefined:
+@table @file
+@item po-vim.css
+This style imitates the look used by vim 7.
+
+@item po-emacs-x.css
+This style imitates the look used by GNU Emacs 21 and 22 in an X11 window.
+
+@item po-emacs-xterm.css
+@itemx po-emacs-xterm16.css
+@itemx po-emacs-xterm256.css
+This style imitates the look used by GNU Emacs 22 in a terminal of type
+@samp{xterm} (8 colors) or @samp{xterm-16color} (16 colors) or
+@samp{xterm-256color} (256 colors), respectively.
+@end table
+
+@noindent
+You can use these styles without specifying a directory.  They are actually
+located in @file{$prefix/share/gettext/styles/}, where @code{$prefix} is the
+installation location.
+
+You can also design your own styles.  This is described in the next section.
+
+
 @node Style rules, Customizing less, The --style option, Colorizing
 @subsection Style rules for PO files
 
@@ -4899,15 +4923,18 @@ This matches an invalid format string directive.
 
 @item .added
 In an untranslated string, this matches a part of the string that was not
-present in the previous untranslated string.
+present in the previous untranslated string.  (Not yet implemented in this
+release.)
 
 @item .changed
 In an untranslated string or in a previous untranslated string, this matches
-a part of the string that is changed or replaced.
+a part of the string that is changed or replaced.  (Not yet implemented in
+this release.)
 
 @item .removed
 In a previous untranslated string, this matches a part of the string that
-is not present in the current untranslated string.
+is not present in the current untranslated string.  (Not yet implemented in
+this release.)
 @end table
 @end itemize