[Groff-commit] groff ChangeLog man/groff_tmac.man src/preproc/...

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     06/07/02 09:06:19

Modified files:
        .              : ChangeLog 
        man            : groff_tmac.man 
        src/preproc/preconv: preconv.man 

Log message:
        * man/groff_tmac.man: Document usage of .PSPIC within diversions.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.975&r2=1.976
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff_tmac.man?cvsroot=groff&r1=1.13&r2=1.14
http://cvs.savannah.gnu.org/viewcvs/groff/src/preproc/preconv/preconv.man?cvsroot=groff&r1=1.1&r2=1.2

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.975
retrieving revision 1.976
diff -u -b -r1.975 -r1.976
--- ChangeLog   1 Jul 2006 22:49:22 -0000       1.975
+++ ChangeLog   2 Jul 2006 09:06:19 -0000       1.976
@@ -1,3 +1,7 @@
+2006-07-02  Werner LEMBERG  <address@hidden>
+
+       * man/groff_tmac.man: Document usage of .PSPIC within diversions.
+
 2006-07-01  Werner LEMBERG  <address@hidden>
 
        * tmac/pspic.tmac: Make .PSPIC work for all devices.

Index: man/groff_tmac.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff_tmac.man,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- man/groff_tmac.man  1 Jul 2006 22:49:22 -0000       1.13
+++ man/groff_tmac.man  2 Jul 2006 09:06:19 -0000       1.14
@@ -14,7 +14,7 @@
 
 File position: <groff-source>/man/groff_tmac.man
 
-Last update: 01 Jul 2006
+Last update: 02 Jul 2006
 
 This file is part of groff, the GNU roff type-setting system.
 
@@ -150,14 +150,14 @@
 .c     result: `sh#  groffer --dpi 100 file'
 .c             with 'sh#' in font I, the rest in CR
 .c
-.c   .Shell_cmd groffer\~--dpi\~100\~file
+.c   .Shell_cmd groffer\ --dpi\ 100\ file
 .c     result: the same as above
 .c
 .c   .Shell_cmd "groffer --dpi=" value " file"
 .c     result: sh#  groffer --dpi=value file
 .c             with `groffer --dpi=' and `file' in CR; `value' in CI
 .c
-.c   .Shell_cmd groffer\~--dpi= value \~file
+.c   .Shell_cmd groffer\ --dpi= value \ file
 .c     result: the same as the previous example
 .c
 .de Shell_cmd
@@ -562,6 +562,25 @@
 (default scaling indicator is\~\c
 .BR m ).
 .
+.IP
+For use of
+.B .PSPIC
+within a diversion it is recommended to extend it with
+the following code, assuring that the diversion's width completely
+covers the image's width.
+.
+.RS
+.IP
+.Example
+.  Text .am PSPIC
+.  Text .\ \ vpt 0
+.  Text \[rs]h'(\[rs]\[rs]n[ps-offset]u + \[rs]\[rs]n[ps-deswid]u)'
+.  Text .\ \ sp -1
+.  Text .\ \ vpt 1
+.  Text ..
+./Example
+.RE
+.
 .
 .TP
 .B trace
@@ -655,10 +674,10 @@
 macro package may be specified as on of the following four methods:
 .
 .IP
-.Shell_cmd "groff\~\-m\~man"
-.Shell_cmd "groff\~\-man"
-.Shell_cmd "groff\~\-mman"
-.Shell_cmd "groff\~\-m\~an"
+.Shell_cmd "groff\ \-m\ man"
+.Shell_cmd "groff\ \-man"
+.Shell_cmd "groff\ \-mman"
+.Shell_cmd "groff\ \-m\ an"
 .
 .
 .P
@@ -673,8 +692,8 @@
 macro package may be specified only as one of the two methods:
 .
 .IP
-.Shell_cmd "groff\~\-m\~www"
-.Shell_cmd "groff\~\-mwww"
+.Shell_cmd "groff\ \-m\ www"
+.Shell_cmd "groff\ \-mwww"
 .
 .
 .P
@@ -782,7 +801,7 @@
 At run-time, the formatter call for this is
 .
 .IP
-.Shell_cmd "groff\~\-m\~" "macrofile\~document.roff"
+.Shell_cmd "groff\ \-m\ " "macrofile\ document.roff"
 .
 .
 .P
@@ -805,7 +824,7 @@
 .P
 In both cases, the formatter is called with
 .IP
-.Shell_cmd "groff\~\-s\~" docu.roff
+.Shell_cmd "groff\ \-s\ " docu.roff
 .
 .
 .P
@@ -966,8 +985,8 @@
 .Example
 .  Text .ds midpart was called with
 .  Text .de print_args
-.  Text address@hidden@2]
-.  Text .\~\~tm\~\[rs]\[rs]$*
+.  Text .\ \ tm\ address@hidden \[rs]\[rs]*[midpart]\ \[rs]\[rs]n[.$]\ 
address@hidden
+.  Text .\ \ tm\ \[rs]\[rs]$*
 .  Text ..
 ./Example
 .rm @1
@@ -1050,8 +1069,8 @@
 .  Text .eo
 .  Text .ds midpart was called with
 .  Text .de print_args
-.  Text address@hidden@2]
-.  Text .\~\~tm\~\[rs]$*
+.  Text .\ \ tm\ address@hidden \[rs]*[midpart]\ \[rs]n[.$]\ address@hidden
+.  Text .\ \ tm\ \[rs]$*
 .  Text ..
 .  Text .ec
 ./Example
@@ -1085,9 +1104,9 @@
 .IP
 .Example
 .  Text .de Text
-.  Text .\~\~if (\[rs]\[rs]n[.$] == 0)\~\[rs]
-.  Text .\~\~\~\~return
-.  Text .\~nop\~\[rs])\[rs]\[rs]$*[rs]\)
+.  Text .\ \ if (\[rs]\[rs]n[.$] == 0)\ \[rs]
+.  Text .\ \ \ \ return
+.  Text .\ nop\ \[rs])\[rs]\[rs]$*[rs]\)
 .  Text ..
 ./Example
 .
@@ -1101,9 +1120,9 @@
 .
 .IP
 .Example
-.  Text .de\~c
+.  Text .de\ c
 .  Text ..
-.  Text .c\~This\~is\~like\~a\~comment\~line.
+.  Text .c\ This\ is\ like\ a\ comment\ line.
 ./Example
 .
 .Topic

Index: src/preproc/preconv/preconv.man
===================================================================
RCS file: /cvsroot/groff/groff/src/preproc/preconv/preconv.man,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- src/preproc/preconv/preconv.man     5 Jan 2006 15:45:00 -0000       1.1
+++ src/preproc/preconv/preconv.man     2 Jul 2006 09:06:19 -0000       1.2
@@ -117,7 +117,7 @@
 or `latin1' if the locale is set to `C', `POSIX', or empty.
 .
 .PP
-Note tha the
+Note that the
 .B groff
 program supports a
 .B GROFF_ENCODING