diff --git a/org/config/bin.org b/org/config/bin.org index 73c94b8..ae9c7f9 100644 --- a/org/config/bin.org +++ b/org/config/bin.org @@ -188,7 +188,7 @@ go. I even made it so that you can execute it as an executable file, like The choice is given to the user which of them to use with options that will be given to =cppnew=. -First of all, if no arguments were passed, return an error. +First, if no arguments were passed, return an error. #+begin_src fish if ! count $argv >/dev/null echo "Missing argument: PROJECT" && return -1 @@ -280,7 +280,7 @@ analysis server as requested. :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/UpdateFlutter :CUSTOM_ID: UpdateFlutter-1e8fbeb7 :END: -This is a simple utility to be ran when the ~flutter~ package is updated. +This is a simple utility to run when the ~flutter~ package is updated. #+BEGIN_SRC fish sudo chown -R :flutterusers /opt/flutter sudo chmod -R g+w /opt/flutter @@ -406,10 +406,11 @@ fi :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/sshbind :CUSTOM_ID: sshbind-756fabb1 :END: -Something that I did not know for quite some time but that is actually crazy -useful about SSH is its ability to bind locally the port of a remote machine, -and vice versa. The syntax is actually very simple, but I prefer a more -intuitive way of writing it. Its usage is ~sshbind PORT FROMHOST TOHOST~. +Something that I did not know for quite some time, but that is +actually crazy useful about SSH is its ability to bind locally the +port of a remote machine, and vice versa. The syntax is actually very +simple, but I prefer a more intuitive way of writing it. Its usage is +~sshbind PORT FROMHOST TOHOST~. #+BEGIN_SRC fish ssh -L $argv[1]:$argv[3]:$argv[1] $argv[2] -N #+END_SRC @@ -448,7 +449,7 @@ end #+end_src We can then read from the first member of ~argv~ which key the user -pressed. Depending on it, we can chose what to execute. +pressed. Depending on it, we can choose what to execute. #+name: nsxiv-switch-statement #+begin_src fish switch "$argv[1]" @@ -487,12 +488,12 @@ case "g" gimp $FILES #+end_src -Often, I use nsxiv to convert an image to a jpeg file, because my -internet connection is not that great and jpeg screenshots are faster -to upload than png screenshots. So what I do is for each file +Often, I use nsxiv to convert an image to a JPEG file, because my +internet connection is not that great and JPEG screenshots are faster +to upload than PNG screenshots. So what I do is for each file selected, I take the base name of the file (i.e. remove its extension), and then I use the ~convert~ command from ~imagemagik~ to -convert it from its original format to a jpg format --- ~imagemagik~ +convert it from its original format to a JPG format --- ~imagemagik~ detects the formats based on the extension. #+name: nsxiv-jpeg #+begin_src fish @@ -594,10 +595,9 @@ xinput set-prop $TPNAME "libinput Tapping Enabled" $NEWTPSTATUS :HEADER-ARGS: :shebang "#!/usr/bin/env sh" :mkdirp yes :tangle ~/.local/bin/wacom-setup :CUSTOM_ID: Wacom_setup-331fb024 :END: -I made a small and quick utility to set up my Wacom tablet so it is -only bound to one screen. This is quite easy, we simply need to find +I made a small and quick utility to set up my Wacom tablet to bind it +to one screen when in Xorg. This is quite easy, we simply need to find the Wacom stylus’ ID and assign it to the display we want. - #+begin_src sh ID=$(xinput | grep -oPi "wacom.+stylus.+id=\K([0-9]+)") SCREEN=$(xrandr -q --current | \ @@ -640,8 +640,8 @@ emacsclient -c -n -a emacs -e "(browse-url-mail \"$*\")" :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/mp42webm :CUSTOM_ID: mp42webm-aeacca58 :END: -This function allows me to convert easily an mp4 video to the webm format. -Nothing too fancy here. +This function allows me to convert easily a MP4 video to the webm +format. Nothing too fancy here. #+BEGIN_SRC fish ffmpeg -i $argv[1] -c:v libvpx -crf 10 -b:v 1M -c:a libvorbis $argv[1].webm #+END_SRC @@ -692,13 +692,14 @@ Categories=Media :HEADER-ARGS:EMACS-LISP: :exports none :tangle no :CUSTOM_ID: ytdl-a-youtube-dl-wrapper-03bd63e0 :END: -This script is a wrapper around ~youtube-dl~ which I use mainly for archiving -YouTube videos on my NAS (at the time I’m writing this, I have already 2.1TB -worth of videos archived). The principle behind this script is quite simple: I -want to avoid as much as possible to redownload any video already downloaded in -order to avoid pinging too much YouTube’s servers, 429 Too Many Requests errors -are really annoying, and it comes really early when you have only a couple of -new videos to download among the few 14k videos already downloaded. +This script is a wrapper around ~youtube-dl~ which I use mainly for +archiving YouTube videos on my NAS (at the time I’m writing this, I +have already 2.1 TB worth of videos archived). The principle behind +this script is quite simple: I want to avoid as much as possible to +redownload any video already downloaded in order to avoid pinging too +much YouTube’s servers, 429 Too Many Requests errors are really +annoying, and it comes really early when you have only a couple of new +videos to download among the few 14k videos already downloaded. Be aware this script was written for the Fish shell (3.1.0 and above), and makes use of youtube-dl 2020.03.24 and above, [[https://github.com/jorgebucaran/fish-getopts][Fish getopts]] and [[https://github.com/BurntSushi/ripgrep][ripgrep]]. diff --git a/org/config/bootstrap.org b/org/config/bootstrap.org index 447d9a4..30e604f 100644 --- a/org/config/bootstrap.org +++ b/org/config/bootstrap.org @@ -38,8 +38,8 @@ have a swap partition at least twice the size of your installed RAM. That is because when this command will be run, the system will try to save the current state of your machine, stored in your RAM, to the swap filesystem. If there is not enough space, the command will fail, and you won’t be able to use this -command. For instance, my current computer has 32GB of RAM, hence my SWAP -partition is 16GB large. +command. For instance, my current computer has 32 GB of RAM, hence my SWAP +partition is 16 GB large. ** Get the latest, fastest mirrors :PROPERTIES: @@ -70,7 +70,7 @@ by default on Arch ISOs anymore, so I’ll need to install it. pacman -S wget #+END_SRC -Now, let’s grab the script. You can check it on [[https://github.com/matmoul/archfi][Github]]. +Now, let’s grab the script. You can check it on [[https://github.com/matmoul/archfi][GitHub]]. #+BEGIN_SRC sh wget archfi.sf.net/archfi # Or from matmoul.github.io/archfi if SourceForge is down @@ -80,7 +80,7 @@ sh archfi Then, follow the instructions and install Arch Linux. Take the opportunity to install as many packages as you need, mainly ~paru~ which I use as my package manager (it is just a wrapper for ~pacman~) and AUR helper, and ~pacman-contrib~ -which will help us installing some packages later. +which will help us to install some packages later. Once your system is installed, reboot and remove your installation media from your computer. @@ -90,9 +90,9 @@ your computer. :HEADER-ARGS:fish: :tangle ~/.config/yadm/bootstrap :shebang "#!/usr/bin/fish" :exports code :mkdirp yes :CUSTOM_ID: Execute_bootstrap-e37054ef :END: -The first thing I will do is add the [[https://aur.chaotic.cx/][Chaotic AUR]] repository so I can -get access to ~paru~ as well as some AUR packages without the need of an -AUR helper (ironic considering ~paru~ is one). We can then install ~fish~, +The first thing I will do is add the [[https://aur.chaotic.cx/][Chaotic AUR]] repository to get +access to ~paru~ as well as some AUR packages without the need of an AUR +helper (ironic considering ~paru~ is one). We can then install ~fish~, ~git~, and ~paru~: #+BEGIN_SRC sh sudo pacman -S fish git paru @@ -221,7 +221,7 @@ sudo chown $USER:(id -g $USER) /mnt/{USB,CD,Android} :PROPERTIES: :CUSTOM_ID: Execute_bootstrap-Set_user’s_shell_to_fish-1a794be2 :END: -First of all, the bootstrap shell will set the user’s shell to fish. +First, the bootstrap shell will set the user’s shell to fish. #+BEGIN_SRC fish printf "\n# Set fish as the default shell ###############################################\n\n" whiptail --yesno "Set the current user’s default shell to fish?" 8 50 @@ -259,7 +259,7 @@ system packages. | jmtpfs | FUSE filesystem for the MTP protocol | | kitty | My current terminal emulator, works with Xorg and Wayland | | logrotate | Rotate system logs automatically | -| man-pages | Linux man pages | +| man-pages | Linux's man pages | | man-db | Read the Linux man pages | | netctl | Profile based systemd network management | | network-manager-applet | System tray applet for NetworkManager | @@ -437,9 +437,9 @@ Let’s install some desktop applications too, shall we? | rofi | A beautiful ~dmenu~ replacement | All these packages will be installed with the command ~paru -S ---skipreview --needed~ so it won’t nag me about the PKGBUILD when I -want to install something from the AUR, and if something is already -installed it paru won’t try to reinstall it. +--skipreview --needed~ to prevent it from nagging me about the PKGBUILD +when I want to install something from the AUR, and if something is +already installed it paru won’t try to reinstall it. #+name: gen-package-list #+header: :wrap "src fish :exports none :tangle no" @@ -547,9 +547,9 @@ cd /home/phundrak/Documents/code/PKGBUILDs/sent && makepkg -si; cd .. :PROPERTIES: :CUSTOM_ID: Execute_bootstrap-Tangle_configuration_files_from_Org_files-cc524361 :END: -Before tangling our configuration files, we need to create some directories -first so our files can be properly tangled. Here’s the list of directories we -need to create: +Before tangling our configuration files, we need to create some +directories first to make sure our files can be properly tangled. +Here’s the list of directories we need to create: #+NAME: dirs-tangled-files | $HOME/.config/fish | | $HOME/.config/gtk-2.0 | @@ -746,8 +746,8 @@ sudo timedatectl set-ntp true :END: ~acpilight~ is our utility managing the brightness of our screen. There is actually no service to enable here, but we must ensure the user is -part of the ~video~ group so we can modify the brightness of our screen -without using ~sudo~. +part of the ~video~ group to enable the user modifying the brightness of +our screen without using ~sudo~. #+BEGIN_SRC fish sudo usermod -aG video $USER #+END_SRC @@ -762,8 +762,8 @@ printf "\n# Enabling and starting Docker ####################################### sudo systemctl enable --now docker #+END_SRC -Now, if we wish it, we can be added to the =docker= group so we won’t have to -type =sudo= each time we call Docker or Docker Compose. +Now, if we wish it, we can add ourselves to the =docker= group to avoid +typing =sudo= each time we call Docker or Docker Compose. #+BEGIN_SRC fish read --prompt "echo 'Do you wish to be added to the `docker` group? (Y/n): ' " -l adddockergroup if test $adddockergroup = 'y' || test $adddockergroup = "Y" || test $adddockergroup = '' @@ -815,10 +815,11 @@ activate: sudo systemctl enable --now nordvpnd #+END_SRC -Let’s also set its default protocol to UDP. This will allow me to use any port -while connected to any WiFi as long as the 443 port is available. Because yes, I -do connect to a WiFi that blocks some important ports, such as the IMAP and SMTP -ports. Thanks University of Paris 8 for being SO paranoid. +Let’s also set its default protocol to UDP. This will allow me to use +any port while connected to any Wi-Fi as long as the 443 port is +available. Because yes, I do connect to a Wi-Fi that blocks some +important ports, such as the IMAP and SMTP ports. Thanks University of +Paris 8 for being SO paranoid. #+BEGIN_SRC fish nordvpn s protocol tcp #+END_SRC @@ -840,9 +841,9 @@ Linux kernel since its version 5.6. And Windows’ since August 2021, but I don’t really care about Windows. *But*, WireGuard is less privacy-oriented than OpenVPN. So, if I ever -need to use my VPN for privacy reasons, I can simply revert back to -the OpenVPN technology like shown with this command (not tangled in -the bootstrap): +need to use my VPN for privacy reasons, I can simply revert to the +OpenVPN technology like shown with this command (not tangled in the +bootstrap): #+begin_src fish :tangle no nordvpn set technology OpenVPN #+end_src @@ -875,10 +876,10 @@ activate it right away: systemctl --user enable --now pipewire-input-filter-chain.service #+end_src -Just make sure afterwards the microphone is redirected to the noise -canceling source. The same source should be your input device where -you want to use your microphone. The only downside is this is ony a -mono input, but it shouldn’t matter for most people. +Just make sure afterwards the microphone is redirected to the +noise-canceling source. The same source should be your input device +where you want to use your microphone. The only downside is this is +ony a mono input, but it shouldn’t matter for most people. *** SSH server :PROPERTIES: @@ -995,7 +996,7 @@ order to improve the user experience. :PROPERTIES: :CUSTOM_ID: Execute_bootstrap-Set_up_our_fish_shell-Install_=fisher=-3a44531b :END: -We will be using ~fisher~ as our extensions manager for Fish. Let’s install it. +We will be using ~fisher~ as our extension manager for Fish. Let’s install it. #+BEGIN_SRC fish printf "\n# Installing fisher ###########################################################\n\n" curl -sL https://git.io/fisher | source && fisher install jorgebucaran/fisher diff --git a/org/config/desktop.org b/org/config/desktop.org index 3d232b7..ebb6b3d 100644 --- a/org/config/desktop.org +++ b/org/config/desktop.org @@ -37,9 +37,10 @@ first column the keychord following the leader key, on the second column the EmacsLisp function to be called, and on the third the StumpWM command. If one of the ELisp or StumpWM case’s is empty, it means there is no equivalence. If it’s ~nil~, then it means it is a -prefix key. The fourth column is for now reserved for Emacs’ which-key -so I can give it a better name. If its value is ~nil~, then it should -not show up. Hopefully this can be implemented someday in StumpWM. +prefix key. The fourth column is for now reserved for Emacs’ +which-key, so I can give it a better name. If its value is ~nil~, then +it should not show up. Hopefully this can be implemented someday in +StumpWM. ** Generating Code :noexport: :PROPERTIES: @@ -503,8 +504,9 @@ IconViewScale=-1 :HEADER-ARGS: :mkdirp yes :tangle ~/.config/gtk-3.0/settings.ini :CUSTOM_ID: Theme-and-graphical-tweaks-GTK-Settings-GTK3-ojl7gbc0l9j0 :END: -The following file helps me choosing the aspect of various GTK+ 3 software, -including their theme and icons. First, let’s declare the header: +The following file helps me to choose the aspect of various GTK+ 3 +software, including their theme and icons. First, let’s declare the +header: #+BEGIN_SRC conf-unix [Settings] #+END_SRC @@ -632,15 +634,15 @@ Sent from GNU/Emacs :END: Some software I use are not packaged (yet) on my system. Therefore, in order to make them available in ~rofi~, I need to write a ~.desktop~ file -so I can launch them. +to launch them. ** Emacs :PROPERTIES: :CUSTOM_ID: -desktop-files-for-custom-applications-Emacs-6e9actg0m9j0 :END: -Emacs does have a default ~.desktop~ file, but I want to override it so -I can just “open with Emacs” from other software (such as Nemo) and it -will instead open with ~emacsclient~. +Emacs does have a default ~.desktop~ file, but I want to override it to +just “open with Emacs” from other software (such as Nemo) and it will +open with ~emacsclient~ instead of just =emacs=. #+begin_src conf-desktop :tangle ~/.local/share/applications/emacs.desktop [Desktop Entry] Name=Emacs @@ -673,7 +675,7 @@ StartupWMClass=Gnus Keywords=Text;Editor; #+end_src -Then I also have ~org-protocol.desktop~ so I can capture elements from +Then I also have ~org-protocol.desktop~ that helps capture elements from other software, mainly web pages from Firefox through the [[https://github.com/sprig/org-capture-extension][org-capture extension]]. #+begin_src conf-desktop :tangle ~/.local/share/applications/org-protocol.desktop @@ -730,8 +732,8 @@ Categories=Development :CUSTOM_ID: -desktop-files-for-custom-applications-Minecraft-tds7ddh0m9j0 :END: Yup, I play Minecraft. And yes, it does have a default ~.desktop~ file, -but this one overrides it so it launches automatically Minecraft with -[[https://wiki.archlinux.org/title/PRIME][prime-run]] so my GPU is used. +but this one overrides it to launch automatically Minecraft with +[[https://wiki.archlinux.org/title/PRIME][prime-run]], using my Nvidia GPU instead of my integrated GPU. #+begin_src conf-desktop :tangle ~/.local/share/applications/minecraft-launcher.desktop [Desktop Entry] Type=Application diff --git a/org/config/emacs.org b/org/config/emacs.org index f78f845..39e0789 100644 --- a/org/config/emacs.org +++ b/org/config/emacs.org @@ -173,7 +173,7 @@ preferred tastes —some may prefer 2 spaces tabs, some may prefer 4 spaces tabs, some deranged people prefer 8 spaces tabs, and some monsters prefer 3! -But the thing is, once you indented your code and then you need +But the thing is, once you indented your code, and then you need alignment, tabs don’t work anymore! Or they may on *your* text editor but not on your coworker’s! (He’s the one using 3 spaces tabs by the way). @@ -306,7 +306,7 @@ your unsaved changes won’t be lost. Very polite! :PROPERTIES: :CUSTOM_ID: Basic-configuration-Emacs-Behavior-Misc9j5jel6184j0 :END: -Let’s raise Emacs undo memory to 10MB, and make Emacs auto-save our +Let’s raise Emacs undo memory to 10 MB, and make Emacs auto-save our files by default. #+begin_src emacs-lisp (setq undo-limit 100000000 @@ -322,7 +322,7 @@ files by default. :CUSTOM_ID: Basic-configuration-Personal-Informationi59jel6184j0 :END: Emacs needs to know its master! For various reasons by the way, some -packages rely of these variables to know who it is talking to or +packages rely on these variables to know who it is talking to or dealing with, such as ~mu4e~ which will guess who you are if you haven’t set it up correctly. #+begin_src emacs-lisp @@ -517,7 +517,7 @@ I also had to make the code simply work. :CUSTOM_ID: Custom-Elisp-Dired-functions-phundrak-open-marked-filesdw2kel6184j0 :END: This function allows the user to open all marked files from a dired -buffer as new Emacs buffers. +buffer in new Emacs buffers. #+begin_src emacs-lisp (defun phundrak/open-marked-files (&optional files) "Open all marked FILES in Dired buffer as new Emacs buffers." @@ -556,16 +556,16 @@ b s~, which bring the user directly to the ~*Messages*~ buffer and the :CUSTOM_ID: Custom-Elisp-Screenshots-l9bkib013aj0 :END: Since Emacs27, it is possible for Emacs to take screenshots of itself -in various formats. I’m mainly interested by the SVG and PNG format, +in various formats. I’m mainly interested in the SVG and PNG format, so I’ll only write functions for these. It isn’t really redundant with the ~screenshot.el~ package used [[#Packages-Configuration-Applications-Screenshot96d1fl6184j0][here]] since these functions take a screenshot of Emacs as a whole rather than of a code snippet. First, we have a general function which is a slight modification of -the function shared by Alphapapa in [[https://www.reddit.com/r/emacs/comments/idz35e/emacs_27_can_take_svg_screenshots_of_itself/g2c2c6y/][this Reddit comment]]. It has been -modified so it is possible to pass the function an argument for the -format the screenshot will be taken as, and if ~type~ is ~nil~ the user -can still chose it. +the function shared by Alphapapa in [[https://www.reddit.com/r/emacs/comments/idz35e/emacs_27_can_take_svg_screenshots_of_itself/g2c2c6y/][this Reddit comment]]. I modified it +to make it possible to pass as an argument the format the screenshot +will be taken as or ask the user which format they would like to save +it as. #+begin_src emacs-lisp (defun self-screenshot (&optional type) "Save a screenshot of type TYPE of the current Emacs frame. @@ -628,9 +628,9 @@ focus the new window immediately. :CUSTOM_ID: Custom-Elisp-Extend-add-to-list-eh2325605gj0 :END: One function I find missing regarding ~add-to-list~ is ~add-all-to-list~ -so I can add multiple elements to a list at once. Instead, with -vanilla Emacs, I have to repeatedly call ~add-to-list~. That’s not very -clean. Let’s declare this missing function: +which enables the user to add multiple elements to a list at once. +Instead, with vanilla Emacs, I have to repeatedly call ~add-to-list~. +That’s not very clean. Let’s declare this missing function: #+begin_src emacs-lisp (defun add-all-to-list (list-var elements &optional append compare-fn) "Add ELEMENTS to the value of LIST-VAR if it isn’t there yet. @@ -669,11 +669,11 @@ an absurd amount of Emacs packages. :PROPERTIES: :CUSTOM_ID: Package-Management-Straightry3lel6184j0 :END: -For my package management, I prefer to use ~straight~ ([[https://github.com/raxod502/straight.el][Github]]). This is +For my package management, I prefer to use ~straight~ ([[https://github.com/raxod502/straight.el][GitHub]]). This is due to its capacity of integrating nicely with ~use-package~, which also supports ~general~ which I use for my keybindings (see below), but also -because with it I can specify where to retrieve packages that are not -on MELPA or ELPA but on Github and other online Git repositories too. +because with it, I can specify where to retrieve packages that are not +on MELPA or ELPA but on GitHub and other online Git repositories too. First, let’s bootstrap straight. #+begin_src emacs-lisp (defvar bootstrap-version) @@ -702,7 +702,7 @@ stuff. From time to time, I fork some packages either because I’m trying to implement something new in said package, or because the package is -unmaintained and I want to continue developing it a bit more. Straight +unmaintained, and I want to continue developing it a bit more. Straight provides a nice feature for using forks of a package with its ~:fork~ option. If set to ~t~, then straight will attempt to retrieve the package with the same name but with a different username on the same @@ -716,11 +716,11 @@ host. This username is retrieved through the following variable: The huge advantage of straight is it clones through git the packages it installs. This means development can be done directly on the downloaded package. However, Forge (a Magit extension for interacting -with websites such as Github, Gitlab, and such) interacts by default -with the forge described by the ~origin~ remote, which isn’t necessarily -the one I want Forge to interact with by default. Therefore, all -default remotes are named ~straight~ so it won’t collide with my regular -development flow. +with websites such as GitHub, Gitlab, and such) interacts by default +with the forge described by the =origin= remote, which isn’t necessarily +the one I want Forge to interact with by default. Therefore, +=straight.el= will name all default remotes =straight= to avoid any name +collision with my regular development flow. #+begin_src emacs-lisp (setq straight-vc-git-default-remote-name "straight") #+end_src @@ -845,10 +845,10 @@ they are much more comfortable than Emacs’. (evil-set-initial-state 'dashboard-mode 'normal)) #+end_src -I want to undefine some of the default keybinds of Evil because it -does not match my workflow. Namely, I use the space key and the comma -as leaders for my keybinds, and I’m way too used to Emacs’ ~C-t~, ~C-a~, -~C-e~, and ~C-y~. +I want to undefine some default keybinds of Evil because it does not +match my workflow. Namely, I use the space key and the comma as +leaders for my keybinds, and I’m way too used to Emacs’ ~C-t~, ~C-a~, ~C-e~, +and ~C-y~. #+name: evil-undefine-keys #+begin_src emacs-lisp :tangle no (evil-global-set-key 'motion "t" 'evil-next-visual-line) @@ -957,7 +957,7 @@ files with ~zstd~ when it is present on the system. Not only do we enjoy much smaller files (according to DoomEmacs, we get something like 80% file savings), Emacs can load them much faster than the regular files. Sure, it uses more CPU time uncompressing these files, but it’s -insignificant and it’s still faster than loading a heavier file. +insignificant, and it’s still faster than loading a heavier file. #+name: undo-tree-compress-files #+begin_src emacs-lisp :tangle no (when (executable-find "zstd") @@ -1243,11 +1243,11 @@ with an org-table. :PROPERTIES: :CUSTOM_ID: Packages-Configuration-Autocompletion-Ivy84q1fl6184j0 :END: -My main menu package is ~ivy~ which I use as much as possible –I’ve -noticed ~helm~ can be slow, very slow in comparison to ~ivy~ so I’ll use -the latter as much as possible. Actually, only ~ivy~ is installed for -now. I could have used ~ido~ too, but I find it to be a bit too -restricted in terms of features compared to ~ivy~. +My main menu package is =ivy= which I use as much as possible –I’ve +noticed =helm= can be slow, very slow in comparison to =ivy=, so I’ll use +the latter as much as possible. Actually, only =ivy= is installed for +now. I could have used =ido= too, but I find it to be a bit too +restricted in terms of features compared to =ivy=. #+begin_src emacs-lisp (use-package ivy :straight (:build t) @@ -1377,7 +1377,7 @@ and ask the user for some input in some precise places. (text-mode . yas-minor-mode))) #+end_src -Of course, yasnippet wouldn’t be as awesome as it is without premade +Of course, yasnippet wouldn’t be as awesome as it is without pre-made snippets. #+begin_src emacs-lisp (use-package yasnippet-snippets @@ -1386,7 +1386,7 @@ snippets. :straight (:build t)) #+end_src -Similarly, yatemplate offers premade files rather than just strings. +Similarly, yatemplate offers pre-made files rather than just strings. That’s still yasnippet by the way. #+begin_src emacs-lisp (use-package yatemplate @@ -1395,7 +1395,7 @@ That’s still yasnippet by the way. :straight (:build t)) #+end_src -And finally, with ivy you can chose your snippets from a menu if +And finally, with ivy you can choose your snippets from a menu if you’re not sure or if you don’t remember what your snippet is. #+begin_src emacs-lisp (use-package ivy-yasnippet @@ -1479,10 +1479,10 @@ database is to be stored. #+end_src I don’t want YouTube videos to be open with my web browser when I -invoke ~elfeed-show-visit~, so I’ll advise this function so I can modify -the behavior of said function. Oh, and I already made [[#Packages-Configuration-Misc-Ytplay-wxm9weq0r4j0][a neat package]] -for playing YouTube videos and friends through [[https://ytdl-org.github.io/youtube-dl/][youtube-dl]] or its -superior fork [[https://github.com/yt-dlp/yt-dlp][yt-dlp]] in mpv. +invoke ~elfeed-show-visit~, so I’ll advise this function to make it +possible to modify the behavior of said function. Oh, and I already +made [[#Packages-Configuration-Misc-Ytplay-wxm9weq0r4j0][a neat package]] for playing YouTube videos and friends through +[[https://ytdl-org.github.io/youtube-dl/][youtube-dl]] or its superior fork [[https://github.com/yt-dlp/yt-dlp][yt-dlp]] in mpv. #+name: elfeed-open-youtube-with-mpv #+begin_src emacs-lisp (defun my/elfeed-filter-youtube-videos (orig-fun &rest args) @@ -1815,8 +1815,8 @@ configuration for the ~mu4e~ package itself. Quick sidenote: on ArchLinux, you’ll need to install either ~mu~ or ~mu-git~ from the AUR in order to use mu4e. I also have a ~.desktop~ file -so I can open mu4e directly from my program picker. It uses the shell -script ~emacsmail~ I’ve written [[file:bin.org::#Emacsmail-afffb7cd][here]]. +to make it possible to open mu4e directly from my program picker. It +uses the shell script ~emacsmail~ I’ve written [[file:bin.org::#Emacsmail-afffb7cd][here]]. #+header: :mkdirp yes #+begin_src conf-desktop :tangle ~/.local/share/applications/mu4e.desktop [Desktop Entry] @@ -1937,7 +1937,7 @@ Next I need an inbox dedicated to the association I’m part of. As for the Emacs-doctor list, I need to match both the current, modern mailing list address but also its old address. The same applies for -the emacs-devel mailing list as well as Github emails related to my +the emacs-devel mailing list as well as GitHub emails related to my package ~eshell-info-banner.el~ ([[#Packages-Configuration-Emacs-built-ins-Eshell-Visual-configuratione7c2fl6184j0][see here]]). Here are the addresses to match: @@ -1957,7 +1957,7 @@ match: : list:/ateliers.*emacs.*/ OR t:/ateliers.*emacs.*/ OR f:/ateliers.*emacs.*/ OR contact:/ateliers.*emacs.*/ OR list:/emacs-.*@gnu.org/ OR t:/emacs-.*@gnu.org/ OR f:/emacs-.*@gnu.org/ OR contact:/emacs-.*@gnu.org/ OR list:/.*eshell-info-banner.*/ OR t:/.*eshell-info-banner.*/ OR f:/.*eshell-info-banner.*/ OR contact:/.*eshell-info-banner.*/ OR list:/.*emacsfr.*/ OR t:/.*emacsfr.*/ OR f:/.*emacsfr.*/ OR contact:/.*emacsfr.*/ Another bookmark I wish to have is one dedicated to emails related to -more general development topics, including issues and PRs from Github. +more general development topics, including issues and PRs from GitHub. #+name: mu4e-github-mailing-lists - ~/.*\\.github\\.com/~ - ~/.*\\.gitlab\\.com/~ @@ -2098,9 +2098,9 @@ With this piece of code, I can simply jump to my inbox maildir with I’m sure you have received at least one email recently from a sketchy email address asking you something that might be completely unrelated to what you do, or at least somewhat related. Fortunately, [[https://twitter.com/Boris/status/1360208504544444417][we have a -hero]]! Now, let me write a function that will insert their pre-written -text at point so I don’t have to go back to their Twitter thread each -time I want to shut spammers up. +hero]]! Now, let me write a function that will insert their +pre-written text at point to avoid me going back to their Twitter +thread each time I want to shut spammers up. #+begin_src emacs-lisp (defun reply-to-bill () (interactive) @@ -2336,8 +2336,8 @@ the major-mode leader and call a simple function. :CUSTOM_ID: Packages-Configuration-Applications-Email-Composing-messagesth71fl6184j0 :END: Org mime is cool and all, you can write some org-mode and then export -it so you can send an HTML email. BUT, have you considered skipping -the export part and write your emails directly in org-mode? +it to either a plain-text or an HTML email. BUT, have you considered +skipping the export part and write your emails directly in org-mode? #+begin_src emacs-lisp (use-package org-msg :after (mu4e) @@ -2705,7 +2705,7 @@ left it. Magit is an awesome wrapper around Git for Emacs! Very often, I go from disliking to really hating Git GUI clients because they often obfuscate which Git commands are used to make things happen. Such a -thing doesn’t happen with Magit, it’s pretty transparent but it still +thing doesn’t happen with Magit, it’s pretty transparent, but it still provides some awesome features and visualizations of what you are doing and what Git is doing! In short, I absolutely love it! #+begin_src emacs-lisp @@ -2759,7 +2759,7 @@ doing and what Git is doing! In short, I absolutely love it! display in the Magit buffer a list of TODOs found in the current project to remind you of what to do next. -First, let’s setup our todo keywords with ~hl-todo~. A good few todo +First, let’s se tup our todo keywords with ~hl-todo~. A good few todo keywords are already defined in the ~hl-todo-keyword-faces~ variable. Why not use them? ~hl-todo-mode~ enables fontlock highlight of these keywords in a buffer. Let’s enable this mode globally. @@ -2816,7 +2816,7 @@ with ~magit-gitflow~: :PROPERTIES: :CUSTOM_ID: Packages-Configuration-Project-Management-Forgelcq5fl6184j0 :END: -Forge acts as an interface for Github, Gitlab, and Bitbucket inside +Forge acts as an interface for GitHub, Gitlab, and Bitbucket inside Magit. A lot of possibilities are present, you can read issues and pull requests, create them, and fork projects among other things. @@ -2862,7 +2862,8 @@ which will be very useful when managing projects. #+end_src Now, I can use projectile, which is sort of the /de facto/ standard -project manager in Emacs. I know there’s ~project.el~, but,… Eh… +project manager in Emacs. I know there’s ~project.el~, but… Eh… I’m used +to projectile. #+begin_src emacs-lisp (use-package projectile :straight (:build t) @@ -3367,9 +3368,9 @@ files and images. #+end_src Copying files with Dired is a blocking process. It’s usually fine when -there’s not a lot to copy, but it becomes more annoying when moving -larger files. The package ~dired-rsync~ allows to copy files with ~rsync~ -in the background so we can carry on with our tasks while the copy is +there’s not a lot to copy, but it becomes annoying when moving larger +files. The package ~dired-rsync~ allows copying files with ~rsync~ in the +background; we can then carry on with our tasks while the copy is happening. #+begin_src emacs-lisp (use-package dired-rsync @@ -3562,7 +3563,7 @@ that. (eshell 'N)) #+end_src -A very useful command I use often in fish is ~z~, a port from bash’s and +A very useful command I often use in fish is ~z~, a port from bash’s and zsh’s command that allows to jump around directories based on how often we go in various directories. #+begin_src emacs-lisp @@ -3840,11 +3841,11 @@ don’t know at which rate it is updated. And more packages down the line will depend on this Git repository, so I might as well just clone it right now. -As you can see, in the ~:config~ secion I added to two hooks functions -so buffers are accurately renamed. While the average X window will -simply get the name of the current X window, I want Firefox and -Qutebrowser to be prefixed with the name of the browser. Actually, all -these will be renamed this way: +As you can see, I added in the ~:config~ secion to two hooks functions +that rename buffers accurately. While the average X window will simply +get the name of the current X window, I want Firefox and Qutebrowser +to be prefixed with the name of the browser. Actually, all these will +be renamed this way: #+name: exwm-renamed-buffers-list - Kitty - Qutebrowser @@ -3883,10 +3884,10 @@ these will be renamed this way: <>))) #+end_src -As you can see below, in the ~:config~ section I added two advices and one -hook in order to correctly integrate evil with EXWM. When I’m in an X -window, I want to be in insert-mode so I can type however I want. -However, when I exit one, I want to default back to normal-mode. +As you can see below, in the ~:config~ section I added two advices and +one hook in order to correctly integrate evil with EXWM. When I’m in +an X window, I want to be in insert-mode in order to type however I +want. However, when I exit one, I want to default back to normal-mode. #+name: exwm-advices-evil #+begin_src emacs-lisp :tangle no (add-hook 'exwm-manage-finish-hook (lambda () (call-interactively #'exwm-input-release-keyboard))) @@ -3920,7 +3921,7 @@ completely forgotten. So I removed ~s-I~ and made ~s-~ behave like As stated a couple of times in my different configuration files, I’m using the bépo layout, which means the default keys in the number row -are laid as follow: +are laid as follows: #+name: exwm-bepo-number-row #+begin_src emacs-lisp :tangle no (defconst exwm-workspace-keys '("\"" "«" "»" "(" ")" "@" "+" "-" "/" "*")) @@ -3952,7 +3953,7 @@ workspaces 0 to 9. You can then see the list of the keybinds I have set for EXWM, which are all prefixed with ~SPC x~ in normal mode (and ~C-SPC x~ in insert -mode), with the exception of ~s-RET~ which opens an eshell terminal. +mode), except for ~s-RET~ which opens an eshell terminal. #+name: exwm-keybinds #+begin_src emacs-lisp :tangle no (exwm-input-set-key (kbd "s-") (lambda () @@ -4191,7 +4192,7 @@ human-friendly name." :PROPERTIES: :CUSTOM_ID: Packages-Configuration-Making-my-life-easier-Buflerw215fl6184j0 :END: -Bufler is a package that organizes and lists buffers in a much better +Bufler is a package that organises and lists buffers in a much better way than how they are usually sorted. You can easily and quickly find buffers by their group, not only by their name, and THIS is great news! Also, no ~helm~ please! And for some reasons the keybindings are @@ -4703,7 +4704,7 @@ A useful package I like is ~toc-org~ which creates automatically a table of contents. My main usage for this however is not just to create a table of content of my files to quickly jump around my file (I have ~counsel-org-goto~ for that), but it is for creating table of contents -for org files that will be hosted and viewable on Github. +for org files that will be hosted and viewable on GitHub. #+begin_src emacs-lisp (use-package toc-org :after (org markdown-mode) @@ -5881,8 +5882,8 @@ to anything user-defined. Let’s all-the-iconify this! :END: Treesit is a native Emacs [[https://tree-sitter.github.io/tree-sitter/][tree-sitter]] implementation which provides a very fast and flexible way of performing code-highlighting in Emacs. -It is built-in in Emacs 29 and newer, and I just need to tweak one -variable for now so I can install grammars for different languages. +It is built-in in Emacs 29 and newer, and I just need to tweak a couple of +variables to install grammars for different languages. #+begin_src emacs-lisp (use-package treesit :defer t @@ -6482,7 +6483,7 @@ visual graphs and networks. :END: Yes, I love org-mode and I largely prefer to use it instead of Markdown due to its far superior power and abilities. But still, -sometimes I need to use Markdown because not everyone use org-mode, +sometimes I need to use Markdown because not everyone uses org-mode, unfortunately. #+begin_src emacs-lisp (use-package markdown-mode @@ -6584,7 +6585,7 @@ unfortunately. (setq markdown-fontify-code-blocks-natively t)) #+end_src -Since most of my Markdown files are related to Github, I’d like to be +Since most of my Markdown files are related to GitHub, I’d like to be able to render Markdown through its API. #+begin_src emacs-lisp (use-package gh-md @@ -6598,7 +6599,7 @@ able to render Markdown through its API. "cr" #'gh-md-render-buffer)) #+end_src -Sometimes, I have to work with Github’s markdown flavour, but I’m not +Sometimes, I have to work with GitHub’s markdown flavour, but I’m not really a huge fan of writing it by hand. So instead, I’ll write it in org-mode and then export it with ~ox-gfm~. #+begin_src emacs-lisp @@ -6874,10 +6875,10 @@ In Lisp buffers, let’s enable ~parinfer-rust-mode~. My current window manager is StumpWM, inspired by Emacs and written in CommonLisp. ~stumpwm-mode~ offers some integration between Emacs and -StumpWM so we can evaluate CLisp code and see its effects in StumpWM -immediately. Since my only use for CommonLisp is for my StumpWM -configuration, it should be automatically enabled when entering -~lisp-mode~. +StumpWM that makes the user able to evaluate CommonLisp code and see +its effects in StumpWM immediately. Since my only use for CommonLisp +is for my StumpWM configuration, it should be automatically enabled +when entering ~lisp-mode~. #+begin_src emacs-lisp (use-package stumpwm-mode :straight (:build t) @@ -7016,7 +7017,7 @@ If I need to run CI on a package, [[https://github.com/cask/cask][Cask]] manages #+end_src However, I recently began using [[https://github.com/emacs-eask/eask][Eask]] more and more, I find it nicer to -work with and it has a lot more features than Cask. +work with, and it has a lot more features than Cask. #+begin_src emacs-lisp (use-package eask-api :defer t @@ -7358,7 +7359,7 @@ development. First, let’s install the most important package, :CUSTOM_ID: Packages-Configuration-Programming-languages-General-Programming-Languages-Web-programming-7ca40po085j0 :END: [[https://emmet.io/][Emmet]] is a powerful templating engine that can generate through simple -CSS-like expression some HTML so you don’t have to write everything by +CSS-like expression some HTML to avoid the user writing everything by hand. #+begin_src emacs-lisp (use-package emmet-mode @@ -7384,8 +7385,8 @@ hand. "ew" #'emmet-wrap-with-markup)) #+end_src -Impatient mode serves web buffers live over HTTP so you can see your -editions as you type them. +Impatient mode serves web buffers live over HTTP, including your live +modifications. #+begin_src emacs-lisp (use-package impatient-mode :straight (:build t) @@ -7573,7 +7574,7 @@ Next.JS. #+end_src ~js2-refactor~ is an amazing tool for refactoring Javascript code. I -mean, [[https://www.youtube.com/watch?v=-7yMWD1wUu4][look at this]]! And the video is only from 2013 and it still +mean, [[https://www.youtube.com/watch?v=-7yMWD1wUu4][look at this]]! And the video is only from 2013, and it still receives some commits! #+begin_src emacs-lisp (use-package js2-refactor diff --git a/org/config/fish.org b/org/config/fish.org index c7a26e4..e46e051 100644 --- a/org/config/fish.org +++ b/org/config/fish.org @@ -15,7 +15,7 @@ The file present in =~/.config/fish/config.fish= is the configuration file for the [[https://fishshell.com/][fish shell]]. It contains custom functions, environment variables and abbreviations. -Just in case, we might need sometimes to declare the fish function =fish_title= +Just in case, we might sometimes need to declare the fish function =fish_title= as =true=, so let’s do so. #+BEGIN_SRC fish function fish_title @@ -59,10 +59,11 @@ set -gx PKG_CONFIG_PATH /usr/local/lib/pkgconfig/ $PKG_CONFIG_PATH :PROPERTIES: :CUSTOM_ID: Tramp_remote_access-72aedec2 :END: -When accessing from a remote machine our computer from Emacs, tramp needs a -precise shell appearance: a simple =$= followed by a space after which to put -the commands it needs to execute, and nothing else. Due to this, let’s -deactivate and redefine some of the functions defining the appearance of fish. +When accessing from a remote machine our computer from Emacs, tramp +needs a precise shell appearance: a simple =$= followed by a space after +which to put the commands it needs to execute, and nothing else. Due +to this, let’s deactivate and redefine some functions defining the +appearance of fish. #+BEGIN_SRC fish if test "$TERM" = "dumb" function fish_prompt @@ -245,16 +246,17 @@ the terminal window will come back. :PROPERTIES: :CUSTOM_ID: Abbreviations-System_monitoring-bd909755 :END: -Here I have some abbreviations which are quite useful when performing some -system monitoring. With =df=, we can get an overview of our filesystem usage, -while with =diskspace= we get some more precise information. =meminfo= is a call -to =free= with sane defaults, and similar to =meminfo=, we also have -=gpumeminfo= so we can get a quick look at the memory-related logs of our X -session. I also declared =cpuinfo= an alias of =lscpu= in order to keep -consistent with =meminfo=. =pscpu= gives us information on what the CPU is -running right now, and =pscpu10= limits that to the top 10 threads. Similarly, -=psmem= gives us information on the memory usage of the current threads, and -=psmem10= only the ten most important threads in terms of memory usage. +Here I have some abbreviations which are quite useful when performing +some system monitoring. With =df=, we can get an overview of our +filesystem usage, while with =diskspace= we get some more precise +information. =meminfo= is a call to =free= with sane defaults, and similar +to =meminfo=, we also have =gpumeminfo= to get a quick look at the +memory-related logs of our X session. I also declared =cpuinfo= an alias +of =lscpu= in order to keep consistent with =meminfo=. =pscpu= gives us +information on what the CPU is running right now, and =pscpu10= limits +that to the top 10 threads. Similarly, =psmem= gives us information on +the memory usage of the current threads, and =psmem10= only the ten most +important threads in terms of memory usage. #+NAME: mgmt-abbr | abbreviation | command | |--------------+--------------------------------------------| @@ -327,7 +329,7 @@ comes to compilation or Docker. :PROPERTIES: :CUSTOM_ID: Abbreviations-Development-CMake-f2951675 :END: -I have the following abbreviations so I can quickly run CMake and create a +I have the following abbreviations to quickly run CMake and create a configuration for debug or release profiles. #+NAME: abbr-cmake | abbreviation | command | @@ -374,7 +376,7 @@ I greatly prefer to use Emacsclient as my main text editor; Emacs has basically all I need. So, it's only normal I have an abbreviation to launch a new instance of it. If launched in the terminal, I’ll usually want Emacs to be displayed in CLI mode and not in GUI mode, otherwise I would invoke it with my WM’s shortcut. -In case we want to launch Emacs in GUI mode anyways, ~egui~ is available too. +In case we want to launch Emacs in GUI mode anyway, ~egui~ is available too. #+NAME: abbr-text-ed | abbreviation | command | @@ -428,7 +430,7 @@ Here is the corresponding fish configuration: :CUSTOM_ID: Abbreviations-LaTeX-76865eb9 :END: Yes, although I use org-mode, I still have some use for LaTeX, especially when -it comes to PDF exports of my org files. Hence why I use the LaTeX package +it comes to PDF exports of my org files. Hence, why I use the LaTeX package manager. It is recommended to use ~tllocalmgr~ instead of ~tlmgr~, but I can never remember the command, and the latter is faster to type, so time for an abbreviation. Same goes for ~texhash~ which must be run as sudo. @@ -447,14 +449,14 @@ Here is the corresponding fish configuration: :PROPERTIES: :CUSTOM_ID: Abbreviations-Some_security_measures-489cb521 :END: -Some commands can be quite dangerous when not used properly, which is why I -added default flags and options so I can get warnings before things get ugly. -The =-i= and =-I= add prompts in case we might not want to do what we asked the -shell to do. Notice =lns= which creates symlinks, =rmd= which removes -directories, =rmf= which forces deletion, and =rmdf= which forces the delition -of a directory. Notice also the =--preserve-root= which will prevent me from -accidentally removing the root folder. I added the same option to =chgrp=, -=chmod=, and =chown=. +Some commands can be quite dangerous when not used properly, which is +why I added default flags and options in order to get warnings before +things get ugly. The =-i= and =-I= add prompts in case we might not want +to do what we asked the shell to do. Notice =lns= which creates +symlinks, =rmd= which removes directories, =rmf= which forces deletion, +and =rmdf= which forces the delition of a directory. Notice also the +=--preserve-root= which will prevent me from accidentally removing the +root folder. I added the same option to =chgrp=, =chmod=, and =chown=. #+NAME: sec-abbr | abbreviation | command | |--------------+--------------------------| @@ -539,13 +541,13 @@ program. abbr nsxiv 'nsxiv -abfos f' #+END_SRC -The following abbreviation is here so I can easily launch software -with my Nvidia GPU. +The following abbreviation is here to launch software with my Nvidia +GPU. #+begin_src fish abbr nv 'env __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia' #+end_src -Finally, let's declare the following abbreviation that will launch an mpv +Finally, let's declare the following abbreviation that will launch a MPV instance displaying my webcam: #+BEGIN_SRC fish abbr webcam 'devour mpv --demuxer-lavf-format=video4linux2 --demuxer-lavf-o-set=input_format=mjpeg av://v4l2:/dev/video0' diff --git a/org/config/index.org b/org/config/index.org index 7377db9..e932b8a 100644 --- a/org/config/index.org +++ b/org/config/index.org @@ -38,15 +38,15 @@ some games that do not offer to remap keys (I’m looking at you, Among Us). :PROPERTIES: :CUSTOM_ID: Features-5ab2a2c0 :END: -- Emacs configuration perfectly tailored for my own use +- Emacs' configuration perfectly tailored for my own use - Beautiful and comfy StumpWM configuration - And enough information below to get basically the same distro install as I have on computer. -Most of the org files you will find in this repos are the actual -source code of much of my config files. For instance, the bootstrap -found in [[file:bootstrap.org][bootstrap.org]] exports almost all of its code snippets to -~$HOME/.config/yadm/bootstrap~ thanks to =M-x org-babel-tangle= from +Most of the org files you will find in this repo are the actual source +code of much of my config files. For instance, the bootstrap found in +[[file:bootstrap.org][bootstrap.org]] exports almost all of its code snippets to +=$HOME/.config/yadm/bootstrap= thanks to =M-x org-babel-tangle= from within Emacs. Below I will also present and comment some of my short config files which do not deserve to have a full org file dedicated to them. @@ -186,14 +186,15 @@ welcome either. :PROPERTIES: :CUSTOM_ID: Features-And-some-minor-configuration-files-Paru-1f3ef49e :END: -~paru~ is an AUR helper for Arch Linux which aims to be a replacement for ~yay~. -A couple of the options you will see below aim at restoring the behavior of -~yay~ in ~paru~. I also activated the sudo loop so I don’t have to enter my -password if one package takes too much time to compile and/or compress. I know -it can be a security issue if someone ever get access to my computer while paru -is running, but if it ever happens it will be already concerning enough they -managed to. I also make use of [[file:bin.org::#Emacs-stuff-Dired-2eeca9da][my custom script dired]] so I can use Emacs’ Dired -as the file manager for ~paru~. +~paru~ is an AUR helper for Arch Linux which aims to be a replacement +for ~yay~. A couple of the options you will see below aim at restoring +the behavior of ~yay~ in ~paru~. Sudo loop avoids me having to enter again +my password if one package takes too much time to compile and/or +compress. I know it can be a security issue if someone ever get access +to my computer while paru is running, but if it ever happens it will +be already concerning enough they managed to. I also make use of [[file:bin.org::#Emacs-stuff-Dired-2eeca9da][my +custom script dired]] so I can use Emacs’ Dired as the file manager +for ~paru~. #+BEGIN_SRC conf :tangle ~/.config/paru/paru.conf :mkdirp yes [options] BottomUp diff --git a/org/config/mpd.org b/org/config/mpd.org index 5a8fac8..b8b0040 100644 --- a/org/config/mpd.org +++ b/org/config/mpd.org @@ -62,9 +62,9 @@ log_file "~/.config/mpd/log" :PROPERTIES: :CUSTOM_ID: Optional-Parameters-hkw8zz71v8j0 :END: -While these values are not strictly necessary, some are still -extremely useful such as ~music_directory~ so we don’t have to manually -add our music to MPD each time we run it. +While these values are not strictly necessary, some are still useful +such as ~music_directory~: we don’t have to manually add our music to +MPD each time we run it. #+name: mpd-optional-parameters | Parameter | Value | Comment | |--------------------+---------------------+-----------------------------------------------------------| @@ -83,9 +83,8 @@ add our music to MPD each time we run it. :PROPERTIES: :CUSTOM_ID: Audio-outputs-emqjro81v8j0 :END: -Two audio outputs will be defined. The first one is dedicated to -Pulseaudio so I can actually hear my music. Its configuration is -simple, really. +Two audio outputs will be defined. The first one sets Pulseaudio up so +I can actually hear my music. Its configuration is simple, really. #+begin_src conf-space audio_output { type "pulse" @@ -93,9 +92,8 @@ audio_output { } #+end_src -Another one is created, but this time for the visualizer of ~ncmpcpp~. -It is not necessary to create this one if you don’t plan on using this -feature. +Another one sets up the visualizer of ~ncmpcpp~. It is not necessary to +create this one if you don’t plan on using this feature. #+begin_src conf-space audio_output { type "fifo" diff --git a/org/config/neofetch.org b/org/config/neofetch.org index 53d3ce5..33c5e1b 100644 --- a/org/config/neofetch.org +++ b/org/config/neofetch.org @@ -405,7 +405,7 @@ gtk3="off" :PROPERTIES: :CUSTOM_ID: Information_settings-Hardware-CPU-CPU_brand-5b25776b :END: -With this variables, it is possible to show or hide the brand of a CPU in the +With these variables, it is possible to show or hide the brand of a CPU in the ~cpu~ output. - Default value :: ~"on"~ - Values :: @@ -459,8 +459,8 @@ speed_type="bios_limit" :PROPERTIES: :CUSTOM_ID: Information_settings-Hardware-CPU-CPU_speed_shorthand-0d15fe08 :END: -This value allows to show sorter CPU speed with less digits. This flag is not -supported in systems with CPU speed below 1GHz. +This value allows showing sorter CPU speed with fewer digits. This flag +is not supported in systems with CPU speed below 1GHz. - Default value :: ~"off"~ - Values :: - ~"on"~ diff --git a/org/config/picom.org b/org/config/picom.org index e7d00aa..2811093 100644 --- a/org/config/picom.org +++ b/org/config/picom.org @@ -26,7 +26,7 @@ requested using the wintypes option. shadow = true; #+END_SRC -The blur radius radius for shadows is measured in pixels, and it defaults to +The blur radius for shadows is measured in pixels, and it defaults to 12px. #+BEGIN_SRC conf shadow-radius = 17; @@ -55,8 +55,8 @@ or ~shadow-blue~. shadow-color = "#171A20" #+END_SRC -It is possible to specify a list of conditions of windows that should have no -shadow. +It is possible to specify a list of conditions of windows that should +have no shadow. | Default value | ~[]~ | #+BEGIN_SRC conf shadow-exclude = [ @@ -102,9 +102,9 @@ config file instead. no-dock-shadow = false; #+END_SRC -This option allows Picom not to draw on drag-and-drop windows. This option is -deprecated, and users should use the ~wintypes~ option in their config file -instead. +This option allows Picom not to draw on drag-and-drop windows. It is +deprecated, and users should use the ~wintypes~ option in their config +file instead. | Default value | ~false~ | #+BEGIN_SRC conf no-dnd-shadow = false; @@ -156,7 +156,8 @@ feature on or off. However, its behavior can be changed with fading = true #+END_SRC -These values controls the opacity change between steps while fading in and out. +These values control the opacity change between steps while fading in +and out. | Default value | ~0.028~ (fade-in), ~0.03~ (fade-out) | | Min value | ~0.01~ | | Max value | ~1.0~ | @@ -268,7 +269,7 @@ focus-exclude = [ #+END_SRC The user can also specify a list of opacity rules, in the format -~PERCENT:PATTERN~, like ~50:name *= "Firefox"~ . ~picom-trans~ is recommended +~PERCENT:PATTERN~, like ~50:name *= "Firefox"~ . ~picom-trans~ is recommended over this. Note we don't make any guarantee about possible conflicts with other programs that set ~_NET_WM_WINDOW_OPACITY~ on frame or client windows. | Default value | ~[]~ | @@ -336,8 +337,8 @@ blur-background-exclude = [ :PROPERTIES: :CUSTOM_ID: General_settings-41398de7 :END: -Daemonize process. Fork to background after initialization. Causes issues with -certain (badly-written) drivers. +Daemonize process. Fork to background after initialization. Can cause +issues with certain (badly-written) drivers. | Default value | ~false~ | #+BEGIN_SRC conf daemon = true; @@ -391,13 +392,10 @@ passing ~_NET_WM_OPACITY~ of client windows to frame windows. detect-client-opacity = true; #+END_SRC -Limit picom to repaint at most once every 1 / ~refresh_rate~ second to boost -performance. This should not be used with -#+BEGIN_SRC text :tangle no -vsync drm/opengl/opengl-oml -#+END_SRC -as they essentially does sw-opti's job already, unless you wish to specify a -lower refresh rate than the actual value. +Limit picom to repaint at most once every 1 / ~refresh_rate~ second to +boost performance. This should not be used with ~vsync +drm/opengl/opengl-oml~ as they essentially do sw-opti's job already, +unless you wish to specify a lower refresh rate than the actual value. | Default value | ~""~ | #+BEGIN_SRC conf # sw-opti =; @@ -411,10 +409,10 @@ the WM supports it. # use-ewmh-active-win = false; #+END_SRC -Unredirect all windows if a full-screen opaque window is detected, to maximize -performance for full-screen windows. Known to cause flickering when -redirecting/unredirecting windows. paint-on-overlay may make the flickering less -obvious. +Unredirect all windows if a full-screen opaque window is detected, to +maximize performance for full-screen windows. Known to cause +flickering when redirecting/unredirecting windows. =paint-on-overlay= +may make the flickering less obvious. | Default value | ~false~ | #+BEGIN_SRC conf unredir-if-possible = false; @@ -500,10 +498,10 @@ fullscreen based only on its size and coordinates. no-ewmh-fullscreen = false; #+END_SRC -Dimming bright windows so their brightness doesn't exceed this set value. -Brightness of a window is estimated by averaging all pixels in the window, so -this could comes with a performance hit. Setting this to 1.0 disables this -behaviour. Requires ~--use-damage~ to be disabled. +Dimming bright windows so their brightness doesn't exceed this set +value. Brightness of a window is estimated by averaging all pixels in +the window, so this could come with a performance hit. Setting this to +1.0 disables this behaviour. Requires ~--use-damage~ to be disabled. | Default value | ~1.0~ | #+BEGIN_SRC conf max-brightness = 1.0; @@ -516,24 +514,25 @@ instead of blending on top of them. transparent-clipping = false; #+END_SRC -Set the log level. Possible values are: +Set the log level. Possible values in increasing level of importance are: - ~trace~ - ~debug~ - ~info~ - ~warn~ - ~error~ -in increasing level of importance. Case doesn't matter. If using the "TRACE" log -level, it's better to log into a file using ~--log-file~, since it can generate -a huge stream of logs. +Case doesn't matter. If using the "TRACE" log level, it's better to +log into a file using ~--log-file~, since it can generate a huge stream +of logs. | Default value | ~"debug"~ | #+BEGIN_SRC conf log-level = "warn"; #+END_SRC -Set the log file. If ~--log-file~ is never specified, logs will be written to -stderr. Otherwise, logs will to written to the given file, though some of the -early logs might still be written to the stderr. When setting this option from -the config file, it is recommended to use an absolute path. +Set the log file. If ~--log-file~ is never specified, logs will be +written to stderr. Otherwise, logs will to written to the given file, +though some early logs might still be written to the stderr. When +setting this option from the config file, it is recommended to use an +absolute path. | Default value | ~''~ | #+BEGIN_SRC conf # log-file = '/path/to/your/log/file'; @@ -577,10 +576,10 @@ Following per window-type options are available: - full-shadow :: Controls whether shadow is drawn under the parts of the window that you normally won't be able to see. Useful when the window has parts of it transparent, and you want shadows in those areas. -- redir-ignore :: Controls whether this type of windows should cause screen to - become redirected again after been unredirected. If you have - unredir-if-possible set, and doesn't want certain window to cause unnecessary - screen redirection, you can set this to `true`. +- redir-ignore :: Controls whether this type of windows should cause + screen to become redirected again after being unredirected. If you + have =unredir-if-possible= set, and doesn't want certain window to + cause unnecessary screen redirection, you can set this to =true=. #+BEGIN_SRC conf wintypes: {