Re: [PATCH] man2/pr-pz.2: srcfix: Use a single-font-change macro for a single argument

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Bjarne,

On 1/6/19 7:33 PM, Bjarni Ingi Gislason wrote:
>   Use a single-font-change macro for a single argument.
> 
>   Remove quotation marks around a single argument (ptrace.2)
> 
>   The output from "nroff" and "groff" is unchanged, except
> 
> 1) a font is changed for a punctuation mark (ptrace.2)
> 
> 2) a comma is moved to the previous line, so the space in front of it
> disappears (ptrace.2).

Changes such as 2) are really useful, but it's very difficult for me 
to check that they are correct, because of all of the "noise" of
the single-font macro changes, and then...

[...]

> -.BR PTRACE_SYSEMU_SINGLESTEP.
> +.B PTRACE_SYSEMU_SINGLESTEP.

I discover other changes that are wrong... (Of course,
the existing formatting is already wrong...)

>  .PP
>  However, even if the tracee was continued using
> -.BR PTRACE_SYSCALL
> -, it is not guaranteed that the next stop will be a syscall-exit-stop.
> +.BR PTRACE_SYSCALL ,
> +it is not guaranteed that the next stop will be a syscall-exit-stop.

Again, changes like this are welcome, but really I'd have wanted 
them as separate patches.

Thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux