Sample Header Ad - 728x90

Is groff ignoring `.nh` command?

6 votes
1 answer
374 views
For a man page written in POD (perlpod) I had the effect that the SYNOPSIS was left-adjusted on the text terminal, but the PostScript output (read: troff) adjusted the text to both borders. So I tried to embed formatting commands in the POD source. However, even when specifying .nh some words like "[--[no-]check-grace-logins]" were hyphenated at a minus. That made me wonder whether the man -l command disobeys the .nh command. The manual page for roff(7) says: > .nh No hyphenation. Here is the relevant part of the roff man page: ~~~lang-roff .\" ======================================================================== .\" .IX Title "LDAP-USER-CHECK 8" .TH LDAP-USER-CHECK 8 "2024-08-14" "0.0.0.0.20n" "System Administration" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" ldap\-user\-check \- check LDAP account status .SH "SYNOPSIS" .IX Header "SYNOPSIS" .\" BEGIN roff .\" save adjustment, then left-adjust .ds _A \n[.j] .ad l .\" save hyphenation, then disable .ds _H \n[.hy] .nh .\" END roff \&\fBldap-user-check\fR [\fB\-\-account\-context=\fR\fIcontext\fR] [\fB\-\-account\-filter=\fR\fIfilter\fR] [\fB\-\-add\-notification\-bcc\-address=\fR\fIemail-spec\fR]... [\fB\-\-add\-notification\-cc\-address=\fR\fIemail-spec\fR]... [\fB\-\-default\-default\-ppolicy=\fR\fIdn\fR] [\fB\-\-default\-language=\fR\fIlang\fR] [\fB\-\-default\-notification\-email\-address=\fR\fIemail-spec\fR]... [\fB\-\-ca\-certs\-path=\fR\fIpath\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-auth-failure\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-grace-logins\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-inconsistent-accounts\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-locked-accounts\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-password-policy\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-pp-override\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcheck-shadow-password\fR] [\fB\-\-credentials\-file\-name=\fR\fIfilename\fR] [\fB\-\-instance\-string=\fR\fIinstance\fR] [\fB\-\-ldap\-size\-limit=\fR\fInumber\fR] \&\fB\-\-ldap\-suffix=\fR\fIsuffix\fR [\fB\-\-ldap\-time\-limit=\fR\fInumber\fR] \&\fB\-\-ldap\-uri=\fR\fI\s-1URI\s0\fR \&\fB\-\-notification\-template=\fR\fIfilename\fR [\fB\-\-override\-default\-ppolicy=\fR\fIdn\fR] [\fB\-\-override\-expiration\-warning\-time=\fR\fInumber\fR] [\fB\-\-override\-from\-email\-address=\fR\fIemail-spec\fR] [\fB\-\-override\-notification\-email\-address=\fR\fIemail-spec\fR]... [\fB\-\-ppolicy\-context=\fR\fIcontext\fR] [\fB\-\-set\-notification\-reply\-to\-address=\fR\fIemail-spec\fR] [\fB\-\-verbosity=\fR\fIlevel\fR] [\fB\-\-wrap\-template=\fR\fIlen\fR] .\" BEGIN roff .\" restore saved hyphenation and adjustment .hy \*(_H .ad \*(_A .\" END roff .SH "DESCRIPTION" .IX Header "DESCRIPTION" ~~~ And here is what I see on a 80-character wide terminal: partial manual page on text terminal WHen converting that manual page using groff -man -Tps the .nh seems to be ignored as well: partial manual page converted to PostScript Programs being used are perl 5.18.2, groff-1.22, both from SLES12 SP5.
Asked by U. Windl (1715 rep)
Aug 14, 2024, 01:02 PM
Last activity: Aug 16, 2024, 12:16 PM