1XDG-USER-DIRS-UPD(1)             User Commands            XDG-USER-DIRS-UPD(1)
2
3
4

NAME

6       xdg-user-dirs-update - Update XDG user dir configuration
7

SYNOPSIS

9       xdg-user-dirs-update [OPTION...] [--set NAME PATH...]
10

DESCRIPTION

12       xdg-user-dirs-update updates the current state of the users
13       user-dirs.dir. If none existed before then one is created based on the
14       system default values, or falling back to the old non-translated
15       filenames if such directories exists. The list of old directories used
16       are: ~/Desktop, ~/Templates and ~/Public.
17
18       If an old configuration exists it is updated with any new default
19       directories. Additionally, any configured directories that point to
20       non-existing locations are reset by pointing then to the users home
21       directory. This typically happens when the users removed the directory,
22       so they likely don't want to use it anymore.
23
24       On the first run a user-dirs.locale file is created containing the
25       locale that was used for the translation. This is used later by GUI
26       tools like xdg-user-dirs-gtk-update to detect if the locale was
27       changed, letting you to migrate from the old names.
28
29       xdg-user-dirs-update is normally run automatically at the start of a
30       user session to update the XDG user dirs according to the users locale.
31

OPTIONS

33       The following options are understood:
34
35       --help
36           Print help output and exit.
37
38       --force
39           Update existing user-dirs.dir, but force a full reset. This means:
40           Don't reset nonexisting directories to HOME, rather recreate the
41           directory. Never use backwards compatible non-translated names.
42           Always recreate user-dirs.locale.
43
44       --dummy-output PATH
45           Write the configuration to PATH instead of the default
46           configuration file. Also, no directories are created.
47
48       --set NAME PATH
49           Sets the XDG user dir with the given name.
50
51           NAME should be one of the following:
52               DESKTOP
53               DOWNLOAD
54               TEMPLATES
55               PUBLICSHARE
56               DOCUMENTS
57               MUSIC
58               PICTURES
59               VIDEOS
60
61           PATH must be an absolute path, e.g.  $HOME/Some/Directory.
62

FILES

64       The XDG user dirs configuration is stored in the user-dirs.dir file in
65       the location pointed to by the XDG_CONFIG_HOME environment variable.
66

ENVIRONMENT

68       The XDG_CONFIG_HOME environment variable determines where the
69       user-dirs.dirs file is located.
70

SEE ALSO

72       xdg-user-dir(1), user-dirs.dirs(5), user-dirs.defaults(5), user-
73       dirs.conf(5).
74
75
76
77XDG                                                       XDG-USER-DIRS-UPD(1)
Impressum