summaryrefslogtreecommitdiff
path: root/Software/xdg-user-dirs.mdwn
diff options
context:
space:
mode:
authorJoe Rayhawk <jrayhawk@freedesktop.org>2013-05-18 00:50:35 -0700
committerJoe Rayhawk <jrayhawk@freedesktop.org>2013-05-18 00:50:35 -0700
commit21564963c940b95d7f4838a856027166cc6b43f4 (patch)
tree18b0d95fb456bbf049328412c5d29332fb2fdc4f /Software/xdg-user-dirs.mdwn
parent1f8c50b5c7798083684782f7f40e7b1b8b38b6bf (diff)
Giant markdown cleanup, notably fixing preformatted text
Diffstat (limited to 'Software/xdg-user-dirs.mdwn')
-rw-r--r--Software/xdg-user-dirs.mdwn112
1 files changed, 55 insertions, 57 deletions
diff --git a/Software/xdg-user-dirs.mdwn b/Software/xdg-user-dirs.mdwn
index 4cc500f8..3529d08e 100644
--- a/Software/xdg-user-dirs.mdwn
+++ b/Software/xdg-user-dirs.mdwn
@@ -1,5 +1,3 @@
-
-
## xdg-user-dirs
xdg-user-dirs is a tool to help manage "well known" user directories like the desktop folder and the music folder. It also handles localization (i.e. translation) of the filenames.
@@ -14,11 +12,11 @@ Sysadmins can configure things by editing /etc/xdg/user-dirs.conf. At the moment
$(XDG_CONFIG_HOME)/user-dirs.dirs specifies the current set of directories for the user. This file is in a shell format, so its easy to access from a shell script. This file can also be modified by users (manually or via applications) to change the directories used. Note: To disable a directory, point it to the homedir. If you delete it it will be recreated on the next login.
Here is a shellscript example of how to find the desktop and the download directory:
-[[!format txt """
-test -f ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs && source ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs
-echo ${XDG_DESKTOP_DIR:-$HOME/Desktop}
-echo ${XDG_DOWNLOAD_DIR:-$HOME}
-"""]]
+
+ test -f ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs && source ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs
+ echo ${XDG_DESKTOP_DIR:-$HOME/Desktop}
+ echo ${XDG_DOWNLOAD_DIR:-$HOME}
+
For application code the hope is that the various desktops will integrate this and have a nice API to find these directories.
@@ -34,53 +32,53 @@ The [[Git|Infrastructure/git]] module for this code is [[xdg/xdg-user-dirs|http:
### Download
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.14.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.14.tar.gz]]
- * New translations
- * Use right permissions on ~/.config if created (0700)
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.13.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.13.tar.gz]]
- * New translations
- * Fix memory leak
- * Generate [[ChangeLog|ChangeLog]] from git
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.12.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.12.tar.gz]]
- * New translations
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.11.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.11.tar.gz]]
- * New translations
- * Change "Download" to "Downloads" by default to match other names
- * Fix bashism in xdg-user-dir
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.10.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.10.tar.gz]]
- * New translations
- * Update cut and paste code to handle oom and c++
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.9.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.9.tar.gz]]
- * New translations
- * Relocatable
- * Fix possible crash
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.8.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.8.tar.gz]]
- * Remove accidental debug spew
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.7.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.7.tar.gz]]
- * Don't recreate dirs set to $HOME
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.6.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.6.tar.gz]]
- * New translations
- * Fixed buggy printouts on --force
- * Make xdg-user-dir-lookup.c #include:able
- * Add xdg_user_dir_lookup_with_fallback to xdg-user-dir-lookup.c
- * Add docs to xdg-user-dir-lookup.c
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.5.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.5.tar.gz]]
- * New translations
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.4.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.4.tar.gz]]
- * New translations
- * fix build with external libintl
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.3.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.3.tar.gz]]
- * Create ~/.config dir if needed
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.2.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.2.tar.gz]]
- * Build fixes
- * Update user-dirs.dirs atomically
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.1.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.1.tar.gz]]
- * Add "Applications" to translations
- * Support --dummy-output to write config file elsewhere on update
- * Support --set to set a directory for the user
- * Save the locale used on initial run and forced update
- * This can be used to track changes in locale
- * [[http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.0.4.tar.gz|http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.0.4.tar.gz]]
- * Added Projects/projects to list of translated keys
- * Also support non-homedir-relative directories in user-dirs.dir.
- * This isn't recommended (as it can cause problems with e.g. shared homedirs on multiple machines), but can be useful at times. \ No newline at end of file
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.14.tar.gz>
+ * New translations
+ * Use right permissions on ~/.config if created (0700)
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.13.tar.gz>
+ * New translations
+ * Fix memory leak
+ * Generate <ChangeLog> from git
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.12.tar.gz>
+ * New translations
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.11.tar.gz>
+ * New translations
+ * Change "Download" to "Downloads" by default to match other names
+ * Fix bashism in xdg-user-dir
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.10.tar.gz>
+ * New translations
+ * Update cut and paste code to handle oom and c++
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.9.tar.gz>
+ * New translations
+ * Relocatable
+ * Fix possible crash
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.8.tar.gz>
+ * Remove accidental debug spew
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.7.tar.gz>
+ * Don't recreate dirs set to $HOME
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.6.tar.gz>
+ * New translations
+ * Fixed buggy printouts on --force
+ * Make xdg-user-dir-lookup.c #include:able
+ * Add xdg_user_dir_lookup_with_fallback to xdg-user-dir-lookup.c
+ * Add docs to xdg-user-dir-lookup.c
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.5.tar.gz>
+ * New translations
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.4.tar.gz>
+ * New translations
+ * fix build with external libintl
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.3.tar.gz>
+ * Create ~/.config dir if needed
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.2.tar.gz>
+ * Build fixes
+ * Update user-dirs.dirs atomically
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.1.tar.gz>
+ * Add "Applications" to translations
+ * Support --dummy-output to write config file elsewhere on update
+ * Support --set to set a directory for the user
+ * Save the locale used on initial run and forced update
+ * This can be used to track changes in locale
+* <http://user-dirs.freedesktop.org/releases/xdg-user-dirs-0.0.4.tar.gz>
+ * Added Projects/projects to list of translated keys
+ * Also support non-homedir-relative directories in user-dirs.dir.
+ * This isn't recommended (as it can cause problems with e.g. shared homedirs on multiple machines), but can be useful at times.