From 2a981a921c4a5e43b821533131dc78f64ccad772 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 14 Jul 2015 13:51:31 +0200 Subject: info: misc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/info/mds.texinfo | 1127 +++++++++++++++++++++++++++++++++----------------- 1 file changed, 758 insertions(+), 369 deletions(-) (limited to 'doc/info/mds.texinfo') diff --git a/doc/info/mds.texinfo b/doc/info/mds.texinfo index e45fa77..a16b4b0 100644 --- a/doc/info/mds.texinfo +++ b/doc/info/mds.texinfo @@ -1,67 +1,184 @@ \input texinfo @c -*-texinfo-*- +@copying +Copyright @copyright{} 2014, 2015 Mattias Andrée (@email{maandree@@member.fsf.org}) + +@quotation +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. A copy of the license is included in the section entitled +``GNU Free Documentation License''. +@end quotation +@end copying + @c %**start of header @setfilename mds.info -@settitle mds +@settitle mds -- The avant-garde micro-display server +@documentencoding UTF-8 +@documentlanguage en_GB +@finalout +@iftex +@c @set USLETTER @c @set AFIVEPAPER @c @set SMALLBOOK -@c This document does not look too good on A5-paper -@c This document looks best on A4-paper, but smallbook format is acceptable + +@c @set HARDCOPY +@c @set CROPMARKS +@c @set SKIPCHAPTERNEWPAGE +@c @set SKIPFONTTEXTSIZE +@end iftex +@c @set LOGO +@c @set DOUBLE_HEADINGS +@c @set SINGLE_HEADINGS +@c @set AMERICANSPACING + +@ignore + + This document does not look too good on A5-paper. + This document looks best on A4-paper, but smallbook + format and US Letter is acceptable. + + CROPMARKS has no effect unless HARDCOPY is set. + CROPMARKS and AFIVEPAPER (or actually @cropmarks + and @afivepaper) does not play well together. + + You can configure how TeX output files should look by + uncommenting @set commands above. Do not uncomment more + than one of the paper sizes (USLETTER, AFIVEPAPER and + SMALLBOOK); if none is uncomment AFOURPAPER will be set. + However, if you do not want to modify this source file, + you can run `make` with for example `TEXIFLAGS='-D HARDCOPY'` + or `TEXIFLAGS='--texinfo="@set HARDCOPY"'`. + +@end ignore + +@ifclear SINGLE_HEADINGS +@ifclear DOUBLE_HEADINGS +@ifclear HARDCOPY +@set SINGLE_HEADINGS +@end ifclear +@ifset HARDCOPY +@set DOUBLE_HEADINGS +@end ifset +@end ifclear +@end ifclear @ifset AFIVEPAPER @afivepaper @end ifset -@ifclear AFIVEPAPER @ifset SMALLBOOK @smallbook @end ifset +@ifclear AFIVEPAPER @ifclear SMALLBOOK +@ifclear USLETTER @afourpaper @set AFOURPAPER @end ifclear @end ifclear - -@documentencoding UTF-8 -@documentlanguage en - -@c @set HARDCOPY -@c @set LOGO +@end ifclear @ifset HARDCOPY +@ifset CROPMARKS @cropmarks +@end ifset +@ifclear SKIPCHAPTERNEWPAGE @setchapternewpage odd +@end ifclear @end ifset -@finalout -@c %**end of header +@ifclear SKIPFONTTEXTSIZE +@ifset SMALLBOOK +@set SMALLFONT +@end ifset +@ifset AFIVEPAPER +@set SMALLFONT +@end ifset +@end ifclear +@ifset SMALLFONT +@fonttextsize 10 +@end ifset +@ifclear SMALLFONT +@fonttextsize 11 +@end ifclear + +@ifclear AMERICANSPACING +@frenchspacing on +@end ifclear +@c @paragraphindent asis +@c @firstparagraphindent none +@c @exampleindent asis +@c @kbdinputstyle distinct @dircategory Graphics environment @direntry -* mds: (mds). The avant-garde micro-display server +* mds: (mds). The avant-garde micro-display server. @end direntry +@documentdescription +User and developer manual for mds, the avant-garde +micro-display server, and servers, protocols, +libraries and concepts. +@end documentdescription +@c %**end of header + + + +@ifset AFIVEPAPER +@set AFIVEPAPER_OR_USLETTER +@set SMALLBOOK_OR_AFIVEPAPER +@set AFOURPAPER_OR_AFIVEPAPER +@end ifset +@ifset USLETTER +@set AFIVEPAPER_OR_USLETTER +@set AFOURPAPER_OR_USLETTER +@end ifset +@ifset AFOURPAPER +@set AFOURPAPER_OR_USLETTER +@set AFOURPAPER_OR_AFIVEPAPER +@end ifset +@ifset SMALLBOOK +@set SMALLBOOK_OR_AFIVEPAPER +@end ifset + +@ifset SMALLFONT +@set AFOURPAPER_OR_USLETTER_OR_SMALLFONT +@ifset SMALLBOOK +@set SMALLBOOK_WITH_SMALLFONT +@set AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@set AFIVEPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@end ifset +@ifset AFIVEPAPER +@set AFIVEPAPER_WITH_SMALLFONT +@end ifset +@ifset AFOURPAPER +@set AFOURPAPER_WITH_SMALLFONT +@set AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT +@end ifset +@ifset USLETTER +@set USLETTER_WITH_SMALLFONT +@end ifset +@end ifset +@ifset AFOURPAPER_OR_USLETTER +@set AFOURPAPER_OR_USLETTER_OR_SMALLFONT +@set AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@end ifset +@ifset AFIVEPAPER_OR_USLETTER +@set AFIVEPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@set AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT +@end ifset + + @defindex op @defindex sg -@ifclear HARDCOPY -@copying -Copyright @copyright{} 2014, 2015 Mattias Andrée - -@quotation -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license is included in the section entitled -``GNU Free Documentation License''. -@end quotation -@end copying -@end ifclear @ifset HARDCOPY @include hardcopy-copying.texinfo @end ifset @@ -99,6 +216,14 @@ Texts. A copy of the license is included in the section entitled @insertcopying @end titlepage +@ifset DOUBLE_HEADINGS +@headings double +@end ifset +@ifset SINGLE_HEADINGS +@headings single +@end ifset + +@shortcontents @contents @@ -120,8 +245,10 @@ Texts. A copy of the license is included in the section entitled * Specifications:: Specifications. * New Concepts:: Discussion of new display server concepts. * Discussion:: Discussion on display server-architecture. + * GNU General Public License:: Copying and sharing @command{mds}. * GNU Free Documentation License:: Copying and sharing this manual. + * Program index:: Index of servers, clients and utilities. * Variable index:: Index of environment variables. * Option index:: Index of command line options. @@ -130,7 +257,7 @@ Texts. A copy of the license is included in the section entitled * Function index:: Index of functions. * Data type index:: Index of data types. @end menu -@c TODO @detailmenu +@c TODO @detailmenu (`C-c C-u m`) @@ -282,7 +409,7 @@ things: @itemize @item -Request assignment of a unique ID. +Request assignment of a unique ID@. @item Multicast a message. @@ -486,7 +613,7 @@ environment variable @env{DISPLAY} to @code{:}, where @code{} is empty if the display is one the local machine. In this tradition @command{mds} does the same thing -with the environment variable @env{MDS_DISPLAY}. +with the environment variable @env{MDS_DISPLAY}@. @cpindex Environment variables @vrindex @env{MDS_PGROUP} @@ -494,7 +621,7 @@ with the environment variable @env{MDS_DISPLAY}. @cpindex Process group, display server @command{mds} also creates a new process group and export the new process group ID to the environment -variable @command{MDS_PGROUP}. This process group +variable @command{MDS_PGROUP}@. This process group can be used to send signals to all @command{mds} servers collectively. @@ -533,7 +660,7 @@ If you need servers to free up allocated memory that they do not use, send the signal @code{SIGDANGER}, or if not defined @code{SIGRTMIN + 1}. Unimportant servers -may choose to die on @code{SIGDANGER}. +may choose to die on @code{SIGDANGER}@. @sgindex @code{SIGINFO} @sgindex @code{SIGRTMIN + 2} @@ -546,7 +673,7 @@ that server do support this signal, but thay must not die when received. @code{SIGINFO} is send by a user to the server, if she wants the server to dump information about the -server's state or statistics to the TTY. +server's state or statistics to the TTY@. @sgindex @code{SIGRTMIN} @cpindex No-operation signal @@ -643,9 +770,11 @@ is seldom a reason for servers to do this.} To do this the client sends @example +@group Command: assign-id\n Message ID: 0\n \n +@end group @end example where @code{\n} is an LF-line break. @@ -691,9 +820,11 @@ and the value that was in the For example: @example +@group ID assignment: 0:1\n In response to: 0\n \n +@end group @end example Notice that the master server never @@ -720,8 +851,10 @@ and contain ID of the client that closed. For example: @example +@group Client closed: 0:1\n \n +@end group @end example Be aware that if a server or client @@ -729,18 +862,20 @@ closes and does not have a unique client ID, this message will be: @example +@group Client closed: 0:0\n \n +@end group @end example Once a client has an unique client ID assigned to it, it should always include the header @code{Client ID} in its messages. The value of @code{Client ID} -should be the client's ID. If a server +should be the client's ID@. If a server wants to address this client, it should include the header @code{To} with the -value set to the recipient's client ID. +value set to the recipient's client ID@. Be aware that such message may not be sent to that recipient uniquely, any server or client is free to sign up @@ -780,9 +915,11 @@ the display server, simply sign up for all messages: @example +@group Command: intercept\n Message ID: 0\n \n +@end group @end example But if you only want messages contain @@ -1039,7 +1176,7 @@ integer would overflow. Native endianness when a endianness is choosen. Do not assume big endianness, but the same endianness that appear on the same machine when -using C. +using C@. @item @cpindex UTF-8, portability @@ -1117,9 +1254,11 @@ its own argument. For example: @opindex @option{--initial-spawn} @example +@group mds-respawn --interval=5 \ @{ mds-foo --initial-spawn @} \ @{ mds-bar --initial-spawn @} & +@end group @end example @cpindex Server supervision @@ -1137,7 +1276,7 @@ respawned. @sgindex @code{SIGTERM} A server is considered to exit with a failure status unless it exits with the return value 0 or is terminated -by the signal @code{SIGTERM}. +by the signal @code{SIGTERM}@. @@ -1280,7 +1419,7 @@ be used to select monitor. @opindex @option{--monitor} Take screenshot of the monitor whose root window's window ID is @var{WINDOW_ID} or has another window -in it whose window ID is @var{WINDOW_ID}. +in it whose window ID is @var{WINDOW_ID}@. @item --embed @opindex @option{--embed} @@ -1290,7 +1429,7 @@ The rat will be used to select window. @item --embed=WINDOW_ID @opindex @option{--monitor} Take a screenshot of an embedded window whose -window ID is @var{WINDOW_ID}. +window ID is @var{WINDOW_ID}@. @item --window @opindex @option{--window} @@ -1300,7 +1439,7 @@ The rat will be used to select window. @item --window=WINDOW_ID @opindex @option{--window} Take a screenshot of a window whose -window ID is @var{WINDOW_ID}. +window ID is @var{WINDOW_ID}@. @item --decoration @opindex @option{--decoration} @@ -1373,7 +1512,7 @@ The rat will be used to select window. @item --embed=WINDOW_ID @opindex @option{--embed} Kill an embedded window whose -window ID is @var{WINDOW_ID}. +window ID is @var{WINDOW_ID}@. @item --window @opindex @option{--window} @@ -1383,7 +1522,7 @@ The rat will be used to select window. @item --window=WINDOW_ID @opindex @option{--window} Kill a window whose -window ID is @var{WINDOW_ID}. +window ID is @var{WINDOW_ID}@. @item --signal=SIGNAL @opindex @option{--signal} @@ -1424,7 +1563,7 @@ recognises the following options: @table @option @item --switch=VT @opindex @option{--switch} -Switch to the virtual terminal with the index @var{VT}. +Switch to the virtual terminal with the index @var{VT}@. @end table @@ -1459,8 +1598,10 @@ can be initialised, you can in @file{$@{XDG_CONFIG_HOME@}/mdsinitrc} write: @example +@group mds-foo --on-init-fork mds-bar & +@end group @end example @opindex @option{--on-init-fork} @@ -1492,6 +1633,21 @@ mds-respawn @{ mds-bar @} & # Spawn `mds-bar`. @end example @end ifset @ifclear AFOURPAPER +@ifset USLETTER +@example +S=$(cmdipc -Scx set 1 | cut -d ' ' -f 2) +# Create a System V semaphore with the value 1. + +mds-respawn @{ mds-foo --on-init-sh="cmdipc -Sk $S p" @} & +# Spawn `mds-foo` and decrease the semaphore with 1 when initialised. + +cmdipc -Sk $S z # Wait for the semaphore's + # value to become 0. +cmdipc -Srk $S # Remove the semaphore. +mds-respawn @{ mds-bar @} & # Spawn `mds-bar`. +@end example +@end ifset +@ifclear USLETTER @example S=$(cmdipc -Scx set 1 | cut -d ' ' -f 2) # Create a System V semaphore with the value 1. @@ -1506,6 +1662,7 @@ cmdipc -Srk $S # Remove the semaphore. mds-respawn @{ mds-bar @} & # Spawn `mds-bar`. @end example @end ifclear +@end ifclear @pgindex @command{mds-reg} This is however seldom necessary as @command{mds-reg} can @@ -1657,7 +1814,7 @@ mode to graphical mode or text mode. By default @command{mds-vt} will select the next available virtual terminal for the display server. You can override this behaviour by exporting a value -to the environment variable @env{XDG_VTNR}. The value +to the environment variable @env{XDG_VTNR}@. The value must be a decimal integer of a valid virtual terminal index@footnote{Which is the same thing as a valid TTY index.}. To select the virtual terminal the display @@ -2303,7 +2460,7 @@ It creates a window that emulates a monitor. @command{mds-meta} is a metadisplay server. It creates or joins a named metadisplay server, and creates an alternative value for -@env{MDS_DISPLAY}. Any server connecting to +@env{MDS_DISPLAY}@. Any server connecting to this alternative @env{MDS_DISPLAY} connects to this metadisplay server. This can be used to make servers shared between display server @@ -2583,7 +2740,7 @@ simple, reference implementation of a, status icon tray. @section Infrastructure Protocols @menu -* assign-id:: Assign new ID to client, or fetch current ID. +* assign-id:: Assign new ID to client, or fetch current ID@. * intercept:: Sign up for reception of message. * register:: Register availability of a command for which you implement a service. * reregister:: Request for reregistration for available commands. @@ -2600,7 +2757,7 @@ simple, reference implementation of a, status icon tray. @code{Command: assign-id} @item Action: -Assign new ID to client, or fetch current ID. +Assign new ID to client, or fetch current ID@. @item Purpose: Assigning ID to clients so server can respond to that client. @@ -2833,7 +2990,7 @@ Allow programs to be aware of which VT the server is running on. @item Purpose: Allow programs to gain access of the TTY associated with the -VT such that they can use ioctl and similar calls on that TTY. +VT such that they can use ioctl and similar calls on that TTY@. @item Compulsivity: Required. @@ -2868,9 +3025,9 @@ Set the TTY text mode if the value of the header @code{Graphical} is @code{no}. @end table The server implementing this protocol should not set the -TTY to text mode temporarily when switching TTY. It is +TTY to text mode temporarily when switching TTY@. It is up to the server that set the request for graphical mode -to temporarily switch to text mode when switching TTY. +to temporarily switch to text mode when switching TTY@. @item Optional header: @code{Exclusive} @table @code @@ -2894,7 +3051,7 @@ Allow presentation servers to enter and leave graphical mode. @item Purpose: Allow programs to gain access of the TTY associated with the -VT such that they can use ioctl and similar calls on that TTY. +VT such that they can use ioctl and similar calls on that TTY@. @item Compulsivity: Required. @@ -2938,7 +3095,7 @@ let the message pass to the next server by telling the master server that it is no modification to do. Once all servers are read for the switch the server that emitted this message should signal the kernel -that it may switch VT. The server should detect +that it may switch VT@. The server should detect this by setting up secondary contection to the display that intercepts this message. This connection should intercept this message with priority @math{-2^{62}}, @@ -3027,36 +3184,36 @@ bit zeroed out. This may not be remapped. Single blank space separated list of active modifiers: @table @code @item shift -Shift (level 2) +@key{Shift} (level 2) @item ctrl -Control +@key{Control} @item alt -Alternative/Option +@key{Alternative}/@key{Option} @item altgr -Alternative Graphic (level 3) +@key{Alternative Graphic} (level 3) @item lvl* @code{*} may be any @math{2^n + 1} integer with @math{1 < n < 20}. @item super -Super +@key{Super} @item hyper -Hyper +@key{Hyper} @item ultra -Ultra +@key{Ultra} @item caps -Caps (usually a lock key) +@key{Caps} (usually a lock key) @item num -Num (usually a lock key) +@key{Num} (usually a lock key) @item scrl -Scroll (usually a lock key) +@key{Scroll} (usually a lock key) @item top -Top (historical) +@key{Top} (historical) @item front -Front (historical) +@key{Front} (historical) @item greek -Greek (historical) +@key{Greek} (historical) @item compose -Compose (rare, it is usually a dead key) +@key{Compose} (rare, it is usually a dead key) @end table Any key that has been locked should be prefix with @code{+}, if the key has been locked by nullified @@ -3069,93 +3226,93 @@ A textual representation of the key that has been typed or released, as mapped by the keyboard layout. @table @code @item esc -Escape +@key{Escape} @item f* -F@code{*} where @code{*} is any integer. +@key{F*} where @code{*} is any integer. @item sysrq -System Request/Print Screen +@key{System Request}/@key{Print Screen} @item scrl -Scroll (lock) +@key{Scroll} (lock) @item break -Break/Pause +@key{Break}/@key{Pause} @item backspace -Backspace +@key{Backspace} @item tab -Tab +@key{Tab} @item return -Return/Enter +@key{Return}/@key{Enter} @item space -Blank Space +@key{Blank Space} @item menu -Application Menu +@key{Application Menu} @item ins -Insert +@key{Insert} @item home -Home +@key{Home} @item pgup -Page Up +@key{Page Up} @item del -Delete +@key{Delete} @item end -End +@key{End} @item pgdown -Page Down +@key{Page Down} @item up -Up Arrow +@key{Up} arrow @item left -Left Arrow +@key{Left} arrow @item down -Down Arrow +@key{Down} arrow @item right -Right Arrow +@key{Right} arrow @item shift -Shift (level 2) +@key{Shift} (level 2) @item begin -Begin (keypad 5 in nagivation mode) +@key{Begin} (keypad @key{5} in nagivation mode) @item ctrl -Control +@key{Control} @item alt -Alternative/Option +@key{Alternative}/@key{Option} @item altgr -Alternative Graphic (level 3) +@key{Alternative Graphic} (level 3) @item lvl* @code{*} may be any @math{2^n + 1} integer with @math{1 < n < 20}. @item super -Super +@key{Super} @item hyper -Hyper +@key{Hyper} @item ultra -Ultra +@key{Ultra} @item caps -Caps (usually a lock key) +@key{Caps} (usually a lock key) @item num -Num (usually a lock key) +@key{Num} (usually a lock key) @item scrl -Scroll (usually a lock key) +@key{Scroll} (usually a lock key) @item top -Top (historical) +@key{Top} (historical) @item front -Front (historical) +@key{Front} (historical) @item greek -Greek (historical) +@key{Greek} (historical) @item compose -Compose (usually a dead key) +@key{Compose} (usually a dead key) @item hexcompose -Hex-Compose (usually a dead key) +@key{Hex-Compose} (usually a dead key) (Used to create aribitrary characters.) @item longhexcompose -Long Hex-Compose (usually a dead key) -(Variant of hexcompose for longer codepoints.) +@key{Long Hex-Compose} (usually a dead key) +(Variant of @code{hexcompose} for longer codepoints.) @item modelock -Mode Lock +@key{Mode Lock} @item letter * @code{*} may be any UTF-8 encoded letter. @end table Keys that lock/unlock a modifer should be suffixed with a blank space and a @code{lock}. If the key is a dead key -(even the compose key) should use @code{dead} instead. A -position, either @code{left}, @code{right}, @code{keypad} +(even the @key{Compose} key) should use @code{dead} instead. +A position, either @code{left}, @code{right}, @code{keypad} or an index, followed by a blank space, should prefix any key that occurs on multiple position on the keyboard, unless it only appears on the keypad once and once not on @@ -3279,13 +3436,13 @@ it is off, and turned off if it is on. The value is a single blank space separated list of LED:s: @table @code @item num -Num lock +@key{Num lock} @item caps -Caps lock +@key{Caps lock} @item scroll -Scroll lock +@key{Scroll lock} @item compose -Compose +@key{Compose} @end table Unsupported LED:s should be silently ignored. @@ -3531,13 +3688,15 @@ is included in the headers. Each line contains contains two single space delimited numbers, the first number is the keycode as determined by the scancode, the second number is keycode that scancode should generate. -For example, @code{1 1} resets Escape to be mapped to Escape, -and @code{1 59} remaps Escape to F1, while +For example, @code{1 1} resets @key{Escape} to be mapped to +@key{Escape}, and @code{1 59} remaps @key{Escape} to @key{F1}, while @example +@group 1 59 59 1 +@end group @end example -swaps Escape and F1. +swaps @key{Escape} and @key{F1}. @item Purpose: Enable the user to swap or replace keys on the keyboard. @@ -3995,49 +4154,61 @@ Alpha channel should be included but ignored if @code{Has alpha: no}, in such as it is best to set it to full. -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER Example image with @code{Bytes: 2}, @code{Has alpha: no} and @code{Size: 3}: @example +@group sRGB(x0102, 0, 0), sRGB(0, x0304, 0), sRGB(0, 0, x0506) sRGB(x0708, 0, 0), sRGB(0, x090A, 0), sRGB(0, 0, x0B0C) sRGB(x0D0E, 0, 0), sRGB(0, x0F10, 0), sRGB(0, 0, x1112) +@end group @end example Encoding of example image in hexadecimal representation: @example +@group FFFF 0102 0000 0000 FFFF 0000 0304 0000 FFFF 0000 0000 0506 FFFF 0708 0000 0000 FFFF 0000 090A 0000 FFFF 0000 0000 0B0C FFFF 0D0E 0000 0000 FFFF 0000 0F10 0000 FFFF 0000 0000 1112 +@end group @end example Note that on a big-endian system this would be: @footnote{x86_64 computers are big-endian.} @example +@group FF FF 02 01 0 0 0 0 FF FF 0 0 04 03 0 0 FF FF 0 0 0 0 06 05 FF FF 08 07 0 0 0 0 FF FF 0 0 0A 09 0 0 FF FF 0 0 0 0 0C 0B FF FF 0E 0D 0 0 0 0 FF FF 0 0 10 0F 0 0 FF FF 0 0 0 0 12 11 +@end group @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER Example image with @code{Bytes: 2}, @code{Has alpha: no} and @code{Size: 2}: @example +@group sRGB(x0102, 0, 0), sRGB(0, x0304, 0) sRGB(x0708, 0, 0), sRGB(0, x090A, 0) +@end group @end example Encoding of example image in hexadecimal representation: @example +@group FFFF 0102 0000 0000 FFFF 0000 0304 0000 FFFF 0708 0000 0000 FFFF 0000 090A 0000 +@end group @end example Note that on a big-endian system this would be: @footnote{x86_64 computers are big-endian.} @example +@group FF FF 02 01 0 0 0 0 FF FF 0 0 04 03 0 0 FF FF 08 07 0 0 0 0 FF FF 0 0 0A 09 0 0 +@end group @end example @end ifclear @@ -4235,16 +4406,20 @@ ramp is (17, 18, 19, 20, 21, 22, 23) and the blue ramp is (33, 34, 35, 36, 37, 38, 39, 40) then the message will be (hexadecimal representation): @example +@group 0001 0002 0003 0004 0005 0006 0011 0012 0013 0014 0015 0016 0017 0021 0022 0023 0024 0025 0026 0027 0028 +@end group @end example On a big-endian system this would be: @example +@group 01 00 02 00 03 00 04 00 05 00 06 00 11 00 12 00 13 00 14 00 15 00 16 00 17 00 21 00 22 00 23 00 24 00 25 00 26 00 27 00 28 00 +@end group @end example However if @code{Coalesce: no} was used in the query, @@ -4331,17 +4506,21 @@ is (1, 2, 3, 4, 5, 6), the green ramp is (17, 18, 19, 37, 38, 39, 40) then the message will be (hexadecimal representation): @example +@group 0001 0002 0003 0004 0005 0006 0011 0012 0013 0014 0015 0016 0017 0021 0022 0023 0024 0025 0026 0027 0028 +@end group @end example Note that on a big-endian system this would be: @footnote{x86_64 computers are big-endian.} @example +@group 01 00 02 00 03 00 04 00 05 00 06 00 11 00 12 00 13 00 14 00 15 00 16 00 17 00 21 00 22 00 23 00 24 00 25 00 26 00 27 00 28 00 +@end group @end example It is up to the networking servers to translate @@ -4664,7 +4843,7 @@ this is however dependent on the operating system. The server will respond with a @command{Command: error} message. In this message the server all include an -ad-hoc header: @code{Process ID}. Its value +ad-hoc header: @code{Process ID}@. Its value will be the ID of the process that owns the window. @@ -4887,8 +5066,10 @@ Decreases the pointer @code{buffer} by the size of @cpindex Marshalling macros @sgindex @code{SIGUPDATE} @example +@group buf_set(buffer, type, 0, variable), buf_next(buffer, type, 1); +@end group @end example @item @code{buf_get_next} [(@code{char* buffer, type, type variable}) @arrow{} @code{type}] @@ -4901,22 +5082,24 @@ buf_next(buffer, type, 1); @cpindex Marshalling macros @sgindex @code{SIGUPDATE} @example +@group buf_get(buffer, type, 0, variable), buf_next(buffer, type, 1); +@end group @end example @item @code{strequals} [(@code{const char* a, const char* b}) @arrow{} @code{int}] @fnindex @code{strequals} @cpindex String comparison Evaluates whether the strings @code{a} and @code{b} -are equals, neither may be @code{NULL}. +are equals, neither may be @code{NULL}@. @item @code{startswith} [(@code{const char* haystack, const char* needle}) @arrow{} @code{int}] @fnindex @code{startswith} @cpindex String comparison Evaluates whether the string @code{haystack} starts with the string @code{needle}, neither -may be @code{NULL}. +may be @code{NULL}@. @item @code{drop_privileges} [(void) @arrow{} @code{int}] @fnindex @code{drop_privileges} @@ -5240,7 +5423,7 @@ may not even refer to the program, and @code{chdir} could also hinter its use. @item -The kernel appends ` (deleted)' to +The kernel appends @samp{ (deleted)} to @file{/proc/self/exe} once it has been removed, so it cannot be replaced. @end enumerate @@ -5586,7 +5769,7 @@ a list, reads its variable @code{size_t size}. The variable @code{uint64_t* clients} is used to retrieve stored elements. -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT @example void print_elements(client_list_t* this) @{ @@ -5596,7 +5779,7 @@ void print_elements(client_list_t* this) @} @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT @example void print_elements(client_list_t* this) @{ @@ -5939,7 +6122,7 @@ be stored to the variable @code{entry} and the bucket index will be stored to the variable @code{i}. -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT @example void print_hash_table(hash_table_t* table) @{ @@ -5950,7 +6133,7 @@ void print_hash_table(hash_table_t* table) @} @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT @example void print_hash_table(hash_table_t* table) @{ @@ -5972,7 +6155,7 @@ is not a popinter. @vrindex @code{fd_table_t.value_comparator} The structures @code{hash_table_t} and @code{fd_table_t} contain the variable @code{value_comparator} which by -default is @code{NULL}. If this variable is set to @code{NULL}, +default is @code{NULL}@. If this variable is set to @code{NULL}, two values will be considered equal if and only if they are numerically identical; otherwise two values will be considered equal if and only if @code{value_comparator} returned a @@ -6217,7 +6400,7 @@ the server has been initialised. @item --on-init-sh=COMMAND @opindex @option{--on-init-sh} When the server has been initialised, run the -command @var{COMMAND}. +command @var{COMMAND}@. @item --immortal @opindex @option{--immortal} @@ -6364,7 +6547,7 @@ Calculate and returns the number of bytes that will be stored by @code{marshal_server}. On failure the server should call @code{abort} or exit with failure status by other means. However it should not be possible for this function to fail. -@code{marshal_server_size} must be pure.@footnote{That is, +@code{marshal_server_size} must be pure@footnote{That is, define with and conforming to @code{__attribute__((pure))}.}. @item @code{marshal_server} [(@code{char* state_buf}) @arrow{} @code{int}] @@ -6633,119 +6816,119 @@ for reference. @table @asis @item @code{1} -@kbd{Escape} key +@key{Escape} key @item @code{2}--@code{11} -Keys: @kbd{1}, @kbd{2}, @kbd{3}, @kbd{4}, @kbd{5}, @kbd{6}, @kbd{7}, @kbd{8}, @kbd{9}, @kbd{0} +Keys: @key{1}, @key{2}, @key{3}, @key{4}, @key{5}, @key{6}, @key{7}, @key{8}, @key{9}, @key{0} @item @code{12} -Key right of @kbd{0}. +Key right of @key{0}. @item @code{13} -Key left of @kbd{backspace} +Key left of @key{Backspace} @item @code{14} -@kbd{Backspace} key +@key{Backspace} key @item @code{15} -@kbd{Tab} key +@key{Tab} key @item @code{16}--@code{25} -Keys: @kbd{q}, @kbd{w}, @kbd{e}, @kbd{r}, @kbd{t}, @kbd{y}, @kbd{u}, @kbd{i}, @kbd{o}, @kbd{p} +Keys: @key{q}, @key{w}, @key{e}, @key{r}, @key{t}, @key{y}, @key{u}, @key{i}, @key{o}, @key{p} @item @code{26} -Key right of @kbd{p}, once removed +Key right of @key{p}, once removed @item @code{27} -Key right of @kbd{p}, twice removed +Key right of @key{p}, twice removed @item @code{28} -@kbd{Return} key +@key{Return} key @item @code{29} -Left @kbd{control} key +Left @key{Control} key @item @code{30}--@code{38} -Keys: @kbd{a}, @kbd{s}, @kbd{d}, @kbd{f}, @kbd{g}, @kbd{h}, @kbd{j}, @kbd{k}, @kbd{l} +Keys: @key{a}, @key{s}, @key{d}, @key{f}, @key{g}, @key{h}, @key{j}, @key{k}, @key{l} @item @code{39} -Key right of @kbd{l}, once removed +Key right of @key{l}, once removed @item @code{40} -Key right of @kbd{l}, twice removed +Key right of @key{l}, twice removed @item @code{41} -Key left of @kbd{1} +Key left of @key{1} @item @code{42} -Left @kbd{shift} key +Left @key{Shift} key @item @code{43} -Key right of @kbd{l}, three times removed +Key right of @key{l}, three times removed @item @code{44}--@code{50} -Keys: @kbd{z}, @kbd{x}, @kbd{c}, @kbd{v}, @kbd{b}, @kbd{n}, @kbd{m} +Keys: @key{z}, @key{x}, @key{c}, @key{v}, @key{b}, @key{n}, @key{m} @item @code{51} -Key right of @kbd{m}, once removed +Key right of @key{m}, once removed @item @code{52} -Key right of @kbd{m}, twice removed +Key right of @key{m}, twice removed @item @code{53} -Key right of @kbd{m}, three times removed +Key right of @key{m}, three times removed @item @code{54} -Right @kbd{shift} key +Right @key{Shift} key @item @code{55} -@kbd{Multiply} key on the keypad +@key{Multiply} key on the keypad @item @code{56} -@kbd{Alternative} key +@key{Alternative} key @item @code{57} -@kbd{Space} key +@key{Space} key @item @code{58} -@kbd{Caps lock} key +@key{Caps Lock} key @item @code{59}--@code{68} -Keys: @kbd{F1} through @kbd{F10} +Keys: @key{F1} through @key{F10} @item @code{69} -@kbd{Num lock} key +@key{Num Lock} key @item @code{70} -@kbd{Scroll lock} key +@key{Scroll Lock} key @item @code{71}--@code{73} -@kbd{7}, @kbd{8}, @kbd{9} keys on the keypad +@key{7}, @key{8}, @key{9} keys on the keypad @item @code{74} -@kbd{Minus} key on the keypad +@key{Minus} key on the keypad @item @code{75}--@code{77} -@kbd{4}, @kbd{5}, @kbd{6} keys on the keypad +@key{4}, @key{5}, @key{6} keys on the keypad @item @code{78} -@kbd{Plus} key on the keypad +@key{Plus} key on the keypad @item @code{79}--@code{82} -@kbd{1}, @kbd{2}, @kbd{3}, @kbd{0} keys on the keypad +@key{1}, @key{2}, @key{3}, @key{0} keys on the keypad @item @code{83} -@kbd{Comma} key on the keypad +@key{Comma} key on the keypad @item @code{86} -Key left of @kbd{z} +Key left of @key{z} @item @code{87} -@kbd{F11} key +@key{F11} key @item @code{88} -@kbd{F12} key +@key{F12} key @item @code{96} -@kbd{Return} key on the keypad +@key{Return} key on the keypad @item @code{97} -Right @kbd{control} key +Right @key{control} key @item @code{98} -@kbd{Divide} key on the keypad +@key{Divide} key on the keypad @item @code{99} -@kbd{System Request/Print Screen} key +@key{System Request}/@key{Print Screen} key @item @code{100} -@kbd{Alternative graphic} key +@key{Alternative Graphic} key @item @code{102} -@kbd{Home} key +@key{Home} key @item @code{103} -@kbd{Up} arrow key +@key{Up} arrow key @item @code{104} -@kbd{Page up} key +@key{Page up} key @item @code{105} -@kbd{Left} arrow key +@key{Left} arrow key @item @code{106} -@kbd{Right} arrow key +@key{Right} arrow key @item @code{107} -@kbd{End} key +@key{End} key @item @code{108} -@kbd{Down} arrow key +@key{Down} arrow key @item @code{109} -@kbd{Page down} down +@key{Page down} down @item @code{110} -@kbd{Insert} key +@key{Insert} key @item @code{111} -@kbd{Delete} key +@key{Delete} key @item @code{119} -@kbd{Pause/Break} key +@key{Pause}/@key{Break} key @item @code{125} -Left @kbd{super} key +Left @key{Super} key @item @code{126} -Right @kbd{super} key +Right @key{Super} key @item @code{127} -@kbd{Application menu} key +@key{Application Menu} key @end table @@ -6799,7 +6982,7 @@ other, does not matter. Additionally, the layout files are parsed line by line, and leading whitespace is ignored. Comment can be started with a #-character and end at the end of the line. It is important to know that modifiers -like @kbd{shift} and @kbd{control} needs to be mapped from +like @key{Shift} and @key{Control} needs to be mapped from a keycode, this and similar that many keyboards have in common, except dead key composition and compose sequences, is already available in the @file{layout/common} directory @@ -6844,27 +7027,33 @@ space when we are writting so we add giving us @example +@group : : " " +@end group @end example Because the order of the mapping statements does not matter we can just as well write @example +@group : " " : +@end group @end example @code{" "} represents a text string with one blank space, but it is possible to have multiple characters. -We want to extend this to @kbd{altgr+space} producing +If we want to extend this to @kbd{altgr+space} producing a no-break space, we can add either of the lines @example +@group : "\u00A0" # no-break space (# comment) : "\u00A0" # no-break space +@end group @end example However, we also need a mapping to @kbd{altgr}: @@ -6877,8 +7066,10 @@ If we want to add a mapping to @kbd{ultra} from @kbd{altgr+menu} we can write @example +@group : : <-altgr ultra> +@end group @end example @code{-altgr} means that @kbd{altgr} should @@ -6901,7 +7092,7 @@ are lock keys or not. To map the keycode But if you do not want it be a lock key, but instead be required to be held down, -similar to how is normal for @kbd{shift}, +similar to how is normal for @key{Shift}, instead write @example @@ -6911,14 +7102,14 @@ instead write Any modifier may be a lock key. Another, just as important, use of mappings -to is map letter keys. Unlike control keys -like space and shift, there are no predefined -letters@footnote{With letters with mean any -character other than space.}. Therefore the -letter is prefixed with the word `letter'. +to is map letter keys. Unlike @key{Control} keys +like @key{Space} and @key{Shift}, there are no +predefined letters@footnote{With letters with +mean any character other than space.}. Therefore +the letter is prefixed with the word `letter'. For example: -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER @example : # The Q-key has keycode 16 (on QWERTY) : "q" # The Q-key should produce a `q' @@ -6927,7 +7118,7 @@ For example: : "q" # but not when both are used @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER @example # The Q-key has keycode 16 (on QWERTY) : @@ -6962,15 +7153,17 @@ To define @kbd{´}, with keycode 13, @kbd{compose}, with keycode 125, as a dead keys write @example +@group : : +@end group @end example @cpindex Duplicate keys @cpindex Keys, duplicates Some may appear on multiple locations on the keyboard, -for example, there may be a left and a right shift key, -and a normal return key and one on the keypad: +for example, there may be a left and a right @key{Shift} +key, and a normal @key{Return} key and one on the keypad: @example : @@ -6985,9 +7178,9 @@ Because @code{} and @code{} are valid keys --- they are arrow keys --- it is importatn to place them directly before the key, and not after. For instance @code{} -denotes the left @kbd{shift} key, whilst -@code{} denotes the left-arrow key -with a @kbd{shift} key held down. Modifiers +denotes the left @key{Shift} key, whilst +@code{} denotes the @key{Left} arrow +key with a @key{Shift} key held down. Modifiers goes first. @@ -7024,8 +7217,8 @@ a sequence: : @end example -An alternative to @kbd{compose} as a dead key, -is @kbd{compose} as a modifier. If you use this, +An alternative to @key{Compose} as a dead key, +is @key{Compose} as a modifier. If you use this, the compose table need to be written for just that. There two ways do this this. Either you can write for example @@ -7035,7 +7228,7 @@ can write for example @end example This maps two `s':es to a `ß', but requires that -@kbd{compose} is held down during both key-presses. +@key{Compose} is held down during both key-presses. The other way is to write @example @@ -7050,8 +7243,10 @@ where it does not matter in which order you press some of the keys. For example, instead of @example +@group "S" "|" : "$" "|" "S" : "$" +@end group @end example you can write @@ -7070,8 +7265,10 @@ You can also use @code{[ ]} for alternation. For example, instead of @example +@group ("S" "|") : "$" ("s" "|") : "$" +@end group @end example you can write @@ -7085,8 +7282,10 @@ for specify that no key press is needed. For example, instead of @example +@group "|" "S" : "$" "|" "|" "S" : "$" +@end group @end example you can write @@ -7108,8 +7307,8 @@ subsequence inside unordered subsequence because of readability issues. Unordered subsequences longer than 5 elements -cannot compile under normal circumstances. This -is eliminiation of unordered subsequences grows +cannot compile under normal circumstances. +Eliminiation of unordered subsequences grows superexponentially, and thus is probably an error than can cause memory exhaustion and unrealistic compilation-time. Therefore, if an unordered @@ -7118,7 +7317,7 @@ compiler required that the @option{--force} flag is used and that the unordered subsequences uses double brackets: -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER @example ("1" "2" "3" "4" "5") : "120" (("1" "2" "3" "4" "5" "6")) : "720" @@ -7127,13 +7326,25 @@ double brackets: (("1" "2" "3" "4" "5" "6" "7" "8" "9")) : "362880" @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER +@ifset SMALLBOOK_WITH_SMALLFONT +@example + ("1" "2" "3" "4" "5") : "120" + (("1" "2" "3" "4" "5" "6")) : "720" + (("1" "2" "3" "4" "5" "6" "7")) : "5040" + (("1" "2" "3" "4" "5" "6" "7" "8")) : "40320" +@end example +@end ifset +@ifclear SMALLBOOK_WITH_SMALLFONT @example +@group ("1" "2" "3" "4" "5") : "120" (("1" "2" "3" "4" "5" "6")) : "720" (("1" "2" "3" "4" "5" "6" "7")) : "5040" +@end group @end example @end ifclear +@end ifclear @@ -7237,9 +7448,9 @@ is compile by itself. If this is done, the compiler can warn when one of the compositions cannot be reached from those basic keys. -If we want to make the compiler assume that @kbd{compose} -is available as a dead key, that @kbd{shift}, @kbd{altgr} -and @kbd{space} are available and that the ASCII letter, +If we want to make the compiler assume that @key{compose} +is available as a dead key, that @key{shift}, @key{altgr} +and @key{space} are available and that the ASCII letter, digits and some basic special characters are available we can write. @@ -7279,8 +7490,10 @@ For instance @file{layout/sv/qwerty} has two include statements to implement its basics: @example +@group include "../common/qwerty" include "../common/base" +@end group @end example @@ -7292,7 +7505,7 @@ include "../common/base" @cpindex Macros, keyboard layout There is a lot of repetitive work in layouts, for instance all letters need mapping for any combination of use of -@kbd{shift} and @kbd{compose}. To reduce this, you can +@key{shift} and @key{compose}. To reduce this, you can define macros. For example instead of writing @@ -7326,9 +7539,9 @@ letter("b" "B") # and so on ... @end example -The name of this macro is `letter/2', -but it is called with the name `letter' -and two arguments. The `/2'-suffix means +The name of this macro is @code{letter/2}, +but it is called with the name @code{letter} +and two arguments. The @code{/2}-suffix means that it is invoked with exactly two arguments. You can use this do define multiple version of the same macro, with the same invocation @@ -7355,45 +7568,48 @@ letter("ö" "Ö") @end example @code{\add( )} and @code{\sub( )} are calls to two -built-in functions named `add/2' and `sub/2'. +built-in functions named @code{add/2} and @code{sub/2}. @cpindex Alternation, keys @cpindex Key alternations Alternation can be used to invoke a macro: -@ifset AFOURPAPER +@ifset AFOURPAPER_OR_USLETTER_OR_SMALLFONT @example +@group letter(["a" "b" "c" "d" "e" "f" "g" "h" "i" "j" "k" "l" "m"]) letter(["n" "o" "p" "q" "r" "s" "t" "u" "v" "w" "x" "y" "z"]) +@end group @end example @end ifset -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER_OR_SMALLFONT @example +@group letter(["a" "b" "c" "d" "e" "f" "g" "h" "i" "j"]) letter(["k" "l" "m" "n" "o" "p" "q" "r" "s" "t"]) letter(["u" "v" "w" "x" "y" "z"]) +@end group @end example @end ifclear @cpindex Alternation, keys @cpindex Key alternations -You may use `.' in an alternation, in that case +You may use @code{.} in an alternation, in that case macro is called once with the argument, causing it -to invoke for example `letter/0' instead of -`letter/1'. +to invoke for example @code{letter/0} instead of +@code{letter/1}. -A related issue are for-loops. If we for -example want to call the macro `letter/1' for -all letters betweeh and including `a' and `z' +A related issue are for-loops. If we for example +want to call the macro @code{letter/1} for all +letters between and including `a' and `z' we can just write -@ifclear AFOURPAPER -@page -@end ifclear @example +@group for "a" to "z" as \1 letter(\1) end for +@end group @end example instead of using the alternation-trick. @@ -7451,7 +7667,6 @@ to or greater than 2 to the power of 31 not allowed and can either cause compile-time error or erroneous compiled files. - @cpindex Keyboard layout, macros @cpindex Macros, keyboard layout Functions are similar to function macros, @@ -7462,13 +7677,15 @@ to the last value it evaluted before it returned. For example instead of @code{\not(\greater(\1 "z"))} you can write @code{\less_eq(\1 "z")} after you -have defined the function `less_eq/2' with the +have defined the function @code{less_eq/2} with the following code: @example +@group function less_eq/2 \not(\greater(\1 \2)) end function +@end group @end example A final construct to make layout code less @@ -7518,16 +7735,20 @@ them, may span multiple lines. For example you may write @example +@group let \1 : @{ "å" "ä" "ö" "à" "é" "ü" @} +@end group @end example but not @example +@group let \1 : @{ "å" "ä" "ö" "à" "é" "ü" @} +@end group @end example See @ref{Builtin Functions} for how they are used. @@ -7572,13 +7793,13 @@ a @code{< >}. But `\' can also be used to specify characters by their code point, for example if you want an `æ' you can write @code{"\u00E6"} or @code{"\uE6"}, instead of @code{"æ"}. You can also write @code{"\0346"}, -the difference between `\0' and `\u' is that `\0' uses -octal whereas `\u' uses hexadecimal. A noteworthy -side-effect of this is that function names cannot start -with a lower case `u'. +the difference between @code{\0} and @code{\u} is that +@code{\0} uses octal whereas @code{\u} uses hexadecimal. +A noteworthy side-effect of this is that function names +cannot start with a lower case `u'. `\' can also be used to access variables and parameters. -For example `\1' in +For example @code{\1} in @example macro letter/2 @@ -7590,19 +7811,20 @@ end macro letter("å" "Å") @end example -is expanded to an `å', where as `\2' is expanded to an `Å'. +is expanded to an `å', where as @code{\2} is expanded +to an `Å'. `\' is also used to call functions, for example if -you want to call the function `f/0' you write +you want to call the function @code{f/0} you write @code{\f()}. Because numerical (possibly prefixed with an `u') are of variable length, it is possible to specify the escape's -termination point with a dot. For instance, if you -want the value of the first variable (\1) followed by -two zeroes, you do not write `\100' as that would expand -to the value of the hundredth variable. Instead you -write `\1.00'. +termination point with a dot. For instance, if you want +the value of the first variable (@code{\1}) followed by +two zeroes, you do not write @code{\100} as that would +expand to the value of the hundredth variable. Instead +you write @code{\1.00}. Use of function calls and variables inside @code{include}-statments invokes undefined behaviour. @@ -7624,74 +7846,73 @@ of basic functions: @table @code @item add/2 @fnindex @code{add/2} -The code points in \1 plus the code points of the -corresponding characters in \2. If \1 and \2 are -not of the same length, the returned string will -be of the length of the longer of the parameters, -and modulo is used to map to the corresponing -character. +The code points in @code{\1} plus the code points +of the corresponding characters in @code{\2}. If +@code{\1} and @code{\2} are not of the same length, +the returned string will be of the length of the +longer of the parameters, and modulo is used to map +to the corresponing character. @item sub/2 @fnindex @code{sub/2} -Like `add/2' but subtraction. +Like @code{add/2} but subtraction. @item mul/2 @fnindex @code{mul/2} -Like `add/2' but multiplication. +Like @code{add/2} but multiplication. @item div/2 @fnindex @code{div/2} -Like `add/2' but division. +Like @code{add/2} but division. @item mod/2 @fnindex @code{mod/2} -Like `add/2' but modulo. +Like @code{add/2} but modulo. @item rsh/2 @fnindex @code{rsh/2} -Like `add/2' but rightward bitwise shift. -If a character in \2 is has a code point -greater than 30, undefined behaviour is -invoked. +Like @code{add/2} but rightward bitwise shift. +If a character in @code{\2} is has a code point +greater than 30, undefined behaviour is invoked. @item lsh/2 @fnindex @code{lsh/2} -Like `add/2' but leftward bitwise shift. -If a character in \2 is has a code point -greater than 30, undefined behaviour is -invoked. +Like @code{add/2} but leftward bitwise shift. +If a character in @code{\2} is has a code point +greater than 30, undefined behaviour is invoked. @item or/2 @fnindex @code{or/2} -Like `add/2' but bitwise OR. +Like @code{add/2} but bitwise OR@. @item and/2 @fnindex @code{and/2} -Like `add/2' but bitwise AND. +Like @code{add/2} but bitwise AND@. @item xor/2 @fnindex @code{xor/2} -Like `add/2' but bitwise XOR. +Like @code{add/2} but bitwise XOR@. @item not/1 @fnindex @code{not/1} -For each character in \1, evaluate to -zero if the character is not zero, and +For each character in @code{\1}, evaluate +to zero if the character is not zero, and one if the character is zero. @item equals/2 @fnindex @code{equals/2} For each character, evalute to one if -the characters in \1 and \2 are equal -and zero otherwise. +the characters in @code{\1} and @code{\2} +are equal and zero otherwise. @item greater/2 @fnindex @code{greater/2} -Like `equals/2' but \1 greater than \2 -rather than \1 equals \2. +Like @code{equals/2} but @code{\1} greater +than @code{\2} rather than @code{\1} equals +@code{\2}. @item less/2 @fnindex @code{less/2} -Like `equals/2' but \1 less than \2 -rather than \1 equals \2. +Like @code{equals/2} but @code{\1} less than +@code{\2} rather than @code{\1} equals @code{\2}. @item set/3 @fnindex @code{set/3} -Set the element with index \2, in the -array with variable index \1, to \3, -and return \3. +Set the element with index @code{\2}, in +the array with variable index @code{\1}, to +@code{\3}, and return @code{\3}. For example @code{\set(1 0 4)} sets the -first element in \1 to 4. +first element in @code{\1} to 4. @item get/2 @fnindex @code{get/2} -Return the element with index \2 in the -array with variable index \1. +Return the element with index @code{\2} in +the array with variable index @code{\1}. For example after @code{\set(1 0 4)} or @code{let \1 : @{ 4 3 2 1 0 @}} has been used, @code{\get(1 0)} evaluates to 4. @@ -7726,10 +7947,10 @@ the compose key. @c * Ancient Greek Numbers:: Ancient Greek Numbers. @c * Ancient Symbols:: Ancient Symbols. @c * Arabic:: Arabic. -@c * Arabic Extended-A:: Arabic Extended-A. +@c * Arabic Extended-A:: Arabic Extended-A@. @c * Arabic Mathematical Alphabetic Symbols:: Arabic Mathematical Alphabetic Symbols. -@c * Arabic Presentation Forms-A:: Arabic Presentation Forms-A. -@c * Arabic Presentation Forms-B:: Arabic Presentation Forms-B. +@c * Arabic Presentation Forms-A:: Arabic Presentation Forms-A@. +@c * Arabic Presentation Forms-B:: Arabic Presentation Forms-B@. @c * Arabic Supplement:: Arabic Supplement. @c * Armenian:: Armenian. * Arrows:: Arrows. @@ -7765,10 +7986,10 @@ the compose key. @c * CJK Strokes:: CJK Strokes. @c * CJK Symbols and Punctuation:: CJK Symbols and Punctuation. @c * CJK Unified Ideographs:: CJK Unified Ideographs. -@c * CJK Unified Ideographs Extension A:: CJK Unified Ideographs Extension A. -@c * CJK Unified Ideographs Extension B:: CJK Unified Ideographs Extension B. -@c * CJK Unified Ideographs Extension C:: CJK Unified Ideographs Extension C. -@c * CJK Unified Ideographs Extension D:: CJK Unified Ideographs Extension D. +@c * CJK Unified Ideographs Extension A:: CJK Unified Ideographs Extension A@. +@c * CJK Unified Ideographs Extension B:: CJK Unified Ideographs Extension B@. +@c * CJK Unified Ideographs Extension C:: CJK Unified Ideographs Extension C@. +@c * CJK Unified Ideographs Extension D:: CJK Unified Ideographs Extension D@. @c * Combining Diacritical Marks:: Combining Diacritical Marks. @c * Combining Diacritical Marks Extended:: Combining Diacritical Marks Extended. @c * Combining Diacritical Marks for Symbols:: Combining Diacritical Marks for Symbols. @@ -7784,8 +8005,8 @@ the compose key. @c * Currency Symbols:: Currency Symbols. @c * Cypriot Syllabary:: Cypriot Syllabary. @c * Cyrillic:: Cyrillic. -@c * Cyrillic Extended-A:: Cyrillic Extended-A. -@c * Cyrillic Extended-B:: Cyrillic Extended-B. +@c * Cyrillic Extended-A:: Cyrillic Extended-A@. +@c * Cyrillic Extended-B:: Cyrillic Extended-B@. @c * Cyrillic Supplement:: Cyrillic Supplement. @c * Deseret:: Deseret. @c * Devanagari:: Devanagari. @@ -7802,7 +8023,7 @@ the compose key. @c * Enclosed CJK Letters and Months:: Enclosed CJK Letters and Months. @c * Ethiopic:: Ethiopic. @c * Ethiopic Extended:: Ethiopic Extended. -@c * Ethiopic Extended-A:: Ethiopic Extended-A. +@c * Ethiopic Extended-A:: Ethiopic Extended-A@. @c * Ethiopic Supplement:: Ethiopic Supplement. * General Punctuation:: General Punctuation. * Geometric Shapes:: Geometric Shapes. @@ -7819,8 +8040,8 @@ the compose key. @c * Halfwidth and Fullwidth Forms:: Halfwidth and Fullwidth Forms. @c * Hangul Compatibility Jamo:: Hangul Compatibility Jamo. @c * Hangul Jamo:: Hangul Jamo. -@c * Hangul Jamo Extended-A:: Hangul Jamo Extended-A. -@c * Hangul Jamo Extended-B:: Hangul Jamo Extended-B. +@c * Hangul Jamo Extended-A:: Hangul Jamo Extended-A@. +@c * Hangul Jamo Extended-B:: Hangul Jamo Extended-B@. @c * Hangul Syllables:: Hangul Syllables. @c * Hanunoo:: Hanunoo. @c * Hebrew:: Hebrew. @@ -7846,16 +8067,16 @@ the compose key. @c * Khudawadi:: Khudawadi. @c * Lao:: Lao. @c * Latin Extended Additional:: Latin Extended Additional. -* Latin Extended-A:: Latin Extended-A. -* Latin Extended-B:: Latin Extended-B. -* Latin Extended-C:: Latin Extended-C. -@c * Latin Extended-D:: Latin Extended-D. -@c * Latin Extended-E:: Latin Extended-E. +* Latin Extended-A:: Latin Extended-A@. +* Latin Extended-B:: Latin Extended-B@. +* Latin Extended-C:: Latin Extended-C@. +@c * Latin Extended-D:: Latin Extended-D@. +@c * Latin Extended-E:: Latin Extended-E@. * Latin-1 Supplement:: Latin-1 Supplement. @c * Lepcha:: Lepcha. @c * Letterlike Symbols:: Letterlike Symbols. @c * Limbu:: Limbu. -@c * Linear A:: Linear A. +@c * Linear A:: Linear A@. @c * Linear B Ideograms:: Linear B Ideograms. @c * Linear B Syllabary:: Linear B Syllabary. @c * Lisu:: Lisu. @@ -7874,8 +8095,8 @@ the compose key. @c * Meroitic Cursive:: Meroitic Cursive. @c * Meroitic Hieroglyphs:: Meroitic Hieroglyphs. @c * Miao:: Miao. -* Miscellaneous Mathematical Symbols-A:: Miscellaneous Mathematical Symbols-A. -* Miscellaneous Mathematical Symbols-B:: Miscellaneous Mathematical Symbols-B. +* Miscellaneous Mathematical Symbols-A:: Miscellaneous Mathematical Symbols-A@. +* Miscellaneous Mathematical Symbols-B:: Miscellaneous Mathematical Symbols-B@. @c * Miscellaneous Symbols:: Miscellaneous Symbols. * Miscellaneous Symbols and Arrows:: Miscellaneous Symbols and Arrows. @c * Miscellaneous Symbols and Pictographs:: Miscellaneous Symbols and Pictographs. @@ -7886,8 +8107,8 @@ the compose key. @c * Mro:: Mro. @c * Musical Symbols:: Musical Symbols. @c * Myanmar:: Myanmar. -@c * Myanmar Extended-A:: Myanmar Extended-A. -@c * Myanmar Extended-B:: Myanmar Extended-B. +@c * Myanmar Extended-A:: Myanmar Extended-A@. +@c * Myanmar Extended-B:: Myanmar Extended-B@. @c * Nabataean:: Nabataean. @c * New Tai Lue:: New Tai Lue. @c * NKo:: NKo. @@ -7932,9 +8153,9 @@ the compose key. @c * Sundanese:: Sundanese. @c * Sundanese Supplement:: Sundanese Supplement. * Superscripts and Subscripts:: Superscripts and Subscripts. -* Supplemental Arrows-A:: Supplemental Arrows-A. -* Supplemental Arrows-B:: Supplemental Arrows-B. -* Supplemental Arrows-C:: Supplemental Arrows-C. +* Supplemental Arrows-A:: Supplemental Arrows-A@. +* Supplemental Arrows-B:: Supplemental Arrows-B@. +* Supplemental Arrows-C:: Supplemental Arrows-C@. * Supplemental Mathematical Operators:: Supplemental Mathematical Operators. @c * Syloti Nagri:: Syloti Nagri. @c * Syriac:: Syriac. @@ -7994,11 +8215,11 @@ the compose key. @subsection Box Drawing Most of the box drawing glyphs can be composed by -typing @kbd{} followed by two -glyphs that should be combined to form the desired -glyphs. If the two glyphs are identical the glyph -becomes heavy. More general, common parts of the -glyphs become heavy. +typing @kbd{} followed by two glyphs +that should be combined to form the desired glyphs. +If the two glyphs are identical the glyph becomes +heavy. More general, common parts of the glyphs +become heavy. Glyphs that contain a heavy part be transformed so that the heavy parts become double stroked. @@ -8698,7 +8919,7 @@ the cursor should transition from @code{X} to @code{X-hold}. @code{X-hold} is the version of @code{X} that should be used if any rat button is held down. @code{X} is an animation from @code{X-release} to @code{X} and is used when the cursor should -transition from @code{X-release} to @code{X}. Clients should +transition from @code{X-release} to @code{X}@. Clients should not set the cursor to either of them, it is up to the server to do this based on events from the rat device. @@ -8721,6 +8942,7 @@ This cursor is usually a north-west or north-north-west pointing arrow. For left-handed themes this cursor is usually a north-east or north-north-east pointing arrow. @example +@group ## #### ###### @@ -8737,6 +8959,7 @@ usually a north-east or north-north-east pointing arrow. ###### #### #### +@end group @end example @page @@ -8749,6 +8972,7 @@ context menu. This cursor is typically @command{default} combined with a small menu. @example +@group ## ############ #### ############ ###### ## ## @@ -8765,8 +8989,9 @@ small menu. ###### #### #### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifset AFIVEPAPER @page @@ -8777,6 +9002,7 @@ an horizontal text that can be selected and possibly edited. This cursor is usually a vertical I-beam. @example +@group ############## ## ## @@ -8793,10 +9019,13 @@ This cursor is usually a vertical I-beam. ## ## ############## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear AFOURPAPER_WITH_SMALLFONT @page +@end ifclear @item vertical-text This cursor should be used when the rat pointers is above an vertical text that can be selected and possibly edited. @@ -8806,6 +9035,7 @@ the first fallback. This cursor is usually a horizontal I-beam. @example +@group ## ## ## ## ## ## @@ -8813,9 +9043,13 @@ This cursor is usually a horizontal I-beam. ## ## ## ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item progress This cursor indicates that the interface can be used as when @command{default} is used. @@ -8825,6 +9059,7 @@ with command the user previously issued. This cursor is usually rendered as a combination of @command{default} and @command{wait}. @example +@group ## ############ #### ############ ###### ######## @@ -8841,10 +9076,13 @@ of @command{default} and @command{wait}. ###### #### #### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear AFOURPAPER_WITH_SMALLFONT @page +@end ifclear @item wait This cursor indicates that the interface cannot be used because it is working or is blocked by @@ -8854,6 +9092,7 @@ This cursor is typically rendered as a hourglass, watch, sundial or some sort of animated ring. @example +@group #################### #################### ################ @@ -8870,10 +9109,11 @@ of animated ring. ################ #################### #################### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifset @item pointer @@ -8886,6 +9126,7 @@ apparent by design that the object is clickable. This cursor is usually a right hand (left hand if left-handed) pointing with the index-finger. @example +@group #### #### #### @@ -8902,10 +9143,13 @@ left-handed) pointing with the index-finger. ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear AFOURPAPER_WITH_SMALLFONT @page +@end ifclear @item help This cursor indicates that the interface is in context help mode. This is usually activated by @@ -8915,6 +9159,7 @@ question mark on it --- on the titlebar. This cursor is typically renderas as @code{default} with a question mark next to it. @example +@group ## ###### #### ########## ###### #### #### @@ -8931,8 +9176,9 @@ with a question mark next to it. ###### #### #### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @item drag This cursor indicates that an object is @@ -8941,6 +9187,7 @@ being dragged. This cursor is usually a closed right hand, or closed left hand if left-handed. @example +@group #### #### #### ################ #### ############################ @@ -8951,8 +9198,9 @@ or closed left hand if left-handed. ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @page @item copy @@ -8965,6 +9213,7 @@ be used as the first fallback. This cursor is usually rendered as @code{drag} with a plus-sign next to it. @example +@group ## ## ########## @@ -8981,8 +9230,9 @@ This cursor is usually rendered as ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifset AFIVEPAPER @page @@ -9000,6 +9250,7 @@ This cursor is usually rendered as The arrow is usually point north east, or north west if left-handed. @example +@group ###### #### ## ## @@ -9016,8 +9267,9 @@ or north west if left-handed. ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @page @item alias @@ -9032,6 +9284,7 @@ This cursor is usually rendered as @code{drag} with an two or three linked links next to it, or an arced arrow. @example +@group #### #### ## ## ## ######## ## @@ -9048,12 +9301,17 @@ links next to it, or an arced arrow. ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear AFOURPAPER +@ifclear SMALLBOOK_WITH_SMALLFONT +@ifclear USLETTER_WITH_SMALLFONT @page @end ifclear +@end ifclear +@end ifclear @item no-drop This cursor indicates that the dragged object cannot be release where the rat pointer is @@ -9068,6 +9326,7 @@ should be used as the first fallback, and This cursor is typically rendered as a combination of @code{drag} and @code{not-allowed}. @example +@group ######## ## #### ## ## ## @@ -9084,8 +9343,9 @@ combination of @code{drag} and @code{not-allowed}. ######################## #################### ################ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @page @item not-allowed @@ -9096,6 +9356,7 @@ operation. This cursor is often rendered as a circle with a diagonal line through it. @example +@group ######## #### #### ## ## @@ -9112,8 +9373,9 @@ a diagonal line through it. ## ## #### #### ######## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifset AFIVEPAPER @page @@ -9126,6 +9388,7 @@ below the cursor This cursor is often rendered as a combined vertical and horizontal twin-headed arrow. @example +@group ## ###### ########## @@ -9141,10 +9404,11 @@ vertical and horizontal twin-headed arrow. ########## ###### ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifclear AFIVEPAPER +@ifclear AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifclear @item up-arrow @@ -9153,6 +9417,7 @@ insertion point. It is often rendered an upwards pointing arrow. @example +@group ## ###### ########## @@ -9164,15 +9429,20 @@ It is often rendered an upwards pointing arrow. ###### ###### ###### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item cell This cursor is often used in spread-sheet applications -when selecting cells +when selecting cells. It is typically rendered as a thick plus-sign. @example +@group ###### ###### ###### @@ -9186,10 +9456,13 @@ It is typically rendered as a thick plus-sign. ###### ###### ###### +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear AFOURPAPER_WITH_SMALLFONT @page +@end ifclear @item col-resize This cursor is used to indicate the the cursor is within a region that allows it rat to be used to resize a column. @@ -9203,6 +9476,7 @@ with an arrow from the left side pointing horizontally towards it and an arrow from the right side pointing horizontally towards it. @example +@group ## ## ## @@ -9218,12 +9492,18 @@ horizontally towards it. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear AFOURPAPER +@ifclear USLETTER_WITH_SMALLFONT @page @end ifclear +@end ifclear +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item row-resize This cursor is used to indicate the the cursor is within a region that allows it rat to be used to resize a column. @@ -9237,6 +9517,7 @@ with an arrow from the left side pointing vertically towards it and an arrow from the right side pointing vertically towards it. @example +@group ## ## ## @@ -9252,16 +9533,27 @@ vertically towards it. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear USLETTER +@ifclear SMALLBOOK_WITH_SMALLFONT +@ifclear AFOURPAPER_WITH_SMALLFONT +@page +@end ifclear +@end ifclear +@end ifclear +@ifset USLETTER_WITH_SMALLFONT @page +@end ifset @item crosshair This cursor is used for precision drawing or precision manipulation of an area. This cursor typically a thin crosshair. @example +@group ## ## ## @@ -9277,8 +9569,9 @@ This cursor typically a thin crosshair. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @item w-resize If this cursor is missing, @code{w-select} @@ -9293,6 +9586,7 @@ This cursor is typically rendered as a west pointing arrow, optionally with a wall at the arrow head. @example +@group ## ## ## ## ## ## @@ -9300,9 +9594,13 @@ wall at the arrow head. ## ## ## ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item w-select If this cursor is missing, @code{w-resize} should be used as the first fallback, @@ -9315,6 +9613,7 @@ the fourth fallback. This cursor is typically rendered as a west pointing arrow. @example +@group ## ## ## @@ -9322,12 +9621,18 @@ west pointing arrow. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifclear AFIVEPAPER +@ifclear AFIVEPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear +@ifset USLETTER_WITH_SMALLFONT +@page +@end ifset @item e-resize If this cursor is missing, @code{e-select} should be used as the first fallback, @@ -9341,6 +9646,7 @@ This cursor is typically rendered as a east pointing arrow, optionally with a wall at the arrow head. @example +@group ## ## ## ## ## ## @@ -9348,11 +9654,14 @@ wall at the arrow head. ## ## ## ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT +@ifclear USLETTER_WITH_SMALLFONT @page +@end ifclear @end ifset @item e-select If this cursor is missing, @code{e-resize} @@ -9366,6 +9675,7 @@ the fourth fallback. This cursor is typically rendered as a east pointing arrow. @example +@group ## ## ## @@ -9373,10 +9683,16 @@ east pointing arrow. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifset SMALLBOOK +@ifclear SMALLFONT +@page +@end ifclear +@end ifset +@ifset AFOURPAPER_WITH_SMALLFONT @page @end ifset @item n-resize @@ -9392,6 +9708,7 @@ This cursor is typically rendered as a north pointing arrow, optionally with a wall at the arrow head. @example +@group ############## ## @@ -9408,12 +9725,18 @@ wall at the arrow head. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear +@ifset SMALLBOOK_WITH_SMALLFONT +@page +@end ifset @item n-select If this cursor is missing, @code{n-resize} should be used as the first fallback, @@ -9426,6 +9749,7 @@ the fourth fallback. This cursor is typically rendered as a north pointing arrow. @example +@group ## ###### ## ## ## @@ -9440,12 +9764,16 @@ north pointing arrow. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifclear AFOURPAPER +@ifclear AFOURPAPER_OR_USLETTER_OR_SMALLBOOK_WITH_SMALLFONT @page @end ifclear +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item s-resize If this cursor is missing, @code{s-select} should be used as the first fallback, @@ -9459,6 +9787,7 @@ This cursor is typically rendered as a south pointing arrow, optionally with a wall at the arrow head. @example +@group ## ## ## @@ -9475,12 +9804,15 @@ wall at the arrow head. ## ############## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear @item s-select If this cursor is missing, @code{s-resize} should be used as the first fallback, @@ -9493,6 +9825,7 @@ the fourth fallback. This cursor is typically rendered as a south pointing arrow. @example +@group ## ## ## @@ -9507,10 +9840,11 @@ south pointing arrow. ## ## ## ###### ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifset @item nw-resize @@ -9526,6 +9860,7 @@ This cursor is typically rendered as a north-west pointing arrow, optionally with a corner at the arrow head. @example +@group ################## ## ## @@ -9542,12 +9877,15 @@ with a corner at the arrow head. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear @item nw-select If this cursor is missing, @code{nw-resize} should be used as the first fallback, @@ -9560,6 +9898,7 @@ the fourth fallback. This cursor is typically rendered as a north-west pointing arrow. @example +@group ############ #### ## ## @@ -9573,10 +9912,11 @@ north-west pointing arrow. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifset @item se-resize @@ -9592,6 +9932,7 @@ This cursor is typically rendered as a south-east pointing arrow, optionally with a corner at the arrow head. @example +@group ## ## ## @@ -9608,12 +9949,15 @@ with a corner at the arrow head. ## ## ################## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear @item se-select If this cursor is missing, @code{se-resize} should be used as the first fallback, @@ -9626,6 +9970,7 @@ the fourth fallback. This cursor is typically rendered as a south-east pointing arrow. @example +@group ## ## ## @@ -9639,10 +9984,11 @@ south-east pointing arrow. ## ## #### ############ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifset @item ne-resize @@ -9658,6 +10004,7 @@ This cursor is typically rendered as a north-east pointing arrow, optionally with a corner at the arrow head. @example +@group ################## ## ## @@ -9674,12 +10021,15 @@ with a corner at the arrow head. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear @item ne-select If this cursor is missing, @code{ne-resize} should be used as the first fallback, @@ -9692,6 +10042,7 @@ the fourth fallback. This cursor is typically rendered as a north-east pointing arrow. @example +@group ############ #### ## ## @@ -9705,10 +10056,11 @@ north-east pointing arrow. ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifset AFIVEPAPER +@ifset AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifset @item sw-resize @@ -9724,6 +10076,7 @@ This cursor is typically rendered as a south-west pointing arrow, optionally with a corner at the arrow head. @example +@group ## ## ## @@ -9740,12 +10093,15 @@ with a corner at the arrow head. ## ## ################## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifclear SMALLBOOK +@ifclear AFOURPAPER_WITH_SMALLFONT @page @end ifclear +@end ifclear @item sw-select If this cursor is missing, @code{sw-resize} should be used as the first fallback, @@ -9758,6 +10114,7 @@ the fourth fallback. This cursor is typically rendered as a south-west pointing arrow. @example +@group ## ## ## @@ -9771,8 +10128,9 @@ south-west pointing arrow. ## ## #### ############ +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @item ew-resize If this cursor is missing, @code{ew-select} @@ -9784,6 +10142,7 @@ This cursor is typically rendered as a east and west pointing twin-arrow, optionally with a wall at the arrow heads. @example +@group ## ## ## ## ## ## ## ## ## ## ## ## @@ -9791,9 +10150,15 @@ optionally with a wall at the arrow heads. ## ## ## ## ## ## ## ## ## ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifset SMALLFONT +@ifset AFOURPAPER_OR_AFIVEPAPER +@page +@end ifset +@end ifset @item ew-select If this cursor is missing, @code{ew-resize} should be used as the first fallback, and @@ -9803,6 +10168,7 @@ second fallback. This cursor is typically rendered as a east and west pointing twin-arrow. @example +@group ## ## ## ## ## ## @@ -9810,10 +10176,11 @@ east and west pointing twin-arrow. ## ## ## ## ## ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll -@ifclear AFIVEPAPER +@ifclear AFIVEPAPER_OR_AFOURPAPER_WITH_SMALLFONT @page @end ifclear @item ns-resize @@ -9826,6 +10193,7 @@ This cursor is typically rendered as a north and south pointing twin-arrow, optionally with a wall at the arrow heads. @example +@group ############## ## @@ -9842,8 +10210,9 @@ optionally with a wall at the arrow heads. ## ############## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @item ns-select If this cursor is missing, @code{ns-resize} @@ -9854,6 +10223,7 @@ second fallback. This cursor is typically rendered as a north and south pointing twin-arrow. @example +@group ## ###### ## ## ## @@ -9866,10 +10236,21 @@ north and south pointing twin-arrow. ## ## ## ###### ## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll +@ifclear SMALLFONT +@ifclear AFIVEPAPER @page +@end ifclear +@end ifclear +@ifset USLETTER_WITH_SMALLFONT +@page +@end ifset +@ifset AFOURPAPER_WITH_SMALLFONT +@page +@end ifset @item nwse-resize If this cursor is missing, @code{all-resize} should be used as the first fallback. @@ -9878,6 +10259,7 @@ This cursor is typically rendered as a north-west and south-east pointing twin-arrow, optionally with a corner at the arrow heads. @example +@group ################## ## ## @@ -9894,8 +10276,9 @@ optionally with a corner at the arrow heads. ## ## ################## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @ifset AFIVEPAPER @page @@ -9908,6 +10291,7 @@ This cursor is typically rendered as a north-east and south-west pointing twin-arrow, optionally with a corner at the arrow heads. @example +@group ################## ## ## @@ -9924,8 +10308,9 @@ optionally with a corner at the arrow heads. ## ## ################## +@end group @end example -@vskip 0pt plus 2filll +@vskip 0pt plus 1filll @page @item all-resize @@ -9935,6 +10320,7 @@ twin-arrow and a north-west and south-east pointing twin-arrow, optionally with a corner at the arrow heads. @example +@group ########## ########## #### #### ## ## ## ## @@ -9950,6 +10336,7 @@ at the arrow heads. ## ## ## ## #### #### ########## ########## +@end group @end example @end table @@ -9971,7 +10358,7 @@ the windows ID of the socket that the application should be embedded in. All @command{mds} applications must be aware -of the environment variable @env{MDS_EMBED}. +of the environment variable @env{MDS_EMBED}@. The application may choose not to embed itself in the announced socket, however it should have good reason for not doing this. @@ -10012,7 +10399,7 @@ if and only if @env{PREFERRED_DISPLAY} lists any other display protocol. If a compatibility server is successfully started, -it shoul be listed in @env{PREFERRED_DISPLAY}. +it shoul be listed in @env{PREFERRED_DISPLAY}@. Be sure to keep the list ordered by preference. @table @code @@ -10077,7 +10464,7 @@ to run them across any number of computers. @pgindex @code{@command{mds-host}} @pgindex @command{mds-remote} -@pgindex Networking +@cpindex Networking If a hosting server, like @command{mds-host}, runs inside a metadisplay, any number of computers can connect to the metadisplay using a server like @@ -10695,7 +11082,7 @@ Development of @command{mds} started out of concern that Wayland would not meet our needs, and the knowledge that X does not. We are now however aware that Wayland meets our needs even -less than X.@footnote{Not even counting that +less than X@.@footnote{Not even counting that the documentation for Wayland is way more lacking that X's documentation.} @@ -11027,31 +11414,31 @@ backgrund. @include fdl.texinfo @node Program index -@appendix Program index +@unnumbered Program index @printindex pg @node Variable index -@appendix Variable index +@unnumbered Variable index @printindex vr @node Option index -@appendix Option index +@unnumbered Option index @printindex op @node Concept index -@appendix Concept index +@unnumbered Concept index @printindex cp @node Signal index -@appendix Signal index +@unnumbered Signal index @printindex sg @node Function index -@appendix Function index +@unnumbered Function index @printindex fn @node Data type index -@appendix Data type index +@unnumbered Data type index @printindex tp @bye @@ -11096,7 +11483,7 @@ TODO protocol: workspace TODO protocol: ping TODO notifications (balloons, bubbles) -TODO virtual resultion (the screen is larger than the output) +TODO virtual resolution (the screen is larger than the output) TODO taskbar features: progress bars (any number) with colours @@ -11111,3 +11498,5 @@ TODO application menu features: different ways to start an program, for example, browers may include a safe-browsing mode. +In `Rat Cursors` use anchors and references to hyperlink names. + -- cgit v1.2.3-70-g09d2