De-duplicate setup notes

4 files changed, 195 insertions, 199 deletions

diff --git a/guides/setups/devices/dell-3190.org b/guides/setups/devices/dell-3190.org
deleted file mode 100644
index ca82630..0000000
--- a/guides/setups/devices/dell-3190.org
+++ /dev/null
@@ -1,61 +0,0 @@
-* Preparing for installation
-Using instructions from <https://wiki.debian.org/Firmware>.
-** Get netinst image from <https://www.debian.org/CD/netinst/>
-** Get firmware archive from <https://cdimage.debian.org/cdimage/unofficial/non-free/firmware/stable/current/>
-So that the installer can use the wireless network card.  Extract all
-.deb files to a top-level =firmware= folder on a USB key.
-** Shrink the MS partition
-Had to "optimize the disk", otherwise some free space remained
-unavailable.
-* Debian installer
-Everything went smoothly:
-
-- if the USB key holding the firmware isn't plugged in, the
-  installer requests it, otherwise it finds the firmware automatically;
-- Secure Boot supported transparently;
-- dual-booting too.
-* OS configuration
-** System
-- CapsLock as Control
-- sources.list (https repositories, security.debian.org →
-  deb.debian.org, backports) (non-free repositories were automatically
-  added during installation, because of the WiFi firmware I imagine)
-- copy .profile to .xsessionrc to have ~/.local/bin in $PATH
-** Applications
-- install a bunch of stuff:
-
-#+begin_src sh
-packages=(
-    # To clone & update dotfiles.
-    git
-    # Look & feel.
-    elementary-xfce-icon-theme greybird-gtk-theme
-    # Enable volume management with Thunar.
-    gvfs-backends gvfs-fuse
-    # Enable touchpad configuration with XFCE.
-    xserver-xorg-input-synaptics
-    # System monitoring.
-    htop powertop wavemon
-    # Documentation:
-    # - info pages,
-    gcc-doc make-doc tar-doc info
-    # - manpages,
-    manpages-dev manpages-posix manpages-posix-dev
-    # - text & HTML pages.
-    git-doc python3-doc
-    # Writing helpers.
-    aspell-fr verbiste wordnet
-    # CLI helpers.
-    mlocate ripgrep vim
-    # Miscellaneous applications.
-    ffmpeg gimp vlc
-    # Optional Emacs 27 build dependencies.
-    libjansson-dev libwebkit2gtk-4.0-dev
-)
-#+end_src
-
-- Install latest Firefox, restore profile
-- Install latest Symbola
-- Clone dotfiles (create SSH key for Gitlab)
-- Install Emacs build-deps, clone, compile & install Emacs
-** TODO XFCE
diff --git a/guides/setups/devices/samsung-nc10.org b/guides/setups/devices/samsung-nc10.org
deleted file mode 100644
index 2f8fc10..0000000
--- a/guides/setups/devices/samsung-nc10.org
+++ /dev/null
@@ -1,38 +0,0 @@
-* Debian Buster installation
-Installer does not recognize the touchpad, for some reason.
-* First boot
-#+BEGIN_QUOTE
-A start job is running for Load AppArmor profiles
-#+END_QUOTE
-Disappeared after ≈30s 🤷
-
-Wooh touchpad works!  Although the sensitivity is a bit low.
-
-Wifi LED is on, whatever that means.
-
-Brightness function keys do not work on the login screen.
-
-Using default XFCE config to get four workspaces.
-
-Brightness and sound function keys work! 🙌
-
-Touchpad click and scroll do not work.
-
-Wifi function key does not work.
-
-Battery life seems somewhat shorter than with Bunsenlabs, even after
-applying all powertop tricks in the book.
-* Someday
-** fix Ethernet after suspend
-Workaround:
-#+BEGIN_SRC sh
-$ sudo modprobe -r sky2 && sudo modprobe -i sky2
-#+END_SRC
-
-References:
-- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1841304
-- https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=895378
-- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1798921
-- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1809843
-- https://askubuntu.com/questions/1029620/ubuntu-18-04-lts-sky2-ethernet-stops-working-after-system-resume-from-suspend
-- https://bbs.archlinux.org/viewtopic.php?id=234725
diff --git a/guides/setups/operating-systems/debian.org b/guides/setups/operating-systems/debian.org
index a3142f0..8d111fb 100644
--- a/guides/setups/operating-systems/debian.org
+++ b/guides/setups/operating-systems/debian.org
@@ -1,12 +1,134 @@
-* Getting comfortable
-** Make CapsLock another Control
-Cf. keyboard(5):
-
-- add =ctrl:nocaps= in =/etc/default/keyboard=
+* Step-by-step recap
+** Setup keyboard
+Turn CapsLock key into Control (cf. keyboard(5)):
+- add =ctrl:nocaps= to =XKBOPTIONS= in =/etc/default/keyboard=
 - run =udevadm trigger --subsystem-match=input --action=change=
 - run =setupcon= in a TTY
