more changes and improvements for READMEs

fontconfig/README.md

@@ -6,12 +6,14 @@ README fontconfig
 POST-INSTALL
 ============
 
-After upgrading fontconfig, always build font information cache files by the
+After upgrading `fontconfig`, always build font information cache files by the
 following command (or just enable post-install scripts):
 
-    fc-cache --force --system-only
+```sh
+fc-cache --force --system-only
+```
 
-Also, always run rejmerge and upgrade `/etc/fonts/fonts.conf` and
+Also, always run `rejmerge` and upgrade `/etc/fonts/fonts.conf` and
 `/etc/fonts/fonts.dtd`.
 
 `/etc/fonts/conf.avail` ships with configuration snippets that can be symlinked
@@ -21,7 +23,7 @@ snippets instead of duplicating XML code in your `/etc/fonts/local.conf`.
 For more information on `conf.avail/conf.d`, please see:
 https://gitlab.freedesktop.org/fontconfig/fontconfig/-/raw/main/conf.d/README.in
 
-For more information on fontconfig, please see:
+For more information on `fontconfig`, please see:
 https://www.freedesktop.org/software/fontconfig/fontconfig-user.html
 
 

harfbuzz/README.md

@@ -8,7 +8,9 @@ POST-INSTALL
 
 After `harfbuzz` is installed, rebuild and reinstall `freetype`:
 
-    sudo pkgman update -fr --deps --depsort freetype
+```sh
+sudo pkgman update -fr --deps --depsort freetype
+```
 
 
 ---

mesa/README.md

@@ -9,9 +9,11 @@ HARDWARE ACCELERATION
 Install `libva` package before building mesa to get hardware acceleration for
 the following drivers:
 
-    usr/lib/dri/nouveau_drv_video.so
-    usr/lib/dri/r600_drv_video.so
-    usr/lib/dri/radeonsi_drv_video.so
+```
+usr/lib/dri/nouveau_drv_video.so
+usr/lib/dri/r600_drv_video.so
+usr/lib/dri/radeonsi_drv_video.so
+```
 
 
 REFERENCES

slock/README.md

@@ -9,7 +9,9 @@ XAUTOLOCK
 `slock` can be started after a specific period of user inactivity using
 `xautolock`.  The command syntax is:
 
-    xautolock -time 10 -locker slock
+```sh
+xautolock -time 10 -locker slock
+```
 
 The alternatives to `xautolock` might be:
   1. https://git.suckless.org/xssstate/

transset/README.md

@@ -35,10 +35,12 @@ not be able to make windowses invisible.
 
 **~/.xbindkeysrc**:
 
-    "transset --min 0.1 -p --dec 0.2"
-    control + b:4
-    "transset -p --inc 0.1"
-    control + b:5
+```
+"transset --min 0.1 -p --dec 0.2"
+control + b:4
+"transset -p --inc 0.1"
+control + b:5
+```
 
 
 ---

xorg-server/README.md

@@ -14,7 +14,9 @@ If you do happen to forget and have sys-rq enabled in your kernel you can do a
 safe reboot with holding down Alt + SysRq, and typing the following sequence
 in order, pausing for several seconds between each key:
 
-    reisub
+```sh
+reisub
+```
 
 
 POST-INSTALL
@@ -26,12 +28,16 @@ packages:
 **NOTE:**
 This only applies on ABI changes between major versions e.g. 1.16.0 -> 1.17.0.
 
-    sudo pkgman update -fr \
-        $(pkgman list --regex --filter='^xorg-xf86-(input|video)|^mesa')
+```sh
+sudo pkgman update -fr \
+    $(pkgman list --regex --filter='^xorg-xf86-(input|video)|^mesa')
+```
 
 If you use nvidia you also need to do this:
 
-    sudo gl-select use xorg  &&  sudo gl-select use nvidia
+```sh
+sudo gl-select use xorg  &&  sudo gl-select use nvidia
+```
 
 
 ---

xorg-xbacklight/README.md

@@ -3,24 +3,30 @@ README xorg-xbacklight
 ---
 
 
-Troubleshooting: No outputs have backlight property
-===================================================
+TROUBLESHOOTING
+===============
 
-If you get **No outputs have backlight property** error, it is because
-xrandr/xbacklight does not choose the right directory in `/sys/class/backlight`.
-You can specify the directory by setting the **Backlight** option of the device
-section in `/etc/X11/xorg.conf.d/20-video.conf`.
+No outputs have backlight property
+----------------------------------
+
+If you get **''No outputs have backlight property''** error, it is because
+`xrandr`/`xbacklight` does not choose the right directory in
+`/sys/class/backlight`.  You can specify the directory by setting the
+**Backlight** option of the device section in
+`/etc/X11/xorg.conf.d/20-video.conf`.
 
 For instance, if the name of the directory is **intel_backlight** and using the
 Intel driver, the device section may be configured as follows:
 
 **/etc/X11/xorg.conf.d/20-video.conf:**
 
-    Section "Device"
-        Identifier  "Intel Graphics"
-        Driver      "intel"
-        Option      "Backlight"  "intel_backlight"
-    EndSection
+```xorg.conf
+Section "Device"
+    Identifier  "Intel Graphics"
+    Driver      "intel"
+    Option      "Backlight"  "intel_backlight"
+EndSection
+```
 
 
 ---