Date: Fri, 1 Dec 2000 16:05:40 +0200 From: Ruslan Ermilov <ru@FreeBSD.org> To: doc@FreeBSD.org Subject: Recent groff(1) warnings fixes Message-ID: <20001201160540.A18011@sunbay.com>
next in thread | raw e-mail | index | archive | help
--IS0zKkzwUGydFO0o Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi! You may have noticed my recent efforts about elimination of groff(1) warnings. I am glad to tell you that I am almost finished, and from the ~3K lines of warnings only 11 left. Unfortunately, some files are on vendor branches, and I do not want to touch these directly. I have sent the fixes to ``nvi'' and ``sendmail'' maintainers, and will do so for ``bind''. Some warnings are caused by groff(1) macro packages, and the fixes should be sent to the groff(1) maintainers. For those interested, here is the portion of fixes that did not get committed for the above reasons. Cheers, -- Ruslan Ermilov Oracle Developer/DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --IS0zKkzwUGydFO0o Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="contrib.fixes" Index: contrib/bind/doc/bog/00macs.me =================================================================== RCS file: /home/ncvs/src/contrib/bind/doc/bog/00macs.me,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 00macs.me --- contrib/bind/doc/bog/00macs.me 1996/08/29 19:20:12 1.1.1.1 +++ contrib/bind/doc/bog/00macs.me 2000/12/01 13:59:28 @@ -31,7 +31,6 @@ EXAMPLE \\n(EX: \(*D .r .lp .. -.if \nl .ls 2 .if t .nr bi 5m .nr si 3n .de $0 \" create a table of contents magically. Index: contrib/bind/doc/bog/files.me =================================================================== RCS file: /home/ncvs/src/contrib/bind/doc/bog/files.me,v retrieving revision 1.1.1.4 diff -u -p -r1.1.1.4 files.me --- contrib/bind/doc/bog/files.me 1998/05/03 04:11:20 1.1.1.4 +++ contrib/bind/doc/bog/files.me 2000/12/01 13:59:28 @@ -762,7 +762,7 @@ for a given domain, creating a \fIdelega The first name field specifies the zone that is serviced by the name server specified by the second name. Every zone needs at least two name servers. -.bp \" ----PLACEMENT HACK---- +.bp \" ----PLACEMENT HACK---- .sh 3 "A - Address" .TS l l l l l. Index: contrib/nvi/docs/USD.doc/vi.ref/ex.cmd.roff =================================================================== RCS file: /home/ncvs/src/contrib/nvi/docs/USD.doc/vi.ref/ex.cmd.roff,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 ex.cmd.roff --- contrib/nvi/docs/USD.doc/vi.ref/ex.cmd.roff 1996/11/01 06:45:34 1.1.1.1 +++ contrib/nvi/docs/USD.doc/vi.ref/ex.cmd.roff 2000/12/01 13:59:28 @@ -264,7 +264,7 @@ command is permitted in an empty file. .sp If the file has been modified since it was last completely written, the -.Co ! +.CO ! command will warn you. .sp A single @@ -859,7 +859,7 @@ Join lines of text together. A .LI count specified to the -.Sy join +.CO join command specifies that the last line of the .LI range plus @@ -1491,7 +1491,7 @@ The command searches for .LI tagstring in the tags file(s) specified by the -.Op tags +.OP tags option. (See .XR ctags 1 @@ -1914,7 +1914,7 @@ reduced to account for those lines. .SS .SP Line: Set to the last line displayed, with the exception of the -.Dq Li \&= +.QT \&= .LI type , where the current line is set to the line specified by the command. .SP Options: Index: contrib/nvi/docs/USD.doc/vi.ref/vi.cmd.roff =================================================================== RCS file: /home/ncvs/src/contrib/nvi/docs/USD.doc/vi.ref/vi.cmd.roff,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 vi.cmd.roff --- contrib/nvi/docs/USD.doc/vi.ref/vi.cmd.roff 1996/11/01 06:45:35 1.1.1.1 +++ contrib/nvi/docs/USD.doc/vi.ref/vi.cmd.roff 2000/12/01 13:59:28 @@ -2927,6 +2927,7 @@ Dependent on the operation being interru Dependent on the operation being interrupted. .SP Options: None. +.SE .SH 1 "Vi Text Input Commands" .pp The following section describes the commands available in the text Index: contrib/nvi/docs/USD.doc/vi.ref/vi.ref =================================================================== RCS file: /home/ncvs/src/contrib/nvi/docs/USD.doc/vi.ref/vi.ref,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 vi.ref --- contrib/nvi/docs/USD.doc/vi.ref/vi.ref 1996/11/01 06:45:34 1.1.1.1 +++ contrib/nvi/docs/USD.doc/vi.ref/vi.ref 2000/12/01 13:59:28 @@ -1825,7 +1825,8 @@ of the file. .bp .SH 1 Index .lp -.2c +0.5i 3 +.ie t .2c +0.5i 3 +.el .2c +0.5i 2 .ta \n($luR .nf .so index.so Index: contrib/nvi/docs/USD.doc/vitut/vi.apwh.ms =================================================================== RCS file: /home/ncvs/src/contrib/nvi/docs/USD.doc/vitut/vi.apwh.ms,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 vi.apwh.ms --- contrib/nvi/docs/USD.doc/vitut/vi.apwh.ms 1996/11/01 06:45:36 1.1.1.1 +++ contrib/nvi/docs/USD.doc/vitut/vi.apwh.ms 2000/12/01 13:59:29 @@ -35,11 +35,10 @@ .nr FL 6.5i .TL Vi Command & Function Reference -.AU CB 2675 +.AU Alan P.W. Hewett .sp Revised for version 2.12 by Mark Horton -.CB .NH 1 Author's Disclaimer .LP @@ -85,7 +84,6 @@ be denoted using the \fIupper case\fR ch example, \fB<^D>\fR is equal to \fB<^d>\fR. The most common character abbreviations used in this list are as follows: -.VL 8 .IP <esc> 8 escape, octal 033 .IP <cr> 8 @@ -106,7 +104,6 @@ formfeed, ^L, octal 014 space, octal 040 .IP <del> 8 delete, octal 0177 -.LE .sp 1 .NH 1 Basics @@ -218,7 +215,6 @@ be necessary to type <esc> first. .NH 2 Cursor and Page Motion .LP -.VL 16 .B NOTE: The arrow keys (see the next four commands) on certain kinds of terminals will not work with the @@ -380,12 +376,10 @@ cursor or scrolling the screen. .IP "\(ga\(ga" 16 Move the cursor back to the exact spot on the line where it was located before the last "non-relative" move. -.LE .NH 2 Searches .LP The following commands allow you to search for items in a file. -.VL 16 .IP [cnt]f{chr} 16 .sp 1 Search forward on the line for the next or "cnt"'th occurrence of @@ -433,7 +427,6 @@ direction. .sp 1 Using the \fB:\fR syntax it is possible to do global searches ala the standard UNIX "ed" editor. -.LE .NH 2 Text Insertion .LP @@ -442,7 +435,6 @@ text insertions are terminated with an < The last change can always be \fBundone\fR by typing a \fBu\fR. The text insert in insertion mode can contain newlines. -.VL 16 .IP a{text}<esc> 16 Insert text immediately following the cursor position. Mnemonic: \fBa\fRppend @@ -460,13 +452,11 @@ insert text there. Mnemonic: \fBo\fRpe .IP O{text}<esc> 16 Insert a new line preceding the line on which the cursor appears and insert text there. -.LE .NH 2 Text Deletion .LP The following commands allow the user to delete text in various ways. All changes can always be \fBundone\fR by typing the \fBu\fR command. -.VL 16 .IP "[cnt]x" 16 Delete the character or characters starting at the cursor position. .IP "[cnt]X" 16 @@ -480,14 +470,12 @@ Mnemonic: \fBD\fRelete the rest of line Deletes one or more occurrences of the specified motion. Any motion from sections 4.1 and 4.2 can be used here. The d can be stuttered (e.g. [cnt]dd) to delete cnt lines. -.LE .NH 2 Text Replacement .LP The following commands allow the user to simultaneously delete and insert new text. All such actions can be \fBundone\fR by typing \fBu\fR following the command. -.VL 16 .IP "r<chr>" 16 Replaces the character at the current cursor position with <chr>. This is a one character replacement. No <esc> is required for termination. @@ -512,7 +500,6 @@ insertion text. A "$" will appear at th that is being deleted unless the deletion involves whole lines. Motion's can be any motion from sections 4.1 or 4.2. Stuttering the c (e.g. [cnt]cc) changes cnt lines. -.LE .NH 2 Moving Text .LP @@ -536,7 +523,6 @@ in such a buffer is appended to it inste .FE There are two more basic commands and some variations useful in getting and putting text into a file. -.VL 16 .IP ["<a-z>][cnt]y{motion} 16 .sp 1 Yank the specified item or "cnt" items and put in the "undo" buffer or @@ -586,13 +572,11 @@ Prettyprints the indicated area accordin .B lisp conventions. The area should be a lisp s-expression. -.LE .NH 2 Miscellaneous Commands .LP \fBVi\fR has a number of miscellaneous commands that are very useful. They are: -.VL 16 .IP ZZ 16 This is the normal way to exit from vi. If any changes have been made, the file is written out. @@ -658,13 +642,11 @@ To just escape to the shell for one comm use :!{cmd}<nl>, see section 5. .IP z{cnt}<nl> 16 This resets the current window size to "cnt" lines and redraws the screen. -.LE .NH 2 Special Insert Characters .LP There are some characters that have special meanings during insert modes. They are: -.VL 16 .IP ^V 16 During inserts, typing a ^V allows you to quote control characters into the file. Any character typed after the ^V will be inserted @@ -688,7 +670,6 @@ Mnemonic: erase \fBW\fRord The backspace always serves as an erase during insert modes in addition to your normal "erase" character. To insert a <bs> into your file, use the <^V> to quote it. -.LE .NH 1 \fB:\fR Commands .LP @@ -698,7 +679,6 @@ the bottom on the screen in preparation also from this mode that you exit from \fBvi\fR or switch to different files. All commands of this variety are terminated by a <nl>, <cr>, or <esc>. -.VL 16 .IP ":w[!] [file]" 16 Causes \fBvi\fR to write out the current text to the disk. It is written to the file you are editing unless "file" is supplied. If @@ -769,7 +749,6 @@ programs so that by saying \fB:ta function<nl>\fR you will be switched to that function. It could also be useful when editing multi-file documents, though the \fBtags\fR file would have to be generated manually. -.LE .NH 1 Special Arrangements for Startup .PP @@ -867,7 +846,6 @@ These are usually placed in your .profil If you are running a system without environments (such as version 6) you can place the set command in the file .exrc in your home directory. -.VL 16 .IP autoindent\ ai 16 Default: noai Type: toggle .br @@ -1078,4 +1056,3 @@ Default: nowa Type: toggle \fBVi\fR normally makes a number of checks before it writes out a file. This prevents the user from inadvertently destroying a file. When the "writeany" option is enabled, \fBvi\fR no longer makes these checks. -.LE Index: contrib/sendmail/doc/op/op.me =================================================================== RCS file: /home/ncvs/src/contrib/sendmail/doc/op/op.me,v retrieving revision 1.1.1.5 diff -u -p -r1.1.1.5 op.me --- contrib/sendmail/doc/op/op.me 2000/10/01 01:48:42 1.1.1.5 +++ contrib/sendmail/doc/op/op.me 2000/12/01 13:59:30 @@ -32,7 +32,6 @@ \\$1 \\$2. \\$3 .)x .. -.sc .+c .(l C .sz 16 @@ -3486,8 +3485,8 @@ addr-->| 3 |-->| D |-- .)c .\} -.el .ie !"\*(.T"" \ -\{\ +.el \{\ +.ie !"\*(.T"" \{\ .PS boxwid = 0.3i boxht = 0.3i @@ -3518,6 +3517,7 @@ Box0: arrow; box "0" .PE .\} .el .sp 2i +.\} .ce Figure 1 \*- Rewriting set semantics .(c @@ -5486,7 +5486,7 @@ Checkpoints the queue every addresses sent. If your system crashes during delivery to a large list, this prevents retransmission to any but the last -.I N +.i N recipients. .ip ClassFactor=\fIfact\fP [z] @@ -6223,7 +6223,7 @@ If there is insufficient space gives a 452 response to the MAIL command. This invites the sender to try again later. -.ip MinQueueAge=\fPage\fP +.ip MinQueueAge=\fIage\fP [no short name] Don't process any queued jobs that have been in the queue less than the indicated time interval. @@ -8926,7 +8926,7 @@ to the specified .i value (for long form option names). These options are described in Section 5.6. -.ip \-M\fIx\|value +.ip \-M\fIx\|value\fP Set macro .i x to the specified --IS0zKkzwUGydFO0o Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="groff.fixes" Index: tmac/tmac.e =================================================================== RCS file: /home/ncvs/src/contrib/groff/tmac/tmac.e,v retrieving revision 1.4 diff -u -p -r1.4 tmac.e --- tmac/tmac.e 2000/01/12 10:26:30 1.4 +++ tmac/tmac.e 2000/12/01 13:59:03 @@ -983,6 +983,8 @@ .sp \\n(bsu+\\n(.Lv-1v .re .. +.de T& +.. .\" .\" REFER .\" @@ -1108,7 +1110,7 @@ in \\f2\\*([B\\f1, \c .de PS \" *** start picture: $1=height, $2=width in units or inches .sp 0.3 .nr g7 \\$2 -.in (\\n(.lu-\\n(g7u)/2u +.in (u;\\n(.l-\\n(g7>?0/2) .ne \\$1u .nr g7 \\n(.u .ls 1 Index: tmac/tmac.s =================================================================== RCS file: /home/ncvs/src/contrib/groff/tmac/tmac.s,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 tmac.s --- tmac/tmac.s 1996/09/07 16:18:27 1.1.1.1 +++ tmac/tmac.s 2000/12/01 13:59:03 @@ -899,7 +899,7 @@ Foundation, 59 Temple Place - Suite 330, .ie '\\n(.z'ds*div' \{\ . di . nf -. in (u;\\n[.l]-\\n[dl]/2) +. in (u;\\n[.l]-\\n[dl]/2>?0) . ds*div . rm ds*div . ds*common-end @@ -954,7 +954,7 @@ Foundation, 59 Temple Place - Suite 330, . br . di . nf -. in (u;\\n[.l]-\\n[dl]/2) +. in (u;\\n[.l]-\\n[dl]/2>?0) . ds@need \\n[dn] . ds*div . rm ds*div --IS0zKkzwUGydFO0o-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001201160540.A18011>