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

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

 



* 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 */"

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. :)

--
Jakub Wilk



[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