Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: manpage warnings: cannot adjust line #3563

Closed
reinerh opened this issue Aug 1, 2020 · 2 comments
Closed

docs: manpage warnings: cannot adjust line #3563

reinerh opened this issue Aug 1, 2020 · 2 comments
Labels
documentation Issues and pull requests related to the documentation
Milestone

Comments

@reinerh
Copy link
Collaborator

reinerh commented Aug 1, 2020

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.

@bbhtt
Copy link
Contributor

bbhtt commented 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

@rusty-snake rusty-snake added this to the 0.9.64 milestone Oct 1, 2020
netblue30 pushed a commit that referenced this issue Oct 19, 2020
@netblue30
Copy link
Owner

all fixed, I braked the lines with "\"

@kmk3 kmk3 added the documentation Issues and pull requests related to the documentation label Sep 5, 2024
@kmk3 kmk3 changed the title Manpage warnings docs: manpage warnings: cannot adjust line Sep 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Issues and pull requests related to the documentation
Projects
None yet
Development

No branches or pull requests

5 participants