URL:
  <https://savannah.gnu.org/bugs/?68344>

                 Summary: doc/screen.1: roff warnings under strict man/groff
checks
                   Group: GNU Screen
               Submitter: pdey
               Submitted: Tue 12 May 2026 06:44:17 PM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Unlocked
                 Release: 5.0.1
           Fixed Release: None
         Planned Release: None
           Work Required: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Tue 12 May 2026 06:44:17 PM UTC By: Peter Dey <pdey>
doc/screen.1 currently triggers roff warnings in strict manpage checks, and
some quoted literals in the rendered page are not displayed correctly (notably
the cat > /tmp/scrprint example in printcmd docs).

Example:
       printcmd [cmd]

       If cmd is not an empty string, screen will not use the terminal
capabilities po/pf if it detects an ansi print sequence ESC [ 5 i, but pipe
the output into cmd.  This should normally be a command like lpr or printcmd
without a command displays the cur-
       rent setting.  The ansi sequence ESC [ 4 i ends printing and closes the
pipe.

       Warning: Be careful with this command! If other user have write access
to your terminal, they will be able to fire off print commands.

After patch applied:
       printcmd [cmd]

       If cmd is not an empty string, screen will not use the terminal
capabilities "po/pf" if it detects an ansi print sequence ESC [ 5 i, but pipe
the output into cmd.  This should normally be a command like "lpr" or "'cat >
/tmp/scrprint'".  printcmd with-
       out a command displays the current setting.  The ansi sequence ESC [ 4
i ends printing and closes the pipe.

       Warning: Be careful with this command! If other user have write access
to your terminal, they will be able to fire off print commands.

Patch attached to fix:
- mark page for tbl preprocessing (.\" t)
- define quote strings used by the page (.ds Q \(dq, .ds U \(dq)
- modernise font escape (\f(CW instead of \fC)
- use literal ellipsis where needed (\&...)







    _______________________________________________________
File Attachments:

Name: fix-groff-manpage-warnings.patch Size: 1017B

<https://file.savannah.gnu.org/file/fix-groff-manpage-warnings.patch?file_id=58608>



    AGPL NOTICE

These attachments are served by Savane. You can download the corresponding
source code of Savane at
https://savannah.gnu.org/source/savane-c36938be85ff6c1b727bc7dd7fd30e48f9142870.tar.gz

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?68344>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/

Attachment: signature.asc
Description: PGP signature

Reply via email to