New: “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”
https://bugzilla.kernel.org/show_bug.cgi?id=221715
Bug ID: 221715
Summary: “make -R build-pdf-pages-troff” fails with “warning:
table row does not fit”
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P3
Component: man-pages
Assignee: [email protected]
Reporter: [email protected]
Regression: No
Created attachment 310413
--> https://bugzilla.kernel.org/attachment.cgi?id=310413&action=edit
A full log of what happens when I follow the steps to reproduce on my system
Steps to reproduce:
1. Open a terminal.
2. Make sure that you have a copy of the man-pages repository on your system.
3. Change directory into the root of the repository by running this command:
cd <path to repository>
4. (Optional) Make sure that you’re using the same set of dependencies that I used when I tried building man-pages by doing the following:
A. Make sure that the Nix package manager is installed by running this
command:
nix-env --version
If that command finishes successfully, then Nix is installed. If that command gives you an error, then you need to install Nix.
B. Activate a dev shell that contains all of the dependencies for
building man-pages by running this command:
nix --extra-experimental-features 'nix-command flakes' develop
'git+https://codeberg.org/JasonYundt/flake-for-working-on-man-pages.git?ref=refs/heads/main&rev=d3e76acfbb2f036aa9215e930b624f80813b7f3e'
5. (Optional) Switch to a revision of man-pages that is known to have this problem by running this command:
git switch --detach a12be0058be628f50da69fb0efb2ed9b4422a699
6. Attempt to build the “build-pdf-pages-troff” target by running this command:
make -R build-pdf-pages-troff
When I follow those steps to reproduce on my system, the build fails with these errors:
Quoted 6 lines
.tmp/man/man4/console_codes.4:420: warning: table row does not fit on page 5 .tmp/man/man4/console_codes.4:778: warning: table row does not fit on page 9
make: *** [/home/jayman/Documents/Home/VC/space_afraid/Git/partially_mine/man-pages/Repo/share/mk/build/pdf/pages/troff.mk:30:
.tmp/man/man4/console_codes.4.pdf.set] Error 1
make: *** Deleting file '.tmp/man/man4/console_codes.4.pdf.set'
Signature · 4 lines
You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.
[Bug 221715] “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”
https://bugzilla.kernel.org/show_bug.cgi?id=221715
--- Comment #1 from Alejandro Colomar ([email protected]) --- Hi Jason,
Quoted 66 lines · On 2026-07-03T00:13:12+0000, [email protected] wrote:
https://bugzilla.kernel.org/show_bug.cgi?id=221715
Bug ID: 221715
Summary: “make -R build-pdf-pages-troff” fails with “warning:
table row does not fit”
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P3
Component: man-pages
Assignee: [email protected]
Reporter: [email protected]
Regression: NoCreated attachment 310413
--> https://bugzilla.kernel.org/attachment.cgi?id=310413&action=edit
A full log of what happens when I follow the steps to reproduce on my systemSteps to reproduce:
1. Open a terminal.
2. Make sure that you have a copy of the man-pages repository on your system.
3. Change directory into the root of the repository by running this command:
cd <path to repository>
4. (Optional) Make sure that you’re using the same set of dependencies that I used when I tried building man-pages by doing the following:
A. Make sure that the Nix package manager is installed by running this
command:nix-env --version
If that command finishes successfully, then Nix is installed. If that command gives you an error, then you need to install Nix.
B. Activate a dev shell that contains all of the dependencies for
building man-pages by running this command:nix --extra-experimental-features 'nix-command flakes' develop
5. (Optional) Switch to a revision of man-pages that is known to have this problem by running this command:
git switch --detach a12be0058be628f50da69fb0efb2ed9b4422a6996. Attempt to build the “build-pdf-pages-troff” target by running this command:
make -R build-pdf-pages-troff
When I follow those steps to reproduce on my system, the build fails with these
errors:
Quoted 9 lines
Quoted 1 line
.tmp/man/man4/console_codes.4:420: warning: table row does not fit on page
5
Quoted 1 line
.tmp/man/man4/console_codes.4:778: warning: table row does not fit on page
9
Quoted 2 lines
make: ***
[
/home/jayman/Documents/Home/VC/space_afraid/Git/partially_mine/man-pages/Repo/share/mk/build/pdf/pages/troff.mk:30:Quoted 2 lines
.tmp/man/man4/console_codes.4.pdf.set] Error 1
make: *** Deleting file '.tmp/man/man4/console_codes.4.pdf.set'
Yup; I'm not an expert in these things. I've CCd BRanden, who knows more groff(7) than I, and maybe he could send patches to have a clean build.
Branden, would you mind having a look at make -R build-pdf and send patches to fix the diagnostics we get? It would also be nice to try build-ps and build-html.
Have a lovely day!
Alex
Signature · 4 lines
You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.
[Bug 221715] “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”
In reply to [email protected]https://bugzilla.kernel.org/show_bug.cgi?id=221715
G. Branden Robinson ([email protected]) changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected] | |m
--- Comment #2 from G. Branden Robinson ([email protected]) --- Hi Alex,
This seemed to do the trick for me.
man/man4/console_codes.4 +4 -0
@@ -413,6 +413,8 @@ .SS Linux console controls set background, same as 40..47 (bright not supported) T} .TE +.br +.ne 4v .P Commands 38 and 48 require further arguments: .P
@@ -762,6 +764,8 @@ .SS Comparisons with other terminals T} ESC ] 50 ; \f[I]fn\f[] ST Set font to \f[I]fn\f[]. .TE +.br +.ne 4v .P It recognizes the following with slightly modified meaning (saving more state, behaving closer to VT100/VT220):
Signature · 4 lines
You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.
[Bug 221715] “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”
In reply to [email protected]https://bugzilla.kernel.org/show_bug.cgi?id=221715
--- Comment #3 from Alejandro Colomar ([email protected]) --- Hi Branden,
Quoted 6 lines · On 2026-07-16T19:53:27+0000, [email protected] wrote:
https://bugzilla.kernel.org/show_bug.cgi?id=221715
G. Branden Robinson ([email protected]) changed:
What |Removed |Added
----------------------------------------------------------------------------
Quoted 7 lines
CC| |[email protected] | |m--- Comment #2 from G. Branden Robinson ([email protected]) --- Hi Alex,
This seemed to do the trick for me.
Would you mind sending a patch in the list? Especially, please document in the commit message what this is doing and why. :)
Is this the only page that needs to be tweaked?
Have a lovely night!
Alex
Quoted 29 lines
man/man4/console_codes.4 +4
-0@@ -413,6 +413,8 @@ .SS Linux console controls set background, same as 40..47 (bright not supported) T} .TE +.br +.ne 4v .P Commands 38 and 48 require further arguments: .P@@ -762,6 +764,8 @@ .SS Comparisons with other terminals T} ESC ] 50 ; \f[I]fn\f[] ST Set font to \f[I]fn\f[]. .TE +.br +.ne 4v .P It recognizes the following with slightly modified meaning (saving more state, behaving closer to VT100/VT220):Signature · 5 lines
-- You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.
Signature · 4 lines
You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.