ivuorinen/dotfiles
1
0
Fork 0
mirror of https://github.com/ivuorinen/dotfiles.git synced 2026-02-24 08:56:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore(docs): rework readme

Browse Source
This commit is contained in:
Ismo Vuorinen
2023-08-11 10:20:24 +03:00
parent e46dadb128
commit 90bc744d51
1 changed files with 46 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
.github/README.md vendored
View File

@@ -68,27 +68,50 @@ The folder structure follows [XDG Base Directory Specification][xdg] where possi
| `$XDG_DATA_HOME` | `$HOME/.local/share` | User-specific data files | | `$XDG_DATA_HOME` | `$HOME/.local/share` | User-specific data files |
| `$XDG_STATE_HOME` | `$HOME/.local/state` | App state that should persist between restarts | | `$XDG_STATE_HOME` | `$HOME/.local/state` | App state that should persist between restarts |
- `$XDG_BIN_HOME` defines directory that contains local binaries. #### XDG_BIN_HOME (`$HOME/.local/bin`)
- `$XDG_DATA_HOME` defines the base directory relative to which user-specific data
files should be stored. `$XDG_BIN_HOME` defines directory that contains local binaries.
- If `$XDG_DATA_HOME` is either not set or empty, a default equal to
`$HOME/.local/share` should be used. User-specific executable files may be stored in `$HOME/.local/bin`.
- `$XDG_CONFIG_HOME` defines the base directory relative to which user-specific Distributions should ensure this directory shows up in the UNIX `$PATH`
configuration files should be stored. environment variable, at an appropriate place.
- If `$XDG_CONFIG_HOME` is either not set or empty, a default equal to `$HOME/.config` should be used.
- `$XDG_STATE_HOME` defines the base directory relative #### XDG_DATA_HOME (`$HOME/.local/share`)
to which user-specific state files should be stored.
- If `$XDG_STATE_HOME` is either not set or empty, a default equal to `$HOME/.local/state` should be used. `$XDG_DATA_HOME` defines the base directory relative to which
- The `$XDG_STATE_HOME` contains state data that should persist between (application) restarts, user-specific *data files* should be stored.
but that is not important or portable enough to the user that it should be stored in `$XDG_DATA_HOME`.
If `$XDG_DATA_HOME` is either not set or empty,
a default equal to `$HOME/.local/share` should be used.
#### XDG_CONFIG_HOME (`$HOME/.config`)
`$XDG_CONFIG_HOME` defines the base directory relative to which
user-specific *configuration files* should be stored.
If `$XDG_CONFIG_HOME` is either not set or empty,
a default equal to `$HOME/.config` should be used.
#### XDG_STATE_HOME (`$HOME/.local/state`)
`$XDG_STATE_HOME` defines the base directory relative to which
user-specific *state files* should be stored.
If `$XDG_STATE_HOME` is either not set or empty,
a default equal to `$HOME/.local/state` should be used.
The `$XDG_STATE_HOME` contains *state data* that should
*persist between (application) restarts*, but that is not important or
portable enough to the user that it should be stored in `$XDG_DATA_HOME`.
- It may contain: - It may contain:
- actions history (logs, history, recently used files, …) - actions history (logs, history, recently used files, …)
- current state of the application that can be reused - current state of the application that can be reused
on a restart (view, layout, open files, undo history, …) on a restart (view, layout, open files, undo history, …)
- User-specific executable files may be stored in `$HOME/.local/bin`.
Distributions should ensure this directory shows up in the UNIX `$PATH` #### XDG_DATA_DIRS
environment variable, at an appropriate place.
- `$XDG_DATA_DIRS` defines the preference-ordered set of base directories `$XDG_DATA_DIRS` defines the preference-ordered set of base directories
to search for data files in addition to the `$XDG_DATA_HOME` base directory. to search for data files in addition to the `$XDG_DATA_HOME` base directory.
The directories in `$XDG_DATA_DIRS` should be seperated with a colon ':'. The directories in `$XDG_DATA_DIRS` should be seperated with a colon ':'.