x.rst
changeset 2228 837f1337c59b
parent 2064 7ffef142163e
child 2559 42551ca22ca3
--- a/x.rst	Sat Feb 10 01:28:53 2018 +0200
+++ b/x.rst	Sat Feb 10 01:30:24 2018 +0200
@@ -9,57 +9,55 @@
 Standard.
 =========
 
-See
-
-  http://www.tronche.com/gui/x/icccm/
+* http://www.tronche.com/gui/x/icccm/
 
 Widget toolkit.
 ===============
 
-  http://en.wikipedia.org/wiki/Widget_toolkit
-                Widget toolkit
-  http://en.wikipedia.org/wiki/List_of_widget_toolkits
-                List of widget toolkits
+http://en.wikipedia.org/wiki/Widget_toolkit
+  Widget toolkit
+http://en.wikipedia.org/wiki/List_of_widget_toolkits
+  List of widget toolkits
 
 GTK+.
 -----
 
-  http://en.wikipedia.org/wiki/GTK%2B
+http://en.wikipedia.org/wiki/GTK%2B
 
 QT.
 ---
 
-  http://en.wikipedia.org/wiki/Qt_%28toolkit%29
+http://en.wikipedia.org/wiki/Qt_%28toolkit%29
 
 WxWidgets.
 ----------
 
-  http://en.wikipedia.org/wiki/WxWidgets
+http://en.wikipedia.org/wiki/WxWidgets
 
 Tk.
 ---
 
-  http://en.wikipedia.org/wiki/Tk_%28computing%29
+http://en.wikipedia.org/wiki/Tk_%28computing%29
 
 FLTK.
 -----
 
-  http://en.wikipedia.org/wiki/FLTK
+http://en.wikipedia.org/wiki/FLTK
 
 Xaw.
 ----
 
-  http://en.wikipedia.org/wiki/Xaw
+http://en.wikipedia.org/wiki/Xaw
 
 GNUstep.
 --------
 
-  http://en.wikipedia.org/wiki/GNUstep
+http://en.wikipedia.org/wiki/GNUstep
 
 XView.
 ------
 
-  http://en.wikipedia.org/wiki/XView
+http://en.wikipedia.org/wiki/XView
 
 Getting info about X window and X-related applications data.
 ============================================================
@@ -80,28 +78,28 @@
 Keyboard's keys under X window.
 ===============================
 
-  scancodes
-                hardware-dependent codes generated by keystrokes and received by
-                the X server.
-  keycodes
-                Codes sent by the X server to the client indicating which key
-                was pressed. Keycodes by themselves do not indicate what the
-                keystroke means; the client must request that information from
-                the X server.
-  modifiers
-                Flags, such as ``shift`` and ``control``, that the server sends
-                with each keycode to the client. The client's interpretation of
-                the keycode may depend on the state of the modifiers. For
-                example, the state of the shift modifier determines whether an
-                alphabetic character should be lowercase or uppercase. Because
-                the X server encodes the states of the eight modifiers (shift,
-                lock, control, mod1, mod2, mod3, mod4, and mod5) in a single
-                byte of data, modifiers are often referred to as ``modifier
-                bits``.
-  keysyms
-                codes that specify the glyphs appearing on the keys. The X
-                server also maintains a list of strings that describe the
-                keysyms, such as ``a``, ``B``, and ``Control``.
+``scancodes``
+  hardware-dependent codes generated by keystrokes and received by
+  the X server.
+``keycodes``
+  Codes sent by the X server to the client indicating which key
+  was pressed. Keycodes by themselves do not indicate what the
+  keystroke means; the client must request that information from
+  the X server.
+``modifiers``
+  Flags, such as ``shift`` and ``control``, that the server sends
+  with each keycode to the client. The client's interpretation of
+  the keycode may depend on the state of the modifiers. For
+  example, the state of the shift modifier determines whether an
+  alphabetic character should be lowercase or uppercase. Because
+  the X server encodes the states of the eight modifiers (shift,
+  lock, control, mod1, mod2, mod3, mod4, and mod5) in a single
+  byte of data, modifiers are often referred to as ``modifier
+  bits``.
+``keysyms``
+  codes that specify the glyphs appearing on the keys. The X
+  server also maintains a list of strings that describe the
+  keysyms, such as ``a``, ``B``, and ``Control``.
 
 Find the keycode.
 =================
