firejail/src/man/firejail-login.txt
Kelvin M. Klann aacd2e7d8d docs: set vim filetype on man pages for syntax highlighting
Since the man pages in src/man use a ".txt" file extension (rather than
".1" or ".5"), their filetype is detected by (neo)vim as "text".

So at the bottom of every man page, add a vim modeline in a comment and
set the filetype to "groff", to enable syntax highlighting.

Note: All of the generated ".man", ".1" and ".5" files are currently
being detected as "nroff".

Note2: Set the filetype to "groff" rather than "nroff" because at least
.UR and .UE are groff extensions.  These macros look the same with
either filetype, but there may be more extensions being used and the
nroff.vim syntax file (which is included by groff.vim) does things
differently based on which filetype is used.

Based on the following example from (neo)vim's filetype.txt:

    or add this modeline to the file:
            /* vim: set filetype=idl : */

See `:help groff.vim` and `:help filetype.txt` in (neo)vim.

See also groff_man(7) for the man page macros (including extensions).

Environment: neovim 0.7.2-3 on Artix Linux.

Misc: I noticed this on #5290.
2022-08-05 17:18:21 -03:00

43 lines
1.4 KiB
Text

.TH FIREJAIL-LOGIN 5 "MONTH YEAR" "VERSION" "login.users man page"
.SH NAME
login.users \- Login file syntax for Firejail
.SH DESCRIPTION
/etc/firejail/login.users file describes additional arguments passed to the firejail executable
upon user logging into a Firejail restricted shell. Each user entry in the file consists of
a user name followed by the arguments passed to firejail. The format is as follows:
user_name: arguments
Example:
netblue: --net=none --protocol=unix
Wildcard patterns are accepted in the user name field:
user*: --private
.SH RESTRICTED SHELL
To configure a restricted shell, replace /bin/bash with /usr/bin/firejail in
the /etc/passwd file for each user that needs to be restricted. Alternatively,
you can specify /usr/bin/firejail using the `adduser` or `usermod` commands:
adduser \-\-shell /usr/bin/firejail username
.br
usermod \-\-shell /usr/bin/firejail username
.SH FILES
/etc/firejail/login.users
.SH LICENSE
Firejail is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
.PP
Homepage: https://firejail.wordpress.com
.SH SEE ALSO
.BR firejail (1),
.BR firemon (1),
.BR firecfg (1),
.BR firejail-profile (5),
.BR firejail-users (5),
.BR jailcheck (1)
.\" vim: set filetype=groff :