[Bug 221715] New: “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”

[Bug 221715] New: “make -R build-pdf-pages-troff” fails with “warning: table row does not fit”

[bugzilla-daemon]

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: documentation_man-pages@kernel-bugs.osdl.org
          Reporter: jason@jasonyundt.email
        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:

> .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'

-- 
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”

[bugzilla-daemon]

https://bugzilla.kernel.org/show_bug.cgi?id=221715

--- Comment #1 from Alejandro Colomar (alx@kernel.org) ---
Hi Jason,

On 2026-07-03T00:13:12+0000, bugzilla-daemon@kernel.org 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: documentation_man-pages@kernel-bugs.osdl.org
>           Reporter: jason@jasonyundt.email
>         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:
> 
> > .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'

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

-- 
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”

[bugzilla-daemon]

https://bugzilla.kernel.org/show_bug.cgi?id=221715

G. Branden Robinson (g.branden.robinson@gmail.com) changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |g.branden.robinson@gmail.co
                   |                            |m

--- Comment #2 from G. Branden Robinson (g.branden.robinson@gmail.com) ---
Hi Alex,

This seemed to do the trick for me.

diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 2fa8368e1..5c0508d4e 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -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):

-- 
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”

[bugzilla-daemon]

https://bugzilla.kernel.org/show_bug.cgi?id=221715

--- Comment #3 from Alejandro Colomar (alx@kernel.org) ---
Hi Branden,

On 2026-07-16T19:53:27+0000, bugzilla-daemon@kernel.org wrote:
> https://bugzilla.kernel.org/show_bug.cgi?id=221715
> 
> G. Branden Robinson (g.branden.robinson@gmail.com) changed:
> 
>            What    |Removed                     |Added
> ----------------------------------------------------------------------------
>                  CC|                            |g.branden.robinson@gmail.co
>                    |                            |m
> 
> --- Comment #2 from G. Branden Robinson (g.branden.robinson@gmail.com) ---
> 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

> 
> diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
> index 2fa8368e1..5c0508d4e 100644
> --- a/man/man4/console_codes.4
> +++ b/man/man4/console_codes.4
> @@ -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):
> 
> -- 
> You may reply to this email to add a comment.
> 
> You are receiving this mail because:
> You are watching the assignee of the bug.

-- 
You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.