@@ -141,10 +139,10 @@
   $ xmodmap -e "keycode 34 = bracketleft braceleft"
   $ xmodmap -e "keysym CapsLock = Control_L"
 
-  https://wiki.ubuntu.com/LaptopTesting/Keycodes
-                Ubuntu Keycodes howto.
-  http://en.gentoo-wiki.com/wiki/Multimedia_Keys
-                Gentoo Multimedia Keys howto.
+https://wiki.ubuntu.com/LaptopTesting/Keycodes
+  Ubuntu Keycodes howto.
+http://en.gentoo-wiki.com/wiki/Multimedia_Keys
+  Gentoo Multimedia Keys howto.
 
 List input devices.
 ===================
@@ -201,23 +199,23 @@
 
 where:
 
-  client
-                The name of the application, some program allow change it by
-                '-name' option. This element is optional (can be substituated
-                with wildcard).
-  restriction
-                Class names or name of specific class instance. The classes
-                names conventionally start with an upper-case letter.
-  resource
-                The name of the resource whose value is to be changed.
-                Resources are typically lowercase with uppercase
-                concatenation.
-  value
-                The actual value of the resource.
-  delimiters
-                A period (.) is used to signify each step down into the
-                hierarchy. A colon (:) is used to separate the resource
-                declaration from the actual value.
+``client``
+  The name of the application, some program allow change it by
+  '-name' option. This element is optional (can be substituated
+  with wildcard).
+``restriction``
+  Class names or name of specific class instance. The classes
+  names conventionally start with an upper-case letter.
+``resource``
+  The name of the resource whose value is to be changed.
+  Resources are typically lowercase with uppercase
+  concatenation.
+``value``
+  The actual value of the resource.
+``delimiters``
+  A period (.) is used to signify each step down into the
+  hierarchy. A colon (:) is used to separate the resource
+  declaration from the actual value.
 
 Comment start with '!' char and goes up to end of line or C-like ``/* */``.
 
@@ -259,6 +257,7 @@
 
 Geometry value type.
 --------------------
+::
 
   XCalc*geometry: 120x120-0-0
   XClock*geometry: -50+100
@@ -267,7 +266,7 @@
 ------------------------
 
 Cursor resources require the name of the file in /usr/include/X11/bitmaps that
-contains the cursor you want to use.
+contains the cursor you want to use::
 
   ScoTerm*pointerShape: gumby
 
@@ -279,6 +278,7 @@
 
 Numebers value type.
 --------------------
+::
 
   XLogo*borderWidth: 10
 
@@ -297,99 +297,99 @@
 X utilities.
 ============
 
