From e1a111e1b72ae3b1ec26591bd2c0cf24377e5d87 Mon Sep 17 00:00:00 2001 From: Pekka Paalanen Date: Thu, 14 Apr 2022 15:40:36 +0300 Subject: [PATCH] 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 --- man/weston.ini.man | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/man/weston.ini.man b/man/weston.ini.man index 096b5cfc..98396027 100644 --- a/man/weston.ini.man +++ b/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),