* src/roff/nroff/nroff.man: Improved documentation (especially

locales).

2 files changed, 40 insertions, 17 deletions

diff --git a/ChangeLog b/ChangeLog
index 38ea7d3d..4576c76d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2001-05-04  Werner LEMBERG  <wl@gnu.org>
+
+	* src/roff/nroff/nroff.man: Improved documentation (especially
+	locales).
+
 2001-05-02  Werner LEMBERG  <wl@gnu.org>
 
 	Added `brp' request: This is \p as a request.
diff --git a/src/roff/nroff/nroff.man b/src/roff/nroff/nroff.man
index e9230bb6..4a594044 100644
--- a/src/roff/nroff/nroff.man
+++ b/src/roff/nroff/nroff.man
@@ -1,5 +1,5 @@
 .ig \"-*- nroff -*-
-Copyright (C) 1989-2000 Free Software Foundation, Inc.
+Copyright (C) 1989-2001 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -30,7 +30,6 @@ the original English.
 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
 .el .RB "[\ " "\\$1" "\ ]"
 ..
-.OP \-v
 .OP \-h
 .OP \-i
 .OP \-m name
@@ -39,7 +38,10 @@ the original English.
 .OP \-p
 .OP \-r cn
 .OP \-t
+.OP \-S
 .OP \-T name
+.OP \-U
+.OP \-v
 .RI "[\ " file\|.\|.\|. "\ ]"
 .br
 .ad \na
@@ -49,24 +51,38 @@ The
 script emulates the
 .B nroff
 command using groff.
-The
-.B \-T
-option with an argument other than
+Only 
 .BR ascii ,
 .BR latin1 ,
 .BR utf8 ,
-or
+and
 .B cp1047
-will be ignored (and
-.B \-Tascii
-will be used).
+are valid arguments for the
+.B -T
+option.
+If an invalid or no
+.BR \-T
+option is given,
+.B @g@nroff
+checks the current locale to select a default output device.
+It first tries the
+.B locale
+program, then the environment variables
+.BR LC_ALL ,
+.BR LC_CTYPE ,
+and
+.BR LANG ,
+and finally the
+.B LESSCHARSET
+environment variable.
+.PP
 The
 .B \-h
 option
 is equivalent to the
-.B grotty
+.BR grotty 's
 .B \-h
-option.
+option (i.e., using tabs in the output).
 The
 .BR \-i ,
 .BR \-n ,
@@ -76,20 +92,22 @@ and
 .B \-r
 options have the effect described in
 .BR @g@troff (@MAN1EXT@).
-In addition
+In addition,
 .B @g@nroff
-silently ignores options of
+silently ignores the options
 .BR \-e ,
-.B \-q
-or
-.BR \-s .
+.BR \-q ,
+and
+.BR \-s
+(which are not implemented in
+.BR @g@troff ).
 Options 
 .B \-p
 (pic),
 .B \-t
 (tbl),
 .B \-S
-(safer) and
+(safer), and
 .B \-U
 (unsafe) are passed to
 .BR groff .