Moving most of the inline docs in autorun.sh to scripts/README.md.
This makes the documentation more discoverable and approachable
(no need to read source code).
This commit also removes redundancies from the inline docs,
clears up some phrasing,
and uses more standard formatting and phrasing such as:
- using `` instead of ""
- calling itself `autorun.sh`
- calling pre and post "execution phases"
This new functionality now makes it possible to execute scripts at the start or end of the build process, while also being super simple to expand to add further script stages in the future.
It also supports effortless reuse of scripts for multiple stages, since the scripts are now executed with the "current stage" as their 1st argument, to allow them to easily determine which stage they're running in.
This fixes the issue where someone specifies `fedora-version: latest`, which won't be known until build-time.
I also added a small "welcome" banner to the build log. It's really just there to retain a somewhat contrived use-case example for how to use `get_yaml_string()`, for other programmers who want to extend this in the future.
You can now define your custom repos with the `%FEDORA_VERSION%` variable, to automatically use the correct repo version, so that you never have to maintain their custom URLs again in the future.
You can now easily remove RPMs from your custom image, without having to edit the build.sh script.
This also changes the old "rpms" config key, to "rpm-install", for consistency with the new setting.
Thanks to leveraging Bash arrays, we are now able to use parameter expansion to perform every package installation as one rpm-ostree operation instead of individual ones. This will give us a huge build speedup.
Bash properly expands every array element as safely quoted arguments, complete with support for spaces and special characters.
This new technique is way easier to use, more maintainable, and safely handles special characters and spaces in the YAML data. It will also enable other features, such as the rpm-ostree improvement coming in the next commit.
The function name is `get_yaml_array()` because it literally reads it into a Bash array, by the way. Don't change the function name in the future. We may need other functions to read values into strings, etc.
Lowercase, run-on sentences are a nightmare to expand later, because the lack of sentence structure means you can't just add more lines and have a nice flow anymore.
Let's add some punctuation and grammar.
* docs: add just nix-me-up command explanation
* docs: explain extrarepos in recipe.yml
* docs: explain copr and how repos work
* What is copr?
* Make clear that you nedd .repo files.
* Show what it does.
* docs: minor grammar & clarity improvements
* docs: restructure COPR section
no need for it to be too long
and copying from the COPR docs is not as useful
as explaining it in more simple terms
---------
Co-authored-by: @EinoHR
* feat: add nix install script from bluefin / dnkmmr
* feat: add nix-me-up just cmd from bluefin
* feat: just update nix if installed
* feat: add nix-app-icons.sh
enables desktop icon support by adding to XDG_DATA_DIRS
* chore: remove nix update for now
this will be added in a later PR
* fix: prevent /etc/ merge issues
discussed at length in #28
also including tons of comments about the issue
* fix: change references of /etc/ to /usr/etc
