On 10/27/20 11:27 AM, Alejandro Colomar wrote: > Hi Michael, > > On 2020-10-27 06:54, Michael Kerrisk (man-pages) wrote: >> Hi Alex, >> >> On 10/26/20 11:34 PM, Alejandro Colomar wrote: >>> Remove comment specifying the layout of the page. >>> >>> The page has grown enough to document the layout by itself. >>> Anything that is not clear enough in the current layout >>> should follow documented conventions. >>> >>> This comment is not needed anymore. >> >> I think there's still some value in retaining this comment! >> IMO, it's not completely obvious how each type should be >> described from simply reading the existing entries. > > > Okay. > I'll keep this patch in the 'rejected' branch, > and maybe some day I'll pick it again :) > >> >> If we retain the comment, the "Notes" piece could >> definitely be removed though. > > > I'm not sure what you mean about this. I mean, this piece seems redundant: .\" * Notes (optional) .\" Or did I miss something? Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
