'\" t
.\"     Title: xdg-user-dirs-update
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/08/2026
.\"    Manual: User Commands
.\"    Source: XDG
.\"  Language: English
.\"
.TH "XDG\-USER\-DIRS\-UPD" "1" "04/08/2026" "XDG" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
xdg-user-dirs-update \- به‌روزرسانی پیکربندی دایرکتوری‌های کاربر XDG
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxdg\-user\-dirs\-update\fR\ 'u
\fBxdg\-user\-dirs\-update\fR [OPTION...] [\-\-set\ \fINAME\fR\ \fIPATH\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBxdg\-user\-dirs\-update\fR
وضعیت کنونی فایل
user\-dirs\&.dirs
کاربران را به‌روزرسانی می‌کند\&. اگر پیش از این چنین فایلی وجود نداشته باشد، فایلی بر اساس مقادیر پیش‌فرض سیستم ایجاد می‌شود، یا در صورت وجود چنین دایرکتوری‌هایی، از نام‌های قدیمیِ ترجمه‌نشده استفاده خواهد شد\&. فهرست دایرکتوری‌های قدیمی مورد استفاده عبارتند از:
~/Desktop،
~/Templates
و
~/Public\&.
.PP
اگر یک پیکربندی قدیمی وجود داشته باشد، با هر دایرکتوری پیش‌فرض جدیدی به‌روزرسانی می‌شود\&. علاوه بر این، هر دایرکتوری پیکربندی‌شده‌ای که به مکان‌های ناموجود اشاره دارد، با اشاره به دایرکتوری خانه (home) کاربر بازنشانی می‌شود\&. این حالت معمولاً زمانی رخ می‌دهد که کاربر دایرکتوری را حذف کرده باشد، بنابراین احتمالاً تمایلی به استفاده مجدد از آن ندارد\&.
.PP
در اولین اجرا، یک فایل
user\-dirs\&.locale
ایجاد می‌شود که حاوی محلی‌سازی (locale) استفاده‌شده برای ترجمه است\&. این فایل بعداً توسط ابزارهای گرافیکی مانند
\fBxdg\-user\-dirs\-gtk\-update\fR
استفاده می‌شود تا تغییر محلی‌سازی را تشخیص داده و امکان انتقال از نام‌های قدیمی را فراهم سازد\&.
.PP
\fBxdg\-user\-dirs\-update\fR
به طور معمول در آغاز نشست کاربر به صورت خودکار اجرا می‌شود تا دایرکتوری‌های کاربر XDG را مطابق با محلی‌سازی کاربر به‌روزرسانی کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-help\fR
.RS 4
نمایش خروجی راهنما و خروج\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
به‌روزرسانی
user\-dirs\&.dirs
موجود، اما با اجبار به بازنشانی کامل\&. این به این معناست: دایرکتوری‌های ناموجود را به HOME بازنشانی نکن، بلکه دایرکتوری را دوباره بساز\&. هرگز از نام‌های ترجمه‌نشده سازگار با نسخه‌های پیشین استفاده نکن\&. همیشه
user\-dirs\&.locale
را دوباره ایجاد کن\&.
.RE
.PP
\fB\-\-dummy\-output \fR\fB\fIPATH\fR\fR
.RS 4
نوشتن پیکربندی در
\fIPATH\fR
به جای فایل پیکربندی پیش‌فرض\&. همچنین، هیچ دایرکتوری‌ای ایجاد نمی‌شود\&.
.RE
.PP
\fB\-\-set \fR\fB\fINAME\fR\fR\fB \fR\fB\fIPATH\fR\fR
.RS 4
تنظیم دایرکتوری کاربر XDG با نام داده‌شده\&.
.sp
\fINAME\fR
باید یکی از موارد زیر باشد:
.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
.sp
\fIPATH\fR
باید یک مسیر مطلق باشد، مانند
$HOME/Some/Directory\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
پیکربندی دایرکتوری‌های کاربر XDG در فایل
user\-dirs\&.dirs
در مکانی که توسط متغیر محیطی
\fBXDG_CONFIG_HOME\fR
مشخص می‌شود، ذخیره می‌گردد\&.
.SH "محیط (ENVIRONMENT)"
.PP
متغیر محیطی
\fBXDG_CONFIG_HOME\fR
تعیین می‌کند که فایل
user\-dirs\&.dirs
در کجا قرار دارد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBxdg-user-dir\fR(1),
\fBuser-dirs.dirs\fR(5),
\fBuser-dirs.defaults\fR(5),
\fBuser-dirs.conf\fR(5)\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBAlexander Larsson\fR <\&alexl@redhat\&.com\&>
.RS 4
توسعه‌دهنده
.RE