Re: [PATCH v1 07/28] cyclictest.8: Remove left-over comments

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

 



On Fri,  4 Jul 2025 15:27:00 +0200
"Ahmed S. Darwish" <darwi@xxxxxxxxxxxxx> wrote:

> Simplify the cyclictest manpage source by removing all obsolete comments.
> 
> Per commit 79ad2eca9abe ("COPYING file and cyclictest's man page added"),
> most of such comments are random leftovers from the original template the
> cyclictest's manpage was based on.  Namely:
> 
> (a) Remove emacs markers; modern emacsen do not need them.
> 
> (b) Remove the roff macros description table; they're all already
>     documented at man(7).
> 
> (c) Reference groff_man_style(7).  Per man(7): "man page authors and
>     maintainers who are not already experienced groff users should
>     consult groff_man_style(7)."
> 
> (d) Remove legacy, commented-out, earlier cyclictest descriptions.
> 
> (e) Remove a reference to info pages; cyclictest does not have any.
> 
> (f) Remove an obscure joke about the manpage being written by "The Rise
>     and Fall of a Fooish Bar."

FTR this was not even an obscure joke, it was another invalid left-over
from the template the manpage was based on. You can find references to
Fooish Bar in many other projects that forgot to remove it.

Glad it's gone, nonetheless. Thank you!

Petr T




[Index of Archives]     [RT Stable]     [Kernel Newbies]     [IDE]     [Security]     [Git]     [Netfilter]     [Bugtraq]     [Yosemite]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux ATA RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]

  Powered by Linux