Re: correct includes in man(2) pages

2013-06-05 Thread Jason McIntyre
On Wed, Jun 05, 2013 at 06:36:11PM +0200, Jan Klemkow wrote: > > The only special case is this one: > > Index: libc/sys/quotactl.2 > === > RCS file: /cvs/src/lib/libc/sys/quotactl.2,v > retrieving revision 1.11 > diff -u -p -r1.11 qu

Re: correct includes in man(2) pages

2013-06-05 Thread Ted Unangst
On Wed, Jun 05, 2013 at 17:56, Jason McIntyre wrote: > we should be careful here. mandoc renders it like this: > > SYNOPSIS > #include /* for ufs quotas */ > #include > > whereas groff does this: > > SYNOPSIS > #include > /* for ufs quotas */ #include > > our mdoc(7) states that .In should

Re: correct includes in man(2) pages

2013-06-05 Thread Jason McIntyre
On Wed, Jun 05, 2013 at 01:14:15PM -0400, Ted Unangst wrote: > On Wed, Jun 05, 2013 at 17:56, Jason McIntyre wrote: > > we should be careful here. mandoc renders it like this: > > > > SYNOPSIS > > #include /* for ufs quotas */ > > #include > > > > whereas groff does this: > > > > SYNOPSIS > >

Re: correct includes in man(2) pages

2013-06-05 Thread Kent R. Spillner
> we should probably not have more than one argument in our pages for the > .In lines, and, arguably, mandoc should behave the same as groff. Regardless, the comment doesn't add much. "#include " is pretty self-explanatory that it's for UFS quotas. :)