dots/bash
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

update

Browse source
This commit is contained in:
Ray Elliott 2026-10-27 13:32:57 +00:00
commit 2ac0f22dba
12 changed files with 346 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

22
README.md
View file

@ -10,9 +10,10 @@ the Bash login sequence.
- Configure Bash history, prompt rendering, completion and command-not-found
behaviour.
- Initialize Bash integrations such as NVM, Pyenv, z.lua and gitstatus.
- Own interactive aliases, functions and their curated command catalogue.
- Isolate Arch-specific interactive commands from general Bash configuration.
- Display the startup greeting and cached package status.
- Display `TODO.md` and `.autonote.md` after successful directory changes.
- Load common interactive aliases from the `profile` repository.
## Boundaries
@ -20,8 +21,6 @@ This repository does not own:
- Portable login environment variables or shared PATH construction. Those
belong in the `profile` repository.
- Common aliases intended for more than one Bourne-family shell. Those load
through `profile/interactive.sh`; genuinely Bash-specific aliases live here.
- User services, timers or background refresh logic. Those belong in the
`systemd` repository. Bash may consume their cached output or request a
non-blocking service start.
@ -44,7 +43,16 @@ shell is not interactive.
- `bash_profile`: connects Bash login startup to the shared profile and Bash RC.
- `bashrc`: interactive guard and ordered module loader.
- `bashrc.d/`: numbered interactive Bash modules; lower numbers load first.
- `aliases.bash`: Bash-specific and warning-only transition aliases.
- `interactive.sh`: loads interactive aliases, functions and reminders.
- `aliases.sh`: general interactive aliases and functions, written portably.
- `aliases.bash`: aliases requiring Bash-specific naming or behaviour.
- `commands.sh`: command-catalogue display and validation functions.
- `commands.tsv`: curated command descriptions and reminder visibility.
- `commands.README.md`: format and maintenance instructions for the catalogue.
- `hosts.sh`: SSH destination listing function.
- `memory.tsv`: curated daily shell-memory questions and answers.
- `memory.README.md`: memory-bank format and selection behaviour.
- `platform/arch.sh`: Arch-specific applications and system integration.
- `gitstatus-custom.sh`: prompt integration for gitstatus.
- `cheat.bash`: completion for `cheat`.
- `install.sh`: installs the home-directory symlinks and gitstatus dependency.
@ -59,7 +67,7 @@ The loader sources every readable `bashrc.d/*.bash` file in lexical order:
- `00-core.bash`: colors, history, terminal and Readline settings.
- `10-prompt.bash`: prompt, gitstatus and per-command history flushing.
- `20-greeting.bash`: calendar-day greeting and adjective selection.
- `30-integrations.bash`: shared aliases, NVM and z.lua.
- `30-integrations.bash`: interactive commands, NVM and z.lua.
- `40-status.bash`: command reminders, memory and cached package status.
- `50-completions.bash`: command-specific completion setup.
- `60-directory-notes.bash`: `TODO.md` and `.autonote.md` display after `cd`.
@ -78,5 +86,5 @@ local package transaction, Bash requests a non-blocking start of
`package-status-refresh.service`, subject to a five-minute retry backoff.
The refresh service and 30-minute timer are owned and documented by the
`systemd` repository. The Arch `update` wrapper in the `profile` repository
also requests a refresh after a successful upgrade.
`systemd` repository. The Arch `update` wrapper in this repository also
requests a refresh after a successful upgrade.