[Groff-commit] groff ChangeLog doc/groff.texinfo man/groff.man

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     10/07/28 16:53:34

Modified files:
        .              : ChangeLog 
        doc            : groff.texinfo 
        man            : groff.man 

Log message:
        * doc/groff.texinfo, man/groff.man: Document `!' operator better.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1242&r2=1.1243
http://cvs.savannah.gnu.org/viewcvs/groff/doc/groff.texinfo?cvsroot=groff&r1=1.291&r2=1.292
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff.man?cvsroot=groff&r1=1.104&r2=1.105

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1242
retrieving revision 1.1243
diff -u -b -r1.1242 -r1.1243
--- ChangeLog   28 Jun 2010 18:06:30 -0000      1.1242
+++ ChangeLog   28 Jul 2010 16:53:33 -0000      1.1243
@@ -1,3 +1,7 @@
+2010-07-28  Larry Kollar  <address@hidden>
+
+       * doc/groff.texinfo, man/groff.man: Document `!' operator better.
+
 2010-06-28  Jan Vcelak  <address@hidden>
 
        * src/roff/troff/node.cpp (make_node): Adding missing `%'.

Index: doc/groff.texinfo
===================================================================
RCS file: /cvsroot/groff/groff/doc/groff.texinfo,v
retrieving revision 1.291
retrieving revision 1.292
diff -u -b -r1.291 -r1.292
--- doc/groff.texinfo   2 Jun 2010 14:26:25 -0000       1.291
+++ doc/groff.texinfo   28 Jul 2010 16:53:34 -0000      1.292
@@ -5128,6 +5128,32 @@
 `true' because @code{gtroff} treats both negative numbers and zero as
 `false'.}  See below for the use of unary operators in motion requests.
 
address@hidden logical not, limitation in expression
address@hidden expression, limitation of logical not in
+The logical not operator,
+as described above,
+works only within @code{if} and @code{while} requests.
+Furthermore, it may appear
+only at the beginning of an expression,
+and negates the entire expression.
+Attempting to insert the @samp{!} operator
+within the expression results in a
address@hidden expression expected} warning.  This
+maintains bug-compatibility
+with old versions of @code{troff}.
+
+Example:
+
address@hidden
+.nr X 1
+.nr Y 0
+.\" This does not work as expected
+.if (\n[X])&(!\n[Y]) .nop X only
+.
+.\" Use this construct instead
+.if (\n[X]=1)&(\n[Y]=0) .nop X only
address@hidden
+
 @item
 @cindex extremum operators (@code{>?}, @code{<?})
 @cindex operators, extremum (@code{>?}, @code{<?})

Index: man/groff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff.man,v
retrieving revision 1.104
retrieving revision 1.105
diff -u -b -r1.104 -r1.105
--- man/groff.man       24 Apr 2009 20:43:20 -0000      1.104
+++ man/groff.man       28 Jul 2010 16:53:34 -0000      1.105
@@ -884,7 +884,7 @@
 .BI ! N
 True if the value of
 .I I
-is\~0.
+is\~0 (see below).
 .
 .TPx
 .BI \[aq] s1 \[aq] s2 \[aq]
@@ -898,7 +898,8 @@
 True if string\~\c
 .I s1
 is not identical to string\~\c
-.IR s2 .
+.I s2
+(see below).
 .
 .TPx
 .BI c ch
@@ -952,6 +953,13 @@
 .
 .RE
 .PD
+.P
+Note that the
+.B !
+operator may only appear at the beginning of an expression,
+and negates the entire expression.
+This maintains bug-compatibility with AT&T
+.IR troff .
 .
 .
 .\" --------------------------------------------------------------------