+** Setup package repositories
+- use HTTPS rather than HTTP
+- add bacpkports
+- add non-free repositories
+- change security.debian.org to deb.debian.org
+** Install stuff
+*** Distro-provided packages
+#+begin_src sh
+packages=(
+    # To clone & update dotfiles.
+    git
+    # Look & feel.
+    elementary-xfce-icon-theme greybird-gtk-theme
+    # Enable volume management with Thunar.
+    gvfs-backends gvfs-fuse
+    # Enable touchpad configuration with XFCE.
+    xserver-xorg-input-synaptics
+    # System monitoring.
+    htop powertop wavemon
+    # Documentation:
+    # - info pages,
+    gcc-doc make-doc tar-doc info
+    # - manpages,
+    manpages-dev manpages-posix manpages-posix-dev
+    # - text & HTML pages.
+    git-doc python3-doc
+    # Writing helpers.
+    aspell-fr verbiste wordnet
+    # CLI helpers.
+    mlocate ripgrep vim
+    # Fonts.
+    fonts-noto-color-emoji
+    # Miscellaneous applications.
+    ffmpeg gimp vlc
+)
+sudo apt install ${packages[@]}
+#+end_src
+*** Latest Firefox
+- download most recent release from from <https://www.mozilla.org>
+- unpack it =$SOMEWHERE=
+- make sure everyone can find it:
+
+#+BEGIN_SRC sh
+$ sudo update-alternatives --install $(which x-www-browser) x-www-browser \
+                           ${SOMEWHERE}/firefox/firefox 1
+$ sudo update-alternatives --set x-www-browser ${SOMEWHERE}/firefox/firefox
+$ ln -s ${SOMEWHERE}/firefox/firefox ~/.local/bin/
+#+END_SRC
+
+- paste backuped profile into =~/.mozilla/firefox/${profile}=
+*** Latest Symbola
+- grab the archive from <http://users.teilar.gr/~g1951d/>
+- drop the TTF files in =~/.local/share/fonts=
+- run =fc-cache -fv=
+** Setup dotfiles
+*** Clone versioned dotfiles
+- create new SSH key for GitLab
+- follow instructions in dotfiles README
+*** Tweak non-versioned dotfiles
+- set EMAIL in .profile
+- add =~/.local/bin= to PATH
+- copy .profile to .xsessionrc
+- in .bashrc
+  - enable globstar and autocd
+  - uncomment grep and ls aliases
+  - source =~/.bash_prompt=
+** Setup Emacs
+- clone from Savannah
+- =apt build-dep emacs=
+- =apt install libjansson-dev libwebkit2gtk-4.0-dev=
+  (optional build dependencies for ≥27)
+- comment out .emacs below =(load custom-file)=
+#+begin_src elisp
+(package-refresh-contents)
+(package-install-selected-packages)
+#+end_src
+** TODO Setup XFCE
+** Setup more stuff
+*** lightdm
+Show my account on startup:
+#+BEGIN_SRC conf
+# /usr/share/lightdm/lightdm.conf.d/99_custom.conf
+[Seat:*]
+greeter-hide-users=false
+#+END_SRC
+*** system groups
+#+begin_src sh
+groups=(
+    adm         # Access /var/log journals.
+    dialout     # Sync my phone.
+)
+for g in ${groups[@]}
+do
+    sudo adduser ${USER} ${g}
+done
+#+end_src
+* Live reactions
+** Samsung NC10
+*** installer
+Touchpad is not recognized, for some reason.
+*** first boot
+#+BEGIN_QUOTE
+A start job is running for Load AppArmor profiles
+#+END_QUOTE
+Disappeared after ≈30s 🤷
 
-** apt install (1/n)
+Wooh touchpad works!  Although the sensitivity is a bit low.
+*NB: solved below.*
+
+Wifi LED is on, whatever that means.
+
+Brightness function keys do not work on the login screen.
+
+Using default XFCE config to get four workspaces.
+
+Brightness and sound function keys work! 🙌
+
+Touchpad click and scroll do not work.
+*NB: solved below.*
+
+Wifi function key does not work.
+
+Battery life seems somewhat shorter than with Bunsenlabs, even after
+applying all powertop tricks in the book.
+*** apt install (1/n)
 git greybird-gtk-theme elementary-xfce-icon-theme emacs
 
 git suggests git-doc: why of course, good idea!
