'\" t
.\"     Title: user-dirs.conf
.\"    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\&.CONF" "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.conf \- configuration for xdg\-user\-dirs\-update
.SH "DESCRIPTION"
.PP
The
/etc/xdg/user\-dirs\&.conf
file is a text file that controls the behavior of the xdg\-user\-dirs\-update command\&. Users can have their own
~/\&.config/user\-dirs\&.conf
file, which overrides the system\-wide configuration\&.
.PP
The following keys are recognised:
.PP
enabled=\fIboolean\fR
.RS 4
When set to False, xdg\-user\-dirs\-update will not change the XDG user dirs configuration\&.
.RE
.PP
filename_encoding=\fIencoding\fR
.RS 4
This sets the filename encoding to use\&.
\fIencoding\fR
can be an explicit encoding name, such as UTF\-8, or "locale", which means the encoding of the users locale will be used\&.
.RE
.PP
Lines beginning with a # character are ignored\&.
.SH "ENVIRONMENT"
.PP
\fBXDG_CONFIG_DIRS\fR
.RS 4
The system\-wide
user\-dirs\&.conf
file is located in this directory\&. The default is
/etc/xdg\&.
.RE
.PP
\fBXDG_CONFIG_HOME\fR
.RS 4
The per\-user
user\-dirs\&.conf
file is located in this directory\&. The default is
$HOME/\&.config\&.
.RE
.SH "SEE ALSO"
.PP
\fBxdg-user-dirs-update\fR(1)