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>
This commit is contained in:
Pekka Paalanen 2022-04-14 15:40:36 +03:00 committed by Marius Vlad
parent 9203910b9a
commit e1a111e1b7

View File

@ -1,15 +1,18 @@
.\" shorthand for double quote that works everywhere. .\" shorthand for double quote that works everywhere.
.ds q \N'34' .ds q \N'34'
.TH weston.ini 5 "2019-03-26" "Weston @version@" .TH weston.ini 5 "2019-03-26" "Weston @version@"
.\"---------------------------------------------------------------------
.SH NAME .SH NAME
weston.ini \- configuration file for weston.ini \- configuration file for
.B Weston .B Weston
\- the reference Wayland \- the reference Wayland
compositor compositor
.\"---------------------------------------------------------------------
.SH INTRODUCTION .SH INTRODUCTION
.B Weston .B Weston
obtains configuration from its command line parameters and the configuration obtains configuration from its command line parameters and the configuration
file described here. file described here.
.\"---------------------------------------------------------------------
.SH DESCRIPTION .SH DESCRIPTION
.B Weston .B Weston
uses a configuration file called 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 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 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'. (e.g. 0x7b) form. Boolean values can be only 'true' or 'false'.
.\"---------------------------------------------------------------------
.SH "CORE SECTION" .SH "CORE SECTION"
The The
.B core .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 video modes. This extended functionality comes at the cost of heavier image
processing and sometimes a loss of some hardware off-loading features like processing and sometimes a loss of some hardware off-loading features like
composite-bypass. composite-bypass.
.\"---------------------------------------------------------------------
.SH "LIBINPUT SECTION" .SH "LIBINPUT SECTION"
The The
.B libinput .B libinput
@ -320,7 +324,7 @@ is the udev sys path for the device and
are the calibration matrix elements in libinput's are the calibration matrix elements in libinput's
.BR LIBINPUT_CALIBRATION_MATRIX " udev property format." .BR LIBINPUT_CALIBRATION_MATRIX " udev property format."
The sys path is an absolute path and starts with the sys mount point. The sys path is an absolute path and starts with the sys mount point.
.\"---------------------------------------------------------------------
.SH "SHELL SECTION" .SH "SHELL SECTION"
The The
.B shell .B shell
@ -432,6 +436,7 @@ sets the cursor theme (string).
.TP 7 .TP 7
.BI "cursor-size=" 24 .BI "cursor-size=" 24
sets the cursor size (unsigned integer). sets the cursor size (unsigned integer).
.\"---------------------------------------------------------------------
.SH "LAUNCHER SECTION" .SH "LAUNCHER SECTION"
There can be multiple launcher sections, one for each launcher. There can be multiple launcher sections, one for each launcher.
.TP 7 .TP 7
@ -451,6 +456,7 @@ example:
path=GDK_BACKEND=wayland gnome-terminal --full-screen path=GDK_BACKEND=wayland gnome-terminal --full-screen
.in .in
.fi .fi
.\"---------------------------------------------------------------------
.SH "OUTPUT SECTION" .SH "OUTPUT SECTION"
There can be multiple output sections, each corresponding to one output. It is There can be multiple output sections, each corresponding to one output. It is
currently only recognized by the drm and x11 backends. 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. 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 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. request. Currently, this option is supported by kiosk-shell.
.\"---------------------------------------------------------------------
.SH "INPUT-METHOD SECTION" .SH "INPUT-METHOD SECTION"
.TP 7 .TP 7
.BI "path=" "@weston_libexecdir@/weston-keyboard" .BI "path=" "@weston_libexecdir@/weston-keyboard"
@ -549,6 +556,7 @@ sets the path of the on screen keyboard input method (string).
.TP 7 .TP 7
.BI "overlay-keyboard=" false .BI "overlay-keyboard=" false
sets weston-keyboard as overlay panel. sets weston-keyboard as overlay panel.
.\"---------------------------------------------------------------------
.SH "KEYBOARD SECTION" .SH "KEYBOARD SECTION"
This section contains the following keys: This section contains the following keys:
.TP 7 .TP 7
@ -589,6 +597,7 @@ support it.
.BI "vt-switching=" "true" .BI "vt-switching=" "true"
Whether to allow the use of Ctrl+Alt+Fn key combinations to switch away from Whether to allow the use of Ctrl+Alt+Fn key combinations to switch away from
the compositor's virtual console. the compositor's virtual console.
.\"---------------------------------------------------------------------
.SH "TERMINAL SECTION" .SH "TERMINAL SECTION"
Contains settings for the weston terminal application (weston-terminal). It Contains settings for the weston terminal application (weston-terminal). It
allows to customize the font and shell of the command line interface. 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 .TP 7
.BI "term=" "xterm-256color" .BI "term=" "xterm-256color"
The terminal shell (string). Sets the $TERM variable. The terminal shell (string). Sets the $TERM variable.
.\"---------------------------------------------------------------------
.SH "XWAYLAND SECTION" .SH "XWAYLAND SECTION"
.TP 7 .TP 7
.BI "path=" "@xserver_path@" .BI "path=" "@xserver_path@"
sets the path to the xserver to run (string). sets the path to the xserver to run (string).
.\"---------------------------------------------------------------------
.SH "SCREEN-SHARE SECTION" .SH "SCREEN-SHARE SECTION"
.TP 7 .TP 7
.BI "command=" "@weston_bindir@/weston --backend=rdp-backend.so \ .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" .BI "start-on-startup=" "false"
If set to true, start screen sharing of all outputs available on Weston startup. If set to true, start screen sharing of all outputs available on Weston startup.
Set to false by default. Set to false by default.
.\"---------------------------------------------------------------------
.SH "AUTOLAUNCH SECTION" .SH "AUTOLAUNCH SECTION"
.TP 7 .TP 7
.BI "path=" "/usr/bin/echo" .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" .BI "watch=" "false"
If set to true, quit Weston after the auto-launched executable exits. Set to false If set to true, quit Weston after the auto-launched executable exits. Set to false
by default. by default.
.\"---------------------------------------------------------------------
.SH "SEE ALSO" .SH "SEE ALSO"
.BR weston (1), .BR weston (1),
.BR weston-bindings (7), .BR weston-bindings (7),