@@ -58,11 +180,7 @@ $ sudo sed -ri 's/security\.debian\.org/deb.debian.org/' /etc/apt/sources.list
 
 [[https://wiki.debian.org/SourcesList#Example_sources.list][🤷]]
 
-** Clone dotfiles
-Generate SSH keys and add them to GitLab through the web UI.  "Clone"
-(init, add remote, fetch, reset) dotfiles.
-
-** Tweak dotfiles
+*** tweak dotfiles
 Set EMAIL in .profile; copy .profile to .xsessionrc (AFAICT XFCE does
 not read ~/.config/environment.d) to get PATHs.
 
@@ -71,36 +189,35 @@ source personal .bash_prompt.
 
 Fun fact!  git can guess user.email from $EMAIL and user.name from the
 [[https://en.wikipedia.org/wiki/Gecos_field][GECOS field]].
-
-** Install Emacs packages
-- Comment out .emacs below (load custom-file)
-- (package-refresh-contents)
-- (package-install-selected-packages)
-
-** Configure XFCE
-*** Thunar
-**** Enable GVFS
+*** apt install (2/n)
+#+BEGIN_QUOTE
+E: Package 'gcc-doc' has no installation candidate
+#+END_QUOTE
+gcc-doc is only available in /backports/?
+*** configure XFCE
+**** Thunar
+***** Enable GVFS
 - apt install gvfs-backends gvfs-fuse
 - thunar > Edit > Preferences > Advanced > Volume Management > Configure
   - [X] Mount removable dries when hot-plugged
   - [X] Mount removable media when inserted
   - [ ] Browse removable media when inserted
-**** View
+***** View
 - Side Pane: Tree
 - View as Detailed List
-*** Terminal
-**** General
+**** Terminal
+***** General
 - Scrollbar is: Disabled
 - [X] Unlimited scrollback
-**** Appearance
+***** Appearance
 - [X] Use system font
 - [ ] Display menubar in new windows
-**** Advanced
+***** Advanced
 - [X] Disable all menu access keys (such as Alt-f) /for readline/
 - [X] Disable help window shortcut key (F10 by default) /for wavemon/
 - [X] Automatically copy selection to clipboard
 
-*** Mouse and Touchpad
+**** Mouse and Touchpad
 - Move sliders a bit to no avail, restore defaults.
 - Google around.
 - Why do my XFCE settings not have this "Touchpad" tab?
@@ -112,8 +229,8 @@ Fun fact!  git can guess user.email from $EMAIL and user.name from the
   - Scrolling mode: Edge scrolling
 🎉
 
-*** Panels
-**** Top panel
+**** Panels
+***** Top panel
 Row size: 24px
 Items:
 - Applications Menu
@@ -129,15 +246,15 @@ Items:
 - Power Manager Plugin: add
   - Show label: None
 - Action Buttons: remove
-**** Remove bottom panel
+***** Remove bottom panel
 I'd rather remember a few Super-… shortcuts to launch these
 applications rather than waste all this vertical space.
 
-*** Workspaces
+**** Workspaces
 Set names to 🖵.
 
-*** Appearance
-**** Style
+**** Appearance
+***** Style
 Greybird
 
 Patch the xfwm-tabwin style to prevent the mouse from screwing with
@@ -159,32 +276,32 @@ diff -u /usr/share/themes/Greybird/gtk-2.0/gtkrc.bkp /usr/share/themes/Greybird/
  	fg[NORMAL]	= shade (0.8, @base_color)
  	fg[ACTIVE]	= @base_color
 #+END_SRC
-**** Icons
+***** Icons
 elementary Xfce darker
-**** Fonts
+***** Fonts
 - Default Font: Noto Sans 9
 - Default Monospace Font: Noto Mono 9
 - Hinting: Slight
 - Sub-pixel order: RGB (trusting the [[http://www.lagom.nl/lcd-test/subpixel.php][Lagom LCD test pages]] here,
   changing the setting has no visible effect AFAICT…)
 
-*** Window manager
-**** Style
+**** Window manager
+***** Style
 - Theme: Greybird-compact
-**** Keyboard
+***** Keyboard
 - Tile window to the left: Super+Left
 - Tile window to the right: Super+Right
 - Show desktop: Super+D
-*** Window manager tweaks
-**** Cycling
+**** Window manager tweaks
+***** Cycling
 - [X] Cycle through windows in a list
-**** Accessiblity
+***** Accessiblity
 - [X] Hide title of windows when maximized
-**** Compositor
+***** Compositor
 - [ ] Show shadows under dock windows
 
-*** Keyboard
-**** Application Shortcuts
+**** Keyboard
+***** Application Shortcuts
 - emacs: Super+E
 - exo-open --launch FileManager: Super+F
 - exo-open --launch TerminalEmulator: Super+T
@@ -195,68 +312,44 @@ elementary Xfce darker
 - xfce4-screenshooter --window: Super+Print
 - xfce4-session-logout: Super+X
 - xflock4: Super+L
-
-** Install more stuff
-aspell-fr ffmpeg gimp vlc wordnet
-*** CLI tools
-mlocate ripgrep vim
-*** documentation
-info manpages-dev manpages-posix manpages-posix-dev gcc-doc make-doc python3-doc tar-doc
-
-#+BEGIN_QUOTE
-E: Package 'gcc-doc' has no installation candidate
-#+END_QUOTE
-
-gcc-doc is only available in the /backports/?
-*** Emacs 27 build dependencies
-- build-dep emacs
-- libjansson-dev libwebkit2gtk-4.0-dev
-*** system monitoring
-htop powertop wavemon
-** Configure more stuff
-*** lightdm
+*** configure more stuff
+**** lightdm
 Debian [[https://wiki.debian.org/LightDM#Enable_user_list][hides the list of users]] on the login screen; Bunsenlabs [[https://github.com/BunsenLabs/bunsen-configs/blob/9.6-1/lightdm.conf.d/50_bunsen.conf][enables
 it]] and I kind of like it (fewer keystrokes, and a cute avatar).
+** Dell 3190
+*** groundwork
+Using instructions from <https://wiki.debian.org/Firmware>.
+**** Get netinst image from <https://www.debian.org/CD/netinst/>
+**** Get firmware archive from <https://cdimage.debian.org/cdimage/unofficial/non-free/firmware/stable/current/>
+So that the installer can use the wireless network card.  Extract all
+.deb files to a top-level =firmware= folder on a USB key.
+**** Shrink the MS partition
+Had to "optimize the disk", otherwise some free space remained
+unavailable.
+*** installer
+Everything went smoothly:
+- if the USB key holding the firmware isn't plugged in, the installer
+  requests it, otherwise it finds the firmware automatically;
+- Secure Boot supported transparently;
+- dual-booting too.
+*** package repositories
+Non-free repositories automatically added during the installation,
+because of the WiFi firmware I presume.
 
-#+BEGIN_SRC sh
-$ sudo tee /usr/share/lightdm/lightdm.conf.d/99_custom.conf <<EOF
-> [Seat:*]
-> greeter-hide-users=false
-> EOF
-#+END_SRC
-*** groups
-adduser ${USER} adm, so that I can read /var/log files.
-adduser ${USER} dialout, so I can sync my phone.
-** Setup Firefox
-- download most recent release from from <https://www.mozilla.org>
-- unpack it $SOMEWHERE
-- make sure everyone can find it:
-
-    #+BEGIN_SRC sh
-    $ sudo update-alternatives --install $(which x-www-browser) x-www-browser \
-                               ${SOMEWHERE}/firefox/firefox 1
-    $ sudo update-alternatives --set x-www-browser ${SOMEWHERE}/firefox/firefox
-    $ ln -s ${SOMEWHERE}/firefox/firefox ~/.local/bin/
-    #+END_SRC
-
-- paste backuped configuration into ~/.mozilla/firefox/${profile}
 * Someday
 ** fix xfce4-terminal opening links with firefox-esr
 ** fix Thunar opening images with Firefox instead of Ristretto
 ** fix Ristretto thumbnails
-** setup fonts
-#+BEGIN_SRC html
-<head>
-  <meta charset="utf-8"/>
-</head>
-<body>
-  😀 😬 😁 😂 😃 😄 😅 😆 😇 😉 😊 🙂 🙃 ☺️ 😋 😌 😍 😘
-</body>
+** Samsung NC10
+*** fix Ethernet after suspend
+Workaround:
+#+BEGIN_SRC sh
+$ sudo modprobe -r sky2 && sudo modprobe -i sky2
 #+END_SRC
-
-- apt install fonts-noto-color-emoji
-- mousepad and xfce4-terminal seem to pick the font up out of the box
-- Firefox 69 displays ☺ with DejaVu Sans Mono
-- Emacs 27 with =(set-fontset-font t nil "Noto Color Emoji")= and
-  use-default-font-for-symbols nil can display everything with Noto
-  Color Emoji
+References:
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1841304
+- https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=895378
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1798921
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1809843
+- https://askubuntu.com/questions/1029620/ubuntu-18-04-lts-sky2-ethernet-stops-working-after-system-resume-from-suspend
+- https://bbs.archlinux.org/viewtopic.php?id=234725
diff --git a/itches/bulk.md b/itches/bulk.md
index ce646ca..9b9c126 100644
--- a/itches/bulk.md
+++ b/itches/bulk.md
@@ -1,6 +1,8 @@
 # XFCE
 
 - xfwm: hide/remove titlebar/decorations
+- read `~/.config/environment.d` to do away with `~/.xsessionrc`
+  (e.g. to set `$PATH`)
 
 # Spell checkers