Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-28 Thread G. Branden Robinson
At 2024-06-28T04:07:56-0600, arn...@skeeve.com wrote: > The use of .bd is indeed the case. I asked. :-) > From BWK, forwarded by permission. Thanks, Arnold! Mystery solved. Regards, Branden signature.asc Description: PGP signature

Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-28 Thread arnold
Hi. > G. Branden Robinson wrote: > > > So maybe they had access to a CAT-8 after all, and used a whopping 5 > > different font plates. Or they used a CAT-4 and had to compose many > > pages in two passes. That would have been mightily tedious. Mychaela Falconia wrote: > Are you certain that

Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-25 Thread Steve Izma
On Tue, Jun 25, 2024 at 11:13:36AM -0500, G. Branden Robinson wrote: > Subject: Re: [TUHS] Re: Documenting a set of functions with -man > > At 2024-06-25T08:51:39-0400, Douglas McIlroy wrote: > > Since the C/A/T held only four fonts, there was no room for > > Courier. >

Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-25 Thread G. Branden Robinson
Hi Mychaela, At 2024-06-25T11:15:32-0800, Mychaela Falconia wrote: > G. Branden Robinson wrote: > > So maybe they had access to a CAT-8 after all, and used a whopping 5 > > different font plates. Or they used a CAT-4 and had to compose many > > pages in two passes. That would have been mightily

Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-25 Thread Mychaela Falconia
G. Branden Robinson wrote: > So maybe they had access to a CAT-8 after all, and used a whopping 5 > different font plates. Or they used a CAT-4 and had to compose many > pages in two passes. That would have been mightily tedious. Are you certain that the bold in that book is real B font and no

Re: [TUHS] Re: Documenting a set of functions with -man

2024-06-25 Thread G. Branden Robinson
[looping the groff list back in; Doug's reply went to TUHS] At 2024-06-25T08:51:39-0400, Douglas McIlroy wrote: > > The lack of a monospaced font is, I suspect, due either to > > physical limitations of the C/A/T phototypesetter[1] or fiscal > > limitations--no budget in that department to buy pho

Re: Documenting a set of functions with -man

2024-06-24 Thread G. Branden Robinson
Hi Anton, ...returning to this after a digression on alignment/adjustment... At 2024-06-18T02:01:24+0300, Anton Shepelev wrote: > G. Branden Robinson: > In my sources, I tend to format the declarations of my > functions in similar manner, e.g.: > >void sort >(void * data, /* pointer

Re: Documenting a set of functions with -man

2024-06-23 Thread Bjarni Ingi Gislason
On Fri, Jun 21, 2024 at 02:52:22PM +, Lennart Jablonka wrote: > Quoth Anton Shepelev: > > What is the covenstional way of documenting a set of C > > functions with -man? Have you any recommendations or > > examples about typesetting function declaraions, their > > return types and aruguments i

Re: Documenting a set of functions with -man

2024-06-21 Thread G. Branden Robinson
Hi Lennart, At 2024-06-21T14:52:22+, Lennart Jablonka wrote: > Quoth Anton Shepelev: > > What is the covenstional way of documenting a set of C > > functions with -man? Have you any recommendations or > > examples about typesetting function declaraions, their > > return types and aruguments i

Re: Documenting a set of functions with -man

2024-06-21 Thread Lennart Jablonka
Quoth Anton Shepelev: What is the covenstional way of documenting a set of C functions with -man? Have you any recommendations or examples about typesetting function declaraions, their return types and aruguments in a classic man-page? The .SY macro does not seem to work well for C, because its

Re: Documenting a set of functions with -man

2024-06-17 Thread Anton Shepelev
G. Branden Robinson: > People frequently run into trouble because they usually > don't want the text of function prototypes filled, but the > prototypes can also get lengthy, and they don't know how > to make the text adapt to the available terminal width in > the absence of filling. (Short answe

Re: Documenting a set of functions with -man

2024-06-13 Thread G. Branden Robinson
Hi Anton, At 2024-06-13T01:27:42+0300, Anton Shepelev wrote: > What is the covenstional way of documenting a set of C functions with > -man? There isn't one. As usual I'll offer some historical background. As far as I know, the community has never converged on a recommended best practice. Page