Ticket 25547 - groff warning when processing squeue(1) man page
Summary: groff warning when processing squeue(1) man page
Status: OPEN
Alias: None
Product: Slurm
Classification: Unclassified
Component: Documentation (show other tickets)
Version: 26.05.1
Hardware: Linux Linux
: C - Contributions
Assignee: Ben Roberts
QA Contact:
URL:
Depends on:
Blocks:
 
Reported: 2026-07-13 14:02 MDT by Gennaro Oliva
Modified: 2026-07-13 16:03 MDT (History)
0 users

See Also:
Site: -Other-
Slinky Site: ---
Alineos Sites: ---
Atos/Eviden Sites: ---
Confidential Site: ---
Coreweave sites: ---
Cray Sites: ---
DS9 clusters: ---
Google sites: ---
HPCnow Sites: ---
HPE Sites: ---
IBM Sites: ---
NOAA SIte: ---
NoveTech Sites: ---
Nvidia HWinf-CS Sites: ---
OCF Sites: ---
Recursion Pharma Sites: ---
SFW Sites: ---
SNIC sites: ---
Tzag Elita Sites: ---
Linux Distro: ---
Machine Name:
CLE Version:
Version Fixed:
Target Release: ---
DevPrio: ---
Emory-Cloud Sites: ---

Attachments
Patch to fix invalid roff markup in squeue(1) man page (317 bytes, text/plain)
2026-07-13 14:02 MDT, Gennaro Oliva 		Details
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this ticket.
Description Gennaro Oliva 2026-07-13 14:02:06 MDT 
Created attachment 45817 [details]
Patch to fix invalid roff markup in squeue(1) man page

The lintian tool used to check the Debian package reports the following warning:

    W: slurm-client: groff-message an.tmac:<standard input>:761: warning: cannot nest .TP or .TQ inside .TP; supply a tag [usr/share/man/man1/squeue.1.gz:1]

The warning is caused by a stray .TP macro before a .RE directive in the Exclusive field description of the squeue(1) man page:

    .TP
    \fBUSER\fR: only one user's jobs may share a node ...
    .TP
    .RE

The empty .TP directive leaves an incomplete tagged paragraph, which recent versions of groff report as invalid roff markup.

The attached patch removes the unnecessary .TP directive before .RE. This fixes the invalid markup and allows the man page to be processed cleanly by groff and lintian.
Comment 1 Ben Roberts 2026-07-13 16:03:14 MDT 
Hi Gennaro,

Thanks for pointing this out.  We will look at correcting this in the docs.

Thanks,
Ben