man: add section delimiters in weston.ini

These added lines are comments (do not affect output) that make it
easier to browse this file and find the section headings.

Removal of the preceding empty lines on two of the section headers
remove a blank line from PDF output. The blank line was kind of nice,
but presumably .SH should add any necessary blanks before a new section
heading. Now all the section headings have the same vertical space to
the preceding content in PDF.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
dev
Pekka Paalanen 2 years ago committed by Marius Vlad
parent 9203910b9a
commit e1a111e1b7
  1. 17
      man/weston.ini.man

@ -1,15 +1,18 @@
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH weston.ini 5 "2019-03-26" "Weston @version@"
.\"---------------------------------------------------------------------
.SH NAME
weston.ini \- configuration file for
.B Weston
\- the reference Wayland
compositor
.\"---------------------------------------------------------------------
.SH INTRODUCTION
.B Weston
obtains configuration from its command line parameters and the configuration
file described here.
.\"---------------------------------------------------------------------
.SH DESCRIPTION
.B Weston
uses a configuration file called
@ -87,6 +90,7 @@ integer, and boolean. Strings must not be quoted, do not support any
escape sequences, and run till the end of the line. Integers can
be given in decimal (e.g. 123), octal (e.g. 0173), and hexadecimal
(e.g. 0x7b) form. Boolean values can be only 'true' or 'false'.
.\"---------------------------------------------------------------------
.SH "CORE SECTION"
The
.B core
@ -200,7 +204,7 @@ spaces and perform monitor profiling, and tone mapping required to enable HDR
video modes. This extended functionality comes at the cost of heavier image
processing and sometimes a loss of some hardware off-loading features like
composite-bypass.
.\"---------------------------------------------------------------------
.SH "LIBINPUT SECTION"
The
.B libinput
@ -320,7 +324,7 @@ is the udev sys path for the device and
are the calibration matrix elements in libinput's
.BR LIBINPUT_CALIBRATION_MATRIX " udev property format."
The sys path is an absolute path and starts with the sys mount point.
.\"---------------------------------------------------------------------
.SH "SHELL SECTION"
The
.B shell
@ -432,6 +436,7 @@ sets the cursor theme (string).
.TP 7
.BI "cursor-size=" 24
sets the cursor size (unsigned integer).
.\"---------------------------------------------------------------------
.SH "LAUNCHER SECTION"
There can be multiple launcher sections, one for each launcher.
.TP 7
@ -451,6 +456,7 @@ example:
path=GDK_BACKEND=wayland gnome-terminal --full-screen
.in
.fi
.\"---------------------------------------------------------------------
.SH "OUTPUT SECTION"
There can be multiple output sections, each corresponding to one output. It is
currently only recognized by the drm and x11 backends.
@ -542,6 +548,7 @@ of content-protection protocol. Currently, HDCP is supported by drm-backend.
A comma separated list of the IDs of applications to place on this output.
These IDs should match the application IDs as set with the xdg_shell.set_app_id
request. Currently, this option is supported by kiosk-shell.
.\"---------------------------------------------------------------------
.SH "INPUT-METHOD SECTION"
.TP 7
.BI "path=" "@weston_libexecdir@/weston-keyboard"
@ -549,6 +556,7 @@ sets the path of the on screen keyboard input method (string).
.TP 7
.BI "overlay-keyboard=" false
sets weston-keyboard as overlay panel.
.\"---------------------------------------------------------------------
.SH "KEYBOARD SECTION"
This section contains the following keys:
.TP 7
@ -589,6 +597,7 @@ support it.
.BI "vt-switching=" "true"
Whether to allow the use of Ctrl+Alt+Fn key combinations to switch away from
the compositor's virtual console.
.\"---------------------------------------------------------------------
.SH "TERMINAL SECTION"
Contains settings for the weston terminal application (weston-terminal). It
allows to customize the font and shell of the command line interface.
@ -602,10 +611,12 @@ sets the size of the terminal font (unsigned integer).
.TP 7
.BI "term=" "xterm-256color"
The terminal shell (string). Sets the $TERM variable.
.\"---------------------------------------------------------------------
.SH "XWAYLAND SECTION"
.TP 7
.BI "path=" "@xserver_path@"
sets the path to the xserver to run (string).
.\"---------------------------------------------------------------------
.SH "SCREEN-SHARE SECTION"
.TP 7
.BI "command=" "@weston_bindir@/weston --backend=rdp-backend.so \
@ -615,6 +626,7 @@ sets the command to start a fullscreen-shell server for screen sharing (string).
.BI "start-on-startup=" "false"
If set to true, start screen sharing of all outputs available on Weston startup.
Set to false by default.
.\"---------------------------------------------------------------------
.SH "AUTOLAUNCH SECTION"
.TP 7
.BI "path=" "/usr/bin/echo"
@ -624,6 +636,7 @@ parallel to Weston, so it does not have to immediately exit. Defaults to empty.
.BI "watch=" "false"
If set to true, quit Weston after the auto-launched executable exits. Set to false
by default.
.\"---------------------------------------------------------------------
.SH "SEE ALSO"
.BR weston (1),
.BR weston-bindings (7),

Loading…
Cancel
Save