Thread (45 messages) 45 messages, 4 authors, 2025-08-07

Re: [PATCH 05/10] fsconfig.2: document 'new' mount api

From: G. Branden Robinson <hidden>
Date: 2025-08-06 07:50:25

At 2025-08-06T10:45:03+0300, Askar Safin wrote:
Also, when I render this manpage using "man", I see this:
quoted
that the  underlying  file  for  the  file  descriptor  aux  should
be  used  as  the  parameter  value  directly;  FSCON‐
FIG_SET_PATH_EMPTY  indicates  that  the  underlying file for the
file descriptor aux should be re-opened by the filesystem
As you can see, "man" breaks word "FSCONFIG_SET_PATH_EMPTY": "FSCON"
appears on one line and "FIG_SET_PATH_EMPTY" on another line.  Can you
somehow prevent this? I. e. to prevent breaking of API names. This is
very annoying.
Yes.  Use the `\%` escape sequence to suppress hyphenation.

groff_man_style(7):

     \%        Control hyphenation.  The location of this escape
               sequence within a word marks a hyphenation point,
               supplementing groff’s automatic hyphenation patterns.  At
               the beginning of a word, it suppresses any hyphenation
               breaks within except those specified with \%.

(This is a *roff feature, not a characteristic of the man(7) macro
package; that is why groff_man(7) itself does not document it.)

Thus one might say:

.B \%FSCONFIG_SET_PATH_EMPTY

Regards,
Branden

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help