iankelling.org Git - distro-setup/blob - README

   1 The following is the GNU All-permissive License as recommended in
   2 <https://www.gnu.org/licenses/license-recommendations.en.html>
   3
   4 Copyright (C) 2024 Ian Kelling <ian@iankelling.org>
   5
   6 Copying and distribution of this file, with or without modification,
   7 are permitted in any medium without royalty provided the copyright
   8 notice and this notice are preserved.  This file is offered as-is,
   9 without any warranty.
  10
  11 ~16k loc bash of config, setup, & .bashrc for my computers
  12
  13 Initial os install is also automated using a separate repo called
  14 automated-distro-installer, also at iankelling.org/git. Beyond the
  15 initial bare os, the rest is automated from scripts in this repo.
  16
  17 This is not meant for other people to run verbatum, but for them to read
  18 and copy the good parts. It has dependencies on other repos at
  19 https://iankelling.org/git.
  20
  21 The main thing missing for someone else to use things is the expected
  22 location of repos in the filesystem. So you would need to lookout for
  23 paths starting with /a and adjust them.
  24
  25 Background: reasoning behind using /a: The home directory is typically
  26 used for local software development, but I use paths like /a instead,
  27 for the following reasons:
  28
  29 1. I want to run code directly from where I work on it, instead of
  30 always having to create and use some install process. If that code is in
  31 a home directory, and you want to run it as root (especially in contexts
  32 where SUDO_USER is not set, like cron/systemd), you have to hardcode the
  33 username for /home/username, or create some install process where that
  34 username is saved somewhere, and then you are stuck with a single
  35 username. If it ever got packaged for a gnu/linux distro, it would rely
  36 on a hardcoded path with no username in it, so let's just do that.
  37
  38 2. The home directory is inconvenient. It's filled with a bunch of junk
  39 you don't care about, which makes directory listing horrible, makes it so
  40 you can't back it up easily (for example, gvfs mountpoint in it breaks
  41 lots of things), and has things you don't want to backup. So, you could
  42 use a subdirectory. But typing /s is much faster than ~/s and in every
  43 root context, /home/username/s.
  44
  45 The license of each file is specified at the start of the file. There is
  46 no overarching license for this repository.
  47
  48 Please email me if you have a patches, bugs, feedback, or republish this
  49 somewhere else: Ian Kelling <ian@iankelling.org>.