-  appres
-                List "application resources".
-  listres
-                List resources in widgets.
-  bitmap, atobm, bmtoa
-                Bitmap editor and converter utilities.
-  editres
-                Dynamic resource editor for X Toolkit applications.
-  iceauth
-                ICE authority file utility.
-  xauth
-                X authority file utility.
-  ico
-                Animate an icosahedron or other polyhedron.
-  luit
-                Locale and ISO 2022 support for Unicode terminals.
-  setxkbmap
-                Set the keyboard using the X Keyboard Extension.
-  x11perf
-                X11 server performance test program.
-  x11perfcomp
-                X11 server performance comparison program.
-  xcalc
-                scientific calculator desktop accessory that can emulate a TI-30
-                or an HP-10C.
-  xclock
-                Displays the time in analog or digital form.
-  xconsole
-                Monitor system console messages with X.
-  xdpyinfo
-                displaying information about an X server.
-  xev
-                "Event Tester" window.
-  xeyes
-                Showing two googly eyes which follow the cursor movements on the
-                screen as if they were watching it.
-  xfontsel
-                Point and click selection of X11 font names.
-  xgamma
-                Alter a monitor's gamma correction through the X server.
-  xhost
-                Server access control program for X.
-  xinit
-                X Window System initializer.
-  startx
-                Initialize an X session.
-  xkill
-                Kill a client by its X resource.
-  xload
-                System load average display for X.
-  xlogo
-                X Window System logo.
-  xlsclients
-                listing information about the client applications running on a display.
-  xmag
-                Magnify parts of the screen.
-  xman
-                Manual page display program for the X Window System.
-  xmessage
-                Display a message or query in a window.
-  xmodmap
-                Utility for modifying keymaps and pointer button mappings in X.
-  xmore
-                Plain text display program for the X Window System.
-  xprop
-                Property displayer for X.
-  xrandr
-                Primitive command line interface to RandR extension.
-  xrdb
-                X server resource database utility.
-  xrefresh
-                Refresh all or part of an X screen.
-  xset
-                User preference utility for X.
-  xsetmode
-                Set the mode for an X Input device.
-  xsetpointer
-                Set an X Input device as the main pointer.
-  xsetroot
-                Root window parameter setting utility for X.
-  xsm
-                X Session Manager
-  resize
-                Set environment and terminal settings to current xterm window size.
-  xterm
-                Standard terminal emulator for the X Window System.
-  xvinfo
-                Print out X-Video extension adaptor information.
-  xwd, xwud
-                Useful and easy way to take screenshots. Saves in the XWD X
-                Window Dump image data format.
-  xwininfo
-                Window information utility for X.
+``appres``
+  List "application resources".
+``listres``
+  List resources in widgets.
+``bitmap, atobm, bmtoa``
+  Bitmap editor and converter utilities.
+``editres``
+  Dynamic resource editor for X Toolkit applications.
+``iceauth``
+  ICE authority file utility.
+``xauth``
+  X authority file utility.
+``ico``
+  Animate an icosahedron or other polyhedron.
+``luit``
+  Locale and ISO 2022 support for Unicode terminals.
+``setxkbmap``
+  Set the keyboard using the X Keyboard Extension.
+``x11perf``
+  X11 server performance test program.
+``x11perfcomp``
+  X11 server performance comparison program.
+``xcalc``
+  scientific calculator desktop accessory that can emulate a TI-30
+  or an HP-10C.
+``xclock``
+  Displays the time in analog or digital form.
+``xconsole``
+  Monitor system console messages with X.
+``xdpyinfo``
+  displaying information about an X server.
+``xev``
+  "Event Tester" window.
+``xeyes``
+  Showing two googly eyes which follow the cursor movements on the
+  screen as if they were watching it.
+``xfontsel``
+  Point and click selection of X11 font names.
+``xgamma``
+  Alter a monitor's gamma correction through the X server.
+``xhost``
+  Server access control program for X.
+``xinit``
+  X Window System initializer.
+``startx``
+  Initialize an X session.
+``xkill``
+  Kill a client by its X resource.
+``xload``
+  System load average display for X.
+``xlogo``
+  X Window System logo.
+``xlsclients``
+  listing information about the client applications running on a display.
+``xmag``
+  Magnify parts of the screen.
+``xman``
+  Manual page display program for the X Window System.
+``xmessage``
+  Display a message or query in a window.
+``xmodmap``
+  Utility for modifying keymaps and pointer button mappings in X.
+``xmore``
+  Plain text display program for the X Window System.
+``xprop``
+  Property displayer for X.
+``xrandr``
+  Primitive command line interface to RandR extension.
+``xrdb``
+  X server resource database utility.
+``xrefresh``
+  Refresh all or part of an X screen.
+``xset``
+  User preference utility for X.
+``xsetmode``
+  Set the mode for an X Input device.
+``xsetpointer``
+  Set an X Input device as the main pointer.
+``xsetroot``
+  Root window parameter setting utility for X.
+``xsm``
+  X Session Manager
+``resize``
+  Set environment and terminal settings to current xterm window size.
+``xterm``
+  Standard terminal emulator for the X Window System.
+``xvinfo``
+  Print out X-Video extension adaptor information.
+``xwd, xwud``
+  Useful and easy way to take screenshots. Saves in the XWD X
+  Window Dump image data format.
+``xwininfo``
+  Window information utility for X.
 
 XText extension.
 ================
@@ -411,10 +411,10 @@
 
 See:
 
-  https://wiki.debian.org/Mesa
-                Mesa is an open source 3D computer graphics library that
-                provides a generic OpenGL implementation for rendering
-                three-dimensional graphics on multiple platforms.
+https://wiki.debian.org/Mesa
+  Mesa is an open source 3D computer graphics library that
+  provides a generic OpenGL implementation for rendering
+  three-dimensional graphics on multiple platforms.
 
 Running a secondary X server.
 =============================