.ad l/.ad b

Hi, Branden and Michael! I've seen these in shmctl.2, and didn't know what they mean. groff(7) wasn't very helpful. [ .SH SYNOPSIS .nf .ad l .B #include .PP .BI "int shmctl(int " shmid ", int " cmd ", struct shmid_ds *" buf ); .ad b .fi ] What are those '.ad X' and do we really need them? I f

AW: .ad l/.ad b

Hi, .ad Begin line adjustment for output lines in current adjust mode. .ad c Start line adjustment in mode c (c=l,r,c,b,n). That looks like left, right, centered, block and neutral? Just my uninformed guess, and I am not at all sure about my impromptu Interpretation of 'n'. Best regards,  Oli

.B, .I disable hyphenation?

Hi Branden, Usually, when a manual page highlights a term, either in bold or italics, it usually is a special identifier (macro, function, command name or argument), for which hyphenation can hurt readability and even worse, turn it into a different valid identifier. What about disabling hyp

Re: AW: .ad l/.ad b

Hi Oliver, On 9/12/21 1:33 PM, Oliver Corff wrote: Hi, .ad Begin line adjustment for output lines in current adjust mode. .ad c Start line adjustment in mode c (c=l,r,c,b,n). That looks like left, right, centered, block and neutral? Just my uninformed guess, and I am not at all sure about my

Re: .ad l/.ad b

Hi Alejandro, Alejandro Colomar (man-pages) wrote on Sun, Sep 12, 2021 at 01:13:07PM +0200: > I've seen these in shmctl.2, and didn't know what they mean. > groff(7) wasn't very helpful. > > [ > .SH SYNOPSIS > .nf > .ad l > .B #include > .PP > .BI "int shmctl(int " shmid ", int " cmd ", struct

Re: .B, .I disable hyphenation?

Hi Alejandro, Alejandro Colomar (man-pages) wrote on Sun, Sep 12, 2021 at 02:56:39PM +0200: > Usually, when a manual page highlights a term, either in bold or > italics, it usually is a special identifier (macro, function, command > name or argument), for which hyphenation can hurt readability

Re: .ad l/.ad b

Hi, Alex! At 2021-09-12T13:13:07+0200, Alejandro Colomar (man-pages) wrote: > Hi, Branden and Michael! > > I've seen these in shmctl.2, and didn't know what they mean. > groff(7) wasn't very helpful. :( It's true that our groff(7) page doesn't cover a lot of topics that were covered in CSTR #54

Re: .ad l/.ad b

Hi Oliver, At 2021-09-12T13:33:38+0200, Oliver Corff wrote: > .ad Begin line adjustment for output lines in current > adjust mode. > .ad c Start line adjustment in mode c (c=l,r,c,b,n). > > That looks like left, right, centered, block and neutral? Yes, pretty much. > Just my uninformed guess, a

Re: .B, .I disable hyphenation?

Hi, Alex! At 2021-09-12T14:56:39+0200, Alejandro Colomar (man-pages) wrote: > Hi Branden, > > Usually, when a manual page highlights a term, either in bold or > italics, it usually is a special identifier (macro, function, command > name or argument), for which hyphenation can hurt readability an

Re: .B, .I disable hyphenation?

Hi Branden, On 9/12/21 7:27 PM, G. Branden Robinson wrote: Hi, Alex! At 2021-09-12T14:56:39+0200, Alejandro Colomar (man-pages) wrote: Hi Branden, Usually, when a manual page highlights a term, either in bold or italics, it usually is a special identifier (macro, function, command name or arg

Re: .B, .I disable hyphenation?

Hi, Alex! I realized only after sending my previous giant message on this subject, that I may have overlooked the elementary step of ensuring that readers know of the existence and function of the *roff hyphenation control escape sequence. groff_man_style(7)[1] explains it as follows. \%