On Wed, 27 Feb 2019 at 11:10, G. Branden Robinson <g.branden.robinson@xxxxxxxxx> wrote: > > At 2019-02-27T10:42:04+0100, Michael Kerrisk (man-pages) wrote: > > Hello Bjarni, > > > > > --- a/man5/sysfs.5 > > > +++ b/man5/sysfs.5 > > [...] > > > > > @@ -286,7 +286,7 @@ of thing that needs to be updated very often. > > > .BR proc (5), > > > .BR udev (7) > > > .PP > > > -P. Mochel. (2005). > > > +P.\& Mochel. (2005). > > > > You can perhaps educate me here. What is the intent of this change? > > *roff systems will interpret the period in the unpatched page as > sentence-ending punctuation and put inter-sentence spacing after it. > (This might not be visible on nroff/terminal devices, but it is more > likely to be on typesetter/PostScript/PDF output). > > groff_man(7) in groff 1.22.4 attempts to throw man page writers a bone > here: > > \& Zero‐width space. Append to an input line to prevent an end‐of‐ > sentence punctuation sequence from being recognized as such, or > insert at the beginning of an input line to prevent a dot or > apostrophe from being interpreted as the beginning of a roff > request. Thanks for info, Branden. So, a patch as below would be appropriate? Cheers, Michael -Linux uses David L. Mills' clock adjustment algorithm (see RFC\ 5905). +Linux uses David L.\& Mills' clock adjustment algorithm (see RFC\ 5905). The system call .BR adjtimex () reads and optionally sets adjustment parameters for this algorithm. diff --git a/man2/futex.2 b/man2/futex.2 index 997741fd3..ea5931c26 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -1915,7 +1915,7 @@ Hart, D., 2009. \fIA futex overview and update\fP, .UR http://lwn.net/Articles/360699/ .UE .PP -Hart, D. and Guniguntala, D., 2009. +Hart, D.\& and Guniguntala, D., 2009. \fIRequeue-PI: Making Glibc Condvars PI-Aware\fP (from proceedings of the 2009 Real-Time Linux Workshop), .UR http://lwn.net/images/conf/rtlws11/papers/proc/p10.pdf diff --git a/man2/mremap.2 b/man2/mremap.2 index 45212e2b0..6f65d9cb6 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -271,6 +271,6 @@ in this scenario. .PP Your favorite text book on operating systems for more information on paged memory -(e.g., \fIModern Operating Systems\fP by Andrew S. Tanenbaum, +(e.g., \fIModern Operating Systems\fP by Andrew S.\& Tanenbaum, \fIInside Linux\fP by Randolf Bentson, -\fIThe Design of the UNIX Operating System\fP by Maurice J. Bach) +\fIThe Design of the UNIX Operating System\fP by Maurice J.\& Bach) diff --git a/man2/seccomp.2 b/man2/seccomp.2 index 7cbb816ba..035532b8b 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -1139,7 +1139,7 @@ and .IR Documentation/prctl/seccomp_filter.txt before Linux 4.13). .PP -McCanne, S. and Jacobson, V. (1992) +McCanne, S.\& and Jacobson, V.\& (1992) .IR "The BSD Packet Filter: A New Architecture for User-level Packet Capture" , Proceedings of the USENIX Winter 1993 Conference .UR http://www.tcpdump.org/papers/bpf\-usenix93.pdf diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 90f4a284f..e13e49bf2 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -313,7 +313,7 @@ can be found in .BR hostname (7), .BR named (8) .PP -R. Gilligan, S. Thomson, J. Bound and W. Stevens, +R.\& Gilligan, S.\& Thomson, J.\& Bound and W.\& Stevens, .IR "Basic Socket Interface Extensions for IPv6" , RFC\ 2553, March 1999. .PP diff --git a/man3/random.3 b/man3/random.3 index 6270b5d43..645e83dd2 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -184,13 +184,13 @@ for that purpose. .PP Random-number generation is a complex topic. .I Numerical Recipes in C: The Art of Scientific Computing -(William H. Press, Brian P. Flannery, Saul A. Teukolsky, William -T. Vetterling; New York: Cambridge University Press, 2007, 3rd ed.) +(William H.\& Press, Brian P.\& Flannery, Saul A.\& Teukolsky, William +T.\& Vetterling; New York: Cambridge University Press, 2007, 3rd ed.) provides an excellent discussion of practical random-number generation issues in Chapter 7 (Random Numbers). .PP For a more theoretical discussion which also covers many practical issues -in depth, see Chapter 3 (Random Numbers) in Donald E. Knuth's +in depth, see Chapter 3 (Random Numbers) in Donald E.\& Knuth's .IR "The Art of Computer Programming" , volume 2 (Seminumerical Algorithms), 2nd ed.; Reading, Massachusetts: Addison-Wesley Publishing Company, 1981. diff --git a/man4/console_codes.4 b/man4/console_codes.4 index bbca863ef..6af663d84 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -592,7 +592,7 @@ own private-mode sequences, refer to the document by Edward Moy, Stephen Gildea, -and Thomas E. Dickey +and Thomas E.\& Dickey available with the X distribution. That document, though terse, is much longer than this manual page. For a chronological overview, diff --git a/man5/sysfs.5 b/man5/sysfs.5 index 52ee96719..f34069697 100644 --- a/man5/sysfs.5 +++ b/man5/sysfs.5 @@ -286,7 +286,7 @@ of thing that needs to be updated very often. .BR proc (5), .BR udev (7) .PP -P. Mochel. (2005). +P.\& Mochel. (2005). .IR "The sysfs filesystem" . Proceedings of the 2005 Ottawa Linux Symposium. .\" https://www.kernel.org/pub/linux/kernel/people/mochel/doc/papers/ols-2005/mochel.pdf diff --git a/man7/sched.7 b/man7/sched.7 index 6ddc53bd0..3e7d94f04 100644 --- a/man7/sched.7 +++ b/man7/sched.7 @@ -997,7 +997,7 @@ was not possible up to kernel version 2.6.17. .ad .PP .I Programming for the real world \- POSIX.4 -by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. +by Bill O.\& Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. .PP The Linux kernel source files .IR Documentation/scheduler/sched-deadline.txt , diff --git a/man7/unicode.7 b/man7/unicode.7 index 1cd224118..08b0484e5 100644 --- a/man7/unicode.7 +++ b/man7/unicode.7 @@ -230,7 +230,7 @@ The Unicode Standard, Version 3.0. The Unicode Consortium, Addison-Wesley, Reading, MA, 2000, ISBN 0-201-61633-5. .IP * -S. Harbison, G. Steele. C: A Reference Manual. Fourth edition, +S.\& Harbison, G.\& Steele. C: A Reference Manual. Fourth edition, Prentice Hall, Englewood Cliffs, 1995, ISBN 0-13-326224-3. .IP A good reference book about the C programming language. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
