[GH-ISSUE #3563] docs: manpage warnings: cannot adjust line #2235

Closed
opened 2026-05-05 08:55:33 -06:00 by gitea-mirror · 2 comments
Owner

Originally created by @reinerh on GitHub (Aug 1, 2020).
Original GitHub issue: https://github.com/netblue30/firejail/issues/3563

While building a package of a current git snapshot, I noticed a linter warning for the manpage:

$ MANWIDTH=80 man --warnings -l src/man/firejail.txt >/dev/null
troff: <standard input>:389: warning [p 5, 10.7i]: cannot adjust line
troff: <standard input>:502: warning [p 7, 4.3i]: cannot adjust line

The lines are:

$ firejail --dbus-system=filter --dbus-system.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications

and

$ firejail --dbus-user=filter --dbus-user.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications

I'm not completely sure what the reason is, but I guess the last argument is a bit long for displaying and it doesn't know how to split it up.

Originally created by @reinerh on GitHub (Aug 1, 2020). Original GitHub issue: https://github.com/netblue30/firejail/issues/3563 While building a package of a current git snapshot, I noticed a linter warning for the manpage: ``` $ MANWIDTH=80 man --warnings -l src/man/firejail.txt >/dev/null troff: <standard input>:389: warning [p 5, 10.7i]: cannot adjust line troff: <standard input>:502: warning [p 7, 4.3i]: cannot adjust line ``` The lines are: ``` $ firejail --dbus-system=filter --dbus-system.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications ``` and ``` $ firejail --dbus-user=filter --dbus-user.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications ``` I'm not completely sure what the reason is, but I guess the last argument is a bit long for displaying and it doesn't know how to split it up.
gitea-mirror 2026-05-05 08:55:33 -06:00
Author
Owner

@bbhtt commented on GitHub (Aug 4, 2020):

You can enclose it in .in +/-.3i, ll -/+.5i to shift, I think:

       --dbus-user.broadcast=name=[member][@path]
              ...........................................................
              interfaces.  The path may have a /* suffix to indicate all objects  underneath  it,  in‐
              cluding itself.  Omitting the interface member or the object path will match all members
              and object paths, respectively.

              Example:
                 $  firejail  --dbus-user=filter  --dbus-user.broadcast=org.freedesktop.Notifica‐
                 tions=org.freedesktop.Notifications.*@/org/freedesktop/Notifications

or break it like:

              Example:
                 $  firejail  --dbus-user=filter  --dbus-
                     user.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications

Without:

              Example:
              $       firejail      --dbus-user=filter      --dbus-user.call=org.freedesktop.Notifica‐
              tions=org.freedesktop.Notifications.*@/org/freedesktop/Notifications
<!-- gh-comment-id:668633484 --> @bbhtt commented on GitHub (Aug 4, 2020): You can enclose it in `.in +/-.3i, ll -/+.5i` to shift, I think: ``` --dbus-user.broadcast=name=[member][@path] ........................................................... interfaces. The path may have a /* suffix to indicate all objects underneath it, in‐ cluding itself. Omitting the interface member or the object path will match all members and object paths, respectively. Example: $ firejail --dbus-user=filter --dbus-user.broadcast=org.freedesktop.Notifica‐ tions=org.freedesktop.Notifications.*@/org/freedesktop/Notifications ``` or break it like: ``` Example: $ firejail --dbus-user=filter --dbus- user.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications ``` Without: ``` Example: $ firejail --dbus-user=filter --dbus-user.call=org.freedesktop.Notifica‐ tions=org.freedesktop.Notifications.*@/org/freedesktop/Notifications ```
Author
Owner

@netblue30 commented on GitHub (Oct 19, 2020):

all fixed, I braked the lines with "\"

<!-- gh-comment-id:712126994 --> @netblue30 commented on GitHub (Oct 19, 2020): all fixed, I braked the lines with "\\"
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/firejail#2235
No description provided.