'\" t
.\"     Title: user-dirs.dirs
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 12/28/2018
.\"    Manual: File Formats
.\"    Source: XDG
.\"  Language: English
.\"
.TH "USER\-DIRS\&.DIRS" "5" "" "XDG" "File Formats"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
user-dirs.dirs \- settings for XDG user dirs
.SH "DESCRIPTION"
.PP
The
$HOME/\&.config/user\-dirs\&.dirs
file is a text file that contains the user\-specific values for the XDG user dirs\&. It is created and updated by the xdg\-user\-dirs\-update command\&.
.PP
This file contains lines of the form
.sp
.if n \{\
.RS 4
.\}
.nf
XDG_\fINAME\fR_DIR=\fIVALUE\fR
.fi
.if n \{\
.RE
.\}
.PP
The following names are recognised:
.RS 4
DESKTOP
.RE
.RS 4
DOWNLOAD
.RE
.RS 4
TEMPLATES
.RE
.RS 4
PUBLICSHARE
.RE
.RS 4
DOCUMENTS
.RE
.RS 4
MUSIC
.RE
.RS 4
PICTURES
.RE
.RS 4
VIDEOS
.RE
.PP
\fIVALUE\fR
must be of the form "$HOME/Path" or "/Path"\&.
.PP
Lines beginning with a # character are ignored\&.
.PP
The format of
user\-dirs\&.dirs
is designed to allow direct sourcing of this file in shell scripts\&.
.SH "ENVIRONMENT"
.PP
\fBXDG_CONFIG_DIRS\fR
.RS 4
The
user\-dirs\&.defaults
file is located in this directory\&. The default is
/etc/xdg\&.
.RE
.SH "SEE ALSO"
.PP
\fBxdg-user-dirs-update\fR(1)