.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "TLMGR 1" .TH TLMGR 1 2025-05-13 "perl v5.42.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" tlmgr \- ابزار بومی مدیریت TeX Live .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" tlmgr [\fIoption\fR...] \fIaction\fR [\fIoption\fR...] [\fIoperand\fR...] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBtlmgr\fR یک نصب موجود از TeX Live را مدیریت می‌کند؛ هم بسته‌ها و هم گزینه‌های پیکربندی را. برای کسب اطلاعات دربارهٔ بارگیری اولیه و نصب TeX Live، به مراجعه کنید. .PP به‌روزترین نسخهٔ این مستندات (که به‌صورت شبانه از مخازن توسعه به‌روز می‌شود) در نشانی به همراه دستورالعمل‌های به‌روزرسانی خود \&\f(CW\*(C`tlmgr\*(C'\fR و اطلاعات دربارهٔ نسخه‌های آزمایشی در دسترس است. .PP سامانهٔ TeX Live در چندین \fIscheme\fR (طرح) سطح‌بالا سازمان‌دهی شده است که هر کدام به‌صورت مجموعه‌ای متفاوت از \fIcollection\fRها و \fIpackage\fRها مشخص شده‌اند؛ به این صورت که هر مجموعه (collection) دسته‌ای از بسته‌ها است و بسته چیزی است که فایل‌های واقعی را در بر دارد. طرح‌ها معمولاً شامل ترکیبی از مجموعه‌ها و بسته‌ها هستند، اما هر بسته دقیقاً و تنها در یک مجموعه گنجانده شده است، نه بیشتر و نه کمتر. یک نصب TeX Live را می‌توان در هر سطحی سفارشی‌سازی و مدیریت کرد. .PP برای مشاهدهٔ تمامی مستندات در دسترس TeX Live، به مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" پس از نصب موفقیت‌آمیز TeX Live، در اینجا چند عملیات متداول با \f(CW\*(C`tlmgr\*(C'\fR آورده شده است: .ie n .IP """tlmgr option repository ctan""" 4 .el .IP "\f(CWtlmgr option repository ctan\fR" 4 .IX Item "tlmgr option repository ctan" .PD 0 .ie n .IP """tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet""" 4 .el .IP "\f(CWtlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet\fR" 4 .IX Item "tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet" .PD به \f(CW\*(C`tlmgr\*(C'\fR اعلام می‌کند که برای به‌روزرسانی‌های آتی از یک آینهٔ (mirror) نزدیک CTAN استفاده کند؛ این کار زمانی مفید است که TeX Live را از تصویر DVD نصب کرده‌اید و می‌خواهید به‌روزرسانی‌های مداوم داشته باشید. این دو دستور معادل یکدیگرند؛ \f(CW\*(C`ctan\*(C'\fR صرفاً یک نام مستعار برای نشانی اینترنتی ارائه‌شده است. .Sp هشدار: \f(CW\*(C`mirror.ctan.org\*(C'\fR به میزبان‌های متعددی نگاشت می‌شود و این میزبان‌ها کاملاً با یکدیگر همگام نیستند؛ توصیه می‌کنیم به‌روزرسانی را حداکثر به‌صورت روزانه انجام دهید و نه بیشتر از آن. در صورت بروز مشکل می‌توانید یک آینهٔ خاص را انتخاب کنید؛ فهرست تمام آینه‌های CTAN به همراه وضعیت هر یک در در دسترس است. .ie n .IP """tlmgr update \-\-list""" 4 .el .IP "\f(CWtlmgr update \-\-list\fR" 4 .IX Item "tlmgr update --list" بدون اعمال هیچ‌گونه تغییر واقعی، گزارش می‌دهد که چه مواردی به‌روزرسانی خواهند شد. .ie n .IP """tlmgr update \-\-all""" 4 .el .IP "\f(CWtlmgr update \-\-all\fR" 4 .IX Item "tlmgr update --all" نصب محلی TeX شما را با آنچه در مخزن بسته‌ها موجود است هماهنگ و منطبق می‌سازد (معمولاً هنگام به‌روزرسانی از CTAN کاربرد دارد). .ie n .IP """tlmgr info"" \fIwhat\fR" 4 .el .IP "\f(CWtlmgr info\fR \fIwhat\fR" 4 .IX Item "tlmgr info what" اطلاعات تفصیلی دربارهٔ یک بسته با نام \fIwhat\fR نظیر وضعیت نصب و شرح آن را نمایش می‌دهد، یا به جستجوی \fIwhat\fR در میان تمامی بسته‌ها می‌پردازد. .ie n .IP """tlmgr bug"" \fIwhat\fR" 4 .el .IP "\f(CWtlmgr bug\fR \fIwhat\fR" 4 .IX Item "tlmgr bug what" اطلاعات موجود برای گزارش اشکال (bug) مربوط به \fIwhat\fR (که نام یک بسته یا فایل است) را نمایش می‌دهد. .PP برای آگاهی از تمام قابلیت‌ها و جزئیات دقیق \f(CW\*(C`tlmgr\*(C'\fR، لطفاً توضیحات تفصیلی زیر را مطالعه فرمایید..SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" گزینه‌های زیر برای \f(CW\*(C`tlmgr\*(C'\fR گزینه‌های سراسری هستند و به هیچ عملیات خاصی اختصاص ندارند. تمام گزینه‌ها، چه سراسری و چه مختص به یک عملیات، می‌توانند در هر کجای خط فرمان و به هر ترتیبی مشخص شوند. نخستین آرگومان غیرگزینه‌ای، عملیات اصلی خواهد بود. در تمام موارد، \&\f(CW\*(C`\-\-\*(C'\fR\fIoption\fR و \f(CW\*(C`\-\*(C'\fR\fIoption\fR معادل یکدیگرند و قرار دادن \f(CW\*(C`=\*(C'\fR میان نام گزینه و مقدار آن اختیاری است. .IP "\fB\-\-repository\fR \fIurl|path\fR" 4 .IX Item "--repository url|path" مخزن بسته‌ای را مشخص می‌کند که بسته‌ها باید از آن نصب یا به‌روزرسانی شوند؛ این مخزن می‌تواند مانند موارد زیر، یک دایرکتوری محلی یا مکانی در شبکه باشد. این گزینه بر مخزن بسته پیش‌فرض که در پایگاه‌داده بسته TeX Live نصب قرار دارد (که با نام TLPDB نیز شناخته می‌شود و به‌طور کامل در فایل \f(CW\*(C`tlpkg/texlive.tlpdb\*(C'\fR ارائه شده است) اولویت دارد. .Sp این گزینه \f(CW\*(C`\-\-repository\*(C'\fR مکان را فقط برای اجرای فعلی تغییر می‌دهد؛ برای اعمال یک تغییر دائمی، از \f(CW\*(C`option repository\*(C'\fR استفاده کنید (عملیات «option» را ببینید). .Sp به عنوان مثال، می‌توانید یک آینه خاص CTAN را با دستوری شبیه به این انتخاب کنید: .Sp .Vb 1 \& \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet .Ve .Sp البته باید یک نام میزبان واقعی و دایرکتوری سطح بالای خاص CTAN آن مشخص شود. فهرست آینه‌های CTAN در در دسترس است. .Sp این هم نمونه‌ای از استفاده از یک دایرکتوری محلی: .Sp .Vb 1 \& \-repository /local/TL/repository .Ve .Sp برای سازگاری با نسخه‌های پیشین و راحتی کار، \f(CW\*(C`\-\-location\*(C'\fR و \f(CW\*(C`\-\-repo\*(C'\fR نیز به عنوان نام‌های مستعار این گزینه پذیرفته می‌شوند. .Sp مکان‌ها را می‌توان به صورت هر یک از موارد زیر مشخص کرد: .RS 4 .ie n .IP """/some/local/dir""" 4 .el .IP \f(CW/some/local/dir\fR 4 .IX Item "/some/local/dir" .PD 0 .ie n .IP """file:/some/local/dir""" 4 .el .IP \f(CWfile:/some/local/dir\fR 4 .IX Item "file:/some/local/dir" .PD روش‌های معادل برای تعیین یک دایرکتوری محلی. .ie n .IP """ctan""" 4 .el .IP \f(CWctan\fR 4 .IX Item "ctan" .PD 0 .ie n .IP """https://mirror.ctan.org/systems/texlive/tlnet""" 4 .el .IP \f(CWhttps://mirror.ctan.org/systems/texlive/tlnet\fR 4 .IX Item "https://mirror.ctan.org/systems/texlive/tlnet" .PD انتخاب خودکار یک آینه CTAN، با تلاش برای برگزیدن موردی که هم نزدیک‌تر و هم به‌روز باشد. آینه انتخاب‌شده برای کل بارگیری استفاده می‌شود. عبارت ساده‌ی \f(CW\*(C`ctan\*(C'\fR صرفاً یک نام مستعار برای URL کامل است. (برای اطلاعات بیشتر درباره CTAN و آینه‌های آن، را ببینید.) .ie n .IP """http://server/path/to/tlnet""" 4 .el .IP \f(CWhttp://server/path/to/tlnet\fR 4 .IX Item "http://server/path/to/tlnet" پروتکل استاندارد HTTP. اگر از روش (پیش‌فرض) LWP استفاده شود، اتصالات پایدار پشتیبانی می‌شوند. TL همچنین می‌تواند برای انجام بارگیری‌ها از \f(CW\*(C`curl\*(C'\fR یا \f(CW\*(C`wget\*(C'\fR، یا هر برنامه دلخواه دیگری که توسط کاربر تعیین شده استفاده کند، همان‌طور که در مستندات \f(CW\*(C`tlmgr\*(C'\fR در () شرح داده شده است. .ie n .IP """https://server/path/to/tlnet""" 4 .el .IP \f(CWhttps://server/path/to/tlnet\fR 4 .IX Item "https://server/path/to/tlnet" مجدداً، اگر از روش (پیش‌فرض) LWP استفاده شود، از اتصالات پایدار پشتیبانی می‌کند. متأسفانه برخی نسخه‌های \f(CW\*(C`wget\*(C'\fR و \f(CW\*(C`curl\*(C'\fR از https پشتیبانی نمی‌کنند، و حتی زمانی که \f(CW\*(C`wget\*(C'\fR از https پشتیبانی می‌کند، ممکن است به دلیل نبود گواهی‌های ریشه محلی، گواهی‌ها رد شوند حتی اگر گواهی کاملاً معتبر باشد. ساده‌ترین راه‌حل برای این مشکل، استفاده از http یا ftp است. .ie n .IP """ftp://server/path/to/tlnet""" 4 .el .IP \f(CWftp://server/path/to/tlnet\fR 4 .IX Item "ftp://server/path/to/tlnet" اگر از روش (پیش‌فرض) LWP استفاده شود، اتصالات پایدار پشتیبانی می‌شوند. .ie n .IP """user@machine:/path/to/tlnet""" 4 .el .IP \f(CWuser@machine:/path/to/tlnet\fR 4 .IX Item "user@machine:/path/to/tlnet" .PD 0 .ie n .IP """scp://user@machine/path/to/tlnet""" 4 .el .IP \f(CWscp://user@machine/path/to/tlnet\fR 4 .IX Item "scp://user@machine/path/to/tlnet" .ie n .IP """ssh://user@machine/path/to/tlnet""" 4 .el .IP \f(CWssh://user@machine/path/to/tlnet\fR 4 .IX Item "ssh://user@machine/path/to/tlnet" .PD این قالب‌ها معادل یکدیگر هستند؛ همگی برای انتقال فایل‌ها از \f(CW\*(C`scp\*(C'\fR استفاده می‌کنند. استفاده از \f(CW\*(C`ssh\-agent\*(C'\fR توصیه می‌شود. (اطلاعات بیشتر: ، .) .RE .RS 4 .Sp اگر مخزن روی شبکه باشد، نویسه‌های پایانی \f(CW\*(C`/\*(C'\fR و/یا بخش‌های پایانی \f(CW\*(C`/tlpkg\*(C'\fR و/یا \f(CW\*(C`/archive\*(C'\fR نادیده گرفته می‌شوند. .RE .IP "\fB\-\-gui\fR [\fIaction\fR]" 4 .IX Item "--gui [action]" دو رابط گرافیکی برجسته برای \f(CW\*(C`tlmgr\*(C'\fR، یعنی \f(CW\*(C`tlshell\*(C'\fR و \f(CW\*(C`tlcockpit\*(C'\fR، به عنوان برنامه‌هایی جداگانه راه‌اندازی می‌شوند؛ مستندات اختصاصی آن‌ها را ببینید. .Sp خود \f(CW\*(C`tlmgr\*(C'\fR نیز علاوه بر رابط خط فرمان، دارای یک رابط گرافیکی است. شما می‌توانید گزینه فراخوانی آن، \f(CW\*(C`\-\-gui\*(C'\fR را به همراه یک عملیات مشخص کنید تا مستقیماً به صفحه مربوط به همان عملیات در رابط گرافیکی هدایت شوید. به عنوان مثال، اجرای: .Sp .Vb 1 \& tlmgr \-\-gui update .Ve .Sp شما را مستقیماً وارد صفحه به‌روزرسانی می‌کند. اگر هیچ عملیاتی مشخص نشود، رابط گرافیکی در صفحه اصلی باز خواهد شد. بخش «GUI FOR TLMGR» را ببینید. .Sp با این حال، رابط گرافیکی بومی نیازمند Perl/TK است که دیگر در توزیع پرل TeX Live برای ویندوز گنجانده نشده است. ممکن است کار با \f(CW\*(C`tlshell\*(C'\fR یا \f(CW\*(C`tlcockpit\*(C'\fR برایتان آسان‌تر باشد. .IP "\fB\-\-gui\-lang\fR \fIllcode\fR" 4 .IX Item "--gui-lang llcode" به‌طور پیش‌فرض، رابط گرافیکی تلاش می‌کند زبان شما را از محیط استنباط کند (در ویندوز از طریق رجیستری و در یونیکس از طریق \f(CW\*(C`LC_MESSAGES\*(C'\fR). در صورت عدم موفقیت، می‌توانید با مشخص کردن این گزینه به همراه یک کد زبان (بر اساس ISO 639\-1)، زبان متفاوتی را انتخاب کنید. زبان‌هایی که در حال حاضر پشتیبانی می‌شوند (اما لزوماً ترجمه کامل ندارند) عبارتند از: انگلیسی\ (en،\ پیش‌فرض)، چکی\ (cs)، آلمانی\ (de)، فرانسوی\ (fr)، ایتالیایی\ (it)، ژاپنی\ (ja)، هلندی\ (nl)، لهستانی\ (pl)، پرتغالی\ برزیلی\ (pt_BR)، روسی\ (ru)، اسلواکی\ (sk)، اسلوونیایی\ (sl)، صربی\ (sr)، اوکراینی\ (uk)، ویتنامی\ (vi)، چینی\ ساده‌شده\ (zh_CN) و چینی\ سنتی\ (zh_TW). .Sp برنامه tlshell کاتالوگ پیام‌های خود را با tlmgr به اشتراک می‌گذارد. .IP "\fB\-\-command\-logfile\fR \fIfile\fR" 4 .IX Item "--command-logfile file" برنامه \f(CW\*(C`tlmgr\*(C'\fR خروجی تمام برنامه‌های فراخوانی‌شده (mktexlr، mtxrun، fmtutil، updmap) را در یک فایل لاگ جداگانه ثبت می‌کند که به‌طور پیش‌فرض \f(CW\*(C`TEXMFSYSVAR/web2c/tlmgr\-commands.log\*(C'\fR است. این گزینه به شما امکان می‌دهد فایل متفاوتی را برای ثبت وقایع مشخص کنید. .IP \fB\-\-debug\-translation\fR 4 .IX Item "--debug-translation" در حالت گرافیکی، این سوئیچ به \f(CW\*(C`tlmgr\*(C'\fR اعلام می‌کند که هر پیام ترجمه‌نشده (یا مفقود) را به خروجی خطای استاندارد گزارش دهد. این کار می‌تواند به مترجمان کمک کند تا ببینند چه مواردی هنوز باقی مانده است. .IP \fB\-\-machine\-readable\fR 4 .IX Item "--machine-readable" به جای خروجی معمول که برای استفاده انسان است، قالبی ثابت و مناسب‌تر برای تجزیه توسط ماشین (در خروجی استاندارد) می‌نویسد. بخش «MACHINE\-READABLE OUTPUT» را در ادامه ببینید. .IP \fB\-\-no\-execute\-actions\fR 4 .IX Item "--no-execute-actions" مانع اجرای عملیات‌های اجرایی مشخص‌شده در فایل‌های tlpsrc می‌شود. مگر اینکه قصد داشته باشید پس‌پردازش را خودتان انجام دهید (همانند کاری که برای مثال \f(CW\*(C`install\-tl\*(C'\fR انجام می‌دهد)، این گزینه نباید مشخص شود. در غیر این صورت، در کنار مشکلات دیگر، فایل‌های فرمت و پایگاه‌داده نام فایل‌ها کهنه و نامعتبر خواهند شد. .IP "\fB\-\-package\-logfile\fR \fIfile\fR" 4 .IX Item "--package-logfile file" برنامه \f(CW\*(C`tlmgr\*(C'\fR تمام عملیات بسته‌ها (نصب، حذف، به‌روزرسانی، به‌روزرسانی‌های ناموفق، بازگردانی‌های ناموفق) را در یک فایل لاگ جداگانه ثبت می‌کند که به‌طور پیش‌فرض \f(CW\*(C`TEXMFSYSVAR/web2c/tlmgr.log\*(C'\fR است. این گزینه به شما اجازه می‌دهد فایل متفاوتی را برای ثبت این وقایع تعیین کنید. .IP \fB\-\-pause\fR 4 .IX Item "--pause" این گزینه باعث می‌شود \f(CW\*(C`tlmgr\*(C'\fR پیش از خروج، منتظر ورودی کاربر بماند. این ویژگی در ویندوز برای جلوگیری از بسته شدن ناگهانی پنجره اعلان فرمان مفید است. .IP \fB\-\-persistent\-downloads\fR 4 .IX Item "--persistent-downloads" .PD 0 .IP \fB\-\-no\-persistent\-downloads\fR 4 .IX Item "--no-persistent-downloads" .PD برای نصب‌های مبتنی بر شبکه، این گزینه (که به‌طور پیش‌فرض فعال است) باعث می‌شود \f(CW\*(C`tlmgr\*(C'\fR تلاش کند یک اتصال پایدار (با استفاده از ماژول پرل \f(CW\*(C`LWP\*(C'\fR) برقرار کند. ایده اصلی این است که در هر نشست تنها یک اتصال بین رایانه شما و سرور باز شده و مجدداً استفاده شود، به جای اینکه برای هر بسته یک بارگیری جدید آغاز گردد. .Sp اگر این کار مقدور نباشد، \f(CW\*(C`tlmgr\*(C'\fR به عنوان راهکار جایگزین به استفاده از \f(CW\*(C`wget\*(C'\fR روی می‌آورد. برای غیرفعال کردن این اتصالات پایدار، از \f(CW\*(C`\-\-no\-persistent\-downloads\*(C'\fR استفاده کنید. .IP \fB\-\-pin\-file\fR 4 .IX Item "--pin-file" مکان فایل پین‌کردن را از \f(CW\*(C`TEXMFLOCAL/tlpkg/pinning.txt\*(C'\fR تغییر می‌دهد (بخش «Pinning» را در ادامه ببینید). این مورد تنها برای کامل بودن مستندات ذکر شده است، چرا که فقط در عیب‌یابی کاربرد دارد. .IP \fB\-\-usermode\fR 4 .IX Item "--usermode" حالت کاربر را برای این اجرای \f(CW\*(C`tlmgr\*(C'\fR فعال می‌کند؛ بخش «USER MODE» را در ادامه ببینید. .IP "\fB\-\-usertree\fR \fIdir\fR" 4 .IX Item "--usertree dir" در حالت کاربر، از \fIdir\fR برای درخت استفاده می‌کند؛ بخش «USER MODE» را در ادامه ببینید. .IP \fB\-\-verify\-repo=[none|main|all]\fR 4 .IX Item "--verify-repo=[none|main|all]" سطح اعتبارسنجی انجام‌شده را مشخص می‌کند: اگر \f(CW\*(C`none\*(C'\fR تعیین شود، هیچ‌گونه اعتبارسنجی صورت نمی‌گیرد. اگر \f(CW\*(C`main\*(C'\fR داده شود و فایل دودویی فعال GnuPG (\f(CW\*(C`gpg\*(C'\fR) در دسترس باشد، تمام مخازن بررسی می‌شوند، اما فقط مخزن اصلی باید امضا شده باشد. اگر \f(CW\*(C`all\*(C'\fR تعیین شود، آنگاه تمام مخازن باید دارای امضا باشند. برای جزئیات، بخش «CRYPTOGRAPHIC VERIFICATION» را در ادامه ببینید..PP گزینه‌های استاندارد برنامه‌های TeX Live نیز پذیرفته می‌شوند: \&\f(CW\*(C`\-\-help/\-h/\-?\*(C'\fR، \f(CW\*(C`\-\-version\*(C'\fR، \f(CW\*(C`\-q\*(C'\fR (بدون پیام‌های اطلاعاتی)، \f(CW\*(C`\-v\*(C'\fR (پیام‌های اشکال‌زدایی، می‌تواند تکرار شود). برای جزئیات در مورد این موارد، به مستندات \f(CW\*(C`TeXLive::TLUtils\*(C'\fR مراجعه کنید. .PP گزینهٔ \f(CW\*(C`\-\-version\*(C'\fR اطلاعات نسخهٔ انتشار TeX Live و خود اسکریپت \&\f(CW\*(C`tlmgr\*(C'\fR را نشان می‌دهد. اگر \f(CW\*(C`\-v\*(C'\fR نیز داده شود، شمارهٔ بازبینی ماژول‌های پرل بارگذاری‌شدهٔ TeX Live نیز نمایش داده می‌شود. .SH "عملیات‌ها (ACTIONS)" .IX Header "ACTIONS" .SS help .IX Subsection "help" نمایش این اطلاعات راهنما و خروج (مشابه \f(CW\*(C`\-\-help\*(C'\fR، و روی وب در ). گاهی اوقات برنامه‌های \f(CW\*(C`perldoc\*(C'\fR یا \f(CW\*(C`PAGER\*(C'\fR روی سیستم دچار مشکل می‌شوند که منجر به چاپ مستقیم نویسه‌های کنترلی در خروجی می‌گردد. این وضعیت همیشه قابل تشخیص نیست، اما می‌توانید متغیر محیطی \f(CW\*(C`NOPERLDOC\*(C'\fR را تنظیم کنید تا از \f(CW\*(C`perldoc\*(C'\fR استفاده نشود. .SS version .IX Subsection "version" اطلاعات نسخه را ارائه می‌دهد (مشابه \f(CW\*(C`\-\-version\*(C'\fR). .PP اگر \f(CW\*(C`\-v\*(C'\fR داده شده باشد، بازبینی‌های ماژول‌های استفاده‌شده نیز گزارش می‌شوند. .SS backup .IX Subsection "backup" .IP "\fBbackup [\fR\f(BIoption\fR\fB...] \-\-all\fR" 4 .IX Item "backup [option...] --all" .PD 0 .IP "\fBbackup [\fR\f(BIoption\fR\fB...] \fR\f(BIpkg\fR\fB...\fR" 4 .IX Item "backup [option...] pkg..." .PD اگر گزینهٔ \f(CW\*(C`\-\-clean\*(C'\fR مشخص نشده باشد، این عملیات از بسته‌های مشخص‌شده، یا با دادن \f(CW\*(C`\-\-all\*(C'\fR از تمامی بسته‌ها نسخهٔ پشتیبان تهیه می‌کند. این نسخه‌های پشتیبان در مقدار گزینهٔ \f(CW\*(C`\-\-backupdir\*(C'\fR، در صورتی که دایرکتوری موجود و قابل‌نوشتن باشد، ذخیره می‌شوند. اگر \f(CW\*(C`\-\-backupdir\*(C'\fR داده نشود، تنظیم گزینهٔ \f(CW\*(C`backupdir\*(C'\fR در TLPDB در صورت وجود استفاده می‌شود. اگر هر دو غایب باشند، هیچ پشتیبانی گرفته نمی‌شود. (نصب‌کننده \f(CW\*(C`backupdir\*(C'\fR را روی \&\f(CW\*(C`.../tlpkg/backups\*(C'\fR در زیر دایرکتوری ریشهٔ نصب TL تنظیم می‌کند، بنابراین معمولاً تعریف شده است؛ برای اطلاعات بیشتر توضیحات «option» را ببینید.) .Sp اگر گزینهٔ \f(CW\*(C`\-\-clean\*(C'\fR مشخص شود، پشتیبان‌ها به جای ذخیره شدن، پاکسازی (حذف) می‌شوند. مقدار عدد صحیح اختیاری \fIN\fR می‌تواند برای تعیین تعداد پشتیبان‌هایی که هنگام پاکسازی نگه داشته می‌شوند مشخص شود. اگر \f(CW\*(C`N\*(C'\fR داده نشود، مقدار گزینهٔ \f(CW\*(C`autobackup\*(C'\fR استفاده می‌شود. اگر هر دو غایب باشند، خطایی صادر می‌شود. برای جزئیات بیشتر دربارهٔ پاکسازی پشتیبان‌ها، عملیات \f(CW\*(C`option\*(C'\fR را ببینید. .Sp گزینه‌ها: .RS 4 .IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 .IX Item "--backupdir directory" تنظیم گزینهٔ \f(CW\*(C`backupdir\*(C'\fR در TLPDB را بازنویسی می‌کند. آرگومان \fIdirectory\fR الزامی است و باید یک دایرکتوری موجود و قابل‌نوشتن را که پشتیبان‌ها در آن قرار می‌گیرند مشخص کند. .IP \fB\-\-all\fR 4 .IX Item "--all" اگر \f(CW\*(C`\-\-clean\*(C'\fR مشخص نشده باشد، از تمامی بسته‌ها در نصب TeX Live پشتیبان تهیه می‌کند؛ این کار زمان و فضای زیادی خواهد برد. اگر \&\f(CW\*(C`\-\-clean\*(C'\fR مشخص شده باشد، تمامی بسته‌ها پاکسازی می‌شوند. .IP \fB\-\-clean\fR[=\fIN\fR] 4 .IX Item "--clean[=N]" به جای پشتیبان‌گیری، همان‌طور که در بالا توضیح داده شد، دایرکتوری پشتیبان را از پشتیبان‌های قدیمی پاکسازی می‌کند. آرگومان اختیاری عدد صحیح \fIN\fR گزینهٔ \&\f(CW\*(C`autobackup\*(C'\fR تنظیم‌شده در TLPDB را بازنویسی می‌کند. بنا به نیاز، باید از \f(CW\*(C`\-\-all\*(C'\fR یا فهرستی از بسته‌ها همراه با این گزینه استفاده کنید. .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل چیزی پشتیبان‌گیری یا حذف نمی‌شود؛ در عوض، عملیاتی که باید انجام شوند در پایانه نوشته می‌شوند. .RE .RS 4 .RE .SS "bug [\fIsearch\-string\fP]" .IX Subsection "bug [search-string]" عبارت \fIsearch\-string\fR را (در صورت عدم ارائه، پرسیده می‌شود) به عنوان نام بسته و در توضیحات بسته به صورت کلمات کامل، و در نام‌فایل‌ها به عنوان هر زیررشته‌ای جستجو می‌کند، و گزارش اشکال و سایر اطلاعات مربوط به بستهٔ انتخاب‌شده از میان نتایج را خروجی می‌دهد. .PP این جستجو معادل \f(CW\*(C`tlmgr search \-\-word \-\-file\*(C'\fR \fIsearch\-string\fR است. بنابراین، \fIsearch\-string\fR به عنوان یک عبارت باقاعده (Perl) تفسیر می‌شود. .SS "candidates \fIpkg\fP" .IX Subsection "candidates pkg" مخازن کاندیدای موجود برای بستهٔ \fIpkg\fR را نشان می‌دهد. بخش «MULTIPLE REPOSITORIES» را در زیر ببینید. .SS "check [\fIoption\fP...] [depends|executes|files|runfiles|texmfdbs|all]" .IX Subsection "check [option...] [depends|executes|files|runfiles|texmfdbs|all]" یک (یا تمام) بررسی‌های مربوط به یکپارچگی نصب را اجرا می‌کند. اگر مشکلی یافت نشود، هیچ خروجی وجود نخواهد داشت. (برای دیدن آنچه در حال انجام است، \f(CW\*(C`tlmgr \-v check\*(C'\fR را اجرا کنید.) .IP \fBdepends\fR 4 .IX Item "depends" بسته‌هایی را که به عنوان وابستگی در یک مجموعهٔ نصب‌شده آمده‌اند اما خودشان نصب نشده‌اند، و بسته‌هایی را که در هیچ مجموعه‌ای قرار ندارند فهرست می‌کند. .Sp اگر دستور \f(CW\*(C`tlmgr check collections\*(C'\fR را اجرا کنید، به جای آن این آزمون انجام می‌شود، زیرا نسخه‌های پیشین \f(CW\*(C`tlmgr\*(C'\fR آن را به این نام فراخوانی می‌کردند. .IP \fBexecutes\fR 4 .IX Item "executes" بررسی می‌کند که فایل‌های ارجاع داده شده توسط دستورالعمل‌های \f(CW\*(C`execute\*(C'\fR در پایگاه دادهٔ TeX Live وجود داشته باشند. .IP \fBfiles\fR 4 .IX Item "files" بررسی می‌کند که آیا تمامی فایل‌های فهرست‌شده در TLPDB محلی (\f(CW\*(C`texlive.tlpdb\*(C'\fR) واقعاً وجود دارند، و فایل‌های ناموجود را فهرست می‌کند. .IP \fBrunfiles\fR 4 .IX Item "runfiles" نام‌فایل‌هایی را که بیش از یک بار در بخش‌های runfiles تکرار شده‌اند، به جز موارد تکراری شناخته‌شده، فهرست می‌کند. .IP \fBtexmfdbs\fR 4 .IX Item "texmfdbs" بررسی‌های مربوط به فایل‌های \f(CW\*(C`ls\-R\*(C'\fR. اگر درخت‌های جدیدی تعریف کرده‌اید، یا متغیرهای \f(CW\*(C`TEXMF\*(C'\fR یا \f(CW\*(C`TEXMFDBS\*(C'\fR را تغییر داده‌اید، اجرای این بررسی زیانی ندارد. این دستور موارد زیر را بررسی می‌کند: .RS 4 .ie n .IP "\- تمام موارد در ""TEXMFDBS"" دارای پیشوند ""!!"" باشند." 8 .el .IP "\- تمام موارد در \f(CWTEXMFDBS\fR دارای پیشوند \f(CW!!\fR باشند." 8 .IX Item "- all items in TEXMFDBS have the !! prefix." .PD 0 .ie n .IP "\- تمام موارد در ""TEXMFBDS"" دارای یک فایل ""ls\-R"" باشند (در صورتی که اصلاً وجود داشته باشند)." 8 .el .IP "\- تمام موارد در \f(CWTEXMFBDS\fR دارای یک فایل \f(CWls\-R\fR باشند (در صورتی که اصلاً وجود داشته باشند)." 8 .IX Item "- all items in TEXMFBDS have an ls-R file (if they exist at all)." .ie n .IP "\- تمام موارد در ""TEXMF"" با ""!!"" در ""TEXMFDBS"" فهرست شده باشند." 8 .el .IP "\- تمام موارد در \f(CWTEXMF\fR با \f(CW!!\fR در \f(CWTEXMFDBS\fR فهرست شده باشند." 8 .IX Item "- all items in TEXMF with !! are listed in TEXMFDBS." .ie n .IP "\- تمام موارد در ""TEXMF"" با یک فایل ""ls\-R"" در ""TEXMFDBS"" فهرست شده باشند." 8 .el .IP "\- تمام موارد در \f(CWTEXMF\fR با یک فایل \f(CWls\-R\fR در \f(CWTEXMFDBS\fR فهرست شده باشند." 8 .IX Item "- all items in TEXMF with an ls-R file are listed in TEXMFDBS." .PD .RE .RS 4 .RE .PP گزینه‌ها: .IP \fB\-\-use\-svn\fR 4 .IX Item "--use-svn" استفاده از خروجی \f(CW\*(C`svn status\*(C'\fR به جای فهرست کردن فایل‌ها؛ برای بررسی مخزن توسعهٔ TL. (این مورد به صورت شبانه اجرا می‌شود.).SS conf .IX Subsection "conf" .IP "\fBconf [texmf|tlmgr|updmap [\-\-conffile \fR\f(BIfile\fR\fB] [\-\-delete] [\fR\f(BIkey\fR\fB [\fR\f(BIvalue\fR\fB]]]\fR" 4 .IX Item "conf [texmf|tlmgr|updmap [--conffile file] [--delete] [key [value]]]" .PD 0 .IP "\fBconf auxtrees [\-\-conffile \fR\f(BIfile\fR\fB] [show|add|remove] [\fR\f(BIvalue\fR\fB]\fR" 4 .IX Item "conf auxtrees [--conffile file] [show|add|remove] [value]" .PD تنها با \f(CW\*(C`conf\*(C'\fR، اطلاعات پیکربندی عمومی TeX Live، از جمله فایل‌های پیکربندی فعال، تنظیمات مسیر (path) و موارد دیگر نمایش داده می‌شود. این دستور مشابه اجرای \f(CW\*(C`texconfig conf\*(C'\fR است، اما بر روی تمامی پلتفرم‌های پشتیبانی‌شده کار می‌کند. .Sp با یکی از دستورهای \f(CW\*(C`conf texmf\*(C'\fR، \f(CW\*(C`conf tlmgr\*(C'\fR، یا \f(CW\*(C`conf updmap\*(C'\fR، تمام جفت‌های کلید/مقدار (یعنی تمامی تنظیمات) که به ترتیب در \f(CW\*(C`ROOT/texmf.cnf\*(C'\fR، فایل پیکربندی مختص کاربرِ \f(CW\*(C`tlmgr\*(C'\fR (زیر را ببینید)، یا اولین فایل \f(CW\*(C`updmap.cfg\*(C'\fR یافت‌شده (از طریق \f(CW\*(C`kpsewhich\*(C'\fR) ذخیره شده‌اند، نمایش داده می‌شوند. .Sp اگر افزون بر این \fIkey\fR داده شود، تنها مقدار همان \fIkey\fR در فایل مربوطه نمایش داده می‌شود. اگر گزینهٔ \fI\-\-delete\fR نیز مشخص شده باشد، مقدار موجود در فایل پیکربندی داده‌شده به‌طور کامل حذف می‌شود (نه اینکه صرفاً کامنت شود). .Sp اگر علاوه بر این \fIvalue\fR نیز داده شود، مقدار \fIkey\fR در فایل مربوطه برابر با \fIvalue\fR تنظیم می‌شود. \fIهیچ‌گونه بررسی خطایی انجام نمی‌شود!\fR .Sp مقدار \f(CW\*(C`PATH\*(C'\fR نشان‌داده‌شده توسط \f(CW\*(C`conf\*(C'\fR همان مقداری است که توسط \f(CW\*(C`tlmgr\*(C'\fR استفاده می‌شود. دایرکتوری‌ای که فایل اجرایی \f(CW\*(C`tlmgr\*(C'\fR در آن قرار دارد، به‌طور خودکار به ابتدای مقدار PATH به ارث رسیده از محیط افزوده می‌شود. .Sp در اینجا یک مثال کاربردی از تغییر مقادیر پیکربندی آورده شده است. چنانچه اجرای (برخی یا تمام) دستورات سیستمی از طریق \f(CW\*(C`\ewrite18\*(C'\fR در هنگام نصب فعال باقی مانده باشد، می‌توانید بعداً آن را غیرفعال کنید: .Sp .Vb 1 \& tlmgr conf texmf shell_escape 0 .Ve .Sp زیردستور \f(CW\*(C`auxtrees\*(C'\fR امکان افزودن و حذف درخت‌های texmf اضافی دلخواه را، کاملاً تحت کنترل کاربر فراهم می‌کند. \f(CW\*(C`auxtrees show\*(C'\fR فهرست درخت‌های اضافی را نشان می‌دهد، \f(CW\*(C`auxtrees add\*(C'\fR \fItree\fR درختی را به فهرست می‌افزاید، و \f(CW\*(C`auxtrees remove\*(C'\fR \fItree\fR درختی را از فهرست (در صورت وجود) حذف می‌کند. این درخت‌ها نباید حاوی فایل \f(CW\*(C`ls\-R\*(C'\fR باشند (وگرنه در صورتی که \f(CW\*(C`ls\-R\*(C'\fR کهنه و نامعتبر شود، فایل‌ها یافت نخواهند شد). این سازوکار با دستکاری متغیر Kpathsea به نام \f(CW\*(C`TEXMFAUXTREES\*(C'\fR، در (به‌طور پیش‌فرض) \&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR عمل می‌کند. مثال: .Sp .Vb 2 \& tlmgr conf auxtrees add /quick/test/tree \& tlmgr conf auxtrees remove /quick/test/tree .Ve .Sp در تمام موارد، فایل پیکربندی را می‌توان با استفاده از گزینهٔ \f(CW\*(C`\-\-conffile\*(C'\fR \fIfile\fR به‌طور صریح مشخص کرد؛ مثلاً اگر نمی‌خواهید پیکربندی سراسری سیستم را تغییر دهید. .Sp هشدار: امکان کلی برای تغییر مقادیر پیکربندی در اینجا وجود دارد، اما دستکاری تنظیمات به این شیوه اکیداً منع می‌شود. مجدداً یادآوری می‌شود، هیچ بررسی خطایی روی کلیدها یا مقادیر انجام نمی‌گیرد، بنابراین هرگونه خرابی محتمل خواهد بود. .SS "dump\-tlpdb [\fIoption\fP...] [\-\-json]" .IX Subsection "dump-tlpdb [option...] [--json]" تخلیه کامل TLPDB محلی یا دوردست به خروجی استاندارد، به همان شکل موجود. خروجی شبیه به خروجی \f(CW\*(C`\-\-machine\-readable\*(C'\fR است؛ بخش «MACHINE\-READABLE OUTPUT» را ببینید. .PP گزینه‌ها: .IP \fB\-\-local\fR 4 .IX Item "--local" تخلیه TLPDB محلی. .IP \fB\-\-remote\fR 4 .IX Item "--remote" تخلیه TLPDB دوردست. .IP \fB\-\-json\fR 4 .IX Item "--json" به جای تخلیه محتوای واقعی، پایگاه‌داده به صورت JSON تخلیه می‌شود. برای آگاهی از قالب خروجی JSON فایل \f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب \f(CW\*(C`TLPDB\*(C'\fR را ببینید. .PP دقیقاً باید یکی از گزینه‌های \f(CW\*(C`\-\-local\*(C'\fR یا \f(CW\*(C`\-\-remote\*(C'\fR مشخص شود. .PP در هر دو حالت، سطر اول خروجی مکان مخزن را با این قالب مشخص می‌کند: .PP .Vb 1 \& "location\-url" "\et" location .Ve .PP که در آن \f(CW\*(C`location\-url\*(C'\fR نام لغوی فیلد است که به دنبال آن یک تب می‌آید، و \&\fIlocation\fR فایل یا نشانی وب (URL) مخزن است. .PP پایان خطوط ممکن است بسته به پلتفرم جاری LF یا CRLF باشد. .SS generate .IX Subsection "generate" .IP "\fBgenerate [\fR\f(BIoption\fR\fB...] language\fR" 4 .IX Item "generate [option...] language" .PD 0 .IP "\fBgenerate [\fR\f(BIoption\fR\fB...] language.dat\fR" 4 .IX Item "generate [option...] language.dat" .IP "\fBgenerate [\fR\f(BIoption\fR\fB...] language.def\fR" 4 .IX Item "generate [option...] language.def" .IP "\fBgenerate [\fR\f(BIoption\fR\fB...] language.dat.lua\fR" 4 .IX Item "generate [option...] language.dat.lua" .PD .PP عملیات \f(CW\*(C`generate\*(C'\fR هرگونه تغییر دستی اعمال‌شده در فایل‌های مربوطه را بازنویسی می‌کند: این عملیات آن‌ها را از ابتدا بر پایهٔ اطلاعات بسته‌های نصب‌شده، به اضافه انطباق‌های محلی، بازسازی می‌کند. نصاب TeX Live و \f(CW\*(C`tlmgr\*(C'\fR به‌طور معمول \f(CW\*(C`generate\*(C'\fR را برای تمامی این فایل‌ها فراخوانی می‌کنند. .PP برای مدیریت قلم‌های اختصاصی خود، لطفاً اطلاعات \f(CW\*(C`updmap \-\-help\*(C'\fR و/یا را بخوانید. .PP برای مدیریت فرمت‌های اختصاصی خود، لطفاً اطلاعات \f(CW\*(C`fmtutil \-\-help\*(C'\fR را بخوانید. .PP با جزئیات بیشتر: \f(CW\*(C`generate\*(C'\fR هر یک از فایل‌های پیکربندی \&\f(CW\*(C`language.dat\*(C'\fR، \f(CW\*(C`language.def\*(C'\fR، و \f(CW\*(C`language.dat.lua\*(C'\fR را از روی اطلاعات موجود در TLPDB محلی، به همراه فایل‌های نگهداری‌شده به صورت محلی بازسازی می‌کند. .PP فایل‌های نگهداری‌شده به صورت محلی عبارتند از \f(CW\*(C`language\-local.dat\*(C'\fR، \&\f(CW\*(C`language\-local.def\*(C'\fR، یا \f(CW\*(C`language\-local.dat.lua\*(C'\fR، که در \&\f(CW\*(C`TEXMFLOCAL\*(C'\fR در دایرکتوری‌های مربوطه جستجو می‌شوند. در صورت وجود افزوده‌های محلی، فایل نهایی با شروع از فایل اصلی، حذف مدخل‌هایی که فایل محلی غیرفعال شدن آن‌ها را تعیین کرده است، و در نهایت افزودن فایل محلی به انتهای آن ساخته می‌شود. .PP (نکتهٔ تاریخی: فایل‌های \f(CW\*(C`updmap\-local.cfg\*(C'\fR و \&\f(CW\*(C`fmtutil\-local.cnf\*(C'\fR که سابقاً پشتیبانی می‌شدند دیگر خوانده نمی‌شوند، زیرا \f(CW\*(C`updmap\*(C'\fR و \f(CW\*(C`fmtutil\*(C'\fR اکنون از چندین فایل پیکربندی پشتیبانی کرده و آن‌ها را می‌خوانند. بنابراین، افزوده‌های محلی می‌توانند و باید در یک فایل \f(CW\*(C`updmap.cfg\*(C'\fR یا \f(CW\*(C`fmtutil.cnf\*(C'\fR در \f(CW\*(C`TEXMFLOCAL\*(C'\fR قرار گیرند. عملیات‌های \f(CW\*(C`generate updmap\*(C'\fR و \f(CW\*(C`generate fmtutil\*(C'\fR دیگر وجود ندارند.) .PP فایل‌های محلی مدخل‌هایی را که باید غیرفعال شوند با یک سطر توضیح (کامنت)، یعنی یکی از این خطوط مشخص می‌کنند: .PP .Vb 2 \& %!NAME \& \-\-!NAME .Ve .PP که در آن \f(CW\*(C`language.dat\*(C'\fR و \f(CW\*(C`language.def\*(C'\fR از \f(CW\*(C`%\*(C'\fR، و \f(CW\*(C`language.dat.lua\*(C'\fR از \f(CW\*(C`\-\-\*(C'\fR استفاده می‌کنند. در تمامی موارد، \fIname\fR نام فرمت مربوطه یا شناسه الگوی خط پیوند (hyphenation) است. مثال‌ها: .PP .Vb 2 \& %!german \& \-\-!usenglishmax .Ve .PP (البته، بعید است که واقعاً بخواهید این موارد خاص را غیرفعال کنید. آن‌ها صرفاً مثال هستند.) .PP پس از چنین سطر غیرفعال‌سازی، اگر تعریف متفاوتی مد نظر باشد، فایل محلی می‌تواند شامل مدخل دیگری برای همان مورد باشد. به‌طور کلی، به جز خطوط غیرفعال‌سازی ویژه، فایل‌های محلی از همان قواعد نحوی فایل‌های اصلی پیروی می‌کنند. .PP شکل \f(CW\*(C`generate language\*(C'\fR هر سه فایل \f(CW\*(C`language.dat\*(C'\fR، \&\f(CW\*(C`language.def\*(C'\fR، و \f(CW\*(C`language.dat.lua\*(C'\fR را بازسازی می‌کند، در حالی که شکل‌های همراه با پسوند تنها همان فایل زبانِ داده‌شده را بازسازی می‌کنند. .PP گزینه‌ها: .IP "\fB\-\-dest\fR \fIoutput_file\fR" 4 .IX Item "--dest output_file" فایل خروجی را تعیین می‌کند (پیش‌فرض آن مکان مربوطه در \&\f(CW\*(C`TEXMFSYSVAR\*(C'\fR است). اگر \f(CW\*(C`\-\-dest\*(C'\fR به \f(CW\*(C`generate language\*(C'\fR داده شود، به عنوان یک نام پایه (basename) عمل می‌کند که \f(CW\*(C`.dat\*(C'\fR برای نام فایل خروجی \f(CW\*(C`language.dat\*(C'\fR به آن اضافه می‌شود، \f(CW\*(C`.def\*(C'\fR به مقدار داده‌شده برای نام فایل خروجی \f(CW\*(C`language.def\*(C'\fR، و \f(CW\*(C`.dat.lua\*(C'\fR برای نام فایل \f(CW\*(C`language.dat.lua\*(C'\fR الحاق خواهد شد. (این کار صرفاً برای جلوگیری از بازنویسی است؛ چنانچه نام مشخصی برای هر فایل خروجی می‌خواهید، توصیه می‌کنیم \f(CW\*(C`tlmgr\*(C'\fR را دو بار فراخوانی کنید.) .IP "\fB\-\-localcfg\fR \fIlocal_conf_file\fR" 4 .IX Item "--localcfg local_conf_file" افزوده‌های محلی (اختیاری) را مشخص می‌کند (پیش‌فرض آن مکان مربوطه در \&\f(CW\*(C`TEXMFLOCAL\*(C'\fR است). .IP \fB\-\-rebuild\-sys\fR 4 .IX Item "--rebuild-sys" به \f(CW\*(C`tlmgr\*(C'\fR اعلام می‌کند که برنامه‌های لازم را پس از بازتولید فایل‌های پیکربندی اجرا کند. این برنامه‌ها عبارتند از: \&\f(CW\*(C`fmtutil\-sys \-\-all\*(C'\fR پس از \f(CW\*(C`generate fmtutil\*(C'\fR، \&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.dat\*(C'\fR پس از \f(CW\*(C`generate language.dat\*(C'\fR، و \&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.def\*(C'\fR پس از \f(CW\*(C`generate language.def\*(C'\fR. .Sp این فراخوانی‌های بعدی باعث می‌شوند که فایل‌های تازه تولیدشده واقعاً به مرحلهٔ اجرا درآیند. این کار به‌طور پیش‌فرض انجام نمی‌شود، چرا که آن فراخوانی‌ها فرایندهایی زمان‌بر هستند و ممکن است فرد بخواهد چندین تغییر مرتبط را قبل از اجرای این برنامه‌ها به‌صورت متوالی انجام دهد. .PP مکان‌های مربوطه به صورت زیر هستند: .PP .Vb 3 \& tex/generic/config/language.dat (and language\-local.dat) \& tex/generic/config/language.def (and language\-local.def) \& tex/generic/config/language.dat.lua (and language\-local.dat.lua) .Ve.SS gui .IX Subsection "gui" رابط کاربری گرافیکی را راه‌اندازی می‌کند. بخش \fBGUI\fR در زیر را ببینید. .SS info .IX Subsection "info" .IP "\fBinfo [\fR\f(BIoption\fR\fB...] \fR\f(BIpkg\fR\fB...\fR" 4 .IX Item "info [option...] pkg..." .PD 0 .IP "\fBinfo [\fR\f(BIoption\fR\fB...] collections\fR" 4 .IX Item "info [option...] collections" .IP "\fBinfo [\fR\f(BIoption\fR\fB...] schemes\fR" 4 .IX Item "info [option...] schemes" .PD بدون هیچ آرگومانی، تمامی بسته‌های موجود در مخزن بسته‌ها را فهرست می‌کند و پیش از بسته‌های نصب‌شده، عبارت \f(CW\*(C`i\*(C'\fR را قرار می‌دهد. .Sp با کلمهٔ منفرد \f(CW\*(C`collections\*(C'\fR یا \f(CW\*(C`schemes\*(C'\fR به‌عنوان آرگومان، نوع درخواستی را به جای تمامی بسته‌ها فهرست می‌کند. .Sp با هر آرگومان دیگری، اطلاعات مربوط به \fIpkg\fR را نمایش می‌دهد: نام، دسته‌بندی، توضیحات کوتاه و کامل، اندازه‌ها، وضعیت نصب، و شمارهٔ بازنگری TeX Live. اگر \fIpkg\fR به‌صورت محلی نصب نشده باشد، در منبع نصب دوردست جستجو می‌کند. .Sp برای بسته‌های عادی (نه collections یا schemes)، اندازهٔ چهار گروه از فایل‌ها (فایل‌های run/src/doc/bin) به‌طور جداگانه نمایش داده می‌شود. برای collections، اندازهٔ تجمعی نشان داده می‌شود که شامل تمامی بسته‌های با وابستگی مستقیم است (اما شامل مجموعه‌های وابسته نمی‌شود). برای schemes نیز اندازهٔ تجمعی نمایش داده می‌شود که شامل تمامی مجموعه‌ها و بسته‌های با وابستگی مستقیم است. .Sp اگر \fIpkg\fR به‌صورت محلی یا دوردست یافت نشود، از عمل جستجو (search) استفاده شده و بسته‌ها و فایل‌های منطبق فهرست می‌شوند. .Sp همچنین اطلاعات برگرفته از TeX Catalogue را نمایش می‌دهد، یعنی نسخه، تاریخ و پروانهٔ بسته. به دلیل ناهماهنگی زمانی در به‌روزرسانی بخش‌های مختلف، این موارد (به‌ویژه نسخهٔ بسته) را تنها تقریبی در نظر بگیرید. در مقابل، مقدار \f(CW\*(C`revision\*(C'\fR مستقیماً از TL می‌آید و قابل اعتماد است. .Sp عمل‌های پیشین \f(CW\*(C`show\*(C'\fR و \f(CW\*(C`list\*(C'\fR در این عمل ادغام شده‌اند، اما برای سازگاری عقبروی همچنان پشتیبانی می‌شوند. .Sp گزینه‌ها: .RS 4 .IP \fB\-\-list\fR 4 .IX Item "--list" اگر گزینهٔ \f(CW\*(C`\-\-list\*(C'\fR همراه با یک بسته مشخص شود، فهرست فایل‌های درون آن، شامل فایل‌های وابستگی‌های وابسته به بستر نیز نمایش داده می‌شود. هنگام استفاده با schemes و collections، گزینهٔ \f(CW\*(C`\-\-list\*(C'\fR وابستگی‌های آن‌ها را به شیوه‌ای مشابه در خروجی می‌آورد. .IP \fB\-\-only\-files\fR 4 .IX Item "--only-files" اگر این گزینه مشخص شود، تنها فایل‌های مربوط به یک بستهٔ مشخص فهرست می‌شوند و هیچ اطلاعات دیگری نمایش داده نمی‌شود. اگر بیش از یک نام بسته مشخص شود، پیش از فهرست فایل‌های هر کدام، نام آن بسته درج می‌گردد. .IP \fB\-\-only\-installed\fR 4 .IX Item "--only-installed" اگر این گزینه مشخص شود، از منبع نصب استفاده نخواهد شد؛ تنها بسته‌ها، collections یا schemes نصب‌شدهٔ محلی فهرست می‌شوند. .IP \fB\-\-only\-remote\fR 4 .IX Item "--only-remote" تنها بسته‌های موجود در مخزن دوردست را فهرست می‌کند. برای بررسی موارد موجود در یک مخزن دوردست با استفاده از \&\f(CW\*(C`tlmgr \-\-repo ... \-\-only\-remote info\*(C'\fR سودمند است. توجه داشته باشید که نمی‌توان هر دوی \&\f(CW\*(C`\-\-only\-installed\*(C'\fR و \f(CW\*(C`\-\-only\-remote\*(C'\fR را با هم مشخص کرد. .ie n .IP "\fB\-\-data \fR\fB""item1,item2,...""\fR" 4 .el .IP "\fB\-\-data \fR\f(CBitem1,item2,...\fR" 4 .IX Item "--data item1,item2,..." اگر گزینهٔ \f(CW\*(C`\-\-data\*(C'\fR مشخص شود، آرگومان آن باید فهرستی جداشده با کاما یا دونقطه از نام فیلدهای زیر باشد: \f(CW\*(C`name\*(C'\fR، \f(CW\*(C`category\*(C'\fR، \f(CW\*(C`localrev\*(C'\fR، \&\f(CW\*(C`remoterev\*(C'\fR، \f(CW\*(C`shortdesc\*(C'\fR، \f(CW\*(C`longdesc\*(C'\fR، \f(CW\*(C`installed\*(C'\fR، \f(CW\*(C`size\*(C'\fR، \&\f(CW\*(C`relocatable\*(C'\fR، \f(CW\*(C`depends\*(C'\fR، \f(CW\*(C`cat\-version\*(C'\fR، \f(CW\*(C`cat\-date\*(C'\fR، \f(CW\*(C`cat\-license\*(C'\fR، به‌همراه فیلدهای گوناگون \f(CW\*(C`cat\-contact\-*\*(C'\fR (زیر را ببینید). .Sp فیلدهای \f(CW\*(C`cat\-*\*(C'\fR همگی از TeX Catalogue () می‌آیند. برای هر یک، دو گونهٔ دیگر با پیشوند \f(CW\*(C`l\*(C'\fR و \f(CW\*(C`r\*(C'\fR وجود دارد، مانند \f(CW\*(C`lcat\-version\*(C'\fR و \&\f(CW\*(C`rcat\-version\*(C'\fR، که به‌ترتیب بیانگر اطلاعات محلی و دوردست هستند. گونه‌های بدون \f(CW\*(C`l\*(C'\fR و \f(CW\*(C`r\*(C'\fR به‌روزترین مقدار را نشان می‌دهند، که معمولاً همان مقدار دوردست است. .Sp اطلاعات بسته‌های درخواستی در قالب CSV، هر بسته در یک خط، فهرست می‌شود و اطلاعات ستون‌ها با \f(CW\*(C`itemN\*(C'\fR مشخص می‌شود. ستون \&\f(CW\*(C`depends\*(C'\fR شامل نام تمامی وابستگی‌ها است که با نویسهٔ \f(CW\*(C`:\*(C'\fR از یکدیگر جدا شده‌اند. .Sp در زمان نگارش این متن، فیلدهای \f(CW\*(C`cat\-contact\-*\*(C'\fR شامل این موارد هستند: \f(CW\*(C`home\*(C'\fR، \&\f(CW\*(C`repository\*(C'\fR، \f(CW\*(C`support\*(C'\fR، \f(CW\*(C`bugs\*(C'\fR، \f(CW\*(C`announce\*(C'\fR، \f(CW\*(C`development\*(C'\fR. هر یک ممکن است خالی یا حاوی یک نشانی اینترنتی (url) باشد. توضیح کوتاهی در برگهٔ بارگذاری بسته‌های جدید CTAN وجود دارد: . .IP \fB\-\-json\fR 4 .IX Item "--json" اگر \f(CW\*(C`\-\-json\*(C'\fR مشخص شود، خروجی یک آرایه با کدگذاری JSON خواهد بود که هر عنصر آن بازنمایی JSON از یک \f(CW\*(C`TLPOBJ\*(C'\fR منفرد است ولی اطلاعات بیشتری دارد. برای جزئیات به \f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب: \f(CW\*(C`TLPOBJINFO\*(C'\fR مراجعه کنید. اگر هر دوی \f(CW\*(C`\-\-json\*(C'\fR و \f(CW\*(C`\-\-data\*(C'\fR مشخص شوند، \f(CW\*(C`\-\-json\*(C'\fR اولویت دارد. .RE .RS 4 .RE .SS init\-usertree .IX Subsection "init-usertree" یک درخت texmf را برای آنچه مدیریت حالت کاربر (user mode) نامیده می‌شود برپا می‌کند؛ چه درخت پیش‌فرض کاربر (\f(CW\*(C`TEXMFHOME\*(C'\fR) و چه درختی که در خط فرمان با \f(CW\*(C`\-\-usertree\*(C'\fR مشخص شده باشد. بخش «حالت کاربر (USER MODE)» در زیر را ببینید. .SS "install [\fIoption\fP...] \fIpkg\fP..." .IX Subsection "install [option...] pkg..." هر \fIpkg\fR مشخص‌شده در خط فرمان را، در صورتی که پیش‌تر نصب نشده باشد، نصب می‌کند. این دستور به بسته‌های موجود دست نمی‌زند؛ برای چگونگی دریافت آخرین نسخهٔ یک بسته، عمل \f(CW\*(C`update\*(C'\fR را ببینید. .PP به‌طور پیش‌فرض، تمامی بسته‌هایی که \fIpkg\fRهای داده‌شده به آن‌ها وابسته‌اند نیز نصب می‌شوند. گزینه‌ها: .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل چیزی نصب نمی‌شود؛ در عوض، اقداماتی که باید انجام گیرند در پایانه نوشته می‌شوند. .IP \fB\-\-file\fR 4 .IX Item "--file" به جای دریافت بسته از مخزن نصب، از فایل‌های بسته‌ای که در خط فرمان داده شده‌اند استفاده می‌کند. این فایل‌ها باید فایل‌های استاندارد بستهٔ TeX Live (شامل فایل tlpobj درون آن) باشند. .IP \fB\-\-force\fR 4 .IX Item "--force" اگر به‌روزرسانی‌هایی برای خودِ \f(CW\*(C`tlmgr\*(C'\fR (یا بخش‌های دیگری از زیرساخت پایه) موجود باشد، \f(CW\*(C`tlmgr\*(C'\fR متوقف شده و عملیات نصب را انجام نخواهد داد مگر اینکه این گزینه داده شود. توصیه نمی‌شود. .IP \fB\-\-no\-depends\fR 4 .IX Item "--no-depends" وابستگی‌ها را نصب نمی‌کند. (به‌طور پیش‌فرض، نصب یک بسته تضمین می‌کند که تمامی وابستگی‌های آن بسته برآورده شوند.) .IP \fB\-\-no\-depends\-at\-all\fR 4 .IX Item "--no-depends-at-all" به‌طور معمول، هنگامی که بسته‌ای را نصب می‌کنید که فایل‌های باینری را ارائه می‌دهد، بستهٔ باینری متناظر نیز نصب خواهد شد. یعنی برای بستهٔ \f(CW\*(C`foo\*(C'\fR، بستهٔ \f(CW\*(C`foo.i386\-linux\*(C'\fR نیز روی یک سیستم \f(CW\*(C`i386\-linux\*(C'\fR نصب می‌شود. این گزینه این رفتار را بازمی‌دارد و همچنین مستلزم \f(CW\*(C`\-\-no\-depends\*(C'\fR است. از آن استفاده نکنید مگر اینکه دقیقاً بدانید چه کار می‌کنید. .IP \fB\-\-reinstall\fR 4 .IX Item "--reinstall" بسته را مجدداً نصب می‌کند (شامل وابستگی‌ها برای collections)، حتی اگر به نظر برسد پیش‌تر نصب شده است (یعنی در TLPDB موجود باشد). این گزینه برای بازیابی فایل‌ها پس از حذف اتفاقی آن‌ها در سلسله‌مراتب فایل‌ها سودمند است. .Sp هنگام نصب مجدد، تنها وابستگی‌های بسته‌های عادی دنبال می‌شوند (یعنی نه وابستگی‌های دسته‌بندی Scheme یا Collection). .IP \fB\-\-with\-doc\fR 4 .IX Item "--with-doc" .PD 0 .IP \fB\-\-with\-src\fR 4 .IX Item "--with-src" .PD اگرچه توصیه نمی‌شود، اما برنامهٔ \f(CW\*(C`install\-tl\*(C'\fR گزینه‌ای برای صرف‌نظر کردن از نصب تمامی مستندات و/یا فایل‌های منبع فراهم می‌کند. (به‌طور پیش‌فرض، همه‌چیز نصب می‌شود.) پس از چنین نصبی، ممکن است در نهایت متوجه شوید که مستندات یا فایل‌های منبع را برای بسته‌ای خاص می‌خواهید. می‌توانید با استفاده از این گزینه‌ها همراه با \&\f(CW\*(C`\-\-reinstall\*(C'\fR آن‌ها را به دست آورید، مانند نمونهٔ زیر (با استفاده از بستهٔ \f(CW\*(C`fontspec\*(C'\fR به‌عنوان مثال): .Sp .Vb 1 \& tlmgr install \-\-reinstall \-\-with\-doc \-\-with\-src fontspec .Ve .PP این عمل به‌طور خودکار پیوندهای نمادین جدید را در دایرکتوری‌های سیستمی ایجاد نمی‌کند؛ در صورتی که از این ویژگی استفاده می‌کنید و مایلید پیوندهای نمادین جدید افزوده شوند، باید خودتان \f(CW\*(C`tlmgr path add\*(C'\fR (بخش «path») را اجرا کنید..SS key .IX Subsection "key" .IP "\fBkey list\fR" 4 .IX Item "key list" .PD 0 .IP "\fBkey add \fR\f(BIfile\fR" 4 .IX Item "key add file" .IP "\fBkey remove \fR\f(BIkeyid\fR" 4 .IX Item "key remove keyid" .PD عملیات \f(CW\*(C`key\*(C'\fR امکان فهرست‌کردن، افزودن و حذف کلیدهای GPG اضافی به مجموعه کلیدهای مورد اعتماد را فراهم می‌کند؛ یعنی کلیدهایی که برای اعتبارسنجی پایگاه‌های داده TeX Live استفاده می‌شوند. .Sp با آرگومان \f(CW\*(C`list\*(C'\fR، دستور \f(CW\*(C`key\*(C'\fR تمام کلیدها را فهرست می‌کند. .Sp آرگومان \f(CW\*(C`add\*(C'\fR به یک آرگومان دیگر نیاز دارد؛ یا یک نام فایل یا \&\f(CW\*(C`\-\*(C'\fR برای stdin که کلید از آن اضافه می‌شود. کلید به دسته‌کلید محلی \f(CW\*(C`GNUPGHOME/repository\-keys.gpg\*(C'\fR افزوده می‌شود که معمولاً \&\f(CW\*(C`tlpkg/gpg/repository\-keys.gpg\*(C'\fR است. .Sp آرگومان \f(CW\*(C`remove\*(C'\fR به یک شناسه کلید نیاز دارد و شناسه درخواستی را از دسته‌کلید محلی حذف می‌کند. .SS list .IX Subsection "list" مترادفی برای "info". .SS option .IX Subsection "option" .IP "\fBoption [\-\-json] [show]\fR" 4 .IX Item "option [--json] [show]" .PD 0 .IP "\fBoption [\-\-json] showall|help\fR" 4 .IX Item "option [--json] showall|help" .IP "\fBoption \fR\f(BIkey\fR\fB [\fR\f(BIvalue\fR\fB]\fR" 4 .IX Item "option key [value]" .PD .PP فرم نخست، \f(CW\*(C`show\*(C'\fR، تنظیمات سراسری TeX Live را که در حال حاضر در TLPDB ذخیره شده‌اند همراه با شرحی کوتاه و \f(CW\*(C`key\*(C'\fR مورد استفاده برای تغییر آن در پرانتز نمایش می‌دهد. .PP فرم دوم، \f(CW\*(C`showall\*(C'\fR، مشابه است، اما گزینه‌هایی را نیز نمایش می‌دهد که قابل تعریف هستند اما در حال حاضر روی هیچ مقداری تنظیم نشده‌اند (\f(CW\*(C`help\*(C'\fR مترادف آن است). .PP هر دو فرم \f(CW\*(C`show...\*(C'\fR گزینه \f(CW\*(C`\-\-json\*(C'\fR را می‌پذیرند که اطلاعات گزینه‌ها را در قالب JSON استخراج می‌کند. در این حالت، هر دو فرم داده‌های یکسانی را خروجی می‌دهند. برای آگاهی از ساختار خروجی JSON، به \&\f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب \f(CW\*(C`TLOPTION\*(C'\fR مراجعه کنید. .PP در فرم سوم، همراه با \fIkey\fR، اگر \fIvalue\fR داده نشود، مقدار تنظیم‌شده برای \fIkey\fR نمایش داده می‌شود. اگر \fIvalue\fR ارائه شده باشد، \fIkey\fR روی \&\fIvalue\fR تنظیم می‌شود. .PP مقادیر ممکن برای \fIkey\fR عبارتند از (برای مشاهده فهرست قطعی، دستور \f(CW\*(C`tlmgr option showall\*(C'\fR را اجرا کنید): .PP .Vb 10 \& repository (مخزن پیش‌فرض بسته‌ها)، \& formats (تولید فرمت‌ها در زمان نصب یا به‌روزرسانی)، \& postcode (اجرای قطعه‌کدهای postinst) \& docfiles (نصب فایل‌های مستندات)، \& srcfiles (نصب فایل‌های سورس)، \& backupdir (دایرکتوری پیش‌فرض برای پشتیبان‌ها)، \& autobackup (تعداد نسخه‌های پشتیبان برای نگهداری). \& sys_bin (دایرکتوری‌ای که فایل‌های اجرایی توسط عملیات path به آن پیوند می‌خورند) \& sys_man (دایرکتوری‌ای که صفحات man توسط عملیات path به آن پیوند می‌خورند) \& sys_info (دایرکتوری‌ای که فایل‌های Info توسط عملیات path به آن پیوند می‌خورند) \& desktop_integration (فقط ویندوز: ایجاد میانبرهای منوی Start) \& fileassocs (فقط ویندوز: تغییر ارتباط فایل‌ها) \& multiuser (فقط ویندوز: نصب برای همه کاربران) .Ve .PP یکی از کاربردهای معمول \f(CW\*(C`option\*(C'\fR تغییر دائمی نصب برای دریافت به‌روزرسانی‌های بعدی از اینترنت، پس از نصب اولیه از روی DVD است. برای انجام این کار، می‌توانید دستور زیر را اجرا کنید: .PP .Vb 1 \& tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet .Ve .PP مستندات \f(CW\*(C`install\-tl\*(C'\fR اطلاعات بیشتری درباره مقادیر ممکن برای \f(CW\*(C`repository\*(C'\fR دارد. (برای سازگاری با نسخه‌های پیشین، می‌توان از \f(CW\*(C`location\*(C'\fR به عنوان مترادفی برای \f(CW\*(C`repository\*(C'\fR استفاده کرد.) .PP اگر \f(CW\*(C`formats\*(C'\fR تنظیم شده باشد (حالت پیش‌فرض)، هنگامی که موتور یا فایل‌های فرمت تغییر کنند، فرمت‌ها دوباره تولید می‌شوند. این گزینه را تنها زمانی غیرفعال کنید که از نحوه بازتولید آن آگاهی دارید و می‌خواهید هر زمان که نیاز شد (که در عمل بسیار رخ می‌دهد) فرمت‌ها را خودتان دوباره بسازید. .PP گزینه \f(CW\*(C`postcode\*(C'\fR اجرای کدهای عملیات پس از نصب مربوط به هر بسته را کنترل می‌کند. این گزینه به‌طور پیش‌فرض فعال است و باز هم غیرفعال کردن آن برای کسی جز توسعه‌دهندگانی که در حال عیب‌یابی هستند جالب نخواهد بود. .PP گزینه‌های \f(CW\*(C`docfiles\*(C'\fR و \f(CW\*(C`srcfiles\*(C'\fR نصب گروه‌های فایلی مربوط به خود (مستندات، سورس‌ها؛ این گروه‌بندی تقریبی است) را به ازای هر بسته کنترل می‌کنند. به‌طور پیش‌فرض هر دو فعال هستند (1). در صورت محدود بودن فضای دیسک یا برای نصب‌های آزمایشی کمینه و غیره، می‌توان یکی از آن‌ها یا هر دو را غیرفعال کرد (تنظیم روی 0). در صورت غیرفعال بودن، فایل‌های مربوطه به هیچ وجه دانلود نمی‌شوند. .PP گزینه‌های \f(CW\*(C`autobackup\*(C'\fR و \f(CW\*(C`backupdir\*(C'\fR مقادیر پیش‌فرض را برای عملیات‌های \f(CW\*(C`update\*(C'\fR، \f(CW\*(C`backup\*(C'\fR و \f(CW\*(C`restore\*(C'\fR تعیین می‌کنند. این سه عملیات نیازمند دایرکتوری‌ای هستند که پشتیبان‌ها را در آن بخوانند یا بنویسند. اگر \&\f(CW\*(C`\-\-backupdir\*(C'\fR در خط فرمان مشخص نشده باشد، مقدار گزینه \f(CW\*(C`backupdir\*(C'\fR استفاده می‌شود (در صورت تنظیم بودن). نصب‌کننده TL مقدار \f(CW\*(C`backupdir\*(C'\fR را روی \&\f(CW\*(C`.../tlpkg/backups\*(C'\fR در زیر دایرکتوری ریشه نصب TL قرار می‌دهد. .PP گزینه \f(CW\*(C`autobackup\*(C'\fR تولید خودکار نسخه‌های پشتیبان را فعال/غیرفعال می‌کند. مقدار آن یک عدد صحیح است. اگر مقدار \f(CW\*(C`autobackup\*(C'\fR برابر با \f(CW\-1\fR باشد، هیچ نسخه پشتیبانی حذف نخواهد شد. اگر مقدار \f(CW\*(C`autobackup\*(C'\fR برابر با 0 یا بیشتر باشد، تعداد پشتیبان‌هایی را که باید نگهداری شوند مشخص می‌کند. بنابراین، اگر مقدار 0 باشد، پشتیبان‌گیری غیرفعال می‌شود. در حالت \f(CW\*(C`\-\-clean\*(C'\fR از عملیات \f(CW\*(C`backup\*(C'\fR نیز این گزینه تعداد نسخه‌های نگه‌داشته‌شده را مشخص می‌کند. مقدار پیش‌فرض 1 است، به این معنی که پشتیبان‌گیری انجام می‌شود، اما تنها یک نسخه پشتیبان نگهداری خواهد شد. .PP برای تنظیم \f(CW\*(C`autobackup\*(C'\fR روی \f(CW\-1\fR در خط فرمان، دستور زیر را به کار ببرید: .PP .Vb 1 \& tlmgr option \-\- autobackup \-1 .Ve .PP علامت \f(CW\*(C`\-\-\*(C'\fR مانع از آن می‌شود که \f(CW\-1\fR به عنوان یک گزینه تفسیر شود. (علامت \f(CW\*(C`\-\-\*(C'\fR پردازش گزینه‌ها را در نقطه‌ای که ظاهر می‌شود متوقف می‌کند؛ این یک ویژگی عمومی در بیشتر برنامه‌های Unix است.) .PP گزینه‌های \f(CW\*(C`sys_bin\*(C'\fR، \f(CW\*(C`sys_man\*(C'\fR و \f(CW\*(C`sys_info\*(C'\fR در سیستم‌های Unix برای کنترل ساخت پیوندها برای فایل‌های اجرایی، فایل‌های Info و صفحات man استفاده می‌شوند. برای جزئیات به عملیات \f(CW\*(C`path\*(C'\fR مراجعه کنید. .PP سه گزینه پایانی بر رفتار در نصب‌های Windows تأثیر می‌گذارند. اگر \&\f(CW\*(C`desktop_integration\*(C'\fR تنظیم شده باشد، برخی بسته‌ها مواردی را در یک پوشه فرعی از منوی Start برای \f(CW\*(C`tlmgr gui\*(C'\fR، مستندات و غیره نصب می‌کنند. اگر \&\f(CW\*(C`fileassocs\*(C'\fR تنظیم شده باشد، انتساب فایل‌های ویندوز برقرار می‌شود (همچنین به عملیات \&\f(CW\*(C`postaction\*(C'\fR مراجعه کنید). در نهایت، اگر \f(CW\*(C`multiuser\*(C'\fR تنظیم شده باشد، تغییرات در رجیستری و منوها به جای فقط کاربر فعلی، برای همه کاربران سیستم اعمال می‌شود. هر سه گزینه به‌طور پیش‌فرض فعال هستند..SS paper .IX Subsection "paper" .IP "\fBpaper [a4|letter]\fR" 4 .IX Item "paper [a4|letter]" .PD 0 .IP "\fB<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [\fR\f(BIpapersize\fR\fB|\-\-list]\fR>" 4 .IX Item "<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [papersize|--list]>" .IP "\fBpaper \-\-json\fR" 4 .IX Item "paper --json" .PD .PP بدون آرگومان (\f(CW\*(C`tlmgr paper\*(C'\fR)، تنظیم اندازه کاغذ پیش‌فرض را برای تمام برنامه‌های شناخته‌شده نشان می‌دهد. .PP با یک آرگومان (مانند \f(CW\*(C`tlmgr paper a4\*(C'\fR)، پیش‌فرض تمام برنامه‌های شناخته‌شده را روی آن اندازه کاغذ تنظیم می‌کند. .PP اگر یک برنامه به عنوان اولین آرگومان داده شده و هیچ اندازه کاغذی مشخص نشده باشد (مانند \f(CW\*(C`tlmgr dvips paper\*(C'\fR)، اندازه کاغذ پیش‌فرض را برای آن برنامه نشان می‌دهد. .PP اگر یک برنامه به عنوان اولین آرگومان و یک اندازه کاغذ به عنوان آخرین آرگومان مشخص شده باشد (مانند \f(CW\*(C`tlmgr dvips paper a4\*(C'\fR)، پیش‌فرض را برای آن برنامه روی آن اندازه کاغذ تنظیم می‌کند. .PP اگر \f(CW\*(C`pdftex\*(C'\fR یا \f(CW\*(C`context\*(C'\fR یکی از آرگومان‌ها باشد، چه به صورت ضمنی و چه صریح، قالب‌های موجود بازسازی می‌شوند (یعنی \f(CW\*(C`fmtutil \&\-\-refresh\*(C'\fR فراخوانی می‌شود)، مگر اینکه \f(CW\*(C`\-\-no\-execute\-actions\*(C'\fR مشخص شده باشد. .PP اگر یک برنامه به عنوان اولین آرگومان و \f(CW\*(C`\-\-list\*(C'\fR به عنوان آخرین آرگومان داده شود (مانند \f(CW\*(C`tlmgr dvips paper \-\-list\*(C'\fR)، تمام اندازه‌های معتبر کاغذ برای آن برنامه را نشان می‌دهد. اولین اندازه نشان‌داده‌شده، پیش‌فرض است. .PP اگر \f(CW\*(C`\-\-json\*(C'\fR بدون گزینه‌های دیگر مشخص شود، پیکربندی کاغذ در قالب JSON خروجی داده می‌شود. برای اطلاع از قالب خروجی JSON، به \&\f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب \f(CW\*(C`TLPAPER\*(C'\fR مراجعه کنید. .PP اتفاقاً، این نحو که نام برنامه خاصی پیش از کلمه کلیدی \&\f(CW\*(C`paper\*(C'\fR قرار گیرد، نامعمول است. این شیوه از اسکریپت قدیمی \&\f(CW\*(C`texconfig\*(C'\fR به ارث رسیده است که از سایر تنظیمات پیکربندی برای برخی برنامه‌ها، به‌ویژه \f(CW\*(C`dvips\*(C'\fR پشتیبانی می‌کند. ابزار \f(CW\*(C`tlmgr\*(C'\fR از آن تنظیمات اضافی پشتیبانی نمی‌کند. .SS path .IX Subsection "path" .IP "\fBpath [\-\-windowsmode=user|admin] add\fR" 4 .IX Item "path [--windowsmode=user|admin] add" .PD 0 .IP "\fBpath [\-\-windowsmode=user|admin] remove\fR" 4 .IX Item "path [--windowsmode=user|admin] remove" .PD در Unix، پیوندهای نمادین را برای فایل‌های اجرایی، صفحات man و صفحات info در دایرکتوری‌های سیستمی تعیین‌شده توسط گزینه‌های مربوطه اضافه یا حذف می‌کند (توضیحات «option» در بالا را ببینید). هیچ‌کدام از فایل‌های راه‌اندازی، چه سیستمی یا شخصی را تغییر نمی‌دهد. علاوه بر این، فایل‌های اجرایی اضافه‌شده یا حذف‌شده توسط به‌روزرسانی‌های آینده به طور خودکار مدیریت نمی‌شوند؛ این دستور در صورت نیاز باید مجدداً اجرا شود. .Sp در Windows، بخشی از رجیستری که دایرکتوری باینری در آن اضافه یا حذف می‌شود، به روش زیر تعیین می‌گردد: .Sp اگر کاربر دسترسی مدیر سیستم (admin) داشته باشد و گزینه \f(CW\*(C`\-\-windowsmode\*(C'\fR داده نشده باشد، تنظیم \fIw32_multi_user\fR مکان را تعیین می‌کند (یعنی اگر روشن باشد مسیر سیستم و در غیر این صورت مسیر کاربر تغییر می‌کند). .Sp اگر کاربر دسترسی مدیر سیستم داشته باشد و گزینه \f(CW\*(C`\-\-windowsmode\*(C'\fR داده شده باشد، این گزینه مسیری را که باید تنظیم شود تعیین می‌کند. .Sp اگر کاربر دسترسی مدیر سیستم نداشته باشد، گزینه \f(CW\*(C`\-\-windowsmode\*(C'\fR داده نشده باشد و تنظیم \fIw32_multi_user\fR خاموش باشد، مسیر کاربر تغییر می‌کند؛ در حالی که اگر تنظیم \fIw32_multi_user\fR روشن باشد، هشداری صادر می‌شود مبنی بر اینکه فراخواننده امتیازات کافی را ندارد. .Sp اگر کاربر دسترسی مدیر سیستم نداشته باشد و گزینه \f(CW\*(C`\-\-windowsmode\*(C'\fR داده شده باشد، این مقدار باید \f(CW\*(C`user\*(C'\fR باشد و مسیر کاربر تنظیم خواهد شد. اگر کاربری بدون دسترسی مدیر سیستم از گزینه \f(CW\*(C`\-\-windowsmode admin\*(C'\fR استفاده کند، هشداری صادر می‌شود مبنی بر اینکه فراخواننده امتیازات کافی را ندارد. .SS pinning .IX Subsection "pinning" عمل \f(CW\*(C`pinning\*(C'\fR فایل تثبیت (pinning) را مدیریت می‌کند؛ بخش «Pinning» را در زیر ببینید. .ie n .IP """pinning show""" 4 .el .IP "\f(CWpinning show\fR" 4 .IX Item "pinning show" داده‌های تثبیت فعلی را نمایش می‌دهد. .ie n .IP """pinning add"" \fIrepo\fR \fIpkgglob\fR..." 4 .el .IP "\f(CWpinning add\fR \fIrepo\fR \fIpkgglob\fR..." 4 .IX Item "pinning add repo pkgglob..." بسته‌های منطبق با \fIpkgglob\fR(ها) را به مخزن \&\fIrepo\fR پین (تثبیت) می‌کند. .ie n .IP """pinning remove"" \fIrepo\fR \fIpkgglob\fR..." 4 .el .IP "\f(CWpinning remove\fR \fIrepo\fR \fIpkgglob\fR..." 4 .IX Item "pinning remove repo pkgglob..." هر بسته‌ای که در فایل تثبیت ثبت شده و با ها برای مخزن داده‌شده \fIrepo\fR مطابقت داشته باشد، حذف می‌شود. .ie n .IP """pinning remove \fIrepo\fR \-\-all""" 4 .el .IP "\f(CWpinning remove \fR\f(CIrepo\fR\f(CW \-\-all\fR" 4 .IX Item "pinning remove repo --all" تمام داده‌های تثبیت را برای مخزن \fIrepo\fR حذف می‌کند. .SS platform .IX Subsection "platform" .IP "\fBplatform list|add|remove \fR\f(BIplatform\fR\fB...\fR" 4 .IX Item "platform list|add|remove platform..." .PD 0 .IP "\fBplatform set \fR\f(BIplatform\fR" 4 .IX Item "platform set platform" .IP "\fBplatform set auto\fR" 4 .IX Item "platform set auto" .PD \&\f(CW\*(C`platform list\*(C'\fR نام‌های TeX Live تمام پلتفرم‌ها (معماری‌ها)، (\f(CW\*(C`i386\-linux\*(C'\fR، ...) موجود در مخزن بسته‌ها را فهرست می‌کند. .Sp \&\f(CW\*(C`platform add\*(C'\fR \fIplatform\fR... فایل‌های اجرایی را برای هر پلتفرم داده‌شده \&\fIplatform\fR از مخزن به سیستم نصب‌شده اضافه می‌کند. .Sp \&\f(CW\*(C`platform remove\*(C'\fR \fIplatform\fR... فایل‌های اجرایی هر پلتفرم داده‌شده \fIplatform\fR را از سیستم نصب‌شده حذف می‌کند، اما در هر حال پلتفرمِ در حال اجرای فعلی را نگه می‌دارد. .Sp \&\f(CW\*(C`platform set\*(C'\fR \fIplatform\fR سیستم TeX Live را تغییر می‌دهد تا همیشه به جای تشخیص خودکار، از پلتفرم داده‌شده استفاده کند. .Sp \&\f(CW\*(C`platform set auto\*(C'\fR سیستم TeX Live را برای پلتفرم به حالت تشخیص خودکار تغییر می‌دهد. .Sp تشخیص پلتفرم برای انتخاب باینری‌های مناسب \f(CW\*(C`xz\*(C'\fR و \&\f(CW\*(C`wget\*(C'\fR که به همراه TeX Live ارائه می‌شوند لازم است. .Sp \&\f(CW\*(C`arch\*(C'\fR مترادفی برای \f(CW\*(C`platform\*(C'\fR است. .Sp گزینه‌ها: .RS 4 .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل چیزی نصب نمی‌شود؛ در عوض، اقداماتی که باید انجام گیرند در ترمینال نوشته می‌شوند. .RE .RS 4 .RE.SS postaction .IX Subsection "postaction" .IP "\fBpostaction [\fR\f(BIoption\fR\fB...] install [shortcut|fileassoc|script] [\fR\f(BIpkg\fR\fB...]\fR" 4 .IX Item "postaction [option...] install [shortcut|fileassoc|script] [pkg...]" .PD 0 .IP "\fBpostaction [\fR\f(BIoption\fR\fB...] remove [shortcut|fileassoc|script] [\fR\f(BIpkg\fR\fB...]\fR" 4 .IX Item "postaction [option...] remove [shortcut|fileassoc|script] [pkg...]" .PD عملیات پس از اجرای (postaction) \f(CW\*(C`shortcut\*(C'\fR، \f(CW\*(C`fileassoc\*(C'\fR یا \f(CW\*(C`script\*(C'\fR را که به‌عنوان دومین آرگومان الزامی مشخص شده است، در حالت install یا remove (که اولین آرگومان الزامی است)، برای بسته‌های ارائه‌شده در خط فرمان، یا در صورت ارائهٔ \f(CW\*(C`\-\-all\*(C'\fR برای همهٔ بسته‌ها اجرا می‌کند. .Sp گزینه‌ها: .RS 4 .IP \fB\-\-windowsmode=[user|admin]\fR 4 .IX Item "--windowsmode=[user|admin]" اگر به گزینهٔ \f(CW\*(C`\-\-windowsmode\*(C'\fR مقدار \f(CW\*(C`user\*(C'\fR داده شود، تمام اقدامات فقط در بخش‌های قابل‌دسترس کاربر در رجیستری/سیستم‌فایل انجام می‌شوند، در حالی که مقدار \f(CW\*(C`admin\*(C'\fR بخش‌های سراسری سیستم در رجیستری را برای پیوند فایل‌ها (file associations) انتخاب می‌کند. اگر دسترسی لازم را نداشته باشید، استفاده از \f(CW\*(C`\-\-windowsmode=admin\*(C'\fR موفقیت‌آمیز نخواهد بود. .IP \fB\-\-fileassocmode=[1|2]\fR 4 .IX Item "--fileassocmode=[1|2]" \&\f(CW\*(C`\-\-fileassocmode\*(C'\fR نحوهٔ عملکرد پیوند فایل‌ها را مشخص می‌کند. اگر روی 1 (پیش‌فرض) تنظیم شود، تنها پیوندهای جدید اضافه می‌شوند؛ اگر روی 2 تنظیم شود، تمام پیوندها روی برنامه‌های TeX Live تنظیم می‌گردند. (همچنین نگاه کنید به \&\f(CW\*(C`option fileassocs\*(C'\fR.) .IP \fB\-\-all\fR 4 .IX Item "--all" اجرای postactionها برای تمام بسته‌ها. .RE .RS 4 .RE .SS print\-platform .IX Subsection "print-platform" شناسهٔ TeX Live مربوط به بستر شناسایی‌شده (ترکیب سخت‌افزار/سیستم‌عامل) را در خروجی استاندارد چاپ کرده و خارج می‌شود. \&\f(CW\*(C`\-\-print\-arch\*(C'\fR مترادف آن است. .SS print\-platform\-info .IX Subsection "print-platform-info" شناسهٔ بستر TeX Live، نام کامل بستر TL و خروجی اصلی دستور guess را چاپ می‌کند. .SS "remove [\fIoption\fP...] \fIpkg\fP..." .IX Subsection "remove [option...] pkg..." هر یک از \fIpkg\fRهای مشخص‌شده را حذف می‌کند. حذف یک مجموعه (collection) تمام وابستگی‌های بسته‌ایِ آن را حذف می‌کند (مگر اینکه \f(CW\*(C`\-\-no\-depends\*(C'\fR مشخص شده باشد)، اما هیچ‌یک از وابستگی‌های مجموعه‌ایِ آن مجموعه را حذف نمی‌کند. با این حال، هنگام حذف یک بسته، وابستگی‌ها هرگز حذف نمی‌شوند. گزینه‌ها: .IP \fB\-\-all\fR 4 .IX Item "--all" کل TeX Live را لغو نصب می‌کند و در صورت عدم تعیین \f(CW\*(C`\-\-force\*(C'\fR، تأییدیه می‌خواهد. .IP \fB\-\-backup\fR 4 .IX Item "--backup" .PD 0 .IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 .IX Item "--backupdir directory" .PD این گزینه‌ها رفتاری مشابه با اقدام update (به آن رجوع شود) دارند، با این تفاوت که پیش از حذف بسته‌ها، برای تهیهٔ نسخهٔ پشتیبان از آن‌ها اعمال می‌شوند. حالت پیش‌فرض، تهیهٔ چنین نسخه‌ای است؛ یعنی ذخیرهٔ یک رونوشت از بسته‌ها پیش از حذف. .Sp اقدام «restore» نحوهٔ بازیابی از یک نسخهٔ پشتیبان را توضیح می‌دهد. .IP \fB\-\-no\-depends\fR 4 .IX Item "--no-depends" بسته‌های وابسته را حذف نمی‌کند. .IP \fB\-\-no\-depends\-at\-all\fR 4 .IX Item "--no-depends-at-all" به توضیحات بالا ذیل بخش install مراجعه کنید (و هوشیار باشید). .IP \fB\-\-force\fR 4 .IX Item "--force" به‌طور پیش‌فرض، حذف یک بسته یا مجموعه که وابستگیِ مجموعه یا طرح (scheme) دیگری است مجاز نیست. با استفاده از این گزینه، بسته بدون قید و شرط حذف خواهد شد. با احتیاط استفاده کنید. .Sp بسته‌ای که با استفاده از گزینهٔ \f(CW\*(C`\-\-force\*(C'\fR حذف شده باشد، از آنجا که هنوز در یک مجموعه یا طرح نصب‌شده فهرست شده است، به‌روزرسانی نخواهد شد و در خروجی \&\f(CW\*(C`tlmgr update \-\-list\*(C'\fR با عبارت \f(CW\*(C`forcibly removed\*(C'\fR (به‌اجبار حذف‌شده) ذکر می‌شود. .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل چیزی حذف نمی‌شود؛ در عوض، اقداماتی که باید انجام گیرند در ترمینال چاپ می‌شوند. .PP به‌جز هنگام استفاده از \f(CW\*(C`\-\-all\*(C'\fR، این اقدام \f(CW\*(C`remove\*(C'\fR به‌طور خودکار پیوندهای نمادین (symlinks) به فایل‌های اجرایی را از دایرکتوری‌های سیستم حذف نمی‌کند؛ اگر بستهٔ مجزایی را که دارای پیوند نمادین در دایرکتوری‌های سیستمی است حذف کنید، باید خودتان دستور \&\f(CW\*(C`tlmgr path remove\*(C'\fR («path») را اجرا نمایید. .SS repository .IX Subsection "repository" .IP "\fBrepository list\fR" 4 .IX Item "repository list" .PD 0 .IP "\fBrepository list \fR\f(BIpath|url|tag\fR" 4 .IX Item "repository list path|url|tag" .IP "\fBrepository add \fR\f(BIpath\fR\fB [\fR\f(BItag\fR\fB]\fR" 4 .IX Item "repository add path [tag]" .IP "\fBrepository remove \fR\f(BIpath|tag\fR" 4 .IX Item "repository remove path|tag" .IP "\fBrepository set \fR\f(BIpath\fR\fB[#\fR\f(BItag\fR\fB] [\fR\f(BIpath\fR\fB[#\fR\f(BItag\fR\fB] ...]\fR" 4 .IX Item "repository set path[#tag] [path[#tag] ...]" .IP "\fBrepository status\fR" 4 .IX Item "repository status" .PD این اقدام، فهرست مخازن را مدیریت می‌کند. برای توضیحات دقیق‌تر، بخش MULTIPLE REPOSITORIES در ادامه را ببینید. .Sp حالت نخست، \f(CW\*(C`repository list\*(C'\fR، تمام مخازن پیکربندی‌شده و برچسب‌های متناظر را در صورت تنظیم فهرست می‌کند. اگر یک مسیر (path)، نشانی (url) یا برچسب (tag) بعد از کلیدواژهٔ \f(CW\*(C`list\*(C'\fR داده شود، به‌عنوان منبعی برای راه‌اندازی اولیهٔ پایگاه‌دادهٔ TL تفسیر شده و بسته‌های موجود در آن را فهرست می‌کند. این منبع می‌تواند مخزنی باشد که در غیر این صورت استفاده نشده است، خواه محلی باشد یا از راه دور. اگر علاوه بر این، گزینهٔ \&\f(CW\*(C`\-\-with\-platforms\*(C'\fR مشخص شود، برای هر بسته، بسترهای در دسترس (در صورت وجود) نیز فهرست می‌شوند. .Sp حالت \f(CW\*(C`repository add\*(C'\fR یک مخزن را (اختیاراً همراه با یک برچسب) به فهرست مخازن اضافه می‌کند، در حالی که \f(CW\*(C`repository remove\*(C'\fR یک مخزن را، خواه بر اساس مسیر/نشانی کامل یا بر اساس برچسب، حذف می‌کند. .Sp حالت \f(CW\*(C`repository set\*(C'\fR فهرست مخازن موجود را روی مواردی که در خط فرمان مشخص شده تنظیم می‌کند و تنظیمات قبلی را بازنویسی می‌نماید. .Sp حالت \f(CW\*(C`repository status\*(C'\fR وضعیت اعتبارسنجی مخازن بارگذاری‌شده را با قالب یک مخزن در هر سطر و فیلدهایی که با یک فاصله از هم جدا شده‌اند گزارش می‌دهد: .RS 4 .IP "برچسب (که می‌تواند همان url باشد)؛" 4 .IX Item "The tag (which can be the same as the url);" = نشانی اینترنتی (url)؛ .Sp = اگر و تنها اگر خروجی ماشین‌خوان مشخص شده باشد، کد اعتبارسنجی (یک عدد)؛ .Sp = شرح متنی وضعیت اعتبارسنجی، به‌عنوان آخرین فیلد که تا انتهای سطر امتداد دارد. .RE .RS 4 .Sp بدین معنی که در خروجی عادی (غیر ماشین‌خوان)، فیلد سوم (وضعیت عددیِ اعتبارسنجی) وجود ندارد. .Sp در همهٔ حالات، یکی از مخازن باید با برچسب \f(CW\*(C`main\*(C'\fR مشخص شده باشد؛ در غیر این صورت، تمام عملیات با شکست مواجه خواهند شد! .RE.SS restore .IX Subsection "restore" .IP "\fBrestore [\fR\f(BIoption\fR\fB...] \fR\f(BIpkg\fR\fB [\fR\f(BIrev\fR\fB]\fR" 4 .IX Item "restore [option...] pkg [rev]" .PD 0 .IP "\fBrestore [\fR\f(BIoption\fR\fB...] \-\-all\fR" 4 .IX Item "restore [option...] --all" .PD بازیابی یک بسته از یک نسخهٔ پشتیبان تهیه‌شدهٔ قبلی. .Sp در صورت مشخص شدن \f(CW\*(C`\-\-all\*(C'\fR، برای بازیابی جدیدترین ویرایش تمام نسخه‌های پشتیبان بسته‌های موجود در دایرکتوری پشتیبان تلاش می‌شود. .Sp در غیر این صورت، چنانچه نه \fIpkg\fR و نه \fIrev\fR مشخص نشده باشند، ویرایش‌های پشتیبانِ موجود برای همهٔ بسته‌ها فهرست می‌شوند. با مشخص شدن \fIpkg\fR اما بدون \fIrev\fR، تمام ویرایش‌های پشتیبانِ موجود از \fIpkg\fR فهرست می‌شوند. .Sp هنگام فهرست کردن بسته‌های موجود، \f(CW\*(C`tlmgr\*(C'\fR شمارهٔ ویرایش و در صورت موجود بودن، زمان ایجاد را داخل پرانتز (در قالب yyyy\-mm\-dd hh:mm) نمایش می‌دهد. .Sp اگر (و فقط اگر) هم \fIpkg\fR و هم یک شماره ویرایش معتبر \fIrev\fR مشخص شده باشند، برای بازیابی بسته از پشتیبانِ تعیین‌شده تلاش می‌شود. .Sp گزینه‌ها: .RS 4 .IP \fB\-\-all\fR 4 .IX Item "--all" تلاش برای بازیابی آخرین ویرایش تمام پشتیبان‌های بسته‌های موجود در دایرکتوری پشتیبان. آرگومان‌های اضافی غیرگزینه‌ای (مانند \fIpkg\fR) مجاز نیستند. .IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 .IX Item "--backupdir directory" مشخص کردن دایرکتوری که پشتیبان‌ها در آن قرار دارند. در صورت مشخص نشدن، از تنظیمات پیکربندی در TLPDB استفاده خواهد شد. .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل چیزی بازیابی نمی‌شود؛ در عوض، عملیاتی که قرار است انجام شوند روی ترمینال نوشته می‌شوند. .IP \fB\-\-force\fR 4 .IX Item "--force" هیچ سؤالی نپرسد (بدون درخواست تأیید از کاربر). .IP \fB\-\-json\fR 4 .IX Item "--json" هنگام فهرست کردن پشتیبان‌ها، گزینهٔ \f(CW\*(C`\-\-json\*(C'\fR خروجی را در قالب JSON می‌نویسد. این قالب آرایه‌ای از شیءهای JSON شامل (\f(CW\*(C`name\*(C'\fR، \f(CW\*(C`rev\*(C'\fR، \f(CW\*(C`date\*(C'\fR) است. برای جزئیات به \f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب: \&\f(CW\*(C`TLBACKUPS\*(C'\fR مراجعه کنید. اگر هر دو گزینهٔ \f(CW\*(C`\-\-json\*(C'\fR و \f(CW\*(C`\-\-data\*(C'\fR مشخص شوند، \f(CW\*(C`\-\-json\*(C'\fR اولویت دارد. .RE .RS 4 .RE .SS search .IX Subsection "search" .IP "\fBsearch [\fR\f(BIoption\fR\fB...] \fR\f(BIwhat\fR" 4 .IX Item "search [option...] what" .PD 0 .IP "\fBsearch [\fR\f(BIoption\fR\fB...] \-\-file \fR\f(BIwhat\fR" 4 .IX Item "search [option...] --file what" .IP "\fBsearch [\fR\f(BIoption\fR\fB...] \-\-all \fR\f(BIwhat\fR" 4 .IX Item "search [option...] --all what" .PD به‌طور پیش‌فرض، نام‌ها، توضیحات کوتاه و توضیحات بلند همهٔ بسته‌های نصب‌شدهٔ محلی را برای آرگومان \fIwhat\fR (که به‌عنوان یک عبارت باقاعدهٔ Perl تفسیر می‌شود) جستجو می‌کند. .Sp گزینه‌ها: .RS 4 .IP \fB\-\-file\fR 4 .IX Item "--file" فهرست کردن تمام نام‌های فایلی که شامل \fIwhat\fR هستند. .IP \fB\-\-all\fR 4 .IX Item "--all" جستجوی همه‌چیز: نام بسته‌ها، توضیحات و نام فایل‌ها. .IP \fB\-\-global\fR 4 .IX Item "--global" جستجو در پایگاه دادهٔ TeX Live مربوط به رسانهٔ نصب، به‌جای نصب محلی. .IP \fB\-\-word\fR 4 .IX Item "--word" محدود کردن جستجوی نام بسته‌ها و توضیحات (نه نام فایل‌ها) تنها به تطبیق کامل کلمات. برای مثال، جستجوی \&\f(CW\*(C`table\*(C'\fR با این گزینه، بسته‌های حاوی کلمهٔ \&\f(CW\*(C`tables\*(C'\fR را در خروجی نمی‌آورد (مگر اینکه کلمهٔ \f(CW\*(C`table\*(C'\fR را نیز به‌تنهایی داشته باشند). .IP \fB\-\-json\fR 4 .IX Item "--json" نمایش نتایج جستجو به‌صورت یک هش JSON با دو کلید: \fBfiles\fR و \&\fBpackages\fR. برای ساختار خروجی JSON به \&\f(CW\*(C`tlpkg/doc/json\-formats.txt\*(C'\fR، تعریف قالب \f(CW\*(C`TLSEARCH\*(C'\fR مراجعه کنید. .RE .RS 4 .RE .SS shell .IX Subsection "shell" یک حالت تعاملی را آغاز می‌کند که در آن tlmgr برای دریافت دستورها اعلان (prompt) می‌دهد. این حالت می‌تواند به‌طور مستقیم یا برای اسکریپت‌نویسی استفاده شود. نخستین خط خروجی عبارت است از \&\f(CW\*(C`protocol\*(C'\fR \fIn\fR، که در آن \fIn\fR یک عدد بدون علامت است که نسخهٔ پروتکل را مشخص می‌کند (در حال حاضر 1). .PP به‌طور کلی، عملیات‌های tlmgr که می‌توان در خط فرمان مشخص کرد، به دستورهایی در این حالت شل تبدیل می‌شوند. برای مثال، می‌توانید عبارت \&\f(CW\*(C`update \-\-list\*(C'\fR را وارد کنید تا ببینید چه مواردی به‌روزرسانی خواهند شد. TLPDB در نخستین باری که به آن نیاز باشد بارگیری می‌شود (نه در آغاز کار)، و در ادامهٔ نشست استفاده خواهد شد. .PP علاوه بر این عملیات‌ها، چند دستور مختص به حالت شل هستند: .IP protocol 4 .IX Item "protocol" چاپ \f(CW\*(C`protocol \fR\f(CIn\fR\f(CW\*(C'\fR، نسخهٔ فعلی پروتکل. .IP help 4 .IX Item "help" چاپ راهنما و ارجاعاتی به این مستندات. .IP version 4 .IX Item "version" چاپ اطلاعات نسخهٔ tlmgr. .IP "quit, end, bye, byebye, EOF" 4 .IX Item "quit, end, bye, byebye, EOF" خروج. .IP restart 4 .IX Item "restart" راه‌اندازی مجدد \f(CW\*(C`tlmgr shell\*(C'\fR با همان خط فرمان اولیه؛ بسیار کاربردی هنگام توسعهٔ \f(CW\*(C`tlmgr\*(C'\fR. .IP "load [local|remote]" 4 .IX Item "load [local|remote]" بارگیری صریح TLPDB، به‌ترتیب به‌صورت محلی (local) یا دوردست (remote). .IP save 4 .IX Item "save" ذخیرهٔ TLPDB محلی، احتمالاً پس از آنکه عملیات‌های دیگر آن را تغییر داده باشند. .IP "get [\fIvar\fR] =item set [\fIvar\fR [\fIval\fR]]" 4 .IX Item "get [var] =item set [var [val]]" دریافت مقدار \fIvar\fR، یا تنظیم آن بر روی \fIval\fR. نام‌های ممکن برای \fIvar\fR: \&\f(CW\*(C`debug\-translation\*(C'\fR، \f(CW\*(C`machine\-readable\*(C'\fR، \f(CW\*(C`no\-execute\-actions\*(C'\fR، \&\f(CW\*(C`require\-verification\*(C'\fR، \f(CW\*(C`verify\-downloads\*(C'\fR، \f(CW\*(C`repository\*(C'\fR، و \&\f(CW\*(C`prompt\*(C'\fR. همگی به‌جز \f(CW\*(C`repository\*(C'\fR و \f(CW\*(C`prompt\*(C'\fR مقادیر بولی هستند که مقادیر 0 و 1 را می‌پذیرند و رفتاری مانند گزینهٔ خط فرمان متناظر خود دارند. متغیر \f(CW\*(C`repository\*(C'\fR یک رشته دریافت می‌کند و مکان مخزن دوردست را تنظیم می‌نماید. متغیر \f(CW\*(C`prompt\*(C'\fR یک رشته دریافت کرده و اعلان پیش‌فرض کنونی را تعیین می‌کند. .Sp اگر \fIvar\fR یا سپس \fIval\fR مشخص نشوند، برای مقدار آن‌ها اعلان داده می‌شود (از کاربر سؤال می‌شود)..SS show .IX Subsection "show" مترادفی برای «info». .SS uninstall .IX Subsection "uninstall" مترادفی برای remove. .SS "update [\fIoption\fP...] [\fIpkg\fP...]" .IX Subsection "update [option...] [pkg...]" بسته‌های داده‌شده به عنوان آرگومان را به آخرین نسخهٔ موجود در منبع نصب به‌روزرسانی می‌کند. باید یا \f(CW\*(C`\-\-all\*(C'\fR یا دست‌کم نام یک \fIpkg\fR مشخص شود. گزینه‌ها: .IP \fB\-\-all\fR 4 .IX Item "--all" تمام بسته‌های نصب‌شده به جز خود \f(CW\*(C`tlmgr\*(C'\fR را به‌روزرسانی می‌کند. اگر به‌روزرسانی‌هایی برای خود \f(CW\*(C`tlmgr\*(C'\fR موجود باشد، خطایی داده می‌شود، مگر اینکه گزینهٔ \f(CW\*(C`\-\-force\*(C'\fR یا \f(CW\*(C`\-\-self\*(C'\fR نیز مشخص شده باشد. (پایین را ببینید.) .Sp علاوه بر به‌روزرسانی بسته‌های نصب‌شده، در حین به‌روزرسانی یک مجموعه (collection)، نصب محلی (به‌طور پیش‌فرض) با وضعیت مجموعه روی سرور، هم برای افزودن‌ها و هم برای حذف‌ها همگام‌سازی می‌شود. .Sp این بدان معناست که اگر بسته‌ای روی سرور حذف شده باشد (و بنابراین از مجموعهٔ مربوطه نیز حذف شده باشد)، \f(CW\*(C`tlmgr\*(C'\fR بسته را در نصب محلی حذف خواهد کرد. این عمل «auto\-remove» نامیده می‌شود و هنگام استفاده از گزینهٔ \f(CW\*(C`\-\-list\*(C'\fR با همین عنوان اعلان می‌گردد. این حذف خودکار می‌تواند با استفاده از گزینهٔ \f(CW\*(C`\-\-no\-auto\-remove\*(C'\fR لغو شود (توصیه نمی‌شود، توضیحات گزینه را ببینید). .Sp به‌طور مشابه، اگر بسته‌ای به مجموعه‌ای روی سرور اضافه شده باشد که روی سیستم محلی نیز نصب است، به نصب محلی افزوده خواهد شد. این عمل «auto\-install» نامیده می‌شود و هنگام استفاده از گزینهٔ \f(CW\*(C`\-\-list\*(C'\fR با همین عنوان اعلان می‌گردد. این نصب خودکار می‌تواند با استفاده از گزینهٔ \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR لغو شود (این نیز توصیه نمی‌شود). .Sp استثنای بررسی وابستگی‌های مجموعه (از جمله نصب خودکار بسته‌ها که پیش‌تر اشاره شد)، بسته‌هایی هستند که توسط شما «اجباراً حذف شده‌اند»؛ یعنی شما \f(CW\*(C`tlmgr remove \-\-force\*(C'\fR را روی آن‌ها فراخوانی کرده‌اید. (مستندات عمل \f(CW\*(C`remove\*(C'\fR را ببینید.) برای نصب مجدد چنین بسته‌هایی که اجباراً حذف شده‌اند، از \f(CW\*(C`\-\-reinstall\-forcibly\-removed\*(C'\fR استفاده کنید. .Sp برای تأکید مجدد: حذف‌ها و افزودن‌های خودکار کاملاً با مقایسهٔ مجموعه‌ها تعیین می‌شوند. بنابراین، اگر به‌صورت دستی بستهٔ تکی \f(CW\*(C`foo\*(C'\fR را نصب کنید که بعداً از روی سرور حذف شود، \f(CW\*(C`tlmgr\*(C'\fR متوجه آن نخواهد شد و آن را در نصب محلی حذف نخواهد کرد. (بدون بازطراحی عمدهٔ معماری، سیستم باید به همین شکل باشد، زیرا tlpdb مخزنی را که بسته‌ها از آن آمده‌اند ثبت نمی‌کند.) .Sp اگر می‌خواهید برخی از بسته‌ها را از اجرای به‌روزرسانی جاری مستثنی کنید (مثلاً به دلیل ارتباط اینترنتی کند)، گزینهٔ \f(CW\*(C`\-\-exclude\*(C'\fR در زیر را ببینید. .IP \fB\-\-self\fR 4 .IX Item "--self" اگر به‌روزرسانی‌هایی برای خود \f(CW\*(C`tlmgr\*(C'\fR موجود باشد، آن را (یعنی بسته‌های زیرساختی را) به‌روزرسانی می‌کند. در Windows این مورد شامل به‌روزرسانی مفسر اختصاصی Perl که درون TeX Live عرضه می‌شود نیز می‌گردد. .Sp اگر این گزینه همراه با \f(CW\*(C`\-\-all\*(C'\fR یا فهرستی از بسته‌ها مشخص شود، ابتدا \f(CW\*(C`tlmgr\*(C'\fR به‌روزرسانی خواهد شد و در صورت موفقیت‌آمیز بودن این به‌روزرسانی، نسخهٔ جدید مجدداً راه‌اندازی می‌شود تا بقیهٔ به‌روزرسانی‌ها را به پایان برساند. .Sp به‌طور خلاصه: .Sp .Vb 4 \& tlmgr update \-\-self # فقط به‌روزرسانی زیرساخت \& tlmgr update \-\-self \-\-all # به‌روزرسانی زیرساخت و همهٔ بسته‌ها \& tlmgr update \-\-force \-\-all # به‌روزرسانی همهٔ بسته‌ها اما *نه* زیرساخت \& # ... مورد آخر با مسئولیت خودتان است و توصیه نمی‌شود! .Ve .IP \fB\-\-dry\-run\fR 4 .IX Item "--dry-run" در عمل هیچ چیزی نصب نمی‌شود؛ در عوض، اقداماتی که قرار است انجام شوند روی ترمینال نوشته می‌شوند. این گزارش دقیق‌تر و با جزئیات بیشتری نسبت به \f(CW\*(C`\-\-list\*(C'\fR است. .IP "\fB\-\-list\fR [\fIpkg\fR]" 4 .IX Item "--list [pkg]" بسته‌هایی را که به‌روزرسانی، تازه نصب یا حذف خواهند شد، به‌طور مختصر و بدون اعمال تغییر واقعی فهرست می‌کند. اگر \f(CW\*(C`\-\-all\*(C'\fR نیز داده شود، تمام به‌روزرسانی‌های موجود فهرست می‌شوند. اگر \f(CW\*(C`\-\-self\*(C'\fR داده شود اما \f(CW\*(C`\-\-all\*(C'\fR داده نشود، تنها به‌روزرسانی‌های مربوط به بسته‌های حیاتی (tlmgr، زیرساخت texlive، perl در Windows، و غیره) فهرست می‌شوند. اگر نه \f(CW\*(C`\-\-all\*(C'\fR و نه \f(CW\*(C`\-\-self\*(C'\fR داده شوند و علاوه بر این هیچ \fIpkg\fR مشخص نشده باشد، آن‌گاه \f(CW\*(C`\-\-all\*(C'\fR فرض می‌شود (بنابراین، \f(CW\*(C`tlmgr update \-\-list\*(C'\fR همانند \f(CW\*(C`tlmgr update \-\-list \-\-all\*(C'\fR است). اگر نه \f(CW\*(C`\-\-all\*(C'\fR و نه \f(CW\*(C`\-\-self\*(C'\fR داده شوند، اما نام‌های مشخصی از بسته‌ها داده شده باشد، وجود به‌روزرسانی برای آن بسته‌ها بررسی می‌شود. .IP "\fB\-\-exclude\fR \fIpkg\fR" 4 .IX Item "--exclude pkg" بستهٔ \fIpkg\fR را از فرآیند به‌روزرسانی مستثنی می‌کند. اگر این گزینه بیش از یک بار داده شود، آرگومان‌های آن انباشته می‌شوند. .Sp یک آرگومان \fIpkg\fR هم خود بستهٔ \fIpkg\fR و هم تمام بسته‌های وابسته به بستر مربوط به آن یعنی \fIpkg.ARCH\fR را مستثنی می‌کند. برای مثال، .Sp .Vb 1 \& tlmgr update \-\-all \-\-exclude a2ping .Ve .Sp بسته‌های \f(CW\*(C`a2ping\*(C'\fR، \f(CW\*(C`a2ping.i386\-linux\*(C'\fR یا هر بستهٔ دیگر \f(CW\*(C`a2ping.\*(C'\fR\fIARCH\fR را به‌روزرسانی نخواهد کرد. .Sp اگر این گزینه بسته‌ای را مشخص کند که در غیر این صورت نامزدی برای نصب خودکار، حذف خودکار یا نصب مجدد یک بستهٔ اجباراً حذف‌شده می‌بود، \f(CW\*(C`tlmgr\*(C'\fR با یک پیام خطا خارج می‌شود. مستثنی‌کردن در این شرایط پشتیبانی نمی‌شود. .Sp این گزینه همچنین می‌تواند به‌صورت دائمی در فایل پیکربندی tlmgr با کلید \f(CW\*(C`update\-exclude\*(C'\fR تنظیم شود. .IP "\fB\-\-no\-auto\-remove\fR [\fIpkg\fR...]" 4 .IX Item "--no-auto-remove [pkg...]" به‌طور پیش‌فرض، \f(CW\*(C`tlmgr\*(C'\fR تلاش می‌کند بسته‌هایی از یک مجموعهٔ موجود را که روی سرور حذف شده‌اند، همان‌طور که در بالا ذیل \f(CW\*(C`\-\-all\*(C'\fR توضیح داده شد، حذف کند. این گزینه جلوی چنین حذف‌هایی را می‌گیرد؛ چه برای تمام بسته‌ها (با \f(CW\*(C`\-\-all\*(C'\fR)، یا صرفاً برای نام‌های داده‌شدهٔ \fIpkg\fR. این امر می‌تواند منجر به یک نصب ناهماهنگ از TeX شود، چرا که کم پیش نمی‌آید بسته‌ها توسط نویسندگانشان تغییر نام یافته یا جایگزین شوند. بنابراین استفاده از این گزینه توصیه نمی‌شود. .IP "\fB\-\-no\-auto\-install\fR [\fIpkg\fR...]" 4 .IX Item "--no-auto-install [pkg...]" در شرایط عادی، \f(CW\*(C`tlmgr\*(C'\fR بسته‌هایی را که روی سرور جدید هستند نصب خواهد کرد، همان‌طور که در بالا ذیل \f(CW\*(C`\-\-all\*(C'\fR توضیح داده شد. این گزینه جلوی هرگونه نصب خودکاری را می‌گیرد؛ چه برای تمام بسته‌ها (با \f(CW\*(C`\-\-all\*(C'\fR)، یا نام‌های داده‌شدهٔ \fIpkg\fR. .Sp علاوه بر این، پس از اتمام اجرای \f(CW\*(C`tlmgr\*(C'\fR با استفاده از این گزینه، بسته‌هایی که قرار بود به‌طور خودکار نصب شوند، \fIبه عنوان اجباراً حذف‌شده در نظر گرفته خواهند شد\fR. بنابراین، اگر \f(CW\*(C`foobar\*(C'\fR تنها بستهٔ جدید روی سرور باشد، آن‌گاه .Sp .Vb 1 \& tlmgr update \-\-all \-\-no\-auto\-install .Ve .Sp معادل است با .Sp .Vb 2 \& tlmgr update \-\-all \& tlmgr remove \-\-force foobar .Ve .Sp مجدداً، از آنجا که بسته‌ها گاهی تغییر نام می‌یابند یا جایگزین می‌شوند، استفاده از این گزینه توصیه نمی‌شود. .IP \fB\-\-reinstall\-forcibly\-removed\fR 4 .IX Item "--reinstall-forcibly-removed" در شرایط عادی، \f(CW\*(C`tlmgr\*(C'\fR بسته‌هایی را که به‌صورت اجباری توسط کاربر حذف شده‌اند نصب نخواهد کرد؛ یعنی بسته‌هایی که با \f(CW\*(C`remove \-\-force\*(C'\fR حذف شده‌اند، یا نصب آن‌ها در طول به‌روزرسانی قبلی توسط \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR منع شده است. .Sp این گزینه باعث می‌شود \f(CW\*(C`tlmgr\*(C'\fR حذف‌های اجباری را نادیده گرفته و همهٔ چنین بسته‌هایی را مجدداً نصب کند. این امر می‌تواند برای همگام‌سازی کامل یک نصب با آنچه از نظر سرور موجود است، استفاده شود: .Sp .Vb 1 \& tlmgr update \-\-reinstall\-forcibly\-removed \-\-all .Ve .IP \fB\-\-backup\fR 4 .IX Item "--backup" .PD 0 .IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 .IX Item "--backupdir directory" .PD این دو گزینه ایجاد نسخه‌های پشتیبان از بسته‌ها را \fIقبل\fR از به‌روزرسانی کنترل می‌کنند؛ یعنی پشتیبان‌گیری از بسته‌ها به همان صورتی که در حال حاضر نصب شده‌اند. اگر هیچ‌یک از گزینه‌ها داده نشود، هیچ پشتیبانی گرفته نخواهد شد. اگر \f(CW\*(C`\-\-backupdir\*(C'\fR داده شود و یک دایرکتوری قابل نوشتن را مشخص کند، پشتیبان در آن مکان ایجاد خواهد شد. اگر تنها \f(CW\*(C`\-\-backup\*(C'\fR داده شود، پشتیبان در دایرکتوری‌ای که قبلاً از طریق عمل «option» تنظیم شده است ایجاد می‌شود (پایین را ببینید). اگر هر دو داده شوند، پشتیبان در \fIdirectory\fR مشخص‌شده ایجاد خواهد شد. .Sp همچنین می‌توانید گزینه‌هایی را از طریق عمل «option» تنظیم کنید تا به‌طور خودکار برای همهٔ بسته‌ها پشتیبان تهیه شود، و/یا فقط تعداد معینی نسخهٔ پشتیبان نگهداری شود. .Sp برنامهٔ \f(CW\*(C`tlmgr\*(C'\fR همیشه هنگام به‌روزرسانی بسته‌ها یک نسخهٔ پشتیبان موقت تهیه می‌کند، تا در صورت بروز خطا در بارگیری یا سایر موارد در حین به‌روزرسانی استفاده شود. در مقابل، هدف از گزینهٔ \f(CW\*(C`\-\-backup\*(C'\fR این است که یک نسخهٔ پشتیبان ماندگار ذخیره شود تا اگر \fIمحتوای\fR واقعی به‌روزرسانی مشکلاتی ایجاد کرد (مثلاً یک ناسازگاری در TeX به وجود آورد)، بتوان از آن استفاده نمود. .Sp عمل «restore» چگونگی بازیابی از یک نسخهٔ پشتیبان را توضیح می‌دهد. .IP \fB\-\-no\-depends\fR 4 .IX Item "--no-depends" اگر درخواست به‌روزرسانی یک بسته را بدهید، معمولاً همهٔ بسته‌های وابسته نیز برای به‌روزرسانی بررسی می‌شوند و در صورت لزوم به‌روزرسانی خواهند شد. این سوییچ این رفتار را غیرفعال می‌کند. .IP \fB\-\-no\-depends\-at\-all\fR 4 .IX Item "--no-depends-at-all" بخش بالا ذیل install را ببینید (و مراقب باشید). .IP \fB\-\-force\fR 4 .IX Item "--force" به‌روزرسانی اجباری بسته‌های عادی، بدون به‌روزرسانی خود \f(CW\*(C`tlmgr\*(C'\fR (مگر اینکه گزینهٔ \f(CW\*(C`\-\-self\*(C'\fR نیز داده شده باشد). توصیه نمی‌شود. .Sp همچنین، \f(CW\*(C`update \-\-list\*(C'\fR صرف‌نظر از این گزینه همچنان انجام می‌شود. .PP اگر بستهٔ روی سرور قدیمی‌تر از بستهٔ نصب‌شده فعلی باشد (مثلاً اگر آینهٔ انتخاب‌شده قدیمی باشد)، \f(CW\*(C`tlmgr\*(C'\fR آن را به نسخهٔ قبل برنمی‌گرداند (downgrade نمی‌کند). همچنین، بسته‌های مربوط به بسترهای نصب‌نشده، نصب نمی‌شوند. .PP برنامهٔ \f(CW\*(C`tlmgr\*(C'\fR یک رونوشت از فایل اصلی \f(CW\*(C`texlive.tlpdb\*(C'\fR استفاده‌شده برای یک به‌روزرسانی را با پسوندی که نمایانگر نشانی اینترنتی (url) مخزن است ذخیره می‌کند، مانند \f(CW\*(C`tlpkg/texlive.tlpdb.main.\*(C'\fR\fIlong\-hash\-string\fR. بدین ترتیب، حتی هنگامی که از آینه‌های متعددی استفاده می‌شود، تنها یک پشتیبان اصلی از \f(CW\*(C`tlpdb\*(C'\fR نگه داشته می‌شود. برای مخازن غیراصلی که عموماً آینه‌ای ندارند (یا تعداد کمی دارند)، هیچ هرس و حذفی روی نسخه‌های پشتیبان انجام نمی‌شود..PP این اقدام به طور خودکار پیوندهای نمادین جدید را در دایرکتوری‌های سیستم اضافه یا حذف نمی‌کند؛ اگر از این ویژگی استفاده می‌کنید و می‌خواهید پیوندهای نمادین جدید اضافه شوند، باید خودتان دستور \f(CW\*(C`tlmgr\*(C'\fR "path" را اجرا کنید. .SH "فایل پیکربندی برای TLMGR (CONFIGURATION FILE FOR TLMGR)" .IX Header "CONFIGURATION FILE FOR TLMGR" دستور \&\f(CW\*(C`tlmgr\*(C'\fR دو فایل پیکربندی را می‌خواند: یکی در سطح کل سیستم در \&\f(CW\*(C`TEXMFSYSCONFIG/tlmgr/config\*(C'\fR، و دیگری مختص کاربر در \&\f(CW\*(C`TEXMFCONFIG/tlmgr/config\*(C'\fR. فایل مختص کاربر، پیش‌فرض برای اقدام \f(CW\*(C`conf tlmgr\*(C'\fR است. (دستور \f(CW\*(C`kpsewhich \&\-var\-value=TEXMFSYSCONFIG\*(C'\fR یا \f(CW\*(C`... TEXMFCONFIG ...\*(C'\fR را برای دیدن نام‌های واقعی دایرکتوری‌ها اجرا کنید.) .PP چند مقدار پیش‌فرض متناظر با گزینه‌های خط فرمان را می‌توان در این فایل‌های پیکربندی تنظیم کرد. علاوه بر این، فایل سراسری سیستم می‌تواند شامل دستورالعملی برای محدود کردن اقدام‌های مجاز باشد. .PP در این فایل‌های پیکربندی، خطوط خالی و خطوطی که با # شروع می‌شوند نادیده گرفته می‌شوند. تمام خطوط دیگر باید به این صورت باشند: .PP .Vb 1 \& key = value .Ve .PP که در آن فاصله‌ها اختیاری هستند اما وجود \f(CW\*(C`=\*(C'\fR الزامی است. .PP کلیدهای مجاز عبارتند از: .ie n .IP """auto\-remove ="" 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .el .IP "\f(CWauto\-remove =\fR 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .IX Item "auto-remove = 0 or 1 (default 1), same as command-line option." .PD 0 .ie n .IP """gui\-expertmode ="" 0 یا 1 (پیش‌فرض 1). این گزینه بین رابط کاربری گرافیکی (GUI) کامل و یک GUI ساده‌شده که فقط رایج‌ترین تنظیمات را دارد جابجا می‌شود." 4 .el .IP "\f(CWgui\-expertmode =\fR 0 یا 1 (پیش‌فرض 1). این گزینه بین رابط کاربری گرافیکی (GUI) کامل و یک GUI ساده‌شده که فقط رایج‌ترین تنظیمات را دارد جابجا می‌شود." 4 .IX Item "gui-expertmode = 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings." .ie n .IP """gui\-lang ="" \fIllcode\fR، با مقدار کد زبان، مشابه گزینه خط فرمان." 4 .el .IP "\f(CWgui\-lang =\fR \fIllcode\fR، با مقدار کد زبان، مشابه گزینه خط فرمان." 4 .IX Item "gui-lang = llcode, with a language code value as with the command-line option." .ie n .IP """no\-checksums ="" 0 یا 1 (پیش‌فرض 0، به زیر مراجعه کنید)." 4 .el .IP "\f(CWno\-checksums =\fR 0 یا 1 (پیش‌فرض 0، به زیر مراجعه کنید)." 4 .IX Item "no-checksums = 0 or 1 (default 0, see below)." .ie n .IP """persistent\-downloads ="" 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .el .IP "\f(CWpersistent\-downloads =\fR 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .IX Item "persistent-downloads = 0 or 1 (default 1), same as command-line option." .ie n .IP """require\-verification ="" 0 یا 1 (پیش‌فرض 0)، مشابه گزینه خط فرمان." 4 .el .IP "\f(CWrequire\-verification =\fR 0 یا 1 (پیش‌فرض 0)، مشابه گزینه خط فرمان." 4 .IX Item "require-verification = 0 or 1 (default 0), same as command-line option." .ie n .IP """tkfontscale ="" \fIfloating\-point number\fR (پیش‌فرض 1.0)؛ ضریب مقیاس قلم‌ها در رابط‌های کاربری مبتنی بر Tk." 4 .el .IP "\f(CWtkfontscale =\fR \fIfloating\-point number\fR (پیش‌فرض 1.0)؛ ضریب مقیاس قلم‌ها در رابط‌های کاربری مبتنی بر Tk." 4 .IX Item "tkfontscale = floating-point number (default 1.0); scaling factor for fonts in the Tk-based frontends." .ie n .IP """update\-exclude ="" \fIفهرست بسته‌ها با جداکننده کاما\fR (فاصله مجاز نیست). مشابه گزینه خط فرمان ""\-\-exclude"" برای اقدام ""update""." 4 .el .IP "\f(CWupdate\-exclude =\fR \fIفهرست بسته‌ها با جداکننده کاما\fR (فاصله مجاز نیست). مشابه گزینه خط فرمان \f(CW\-\-exclude\fR برای اقدام \f(CWupdate\fR." 4 .IX Item "update-exclude = comma-separated list of packages (no spaces allowed). Same as the command line option --exclude for the update action." .ie n .IP """verify\-downloads ="" 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .el .IP "\f(CWverify\-downloads =\fR 0 یا 1 (پیش‌فرض 1)، مشابه گزینه خط فرمان." 4 .IX Item "verify-downloads = 0 or 1 (default 1), same as command-line option." .PD .PP فایل پیکربندی سراسری سیستم می‌تواند شامل یک کلید اضافه باشد: .ie n .IP """allowed\-actions ="" \fIaction1\fR[,\fIaction2\fR,...] مقدار، فهرستی از اقدام‌های ""tlmgr"" است که با کاما جدا شده‌اند (بدون فاصله) و هنگامی که ""tlmgr"" در حالت سیستمی (یعنی بدون ""\-\-usermode"") فراخوانی می‌شود، اجازه اجرا دارند. این قابلیت به توزیع‌کنندگان امکان می‌دهد ""tlmgr"" را در بسته‌های خود قرار دهند، اما تنها به مجموعه محدودی از اقدام‌ها که با مدیر بسته توزیع تداخل ندارند اجازه اجرا دهند. برای نصب‌های بومی TeX Live، نیازی به تنظیم این مورد نیست." 4 .el .IP "\f(CWallowed\-actions =\fR \fIaction1\fR[,\fIaction2\fR,...] مقدار، فهرستی از اقدام‌های \f(CWtlmgr\fR است که با کاما جدا شده‌اند (بدون فاصله) و هنگامی که \f(CWtlmgr\fR در حالت سیستمی (یعنی بدون \f(CW\-\-usermode\fR) فراخوانی می‌شود، اجازه اجرا دارند. این قابلیت به توزیع‌کنندگان امکان می‌دهد \f(CWtlmgr\fR را در بسته‌های خود قرار دهند، اما تنها به مجموعه محدودی از اقدام‌ها که با مدیر بسته توزیع تداخل ندارند اجازه اجرا دهند. برای نصب‌های بومی TeX Live، نیازی به تنظیم این مورد نیست." 4 .IX Item "allowed-actions = action1[,action2,...] The value is a comma-separated list (no spaces) of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode). This allows distributors to include tlmgr in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn't make sense to set this." .PP در نهایت، کلید \f(CW\*(C`no\-checksums\*(C'\fR نیازمند توضیحات بیشتری است. به طور پیش‌فرض، چک‌سام‌های بسته که بر روی سرور (در TLPDB) محاسبه و ذخیره شده‌اند، با چک‌سام‌هایی که پس از دانلود به صورت محلی محاسبه می‌شوند، مقایسه می‌گردند. \&\f(CW\*(C`no\-checksums\*(C'\fR این فرآیند را غیرفعال می‌کند. الگوریتم چک‌سام SHA\-512 است. سیستم شما باید یکی از موارد زیر را داشته باشد (که به همین ترتیب جستجو می‌شوند): ماژول \f(CW\*(C`Digest::SHA\*(C'\fR در Perl، برنامه \f(CW\*(C`openssl\*(C'\fR ()، برنامه \f(CW\*(C`sha512sum\*(C'\fR (از GNU Coreutils، )، یا در نهایت برنامه \f(CW\*(C`shasum\*(C'\fR (صرفاً برای پشتیبانی از مک‌های قدیمی). اگر هیچ‌یک از این‌ها در دسترس نباشند، هشداری صادر می‌شود و \f(CW\*(C`tlmgr\*(C'\fR بدون بررسی چک‌سام‌ها به کار خود ادامه می‌دهد. \&\f(CW\*(C`no\-checksums\*(C'\fR مانع از نمایش این هشدار می‌شود. (ضمناً سایر پیاده‌سازی‌های SHA، مانند ماژول‌های خالص Perl و خالص Lua، بسیار کندتر از آن هستند که در این زمینه قابل استفاده باشند.) .SH "اعتبارسنجی رمزنگاری (CRYPTOGRAPHIC VERIFICATION)" .IX Header "CRYPTOGRAPHIC VERIFICATION" دستورهای \&\f(CW\*(C`tlmgr\*(C'\fR و \f(CW\*(C`install\-tl\*(C'\fR در صورت امکان اعتبارسنجی رمزنگاری را انجام می‌دهند. اگر اعتبارسنجی انجام شود و موفقیت‌آمیز باشد، برنامه‌ها پس از بارگذاری TLPDB مقدار \f(CW\*(C`(verified)\*(C'\fR را گزارش می‌کنند؛ در غیر این صورت، \&\f(CW\*(C`(not verified)\*(C'\fR را گزارش می‌دهند. با این حال در هر دو حالت، به طور پیش‌فرض نصب و/یا به‌روزرسانی‌ها به شکل عادی پیش می‌روند. .PP اگر برنامه‌ای به نام \f(CW\*(C`gpg\*(C'\fR در دسترس باشد (یعنی در \f(CW\*(C`PATH\*(C'\fR یافت شود)، امضاهای رمزنگاری به طور پیش‌فرض بررسی خواهند شد: لازم است که مخزن اصلی امضا شده باشد، اما نیازی به امضای مخازن اضافی نیست. اگر \f(CW\*(C`gpg\*(C'\fR در دسترس نباشد، به طور پیش‌فرض امضاها بررسی نمی‌شوند و هیچ اعتبارسنجی انجام نمی‌گیرد، اما \f(CW\*(C`tlmgr\*(C'\fR همچنان به صورت عادی به کار خود ادامه می‌دهد. .PP رفتار اعتبارسنجی را می‌توان با گزینه خط فرمان و فایل پیکربندی \f(CW\*(C`verify\-repo\*(C'\fR کنترل کرد که یکی از مقادیر زیر را می‌پذیرد: \f(CW\*(C`none\*(C'\fR، \f(CW\*(C`main\*(C'\fR، یا \f(CW\*(C`all\*(C'\fR. با مقدار \f(CW\*(C`none\*(C'\fR، مطلقاً هیچ اعتبارسنجی انجام نمی‌شود. با مقدار \f(CW\*(C`main\*(C'\fR (پیش‌فرض)، اعتبارسنجی فقط برای مخزن اصلی و تنها در صورتی که \f(CW\*(C`gpg\*(C'\fR در دسترس باشد الزامی است؛ هرچند برای همه مخازن تلاش می‌شود، اما نبود امضای مخازن فرعی منجر به خطا نخواهد شد. در نهایت، در مورد \f(CW\*(C`all\*(C'\fR، برنامه \f(CW\*(C`gpg\*(C'\fR باید در دسترس باشد و تمام مخازن باید دارای امضا باشند. .PP در تمام موارد، اگر امضایی بررسی شده و اعتبارسنجی آن با شکست مواجه گردد، یک خطا رخ می‌دهد. .PP اعتبارسنجی رمزنگاری مستلزم موفقیت‌آمیز بودن بررسی چک‌سام (که در بالا توضیح داده شد) و یک برنامه GnuPG (\f(CW\*(C`gpg\*(C'\fR) کارآمد است (برای روش جستجو، بخش زیر را ببینید). سپس، مگر در صورتی که اعتبارسنجی رمزنگاری غیرفعال شده باشد، فایل امضای (\f(CW\*(C`texlive.tlpdb.*.asc\*(C'\fR) مربوط به فایل چک‌سام دانلود شده و صحت امضا اعتبارسنجی می‌شود. این امضا توسط کلید GPG توزیع TeX Live به شناسه 0x0D5E5D9106BAB6BC ایجاد شده است، که به نوبه خود با کلید Karl Berry به شناسه 0x0716748A30D155AD و کلید Norbert Preining به شناسه 0x6CACA448860CDC13 امضا شده است. تمام این کلیدها از سرورهای کلید استاندارد قابل دریافت هستند. .PP کلیدهای معتمد اضافی را می‌توان با استفاده از اقدام \f(CW\*(C`key\*(C'\fR اضافه کرد. .SS "پیکربندی فراخوانی GnuPG (Configuration of GnuPG invocation)" .IX Subsection "Configuration of GnuPG invocation" فایل اجرایی مورد استفاده برای GnuPG به این ترتیب جستجو می‌شود: اگر متغیر محیطی \f(CW\*(C`TL_GNUPG\*(C'\fR تنظیم شده باشد، بررسی شده و استفاده می‌شود؛ در غیر این صورت \f(CW\*(C`gpg\*(C'\fR بررسی می‌شود؛ و در نهایت \f(CW\*(C`gpg2\*(C'\fR بررسی خواهد شد. .PP تنظیمات و سفارشی‌سازی بیشتر فراخوانی \f(CW\*(C`gpg\*(C'\fR را می‌توان با استفاده از دو متغیر محیطی انجام داد: \f(CW\*(C`TL_GNUPGHOME\*(C'\fR که به عنوان مقدار برای \f(CW\*(C`\-\-homedir\*(C'\fR به \f(CW\*(C`gpg\*(C'\fR ارسال می‌شود، و \f(CW\*(C`TL_GNUPGARGS\*(C'\fR که جایگزین گزینه‌های پیش‌فرض \f(CW\*(C`\-\-no\-secmem\-warning \-\-no\-permission\-warning\*(C'\fR می‌شود..SH "حالت کاربر (USER MODE)" .IX Header "USER MODE" دستور \&\f(CW\*(C`tlmgr\*(C'\fR روشی محدودشده موسوم به «حالت کاربر» (\`\`user mode\*(Aq\*(Aq) ارائه می‌دهد تا بتوان درخت‌های texmf دلخواه را به همان شیوه نصب اصلی مدیریت کرد. برای نمونه، این قابلیت به افرادی که مجوز نوشتن در مسیر نصب را ندارند اجازه می‌دهد بسته‌ها را در درختی متعلق به خودشان به‌روزرسانی یا نصب کنند. .PP دستور \&\f(CW\*(C`tlmgr\*(C'\fR با گزینه خط فرمان \&\f(CW\*(C`\-\-usermode\*(C'\fR به حالت کاربر جابه‌جا می‌شود. این جابه‌جایی به‌صورت خودکار صورت نمی‌گیرد و هیچ تنظیمی هم برای آن در فایل‌های پیکربندی وجود ندارد. بنابراین، هر بار که نیاز به فعال‌سازی حالت کاربر باشد، این گزینه باید صراحتاً در خط فرمان مشخص شود. .PP این حالت از \f(CW\*(C`tlmgr\*(C'\fR روی یک درخت کاربر کار می‌کند که به‌طور پیش‌فرض مقدار متغیر \&\f(CW\*(C`TEXMFHOME\*(C'\fR است. این مقدار را می‌توان با گزینه خط فرمان \f(CW\*(C`\-\-usertree\*(C'\fR بازنویسی کرد. در ادامه هر جا که از درخت کاربر سخن می‌گوییم، منظور یا \&\f(CW\*(C`TEXMFHOME\*(C'\fR است یا مقداری که در خط فرمان تعیین شده است. .PP همه عملیات‌ها در حالت کاربر مجاز نیستند؛ \f(CW\*(C`tlmgr\*(C'\fR به شما هشدار خواهد داد و هیچ اقدام مسئله‌سازی را اجرا نخواهد کرد. در حال حاضر عملیات \f(CW\*(C`platform\*(C'\fR پشتیبانی نمی‌شود (و احتمالاً هرگز نخواهد شد). عملیات \f(CW\*(C`gui\*(C'\fR نیز فعلاً پشتیبانی نمی‌شود، اما ممکن است در انتشار‌های آینده در دسترس قرار گیرد. .PP برخی از عملیات‌های \f(CW\*(C`tlmgr\*(C'\fR به مجوز نوشتن نیازی ندارند و از این رو در هر دو حالت کاربر و حالت عادی یکسان عمل می‌کنند. در حال حاضر این عملیات‌ها عبارتند از: \f(CW\*(C`check\*(C'\fR، \&\f(CW\*(C`help\*(C'\fR، \f(CW\*(C`list\*(C'\fR، \f(CW\*(C`print\-platform\*(C'\fR، \f(CW\*(C`print\-platform\-info\*(C'\fR، \f(CW\*(C`search\*(C'\fR، \&\f(CW\*(C`show\*(C'\fR، \f(CW\*(C`version\*(C'\fR. .PP از سوی دیگر، بیشتر عملیات‌های مربوط به مدیریت بسته‌ها نیازمند مجوز نوشتن هستند و در نتیجه، همان‌گونه که در زیر آمده است، در حالت کاربر رفتار متفاوتی دارند: \f(CW\*(C`install\*(C'\fR، \f(CW\*(C`update\*(C'\fR، \f(CW\*(C`remove\*(C'\fR، \f(CW\*(C`option\*(C'\fR، \f(CW\*(C`paper\*(C'\fR، \&\f(CW\*(C`generate\*(C'\fR، \f(CW\*(C`backup\*(C'\fR، \f(CW\*(C`restore\*(C'\fR، \f(CW\*(C`uninstall\*(C'\fR، \f(CW\*(C`symlinks\*(C'\fR. .PP پیش از استفاده از \f(CW\*(C`tlmgr\*(C'\fR در حالت کاربر، باید درخت کاربر را با عملیات \f(CW\*(C`init\-usertree\*(C'\fR برپا کنید. این دستور مسیرهای \fIusertree\fR\f(CW\*(C`/web2c\*(C'\fR و \&\fIusertree\fR\f(CW\*(C`/tlpkg/tlpobj\*(C'\fR و یک فایل کمینه \&\fIusertree\fR\f(CW\*(C`/tlpkg/texlive.tlpdb\*(C'\fR ایجاد می‌کند. پس از آن، می‌توانید با افزودن گزینه خط فرمان \&\f(CW\*(C`\-\-usermode\*(C'\fR به \&\f(CW\*(C`tlmgr\*(C'\fR بگویید که عملیات‌های (پشتیبانی‌شده) را اجرا کند. .PP در حالت کاربر، فایل \fIusertree\fR\f(CW\*(C`/tlpkg/texlive.tlpdb\*(C'\fR تنها شامل بسته‌هایی است که با استفاده از \f(CW\*(C`tlmgr\*(C'\fR در درخت کاربر نصب شده‌اند، به همراه گزینه‌های اضافی برگرفته از بسته «مجازی» \&\f(CW\*(C`00texlive.installation\*(C'\fR (مشابه با \&\f(CW\*(C`texlive.tlpdb\*(C'\fR در نصب اصلی). .PP تمام عملیات‌های مرتبط با بسته‌ها در حالت کاربر تنها بر روی بسته‌هایی قابل انجام است که تحت عنوان \f(CW\*(C`relocatable\*(C'\fR (قابل جابه‌جایی) شناخته می‌شوند. این امر بسته‌های حاوی فایل‌های اجرایی و چند بسته پایه دیگر را مستثنی می‌کند. از میان حدود ۲۵۰۰ بسته موجود در TeX Live، اکثریت قریب به اتفاق قابل جابه‌جایی هستند و می‌توان آن‌ها را در یک درخت کاربر نصب کرد. .PP شرح تغییرات رفتار عملیات‌ها در حالت کاربر: .SS "نصب در حالت کاربر (User mode install)" .IX Subsection "User mode install" در حالت کاربر، عملیات \f(CW\*(C`install\*(C'\fR بررسی می‌کند که بسته و تمام وابستگی‌های آن یا قابل جابه‌جایی باشند و یا از پیش در سطح سیستم نصب شده باشند. اگر چنین باشد، تمام بسته‌های فشرده (containers) مورد نیاز برای نصب را در درخت کاربر استخراج می‌کند (مجدداً، یا \f(CW\*(C`TEXMFHOME\*(C'\fR یا مقدار مشخص‌شده با \f(CW\*(C`\-\-usertree\*(C'\fR) و بسته‌های مربوطه را به \f(CW\*(C`texlive.tlpdb\*(C'\fR متعلق به درخت کاربر اضافه می‌کند (و در صورت لزوم آن را ایجاد می‌نماید). .PP در حال حاضر نصب یک مجموعه (collection) در حالت کاربر، تمامی بسته‌های وابسته را نصب می‌کند، اما بر خلاف حالت عادی، مجموعه‌های وابسته را نصب \fIنمی‌کند\fR. به عنوان مثال، در حالت عادی دستور \f(CW\*(C`tlmgr install collection\-context\*(C'\fR بسته‌های \f(CW\*(C`collection\-basic\*(C'\fR و سایر مجموعه‌ها را نصب می‌کند، در حالی که در حالت کاربر، \fIفقط\fR بسته‌های قید شده در \&\f(CW\*(C`collection\-context\*(C'\fR نصب خواهند شد. .PP اگر بسته‌ای شامل فایل‌های نگاشت (map files) در حالت کاربر نصب شود، یک نسخه پشتیبان از فایل \f(CW\*(C`updmap.cfg\*(C'\fR کاربر در مسیر \f(CW\*(C`USERTREE/web2c/\*(C'\fR تهیه شده و سپس این فایل بر پایه فهرست بسته‌های نصب‌شده دوباره تولید می‌شود. .SS "پشتیبان‌گیری، بازیابی، حذف و به‌روزرسانی در حالت کاربر (User mode backup, restore, remove, update)" .IX Subsection "User mode backup, restore, remove, update" در حالت کاربر، این عملیات‌ها پیش از ادامه کار بررسی می‌کنند که تمام بسته‌های مورد نظر در درخت کاربر نصب شده باشند؛ در غیر این صورت، رفتاری کاملاً مشابه با حالت عادی خواهند داشت. .SS "عملیات‌های generate، option و paper در حالت کاربر (User mode generate, option, paper)" .IX Subsection "User mode generate, option, paper" در حالت کاربر، این عملیات‌ها تنها بر روی فایل‌های پیکربندی درخت کاربر و/یا \f(CW\*(C`texlive.tlpdb\*(C'\fR اعمال می‌شوند. .SS "گزارش‌های حالت کاربر (User mode logs)" .IX Subsection "User mode logs" در حالت کاربر، فایل‌های \f(CW\*(C`tlmgr.log\*(C'\fR و به‌جای دایرکتوری \f(CW\*(C`TEXMFSYSVAR/web2c/\*(C'\fR در دایرکتوری \&\f(CW\*(C`TEXMFVAR/web2c/\*(C'\fR نوشته می‌شوند. .SH "مخازن چندگانه (MULTIPLE REPOSITORIES)" .IX Header "MULTIPLE REPOSITORIES" مخزن اصلی TeX Live دربردارنده گستره عظیمی از بسته‌ها است. با این حال، مخازن محلی دیگر می‌توانند برای تأمین منابعی که به‌صورت محلی نصب می‌شوند (مانند قلم‌های تجاری یا شیوه‌نامه‌های اختصاصی سازمان‌ها) سودمند باشند. افزون بر این، مخازن جایگزین، بسته‌هایی را توزیع می‌کنند که به هر دلیلی امکان گنجاندن آن‌ها در TeX Live وجود ندارد. .PP ساده‌ترین و مطمئن‌ترین شیوه این است که موقتاً منبع نصب را به مخزن دلخواه تغییر دهید (با استفاده از گزینه‌های خط فرمان \f(CW\*(C`\-repository\*(C'\fR یا \&\f(CW\*(C`option repository\*(C'\fR) و سپس عملیات‌های خود را به انجام برسانید. .PP با این وجود، اگر در یک بازه زمانی پیوسته از چندین مخزن استفاده می‌کنید، جابه‌جایی دستی و صریح میان آن‌ها دشوار خواهد بود. از این رو، امکان معرفی مخازن اضافی به \f(CW\*(C`tlmgr\*(C'\fR فراهم شده است. دستور اصلی برای این کار \f(CW\*(C`tlmgr repository add\*(C'\fR است. ادامه این بخش توضیحات بیشتری در این باره ارائه می‌دهد. .PP هنگام استفاده از چندین مخزن، یکی از آن‌ها باید به‌عنوان مخزن اصلی تعیین شود که عمده بسته‌های نصب‌شده از آن توزیع می‌گردد. هنگامی که از نصب تک‌مخزنی به نصب چندمخزنی تغییر وضعیت می‌دهید، همان مخزن منفرد پیشین به‌عنوان مخزن اصلی در نظر گرفته خواهد شد. .PP به‌طور پیش‌فرض، حتی در صورت پیکربندی چند مخزن، بسته‌ها \&\fIهمچنان\fR \fIتنها\fR از مخزن اصلی نصب می‌شوند. بنابراین، صرفاً افزودن یک مخزن دوم سبب فعال‌سازی نصب بسته‌ها از آنجا نمی‌شود. شما باید از طریق تعیین قواعدی که با نام «پین کردن» (\`\`pinning\*(Aq\*(Aq) شناخته می‌شوند، معین کنید کدام بسته‌ها باید از مخزن جدید دریافت گردند؛ این موضوع در ادامه شرح داده شده است. .SS "پین کردن (Pinning)" .IX Subsection "Pinning" هنگامی که یک بسته مانند \f(CW\*(C`foo\*(C'\fR به مخزنی پین می‌شود، بسته \f(CW\*(C`foo\*(C'\fR در هر مخزن دیگری، حتی اگر شماره بازبینی (revision) بالاتری داشته باشد، به‌عنوان گزینه قابل نصب مد نظر قرار نخواهد گرفت. .PP همان‌گونه که در بالا ذکر شد، به‌طور پیش‌فرض همه‌چیز به مخزن اصلی پین شده است. اکنون بیایید نمونه‌ای از برپایی یک مخزن دوم و فعال‌سازی به‌روزرسانی‌های یک بسته از آن را بررسی کنیم. .PP ابتدا بررسی کنید که پشتیبانی از مخازن چندگانه فعال باشد و تنها یک مخزن فعال وجود داشته باشد (که حالت پیش‌فرض نیز همین است): .PP .Vb 3 \& $ tlmgr repository list \& List of repositories (with tags if set): \& /var/www/norbert/tlnet .Ve .PP بسیار خوب. حال بیایید مخزن \f(CW\*(C`tlcontrib\*(C'\fR را (که مخزنی واقعی و میزبانی‌شده در است) با برچسب \f(CW\*(C`tlcontrib\*(C'\fR اضافه کنیم: .PP .Vb 1 \& $ tlmgr repository add http://contrib.texlive.info/current tlcontrib .Ve .PP فهرست مخازن را بار دیگر بررسی کنید: .PP .Vb 4 \& $ tlmgr repository list \& List of repositories (with tags if set): \& http://contrib.texlive.info/current (tlcontrib) \& /var/www/norbert/tlnet (main) .Ve .PP اکنون یک قاعده پین کردن تعیین می‌کنیم تا بسته \f(CW\*(C`classico\*(C'\fR از \&\f(CW\*(C`tlcontrib\*(C'\fR دریافت شود: .PP .Vb 1 \& $ tlmgr pinning add tlcontrib classico .Ve .PP بررسی کنید که بسته \f(CW\*(C`classico\*(C'\fR قابل یافتن باشد: .PP .Vb 5 \& $ tlmgr show classico \& package: classico \& ... \& shortdesc: URW Classico fonts \& ... .Ve .PP \&\- نصب بسته \f(CW\*(C`classico\*(C'\fR: .PP .Vb 4 \& $ tlmgr install classico \& tlmgr: package repositories: \& ... \& [1/1, ??:??/??:??] install: classico @tlcontrib [737k] .Ve .PP در این خروجی مشاهده می‌کنید که بسته \f(CW\*(C`classico\*(C'\fR از مخزن \f(CW\*(C`tlcontrib\*(C'\fR (\f(CW@tlcontrib\fR) نصب شده است. .PP در پایان، دستور \f(CW\*(C`tlmgr pinning\*(C'\fR از حذف بسته‌هایی مشخص یا تمامی بسته‌ها از یک مخزن معین نیز پشتیبانی می‌کند: .PP .Vb 2 \& $ tlmgr pinning remove tlcontrib classico # remove just classico \& $ tlmgr pinning remove tlcontrib \-\-all # take nothing from tlcontrib .Ve .PP خلاصه‌ای از عملیات‌های \f(CW\*(C`tlmgr pinning\*(C'\fR در بالا آمده است..SH "رابط گرافیکی برای TLMGR (GUI FOR TLMGR)" .IX Header "GUI FOR TLMGR" رابط گرافیکی کاربر برای \f(CW\*(C`tlmgr\*(C'\fR نیازمند Perl/Tk است. برای سیستم‌های مبتنی بر Unix، باید Perl/Tk (و البته خود Perl) بیرون از TL نصب شده باشند. حاوی فهرستی از دستورهای فراخوانی برای برخی توزیع‌ها است. برای Windows، ماژول‌های لازم دیگر همراه با TeX Live عرضه نمی‌شوند، بنابراین باید یک Perl خارجی که شامل آن‌ها باشد در دسترس داشته باشید. .PP در اینجا صحبت از رابط گرافیکی تعبیه‌شده در خود tlmgr است، نه سایر رابط‌های گرافیکی tlmgr که عبارت‌اند از: tlshell (مبتنی بر Tcl/Tk)،‏ tlcockpit (مبتنی بر Java) و فقط در سیستم‌های Mac،‏ TeX Live Utility. این‌ها به عنوان برنامه‌هایی جداگانه فراخوانی می‌شوند. .PP حالت رابط گرافیکی tlmgr با فراخوانی \f(CW\*(C`tlmgr gui\*(C'\fR آغاز می‌شود؛ به شرط آن‌که Tk قابل بارگذاری باشد، رابط گرافیکی کاربر نمایش داده خواهد شد. پنجرهٔ اصلی شامل یک نوار منو، بخش نمایش اصلی، و یک ناحیهٔ وضعیت است که پیام‌های معمول کنسول در آنجا نمایش داده می‌شوند. .PP در بخش نمایش اصلی سه قسمت عمده وجود دارد: ناحیهٔ \f(CW\*(C`Display configuration\*(C'\fR (پیکربندی نمایش)، فهرست بسته‌ها، و دکمه‌های عملیات. .PP همچنین در بالا سمت راست، مخزنِ بارگذاری‌شدهٔ فعلی نشان داده می‌شود؛ این قسمت به عنوان یک دکمه نیز عمل می‌کند و در صورت کلیک، برای بارگذاری مخزن پیش‌فرض تلاش خواهد کرد. برای بارگذاری یک مخزن متفاوت، گزینهٔ منوی \f(CW\*(C`tlmgr\*(C'\fR را ببینید. .PP در نهایت، ناحیهٔ وضعیت در پایین پنجره اطلاعات بیشتری را دربارهٔ رویدادهای در حال وقوع ارائه می‌دهد. .SS "صفحه نمایش اصلی (Main display)" .IX Subsection "Main display" \fIناحیهٔ پیکربندی نمایش (Display configuration area)\fR .IX Subsection "Display configuration area" .PP بخش نخست از صفحه نمایش اصلی به شما امکان می‌دهد مشخص (فیلتر) کنید چه بسته‌هایی نشان داده شوند. به صورت پیش‌فرض، همه نمایش داده می‌شوند. تغییرات در اینجا بلافاصله اعمال و منعکس می‌شوند. .IP "Status (وضعیت)" 4 .IX Item "Status" انتخاب این‌که همهٔ بسته‌ها نمایش داده شوند (پیش‌فرض)، فقط بسته‌های نصب‌شده، فقط بسته‌های نصب\fIنشده\fR، یا تنها بسته‌هایی که به‌روزرسانی برای آن‌ها موجود است. .IP "Category (دسته‌بندی)" 4 .IX Item "Category" انتخاب دسته‌های نمایشی: بسته‌ها (packages)، مجموعه‌ها (collections)، و/یا طرح‌ها (schemes). این موارد به اختصار در بخش «توضیحات (DESCRIPTION)» در بالا توضیح داده شده‌اند. .IP "Match (تطابق)" 4 .IX Item "Match" انتخاب بسته‌های منطبق با یک الگوی خاص. به صورت پیش‌فرض، این گزینه هم توضیحات و هم نام فایل‌ها را جستجو می‌کند. شما همچنین می‌توانید زیرمجموعه‌ای را برای جستجو انتخاب کنید. .IP "Selection (گزینش)" 4 .IX Item "Selection" محدود کردن بسته‌های نمایشی به موارد انتخاب‌شده، انتخاب‌نشده، یا همه. در اینجا، «انتخاب‌شده» بدین معناست که جعبهٔ علامت‌زدن در ابتدای سطر بسته تیک خورده باشد. .IP "Display configuration buttons (دکمه‌های پیکربندی نمایش)" 4 .IX Item "Display configuration buttons" در سمت راست سه دکمه قرار دارد: انتخاب همهٔ بسته‌ها، لغو انتخاب همه (عدم انتخاب هیچ‌کدام)، و بازنشانی تمام این فیلترها به مقادیر پیش‌فرض، یعنی نمایش تمام موارد موجود. .PP \fIناحیهٔ فهرست بسته‌ها (Package list area)\fR .IX Subsection "Package list area" .PP ناحیهٔ دوم از صفحه نمایش اصلی، تمام بسته‌های نصب‌شده را فهرست می‌کند. اگر یک مخزن بارگذاری شده باشد، بسته‌های موجودی که نصب نشده‌اند نیز فهرست خواهند شد. .PP دوبار کلیک روی سطر هر بسته، پنجره‌ای اطلاعاتی با جزئیات بیشتر را باز می‌کند: توضیحات کامل، فایل‌های شامل‌شده، و غیره. .PP هر سطر از فهرست بسته‌ها شامل موارد زیر است: .IP "یک جعبهٔ علامت‌زدن (a checkbox)" 4 .IX Item "a checkbox" برای انتخاب بسته‌های مشخص استفاده می‌شود؛ برخی از دکمه‌های عملیاتی (پایین را ببینید) تنها روی بسته‌های انتخاب‌شده کار می‌کنند. .IP "نام بسته (package name)" 4 .IX Item "package name" نام (شناسهٔ) بسته، همان‌گونه که در پایگاه داده قید شده است. .IP "بازنگری محلی [و نسخه] (local revision and version)" 4 .IX Item "local revision (and version)" اگر بسته نصب شده باشد، شماره بازنگری TeX Live برای بستهٔ نصب‌شده نمایش داده می‌شود. اگر نسخهٔ کاتالوگی برای این بسته در پایگاه داده موجود باشد، درون پرانتز نشان داده خواهد شد. با این حال، نسخهٔ کاتالوگ برخلاف بازنگری TL، تضمینی ندارد که بازتاب‌دهندهٔ دقیق نسخهٔ نصب‌شده در عمل باشد. .IP "بازنگری دوردست [و نسخه] (remote revision and version)" 4 .IX Item "remote revision (and version)" اگر مخزنی بارگذاری شده باشد، بازنگری بسته در مخزن (در صورت وجود) نشان داده می‌شود. همانند ستون محلی، در صورت ارائهٔ نسخهٔ کاتالوگ، نمایش داده خواهد شد. همچنین مانند ستون محلی، ممکن است نسخهٔ کاتالوگ قدیمی یا نامعتبر باشد. .IP "شرح کوتاه (short description)" 4 .IX Item "short description" توضیحات کوتاه بسته. .PP \fIدکمه‌های عملیاتی صفحه نمایش اصلی (Main display action buttons)\fR .IX Subsection "Main display action buttons" .PP در زیر فهرست بسته‌ها چندین دکمه قرار دارد: .IP "Update all installed" 4 .IX Item "Update all installed" این دکمه دستور \f(CW\*(C`tlmgr update \-\-all\*(C'\fR را فراخوانی می‌کند؛ یعنی تلاش می‌کند تمام بسته‌های موجود را به‌روزرسانی کند. در زیر این دکمه کلیدی دوحالته وجود دارد که امکان نصب مجدد بسته‌های از پیش حذف‌شده را به عنوان بخشی از این عملیات فراهم می‌کند. .Sp چهار دکمهٔ دیگر تنها روی بسته‌های انتخاب‌شده اثر می‌گذارند؛ یعنی مواردی که جعبهٔ علامت‌زدن در ابتدای سطر آن‌ها تیک خورده باشد. .IP Update 4 .IX Item "Update" تنها بسته‌های انتخاب‌شده را به‌روزرسانی می‌کند. .IP Install 4 .IX Item "Install" بسته‌های انتخاب‌شده را نصب می‌کند؛ مانند \f(CW\*(C`tlmgr install\*(C'\fR عمل می‌کند، یعنی وابستگی‌ها را نیز نصب می‌نماید. بدین ترتیب، نصب یک مجموعه منجر به نصب تمام بسته‌های تشکیل‌دهندهٔ آن می‌شود. .IP Remove 4 .IX Item "Remove" بسته‌های انتخاب‌شده را حذف می‌کند؛ مانند \f(CW\*(C`tlmgr remove\*(C'\fR عمل می‌کند، یعنی وابستگی‌های مجموعه‌ها را نیز حذف خواهد کرد (اما وابستگی‌های بسته‌های معمولی را خیر). .IP Backup 4 .IX Item "Backup" از بسته‌های انتخاب‌شده نسخهٔ پشتیبان تهیه می‌کند؛ مانند \f(CW\*(C`tlmgr backup\*(C'\fR عمل می‌کند. این عملیات نیازمند تنظیم گزینهٔ \f(CW\*(C`backupdir\*(C'\fR است (بخش \f(CW\*(C`Options \-\*(C'\fR General> را ببینید)..SS "نوار منو (Menu bar)" .IX Subsection "Menu bar" موارد زیر را می‌توان در نوار منو یافت: .ie n .IP "منوی ""tlmgr""" 4 .el .IP "منوی \f(CWtlmgr\fR" 4 .IX Item "tlmgr menu" گزینه‌های این بخش مخازن گوناگون را بارگذاری می‌کنند: مخزن پیش‌فرض تعیین‌شده در پایگاه‌دادهٔ TeX Live، مخزن شبکهٔ پیش‌فرض، مخزن مشخص‌شده در خط فرمان (در صورت وجود)، و مخزنی که به‌صورت دستی و دلخواه وارد شده باشد. همچنین عملیات بسیار ضروری \f(CW\*(C`quit\*(C'\fR را نیز در بر دارد. .ie n .IP "منوی ""Options"" (گزینه‌ها)" 4 .el .IP "منوی \f(CWOptions\fR (گزینه‌ها)" 4 .IX Item "Options menu" دسترسی به چندین گروه از گزینه‌ها را فراهم می‌کند: \f(CW\*(C`Paper\*(C'\fR (پیکربندی اندازه‌های پیش‌فرض کاغذ)، \f(CW\*(C`Platforms\*(C'\fR (تنها در یونیکس، پیکربندی سکوهای پشتیبانی‌شده/نصب‌شده)، \f(CW\*(C`GUI Language\*(C'\fR (انتخاب زبان رابط کاربری گرافیکی)، و \f(CW\*(C`General\*(C'\fR (سایر موارد). .Sp چندین گزینهٔ دووضعیتی (toggle) نیز در اینجا قرار دارند. نخستین مورد \f(CW\*(C`Expert options\*(C'\fR است که به‌طور پیش‌فرض فعال است. اگر آن را غیرفعال کنید، در راه‌اندازی بعدی رابط کاربری گرافیکی، صفحه‌ای ساده‌شده نمایش داده می‌شود که تنها عملکردهای اصلی را نشان می‌دهد. این تنظیم در فایل پیکربندی \&\f(CW\*(C`tlmgr\*(C'\fR ذخیره می‌شود؛ برای جزئیات به بخش \(lqCONFIGURATION FILE FOR TLMGR\(rq مراجعه کنید. .Sp سایر گزینه‌های دووضعیتی همگی به‌طور پیش‌فرض غیرفعال هستند: خروجی اشکال‌زدایی (debugging)، غیرفعال کردن نصب خودکار بسته‌های جدید، و غیرفعال کردن حذف خودکار بسته‌های حذف‌شده از سرور. تغییر نسنجیده در گزینه‌های مربوط به این‌که چه بسته‌هایی نصب شوند یا نشوند ممکن است منجر به ناهماهنگی در نصب TeX Live شود؛ برای نمونه، هنگامی که نام یک بسته تغییر می‌کند. .ie n .IP "منوی ""Actions"" (عملیات)" 4 .el .IP "منوی \f(CWActions\fR (عملیات)" 4 .IX Item "Actions menu" دسترسی به چندین اقدام را فراهم می‌کند: به‌روزرسانی پایگاه‌دادهٔ نام فایل‌ها (معروف به \&\f(CW\*(C`ls\-R\*(C'\fR، \f(CW\*(C`mktexlsr\*(C'\fR، \f(CW\*(C`texhash\*(C'\fR)، بازسازی همهٔ فرمت‌ها (\f(CW\*(C`fmtutil\-sys \&\-\-all\*(C'\fR)، به‌روزرسانی پایگاه‌دادهٔ نگاشت فونت (\f(CW\*(C`updmap\-sys\*(C'\fR)، بازیابی از نسخهٔ پشتیبان یک بسته، و استفاده از پیوندهای نمادین در دایرکتوری‌های سیستمی (نه در ویندوز). .Sp آخرین اقدام، حذف کل بستهٔ نصب‌شدهٔ TeX Live است (این مورد نیز در ویندوز دردسترس نیست). .ie n .IP "منوی ""Help"" (راهنما)" 4 .el .IP "منوی \f(CWHelp\fR (راهنما)" 4 .IX Item "Help menu" دسترسی به دفترچهٔ راهنمای TeX Live (همچنین در وب در ) و کادر گفتگوی معمول \`\`درباره\*(Aq\*(Aq (\`\`About\*(Aq\*(Aq) را فراهم می‌آورد. .SS "گزینه‌های رابط کاربری گرافیکی (GUI options)" .IX Subsection "GUI options" برخی از گزینه‌های عمومی Perl/Tk را می‌توان به همراه \f(CW\*(C`tlmgr gui\*(C'\fR برای کنترل نحوهٔ نمایش مشخص کرد: .ie n .IP """\-background"" \fIcolor\fR" 4 .el .IP "\f(CW\-background\fR \fIcolor\fR" 4 .IX Item "-background color" تنظیم رنگ پس‌زمینه. .ie n .IP """\-font """" \fIfontname\fR \fIfontsize\fR """"""" 4 .el .IP "\f(CW\-font ""\fR \fIfontname\fR \fIfontsize\fR \f(CW""\fR" 4 .IX Item "-font "" fontname fontsize """ تنظیم فونت، برای نمونه \f(CW\*(C`tlmgr gui \-font "helvetica 18"\*(C'\fR. آرگومان \&\f(CW\*(C`\-font\*(C'\fR باید درون نقل‌قول قرار گیرد، یعنی به‌صورت یک رشتهٔ واحد ارسال شود. .ie n .IP """\-foreground"" \fIcolor\fR" 4 .el .IP "\f(CW\-foreground\fR \fIcolor\fR" 4 .IX Item "-foreground color" تنظیم رنگ پیش‌زمینه. .ie n .IP """\-geometry"" \fIgeomspec\fR" 4 .el .IP "\f(CW\-geometry\fR \fIgeomspec\fR" 4 .IX Item "-geometry geomspec" تنظیم هندسهٔ X، برای نمونه \f(CW\*(C`tlmgr gui \-geometry 1024x512\-0+0\*(C'\fR پنجره‌ای با اندازهٔ (تقریبی) ارائه‌شده در گوشهٔ بالا\-راست نمایشگر ایجاد می‌کند. .ie n .IP """\-xrm"" \fIxresource\fR" 4 .el .IP "\f(CW\-xrm\fR \fIxresource\fR" 4 .IX Item "-xrm xresource" ارسال رشتهٔ منبع دلخواه سامانهٔ پنجره‌ای X با عنوان \fIxresource\fR. .PP چندین گزینهٔ کمتر شناخته‌شدهٔ دیگر نیز شناسایی می‌شوند اما در اینجا ذکر نشده‌اند. برای فهرست کامل به مستندات Perl/Tk در () و برای اطلاعات عمومی به هر یک از مستندات سامانهٔ پنجره‌ای X مراجعه کنید. .SH "خروجی ماشین‌خوان (MACHINE\-READABLE OUTPUT)" .IX Header "MACHINE-READABLE OUTPUT" با گزینهٔ \f(CW\*(C`\-\-machine\-readable\*(C'\fR، دستور \f(CW\*(C`tlmgr\*(C'\fR اطلاعات را در قالب خط‌محور و ثابتی که در اینجا شرح داده شده در stdout می‌نویسد، و پیام‌های اطلاع‌رسانی معمول برای کاربران در stderr نوشته می‌شوند (در حالی که در حالت عادی در stdout نوشته می‌شوند). هدف این است که یک برنامه بتواند تمامی اطلاعات مورد نیاز خود را تنها با خواندن stdout دریافت کند. .PP در حال حاضر این گزینه تنها برای عملیات‌های update،‏ install و \(lqoption\(rq اعمال می‌شود. .ie n .SS "خروجی ماشین‌خوان ""update"" و ""install""" .el .SS "خروجی ماشین‌خوان \f(CWupdate\fP و \f(CWinstall\fP" .IX Subsection "Machine-readable update and install output" قالب خروجی به صورت زیر است: .PP .Vb 7 \& fieldname "\et" value \& ... \& "end\-of\-header" \& pkgname status localrev serverrev size runtime esttot \& ... \& "end\-of\-updates" \& other output from post actions, not in machine readable form .Ve .PP بخش سرایند در حال حاضر دو فیلد دارد: \f(CW\*(C`location\-url\*(C'\fR (منبع مخزنی که به‌روزرسانی‌ها از آن دریافت می‌شوند) و \&\f(CW\*(C`total\-bytes\*(C'\fR (تعداد کل بایت‌هایی که باید بارگیری شوند). .PP فیلدهای \fIlocalrev\fR و \fIserverrev\fR برای هر بسته به‌ترتیب شمارهٔ بازنگری (revision) در نصب محلی و در مخزن سرور هستند. فیلد \fIsize\fR تعداد بایت‌هایی است که باید بارگیری شوند، یعنی اندازهٔ فایل tar فشرده‌شده برای یک نصب شبکه‌ای، نه اندازهٔ غیرفشرده‌شده پس از استخراج. فیلدهای runtime و esttot تنها برای بسته‌های به‌روزشده و بسته‌های نصب خودکار (auto\-install) وجود دارند و شامل زمان سپری‌شده از آغاز نصب/به‌روزرسانی و تخمین کل زمان هستند. .PP پایان خطوط ممکن است بسته به سکوی فعلی LF یا CRLF باشد. .ie n .IP """location\-url"" \fIlocation\fR" 4 .el .IP "\f(CWlocation\-url\fR \fIlocation\fR" 4 .IX Item "location-url location" مقدار \fIlocation\fR ممکن است یک آدرس url (از جمله \f(CW\*(C`file:///foo/bar/...\*(C'\fR) یا نام یک دایرکتوری (\f(CW\*(C`/foo/bar\*(C'\fR) باشد. این همان مخزن بسته‌ای است که اطلاعات جدید بسته از آن دریافت شده است. .ie n .IP """total\-bytes"" \fIcount\fR" 4 .el .IP "\f(CWtotal\-bytes\fR \fIcount\fR" 4 .IX Item "total-bytes count" مقدار \fIcount\fR صرفاً یک عدد در مبنای ۱۰ است؛ مجموع اندازهٔ تمام بسته‌هایی که نیازمند به‌روزرسانی یا نصب هستند (و در ادامه فهرست شده‌اند). .PP سپس خطی می‌آید که فقط شامل رشتهٔ دقیق \f(CW\*(C`end\-of\-header\*(C'\fR است. .PP هر یک از خطوط بعدی تا رسیدن به خطی با رشتهٔ متنی \f(CW\*(C`end\-of\-updates\*(C'\fR، وضع یک بسته را گزارش می‌دهند. فیلدهای هر خط با یک نویسهٔ تب (tab) جدا می‌شوند. این فیلدها عبارتند از: .IP \fIpkgname\fR 4 .IX Item "pkgname" شناسهٔ بستهٔ TeX Live، همراه با پسوند احتمالی سکو برای فایل‌های اجرایی. برای نمونه، \f(CW\*(C`pdftex\*(C'\fR و \f(CW\*(C`pdftex.i386\-linux\*(C'\fR به عنوان دو بستهٔ جداگانه، هر کدام در یک خط، ارائه می‌شوند. .IP \fIstatus\fR 4 .IX Item "status" وضعیت به‌روزرسانی بسته. یک نویسه، به شرح زیر: .RS 4 .ie n .IP """d""" 8 .el .IP \f(CWd\fR 8 .IX Item "d" بسته روی سرور حذف شده است. .ie n .IP """f""" 8 .el .IP \f(CWf\fR 8 .IX Item "f" بسته از نصب محلی حذف شده است، هرچند مجموعه‌ای به آن وابسته بوده است. (برای نمونه، کاربر دستور \f(CW\*(C`tlmgr remove \&\-\-force\*(C'\fR را اجرا کرده است.) .ie n .IP """u""" 8 .el .IP \f(CWu\fR 8 .IX Item "u" به‌روزرسانی عادی مورد نیاز است. .ie n .IP """r""" 8 .el .IP \f(CWr\fR 8 .IX Item "r" به‌روزرسانی‌نشدن معکوس: نسخهٔ نصب‌شده به‌صورت محلی، جدیدتر از نسخهٔ روی سرور است. .ie n .IP """a""" 8 .el .IP \f(CWa\fR 8 .IX Item "a" نیاز به نصب که به‌صورت خودکار تشخیص داده شده است؛ بسته روی سرور جدید است و (به احتمال زیاد) بخشی از یک مجموعهٔ نصب‌شده است. .ie n .IP """i""" 8 .el .IP \f(CWi\fR 8 .IX Item "i" بسته نصب خواهد شد و در حال حاضر در نصب محلی وجود ندارد (عملیات install). .ie n .IP """I""" 8 .el .IP \f(CWI\fR 8 .IX Item "I" بسته در حال حاضر موجود است اما مجدداً نصب خواهد شد (عملیات install). .RE .RS 4 .RE .IP \fIlocalrev\fR 4 .IX Item "localrev" شمارهٔ بازنگری بستهٔ نصب‌شده، یا \f(CW\*(C`\-\*(C'\fR اگر به‌صورت محلی موجود نباشد. .IP \fIserverrev\fR 4 .IX Item "serverrev" شمارهٔ بازنگری بسته روی سرور، یا \f(CW\*(C`\-\*(C'\fR اگر روی سرور موجود نباشد. .IP \fIsize\fR 4 .IX Item "size" اندازهٔ بسته روی سرور برحسب بایت. مجموع اندازهٔ همهٔ بسته‌ها در فیلد سرایند \f(CW\*(C`total\-bytes\*(C'\fR که در بالا اشاره شد آورده می‌شود. .IP \fIruntime\fR 4 .IX Item "runtime" مدت‌زمان سپری‌شده از آغاز عملیات نصب یا به‌روزرسانی‌ها. .IP \fIesttot\fR 4 .IX Item "esttot" کل زمان تخمینی. .ie n .SS "خروجی ماشین‌خوان ""option""" .el .SS "خروجی ماشین‌خوان \f(CWoption\fP" .IX Subsection "Machine-readable option output" قالب خروجی به صورت زیر است:.PP .Vb 1 \& key "\et" value .Ve .PP اگر مقداری در پایگاه‌داده ذخیره نشده باشد، رشته‌ی \f(CW\*(C`(not set)\*(C'\fR نمایش داده می‌شود. .PP اگر در حال توسعه‌ی برنامه‌ای هستید که از این خروجی استفاده می‌کند و احساس می‌کنید اعمال تغییراتی می‌تواند مفید باشد، بدون درنگ به فهرست پستی (mailing list) بنویسید. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .IX Header "ENVIRONMENT VARIABLES" ابزار \&\f(CW\*(C`tlmgr\*(C'\fR از بسیاری از متغیرهای محیطی استاندارد TeX استفاده می‌کند؛ همان‌طور که برای نمونه توسط \f(CW\*(C`tlmgr conf\*(C'\fR (بخش «conf») گزارش می‌شود. .PP علاوه بر این، برای تسهیل در اسکریپت‌نویسی و اشکال‌زدایی، \f(CW\*(C`tlmgr\*(C'\fR متغیرهای محیطی زیر را بررسی می‌کند. این متغیرها برای نصب‌های معمول کاربران کاربردی ندارند. .ie n .IP """TEXLIVE_COMPRESSOR""" 4 .el .IP \f(CWTEXLIVE_COMPRESSOR\fR 4 .IX Item "TEXLIVE_COMPRESSOR" این متغیر امکان انتخاب برنامه‌ی فشرده‌سازی دیگری را برای نسخه‌های پشتیبان و بسته‌های میانی بازگردانی (rollback containers) فراهم می‌کند. اولویت انتخاب بدین صورت است: .RS 4 .IP 1. 8 اگر متغیر محیطی \f(CW\*(C`TEXLIVE_COMPRESSOR\*(C'\fR تعریف شده باشد، از آن استفاده می‌شود؛ در صورت کار نکردن، عملیات لغو می‌شود. مقادیر ممکن: \&\f(CW\*(C`lz4\*(C'\fR، \f(CW\*(C`gzip\*(C'\fR، \f(CW\*(C`xz\*(C'\fR. گزینه‌های لازم به صورت داخلی افزوده می‌شوند. .IP 2. 8 اگر lz4 در دسترس باشد (چه از سیستم و چه از TL) و درست کار کند، از آن استفاده می‌شود. .IP 3. 8 اگر gzip در دسترس باشد (از سیستم) و درست کار کند، از آن استفاده می‌شود. .IP 4. 8 اگر xz در دسترس باشد (چه از سیستم و چه از TL) و درست کار کند، از آن استفاده می‌شود. .RE .RS 4 .Sp برنامه‌های lz4 و gzip در ایجاد پشتیبان‌های محلی tlmgr سریع‌تر عمل می‌کنند، به همین دلیل ترجیح داده می‌شوند. استفاده‌ی بدون قید و شرط از xz برای بسته‌های tlnet جهت به حداقل رساندن حجم بارگیری، تحت تأثیر قرار نمی‌گیرد. .RE .ie n .IP """TEXLIVE_DOWNLOADER""" 4 .el .IP \f(CWTEXLIVE_DOWNLOADER\fR 4 .IX Item "TEXLIVE_DOWNLOADER" .PD 0 .ie n .IP """TL_DOWNLOAD_PROGRAM""" 4 .el .IP \f(CWTL_DOWNLOAD_PROGRAM\fR 4 .IX Item "TL_DOWNLOAD_PROGRAM" .ie n .IP """TL_DOWNLOAD_ARGS""" 4 .el .IP \f(CWTL_DOWNLOAD_ARGS\fR 4 .IX Item "TL_DOWNLOAD_ARGS" .PD این گزینه‌ها امکان انتخاب برنامه‌های بارگیری متفاوتی را نسبت به برنامه‌هایی که توسط نصاب به طور خودکار انتخاب می‌شوند، ممکن می‌سازند. اولویت انتخاب بدین ترتیب است: .RS 4 .IP 1. 8 اگر متغیر محیطی \f(CW\*(C`TEXLIVE_DOWNLOADER\*(C'\fR تعریف شده باشد، از آن استفاده می‌شود؛ در صورت کار نکردن برنامه‌ی مشخص‌شده، عملیات لغو می‌شود. مقادیر ممکن: \f(CW\*(C`lwp\*(C'\fR، \&\f(CW\*(C`curl\*(C'\fR، \f(CW\*(C`wget\*(C'\fR. گزینه‌های لازم به طور داخلی اضافه می‌شوند. .IP 2. 8 اگر متغیر محیطی \f(CW\*(C`TL_DOWNLOAD_PROGRAM\*(C'\fR تعریف شده باشد (می‌تواند هر مقداری باشد)، همراه با \&\f(CW\*(C`TL_DOWNLOAD_ARGS\*(C'\fR استفاده می‌شود؛ در صورت کار نکردن، عملیات لغو می‌شود. .IP 3. 8 اگر LWP در دسترس و کارآمد باشد، از آن استفاده می‌شود (به دلیل پشتیبانی از بارگیری‌های مداوم و پایدار، با اختلاف کارآمدترین روش است). .IP 4. 8 اگر curl در دسترس باشد (از سیستم) و کار کند، از آن استفاده می‌شود. .IP 5. 8 اگر wget در دسترس باشد (چه از سیستم و چه از TL) و کار کند، از آن استفاده می‌شود. .RE .RS 4 .Sp مجموعه‌ی TL باینری‌های \f(CW\*(C`wget\*(C'\fR را در صورت نیاز برای پلتفرم‌های مختلف فراهم می‌کند، بنابراین همواره باید روشی برای بارگیری در دسترس باشد. .RE .ie n .IP """TEXLIVE_PREFER_OWN""" 4 .el .IP \f(CWTEXLIVE_PREFER_OWN\fR 4 .IX Item "TEXLIVE_PREFER_OWN" به‌طور پیش‌فرض، برنامه‌های فشرده‌سازی و بارگیری ارائه‌شده توسط سیستم (یعنی مواردی که در مسیر \f(CW\*(C`PATH\*(C'\fR یافت می‌شوند) بر برنامه‌های ارائه‌شده همراه با TeX Live ترجیح داده می‌شوند. .Sp این موضوع می‌تواند در سیستم‌های بسیار قدیمی مشکل‌ساز شود، و بنابراین می‌توان با تنظیم متغیر محیطی \f(CW\*(C`TEXLIVE_PREFER_OWN\*(C'\fR بر روی مقدار 1 آن را نادیده گرفت. در این حالت، فایل‌های اجرایی عرضه‌شده به همراه TL در اولویت قرار خواهند گرفت. .Sp برنامه‌های فشرده‌سازی/بارگیری اضافی که توسط TL ارائه نمی‌شوند، مانند gzip، lwp و curl، طبق موارد فوق همچنان در سیستم بررسی شده و در صورت موجود بودن مورد استفاده قرار می‌گیرند. متغیر \f(CW\*(C`TEXLIVE_PREFER_OWN\*(C'\fR تنها زمانی اعمال می‌شود که برنامه‌ی در حال بررسی، همراه با TL عرضه شده باشد؛ یعنی فشرده‌سازهای lz4 و xz و بارگیرنده‌ی wget. .Sp استثنا: در Windows، فایل \f(CW\*(C`tar.exe\*(C'\fR عرضه‌شده همراه با TL صرف‌نظر از هرگونه تنظیمی، همواره استفاده می‌شود. .SH "نویسندگان و کپی‌رایت (AUTHORS AND COPYRIGHT)" .IX Header "AUTHORS AND COPYRIGHT" این اسکریپت و مستندات آن برای توزیع TeX Live () نوشته شده‌اند و هر دو تحت مجوز عمومی همگانی گنو نگارش ۲ یا پسین (GNU General Public License Version 2 or later) منتشر شده‌اند. .PP \&\f(CW$Id:\fR tlmgr.pl 75204 2025\-05\-13 21:48:24Z karl $