Add a New Comment (Rich Markup)
I found it. GMail, surprisingly, led me straight to it once I poked its into my sent box. https://lists.gnu.org/archive/html/groff/2022-01/msg00010.html
comment #2:
> Updating Item Group: Branden can correct me if I'm wrong, but I believe "Lint" is intended for coding issues. Documentation files can include code, roff being a full programming language, but this bug reports only issues with documentation content, making "Documentation" seem more appropriate.
Hi Dave, Actually, no. "Lint Some detail of groff is unfastidious, such as non-confusing typos in documentation or code style nits. These matters do not warrant a ChangeLog entry absent a Savannah ticket." The Item Groups do actually have descriptions. Perversely, only the administrators of Savannah projects can see them (or the descriptions of the Categories). This strikes me as supremely unhelpful to Savannah users, but I haven't worked up the anger to thunder about this to the savannah-hackers-public list yet. I did publish my updates to the groff Item Groups and Categories a while back after grinding through them, so there is some public record of this. It is apparently the only one. But it's so hard to find, I can't locate it. Neither lists.gnu.org's mailing list search (about which Alex Colomar complained) nor Google turns it up. Great. :-|
> this bug reports only issues with documentation content,
...only DEALS with...
Updating Item Group: Branden can correct me if I'm wrong, but I believe "Lint" is intended for coding issues. Documentation files can include code, roff being a full programming language, but this bug reports only issues with documentation content, making "Documentation" seem more appropriate.
original submission:
> See a manual of style about the difference between "abc..." and > "abc ...".
Maybe you could give a specific style manual reference, and say what that manual says about this difference? As a counterexample, the Chicago Manual of Style, a widely used US style manual, makes no such distinction. It does distinguish between an ellipsis followed by a period, and a period followed by an ellipsis (see section 13.53 in the latest (17th) edition), which does affect the spacing with the preceding word, but both of these constructions necessarily involve four dots, and therefore apply to none of the 28 instances you've cited throughout this bug report. (The online CMoS is behind a paywall so I can't give a URL to the above citation.) Adding Peter to cc, since this item and one other affect a -mom file, and he can decide whether/how he wants to change it.
Subject: manpages: improve some wording and typesetting Input file is ./contrib/gperl/gperl.1.man Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 347:stores the 1st argument as ##### Input file is ./contrib/mm/groff_mm.7.man Split lines longer than 100 characters into two or more lines. Appropriate break points are the end of a sentence and a subordinate clause; after punctuation marks. ./contrib/mm/groff_mm.7.man: line 3245 length 129 .BI TC\ "\fR[\fPslevel \fR[\fPspacing \fR[\fPtlevel \fR[\fPtab \fR[\fPh1 \fR[\fPh2 \fR[\fPh3 \fR[\fPh4 \fR[\fPh5\fR]]]]]]]]]\fP" ##### Add a missing left italic correction in front of \fI, or use a macro .BI LT\ \fR[\fIarg\/\fR]\fI ##### Add a zero (0) in front of a decimal fraction that begins with a period (.) 3321:\&.ds Ci .25i .5i .75i 1i 1i ##### Use the name of units in text, symbols in tables and calculations 1427:the default amount is 1v. 1842:Default is 2v. 3189:like \[lq]3i\[rq] or \[lq]8v\[rq]. 3206:Reset tabs to every\ 5n. 3503:Indent the verbose text by \[lq]5n\[rq]. 3549:(\[lq]7v 5v\[rq]) 4385:The default is 0.5v in troff mode and 1v in nroff mode. 4617:Default is 5n. ##### Split a punctuation from a single argument, if a two-fonts macro is meant 951:.I format, 952:.I fill, 3092:.I mode, ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 695:.BI AT\~ title\c 2783:.BI \-I\~ n\c ##### Input file is ./contrib/mom/groff_mom.7.man Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 142:.\" XXX: but we have PDFPIC now...so -Tps is necessary only for people 1728: threat, at length I would be avenged.\|.\|. 1863:.RI ( "The most important point.\|.\|.\&" ) 2878:.BR \[rs]*[ST].\|.\|.\&\[rs]*[STX] ), 2894:.BR \[rs]*[ST].\|.\|.\&\[rs]*[STX] ). 3137:.B The beginning of a paragraph.\|.\|.\& 3139:.B The beginning of another paragraph.\|.\|.\& ##### Add a zero (0) in front of a decimal fraction that begins with a period (.) 1162:.B .B_MARGIN .75i 2220:.B .L_MARGIN .5i ##### Input file is ./man/groff.7.man Split a punctuation from a single argument, if a two-fonts macro is meant 491:.I groff, 1091:.B !\&, 2707:.I ident. 4143:.I font. 5318:.I registers. 6654:.I stack, ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 600:.BI \[rs] newline\c 635:.BI \[rs] newline\c 1717:.BI \[rs] space\c 6931:.BI ": ${" var \c ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 3074:(in multiples of 1/1000th). 3942:.IR N \~12ths 3951:.IR M \~12ths ##### Input file is ./man/groff_char.7.man Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 802:].\|.\|.] 875:.\" And thereby hangs a tale... 933:.\" XXX: I surmise that... ##### Split a punctuation from a single argument, if a two-fonts macro is meant 156:.B \e[bs]. ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 743:.BI \[rs][u nnnn\c 744:.RI [ n\c 799:.BI \[rs][u base-glyph\c 801:.BI _ combining-component\c 894:.BI \[rs]( xx\c ##### Input file is ./man/groff_diff.7.man Find a repeated word ! 770 --> is ##### Split a punctuation from a single argument, if a two-fonts macro is meant 1018:.B \[rs], 1033:.B \[rs], 1942:.I ident. 3634:.I anything, 3639:.I body. ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 406:.BI \[rs][ xxx\c 408:.BI \[rs]N\[aq] xxx\c 2632:.BI .hpfcode\~ "a b"\c ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 2334:must a non-negative integer multiple of 1/1000th. N.B. line 2334 is missing the word "be" 4229:The zoom value of the current font, in multiples of 1/1000th. ##### Input file is ./man/groff_font.5.man Split a punctuation from a single argument, if a two-fonts macro is meant 805:.I subfields, ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 211:.BI papersize\~ format-or-dimension-pair-or-file-name\c ##### Input file is ./man/groff_out.5.man Use a macro to change to the italic font, instead of \fI [1], if possible. The macros have the italic corrections, but "\c" removes the "\/" part, which is in the macro. So "\/" must be added to the argument before the "\c" string. Or add the italic corrections. [1] man-pages(7) 67:\fB\\$1\fP\ \fI\,\\$2\/\fP\\$3 71:\fBD\\$1\fP\ \fI\,\\$2\/\fP\|\*[@linebreak] 91:\fBx\\$1\fP\ \fI\\$2\fP\|\*[@linebreak] ##### Split a punctuation from a single argument, if a two-fonts macro is meant 562:.I n; 799:.I n; ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 447:.BI # anything\c ##### Input file is ./man/groff_tmac.5.man Use a macro to change to the italic font, instead of \fI [1], if possible. The macros have the italic corrections, but "\c" removes the "\/" part, which is in the macro. So "\/" must be added to the argument before the "\c" string. Or add the italic corrections. [1] man-pages(7) 671:|\|\fB\-I\fP\~\fIn\fP] \ 672:\fI\|file\fP [\fIwidth\fP [\,\fIheight\/\fP]] ##### Add a missing left italic correction in front of \fI, or use a macro \fI\|file\fP [\fIwidth\fP [\,\fIheight\/\fP]] ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 514:.BI \%paper= format\c ##### Input file is ./man/roff.7.man Increase size of ~ (tilde) to make it more visible with "troff" by using character \(ti. 1325:.\" <https://www.cs.princeton.edu/~bwk/202/summer.reconstructed.pdf>. ##### Split a punctuation from a single argument, if a two-fonts macro is meant 137:.I filling. 228:.I hyphenation. 248:.I break. 330:.I requests. 416:.I arguments, 450:.I interpolation. 589:.I vee. 718:.I characters. 721:.I groff, ##### Input file is ./src/devices/grodvi/grodvi.1.man Find a repeated word ! 333 --> are ##### Input file is ./src/devices/grolbp/grolbp.1.man An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 60:.BI \-\-copies= num-copies\c 62:.BI \-\-fontdir= font-directory\c 66:.BI \-\-linewidth= width\c 68:.BI \-\-orientation= orientation\c 70:.BI \-\-papersize= paper-format\c ##### Input file is ./src/devices/gropdf/gropdf.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 661:.B grops. 1355:.I gropdf. 1672:.I troffrc. ##### Input file is ./src/devices/grops/grops.1.man Add a zero (0) in front of a decimal fraction that begins with a period (.) 1173:\[rs]D\[aq]l .9m 0\[aq]\[rs]h\[aq].05m\[aq]\[aq]\[rs] 1223:{ gsave .9 setgray clippath pathbbox exch 2 copy 1224: .5 mul exch .5 mul translate atan rotate pop pop ##### Split a punctuation from a single argument, if a two-fonts macro is meant 347:.I GROPS_PROLOGUE. 1385:.I grops. 1761:.I troffrc. ##### Input file is ./src/devices/grotty/grotty.1.man Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 261:.\" Version 487 of... ##### Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 252:.\" double-struck characters as bold nor supports -b, but does render ##### Split a punctuation from a single argument, if a two-fonts macro is meant 641:.I grotty. ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 288:.IR uri \~[ key\c 289:.BI = value\c ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 132:.\" ECMA-48, 2nd edition (1979) calls it "negative image". 753:5th\~edition, ##### Input file is ./src/preproc/eqn/eqn.1.man Do not use "\s0" but an absolute number, as the size of the string could be changed. 236:.ds Su \[lq]\s+5\[*S]\s0\[rq] ##### Input file is ./src/preproc/grn/grn.1.man Use the name of units in text, symbols in tables and calculations 290:times 0.15pt 296:which corresponds to 0.15pt 297:(0.45pt and 0.75pt, ##### Input file is ./src/preproc/pic/pic.1.man Use a macro to change to the italic font, instead of \fI [1], if possible. The macros have the italic corrections, but "\c" removes the "\/" part, which is in the macro. So "\/" must be added to the argument before the "\c" string. Or add the italic corrections. [1] man-pages(7) 457:\fBfor\fR \fIvariable\fR \fB=\fR \fIexpr1\fR \fBto\fR \fIexpr2\fR \ 458:[\fBby\fR [\fB*\fR]\,\fIexpr3\/\fR] \fBdo\fR \fIX\fR \fIbody\fR \fIX\fR 509:\fBif\fR \fIexpr\fR \fBthen\fR \fIX\fR \fIif-true\fR \fIX\fR \ 510:[\fBelse\fR \fIY\fR \fIif-false\fR \fIY\fR] 586:\fBsh\fR \fIX\fR \fIcommand\fR \fIX\fR 593:\fBcopy\fR \fB"\,\fIfilename\/\fB"\fR 717:\fBplot\fR \fIexpr\fR [\fB"\,\fItext\*(ic\fB"\fR] 834:\fIe1\fB && \fIe2\fR 836:\fIe1\fB || \fIe2\fR 838:\fIe1\fB == \fIe2\fR 840:\fIe1\fB != \fIe2\fR 842:\fIe1\fB >= \fIe2\fR 844:\fIe1\fB > \fIe2\fR 846:\fIe1\fB <= \fIe2\fR 848:\fIe1\fB < \fIe2\fR 850:\fB"\,\fIstr1\*(ic\fB" == "\,\fIstr2\*(ic\fB"\fR 852:\fB"\,\fIstr1\*(ic\fB" != "\,\fIstr2\*(ic\fB"\fR ##### Add a missing left italic correction in front of \fI, or use a macro 811:.el 10\[ha]\fIx\fR) ##### Do not use "\s0" but an absolute number, as the size of the string could be changed. 41:. ds lx L\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\*[tx] ##### Use the name of units in text, symbols in tables and calculations 407:\[rs]centerline{\[rs]raise 1em\[rs]box\[rs]graph} 422: \[rs]vbox{\[rs]unvbox\[rs]csname #1\[rs]endcsname\[rs]kern 0pt}} 909:x = 5e\-2 ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 527:.BI print\~ arg\c 541:.BI command\~ arg\c 695:.BI reset\~ pvar1\c ##### Input file is ./src/preproc/refer/refer.1.man Use the correct macro for the font change of a single argument or split the argument into two. 1050:.IR "et cetera".) ##### Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 1895:.B refer -p my\-db\-file ##### Add a hair space (\^) around "|" to increase readability 1788:.B \%label \[dq](A.n|Q) \[aq], \[aq] (D.y|D)\[dq]; \ ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 43:.IB field . macro\c 368:.IB m \- \c ##### Input file is ./src/preproc/soelim/soelim.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 380:.I included-files. ##### Input file is ./src/preproc/tbl/tbl.1.man Add a hair space (\^) around "|" to increase readability 1839:n|n\[rs]f[B]\[rs][tmu]\[rs]f[]n|difference 1856:n|n\f[B]\[tmu]\f[]n|difference ##### Use the name of units in text, symbols in tables and calculations 1620:\&Lw(2i)0 L. 1631:Lw(2i)0 L. ##### Split a punctuation from a single argument, if a two-fonts macro is meant 181:.I entries. 392:.I descriptors. 426:.I classifier, 443:.I modifiers; 1210:.I adjustment. ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 1078:.BI \[rs]R x\c ##### Input file is ./src/roff/groff/groff.1.man Change -- in x--y to \(em (em-dash), or, if an option, to \-\- 1948:.\" --help or --version. ##### Input file is ./src/roff/troff/troff.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 221:.I text. 359:.I num. 368:.I list, 372:.I n, 387:.I list. 400:.I numeric-expression. 435:.I dev. 476:.I name. 897:.I name. ##### Input file is ./src/utils/afmtodit/afmtodit.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 93:.I font-description-file, 409:.I font-description-file. ##### Input file is ./src/utils/hpftodit/hpftodit.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 200:.I font-description, ##### Input file is ./src/utils/tfmtodit/tfmtodit.1.man Split a punctuation from a single argument, if a two-fonts macro is meant 110:.I tfm-file, 118:.I font-description, 144:.I tfm-file. 241:.I skew-char. ##### Input file is ./src/utils/xtotroff/xtotroff.1.man Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 123:.B -d ##### Use the name of units in text, symbols in tables and calculations 160:a resolution of 75dpi is assumed. ##### Input file is ./tmac/groff_mdoc.7.man Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 807:.\" should be room anyway...bug? 5347:.\" Not a pretty sight... ##### Use the name of units in text, symbols in tables and calculations 1508:The default width is 12n. 1536:The default width is 12n. 1608:The default width is 12n. 1639:The default width is 12n. 1658:The default width is 10n. 1684:The default width is 12n. 1716:The default width is 17n. 1737:The default width is 15n. 1786:The default width is 12n. 1972:are 12n and 16n, 2004:The default width is 12n. 2087:The default width is 12n. 2287:The default width is 16n. 2346:The default width is 10n. 2420:are 14n and 10n, respectively. 2449:The default width is 32n. 2618:The default width is 12n. 2652:The default width is 10n. 2814:The default width is 10n. 2894:have a default width value of 12n. 2914:The default width value is 12n for both macros. 2940:The default width is 16n. 2952:The default width is 12n. 3039:-compact -offset 15n 3055:The default width is 12n. 3108:The default width is 16n. 3130:The default width is 6n. 3151:The default width is 6n. 3270:The default width is 10n. 3394:The default width is 8n. 3640:The default width is 8n. 3954:The indentation value is normally set to\~6n or about two thirds of an inch 4607:a default indent value (normally set to\~6n, 4687:Its default width is 6n. 4712:Its default width is 12n. 4742:Its default width is 6n. 4755:Its default width is 6n. 4767:Its default width is 6n. 4800:Its default width is 8n. 4819:Its default width is 8n. 5051:The default is \-0.5i. 5093:The default paragraph indentation is 7.2n on typesetters and 7n on 5096:The default subsection heading indentation amount is 3n; 5110:both registers default to 78n for terminal devices and 6.5i otherwise. 5122:To change the document font size to 11p or 12p, ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 1132:7th, 7, III, 3, V, V.2, V.3, V.4 4841:.\" 2nd and 3rd columns; we had to steal a character cell from each (the ##### Input file is ./tmac/groff_me.7.man Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 484:.\" 'When I started writing the -me macros it began as something in my 490:.\" finally consented to "-meric" (which I always hated), since it was 492:.\" Berkeley it got shortened to "-me", much to my relief. 494:.\" Of course, if AT&T had been willing to let Berkeley have -ms then 495:.\" most likely -me would never have happened at all. Without a macro 496:.\" package, nroff/troff is basically unusable; -me stepped into the ##### Input file is ./tmac/groff_ms.7.man Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 874:.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper... 1926:.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper... ##### Split a punctuation from a single argument, if a two-fonts macro is meant 1038:.I post, 1072:.BR .B , 1084:.BR .B , 1092:.BR .B , 1103:.BR .B , 1141:.I post, 1587:.I marker, ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 1125:.BI \[rs] space\c 2721:.IB \%module * name\c 2726:.IB \%module @ name\c 2731:.IB \%environment : name\c 2743:.IB \%array ! index\c ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 1096:.\" possibly 9th, but definitely not Berkeley 1107:.\" possibly 9th, but definitely not Berkeley 2311:Tenth Edition \" possibly 9th 2600:.BR UX ). \" Unix; on 1st use, add footnote identifying trademark owner ##### Input file is ./tmac/groff_trace.7.man Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 216:.RB $\~ "cat <<EOF | groff -ms > /dev/null" ##### Input file is ./tmac/groff_man.7.man.in Separate an ellipsis from the preceding string with a space character, if it does not mean a continuation of it. See a manual of style about the difference between "abc..." and "abc ...". 569:.RB "].\|.\|.\& \e\- "\c 674:.\" Also see subsection "History" below... 1198:.\" end-of-sentence detection, and a newline... 2532:.\" end-of-sentence detection is performed, and... 3191:.\" rules (\[br]) as margin characters, as well as... 3222:.\" .5v after, as well as... 3228:.\" <https://lists.gnu.org/archive/html/groff/2019-07/msg00038.html>... 3745:To get a \(lqliteral\(rq.\|.\|. .\|.\|.should be input. 3793:Instead of.\|.\|. .\|.\|.should be considered. 3806:\fR.\|.\|. \fIparagraph 3807:\fR.\|.\|. .RE 3985:Instead of.\|.\|. .\|.\|.should be considered. 4040:Instead of.\|.\|. .\|.\|.do this. ##### Use the correct macro for the font change of a single argument or split the argument into two. 569:.RB "].\|.\|.\& \e\- "\c ##### Use a macro to change to the italic font, instead of \fI [1], if possible. The macros have the italic corrections, but "\c" removes the "\/" part, which is in the macro. So "\/" must be added to the argument before the "\c" string. Or add the italic corrections. [1] man-pages(7) 3797:\&.BI \(dq\(dq \fIitalic-text bold-text .IB \fIitalic-text bold-text 3805:\fIparagraph .P 3806:\fR.\|.\|. \fIparagraph 3988:\fIparagraph \fIparagraph 3990:\fIanother-paragraph \fIanother-paragraph ##### Find a repeated word ! 2141 --> is ##### The name of a manual page is set in bold and the section in roman (see man-pages(7). 3:material that differs between groff_man(7) and groff_man_style(7) as ##### Add a zero (0) in front of a decimal fraction that begins with a period (.) 3222:.\" .5v after, as well as... ##### Split a punctuation from a single argument, if a two-fonts macro is meant 235:.I break. 413:.I section. 458:.I section, 468:.I header-middle; 528:.I heading-text. 601:.I subheading-text. 701:.I indentation, 722:.I level. 809:.I indentation, 1387:.I trailing-text. 1442:.I trailing-text. 3284:.I adjustment-mode, 3368:.I footer-distance; 3500:.I subsection-indentation. ##### An italic correction (\/) is missing in front of "\c", as the correction in the macro will be removed by "\c". 399:.BI .TH " topic section"\c 568:.BI , " another-topic"\c 1320:.BI .MR "\~topic manual-section"\c 1762:.BI .BI " bold-text italic-text "\c 1780:.BI .BR " bold-text roman-text "\c 1800:.BI .IB " italic-text bold-text "\c 1820:.BI .IR " italic-text roman-text "\c 1841:.BI .RB " roman-text bold-text "\c 1863:.BI .RI " roman-text italic-text "\c ##### Use a word (or exponential notation) instead of a number plus suffix for ordinal numbers 2946:7th edition 3115:4th Berkeley Distribution #####
(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)
Attach Files: Comment:
No files currently attached
Depends on the following items: None found
Items that depend on this one: None found
There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.
Only logged-in users can vote.
Please enter the title of George Orwell's famous dystopian book (it's a date):
Follow 4 latest changes.
Copyright © 2023 Free Software Foundation, Inc. Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved. The Levitating, Meditating, Flute-playing Gnu logo is a GNU GPL'ed image provided by the Nevrax Design Team. Source Code
Powered by Savane 3.11