aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorPatrick Spek <p.spek@tyil.nl>2023-01-23 11:51:16 +0100
committerPatrick Spek <p.spek@tyil.nl>2023-01-23 11:51:16 +0100
commit4f4d42bb8794e19f0c5be39ee341f919e13f59f0 (patch)
tree07bfe2d93599d05d5855675cd0a50a3591b8ff91 /README.md
parent590bd304e39eb0c3c4067a8b9a8021a603b9ea62 (diff)
Merge v0.2.0 sourcesv0.2.0
Diffstat (limited to 'README.md')
-rw-r--r--README.md89
1 files changed, 89 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5ca1652
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+### sub xdg-config-dirs
+
+```perl6
+sub xdg-config-dirs(
+ Bool:D :$home = Bool::True
+) returns Iterable
+```
+
+Retrieve the value of XDG_CONFIG_DIRS as a sequence of IO::Path objects. If this variable is not set, it will use the default value of /etc/xdg. These directories should be read in order to retrieve configuration files.
+
+class Bool:D :$home = Bool::True
+--------------------------------
+
+When set to true, this sequence will start with the XDG_CONFIG_HOME value (or its default).
+
+### sub xdg-config-home
+
+```perl6
+sub xdg-config-home() returns IO::Path
+```
+
+Returns an IO::Path for $XDG_CONFIG_HOME, if it exists as environment variable. Otherwise, return the default value, $HOME/.config. This directory should contain user-specific configuration files.
+
+### sub xdg-cache-home
+
+```perl6
+sub xdg-cache-home() returns IO::Path
+```
+
+Returns an IO::Path for $XDG_CACHE_HOME, if it exists as environment variable. Otherwise, return the default value, $HOME/.cache. This directory should contain user-specific, non-essential (cached) data.
+
+### sub xdg-data-dirs
+
+```perl6
+sub xdg-data-dirs(
+ Bool:D :$home = Bool::True
+) returns Iterable
+```
+
+Retrieve the value of XDG_DATA_DIRS as a sequence of IO::Path objects. If this variable is not set, it will use the default values of /usr/local/share and /usr/share. These directories should be read in order to retrieve user specific data files.
+
+class Bool:D :$home = Bool::True
+--------------------------------
+
+When set to true, this sequence will start with the XDG_DATA_HOME value (or its default).
+
+### sub xdg-data-home
+
+```perl6
+sub xdg-data-home() returns IO::Path
+```
+
+Returns an IO::Path for $XDG_DATA_HOME, if it exists as environment variable. Otherwise, return the default value, $HOME/.local/share. This directory should contain user-specific data files.
+
+### sub xdg-runtime-dir
+
+```perl6
+sub xdg-runtime-dir() returns IO::Path
+```
+
+Returns an IO::Path for $XDG_RUNTIME_DIR, if it exists as environment variable. Otherwise, return an IO::Path to a temporary directory. This directory should contain user-specific runtime files and other file objects.
+
+NAME
+====
+
+IO::Path::XDG
+
+AUTHOR
+======
+
+Patrick Spek <p.spek@tyil.work>
+
+VERSION
+=======
+
+0.2.0
+
+Synopsis
+========
+
+Description
+===========
+
+Examples
+========
+
+See also
+========
+