Re: Errors in man pages, here: setpgid.2.po: Inconsistent formatting

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

 



Hello Jakub,

On Tue, 21 Apr 2020 at 10:34, Jakub Wilk <jwilk@xxxxxxxxx> wrote:
>
> * Michael Kerrisk (man-pages) <mtk.manpages@xxxxxxxxx>, 2020-04-20, 08:12:
> >># FIXME: inconsistant formatting/markup (compared to previous entries)
> >>
> >>"B<pid_t getpgrp(pid_t >I<pid>B<);\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ > /* BSD "
> >>"version */"
> >
> >I need more context here. I can't see the problem.
>
> I think it's about comment indentation:
> for the BSD functions, it's done with escaped spaces:
>
>    .BI "pid_t getpgrp(pid_t " pid ");\ \ \ \ \ \ \ \ \ \ \ "
>    /* BSD version */
>
> whereas for the other functions, plain spaces are used:
>
>    .BR "pid_t getpgrp(void);" "                 /* POSIX.1 version */"

D'oh! What idiot formatted things like tha... ohhhh....

> While we can't just remove backslashes, we could do something like this:
>
>    .BI "pid_t getpgrp(pid_t " pid ");\fR            /* BSD version */"
>
> This is more readable IMO, and should make translators happy. :)

Agreed. Changed as you suggest.

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