tlmgr - En ligne dans le Cloud

PROGRAMME:

Nom

tlmgr - le gestionnaire TeX Live

SYNOPSIS

tlmgr [option] ... action [option]... [opérande] ...

DESCRIPTION

tlmgr gère une installation existante de TeX Live, à la fois les packages et les options de configuration.
Pour plus d'informations sur le téléchargement initial et l'installation de TeX Live, consultez
<http://tug.org/texlive/acquire.html>.

La version la plus récente de cette documentation (mise à jour tous les soirs à partir du développement
sources) est disponible surhttp://tug.org/texlive/tlmgr.html>, ainsi que les procédures de
mettre à jour "tlmgr" lui-même et des informations sur les versions de test.

ATTENTION : tlmgr dans Debian s'exécute toujours en mode utilisateur

TeX Live est organisé en quelques Schémas, dont chacun est spécifié comme un
ensemble différent de collections et votre Forfaits, où une collection est un ensemble de packages, et un
package est ce qui contient les fichiers réels. Les schémas contiennent généralement un mélange de collections et
packages, mais chaque package est inclus dans exactement une collection, ni plus ni moins. UNE
L'installation de TeX Live peut être personnalisée et gérée à n'importe quel niveau.

Voirhttp://tug.org/texlive/doc> pour toute la documentation TeX Live disponible.

EXEMPLES

Après avoir installé avec succès TeX Live, voici quelques opérations courantes avec "tlmgr":

"dépôt d'options tlmgr http://mirror.ctan.org/systems/texlive/tlnet"
Dites à "tlmgr" d'utiliser un miroir CTAN à proximité pour les futures mises à jour ; utile si vous avez installé
TeX Live à partir de l'image DVD et que vous souhaitez des mises à jour continues.

"mise à jour tlmgr --list"
Signalez ce qui serait mis à jour sans rien mettre à jour réellement.

"mise à jour tlmgr --all"
Faites en sorte que votre installation locale de TeX corresponde à ce qui se trouve dans le référentiel de packages
(généralement utile lors de la mise à jour depuis CTAN).

"info tlmgr" est ce que nous faisons
Afficher des informations détaillées sur un package est ce que nous faisons, tels que l'état de l'installation et
description, des recherches de est ce que nous faisons dans tous les colis.

Pour toutes les capacités et les détails de "tlmgr", veuillez lire le volumineux suivant
</br>L’Information.

OPTIONS

Les options suivantes de "tlmgr" sont des options globales, non spécifiques à une action. Tous
les options, qu'elles soient globales ou spécifiques à une action, peuvent être données n'importe où sur la ligne de commande, et
dans n'importe quel ordre. Le premier argument non optionnel sera l'action principale. Dans tous les cas,
"-"option et "-"option sont équivalents, et un "=" est facultatif entre un nom d'option et
Sa valeur.

--dépôt URL|chemin
Spécifie le référentiel de packages à partir duquel les packages doivent être installés ou mis à jour,
remplacer le référentiel de packages par défaut trouvé dans le package TeX Live de l'installation
Base de données (alias la TLPDB, entièrement définie dans le fichier "tlpkg/texlive.tlpdb"). Les
la documentation pour "install-tl" a plus de détails à ce sujet
(<http://tug.org/texlive/doc/install-tl.html>).

"--repository" modifie l'emplacement du référentiel uniquement pour l'exécution en cours ; faire un
changement permanent, utilisez "option repository" (voir l'action "option").

Pour des raisons de compatibilité descendante et de commodité, "--location" et "--repo" sont acceptés comme
alias pour cette option.

--gui [action]
"tlmgr" a une interface graphique ainsi qu'une interface en ligne de commande. Tu peux donner
cette option, "--gui", accompagnée d'une action à introduire directement dans le
écran respectif de l'interface graphique. Par exemple, courir

tlmgr --gui mise à jour

vous démarre directement à l'écran de mise à jour. Si aucune action n'est donnée, l'interface graphique sera
commencé à l'écran principal.

--gui-lang code
Par défaut, l'interface graphique essaie de déduire votre langue de l'environnement (sous Windows via
la base de registre, sous Unix via "LC_MESSAGES"). Si cela échoue, vous pouvez sélectionner un autre
langue en donnant à cette option un code de langue (basé sur ISO 639-1). Actuellement
pris en charge (mais pas nécessairement complètement traduits) sont : l'anglais (en, par défaut),
tchèque (cs), allemand (de), français (fr), italien (it), japonais (ja), néerlandais (nl), polonais
(pl), portugais brésilien (pt_BR), russe (ru), slovaque (sk), slovène (sl), serbe
(sr), ukrainien (uk), vietnamien (vi), chinois simplifié (zh_CN) et traditionnel
Chinois (zh_TW).

--debug-traduction
En mode GUI, ce commutateur indique à "tlmgr" de signaler tout non traduit (ou manquant)
messages à l'erreur standard. Cela peut aider les traducteurs à voir ce qu'il reste à faire.

--lisible par machine
Au lieu de la sortie normale destinée à la consommation humaine, écrivez (au standard
sortie) un format fixe plus adapté à l'analyse machine. Voir le " LISIBLE EN MACHINE
SORTIE" ci-dessous.

--pas d'exécution d'actions
Supprimez l'exécution des actions d'exécution telles que définies dans les fichiers tlpsrc.
Documenté uniquement par souci d'exhaustivité, car cela n'est utile que pour le débogage.

--package-fichier journal filet
"tlmgr" enregistre toutes les actions du package (installation, suppression, mise à jour, échec des mises à jour, échec
restaurations) dans un fichier journal séparé, par défaut "TEXMFSYSVAR/web2c/tlmgr.log". Cette
L'option vous permet de spécifier un fichier différent pour le journal.

--pause
Cette option fait que "tlmgr" attend l'entrée de l'utilisateur avant de quitter. Utile sous Windows pour
éviter de faire disparaître les fenêtres de commande.

--persistant-téléchargements
--no-persistant-downloads
Pour les installations basées sur le réseau, cette option (activée par défaut) oblige "tlmgr" à essayer de définir
une connexion persistante (en utilisant le module Perl "LWP"). L'idée est d'ouvrir et
réutiliser une seule connexion par session entre votre ordinateur et le serveur, au lieu de
lancer un nouveau téléchargement pour chaque package.

Si cela n'est pas possible, "tlmgr" reviendra à l'utilisation de "wget". Pour désactiver ces
connexions persistantes, utilisez "--no-persistent-downloads".

--fichier-pin
Modifiez l'emplacement du fichier d'épinglage de « TEXMFLOCAL/tlpkg/pinning.txt » (voir « Épinglage »
au dessous de). Documenté uniquement par souci d'exhaustivité, car cela n'est utile que pour le débogage.

--mode utilisateur
Active le mode utilisateur pour cette exécution de "tlmgr" ; voir "MODE UTILISATEUR" ci-dessous.

--usertree dir
Utilisations dir pour l'arbre en mode utilisateur ; voir "MODE UTILISATEUR" ci-dessous.

Les options standard des programmes TeX Live sont également acceptées : "--help/-h/-?", "--version",
"-q" (pas de messages d'information), "-v" (messages de débogage, peuvent être répétés). Pour le
plus de détails à ce sujet, consultez la documentation "TeXLive::TLUtils".

L'option "--version" affiche des informations sur la version de la version TeX Live et sur la
script "tlmgr" lui-même. Si "-v" est également donné, le numéro de révision pour le TeX Live chargé
Les modules Perl sont également affichés.

ACTIONS

vous aider
Affichez ces informations d'aide et quittez (identique à "--help", et sur le Web à l'adresse
<http://tug.org/texlive/doc/tlmgr.html>). Parfois les programmes "perldoc" et/ou "PAGER"
sur le système ont des problèmes, ce qui entraîne la sortie littéralement de caractères de contrôle. Cette
ne peut pas toujours être détecté, mais vous pouvez définir la variable d'environnement "NOPERLDOC" et
"perldoc" ne sera pas utilisé.

version
Donne des informations sur la version (identique à "--version").

Si "-v" a été donné, les révisions des modules utilisés sont également signalées.

sauvegarde [--nettoyer[=N]] [--rép_sauvegarde dir] [--tous | pkg] ...
Si l'option "--clean" n'est pas spécifiée, cette action effectue une sauvegarde du
packages, ou tous les packages ayant reçu "--all". Ces sauvegardes sont enregistrées à la valeur du
l'option "--backupdir", s'il s'agit d'un répertoire existant et accessible en écriture. Si "--backupdir" est
n'est pas fourni, le paramètre de l'option "backupdir" dans la TLPDB est utilisé, s'il est présent. Si les deux sont
manquant, aucune sauvegarde n'est effectuée.

Si l'option "--clean" est spécifiée, les sauvegardes sont élaguées (supprimées) au lieu d'être enregistrées. Les
valeur entière facultative N peut être spécifié pour définir le nombre de sauvegardes qui seront
retenu lors du nettoyage. Si "N" n'est pas donné, la valeur de l'option "autobackup" est utilisée.
Si les deux sont manquants, une erreur est émise. Pour plus de détails sur l'élagage de sauvegarde, consultez le
action "optionnelle".

Options:

--répertoire de sauvegarde annuaire
Remplace le paramètre d'option "backupdir" dans la TLPDB. Les annuaire l'argument est
requis et doit spécifier un répertoire existant et accessible en écriture où les sauvegardes doivent être
mis.

--tout
Si "--clean" n'est pas spécifié, effectuez une sauvegarde de tous les packages dans le TeX Live
installation; cela prendra beaucoup de temps et d'espace. Si "--clean" est
spécifié, tous les packages sont élagués.

--nettoyer[=N]
Au lieu de faire des sauvegardes, élaguez le répertoire de sauvegarde des anciennes sauvegardes, comme expliqué
dessus. L'argument entier facultatif N remplace l'option "autobackup" définie dans le
TLPDB. Vous devez utiliser "--all" ou une liste de packages avec cette option, car
voulu.

- à sec
Rien n'est réellement sauvegardé ou supprimé ; au lieu de cela, les actions à effectuer sont
écrit sur le terminal.

candidats pkg
candidats pkg
Affiche les référentiels candidats disponibles pour le package pkg. Voir « PLUSIEURS
RÉFÉRENCES" ci-dessous.

vérifier [option] ... [fichiers|dépend|exécute|runfiles|all]
Exécute une (ou toutes) vérification(s) de la cohérence de l'installation.

fichiers
Vérifie que tous les fichiers répertoriés dans la TLPDB locale ("texlive.tlpdb") sont réellement
présents et liste les manquants.

dépend
Répertorie les packages qui apparaissent en tant que dépendances dans une collection installée, mais qui sont
eux-mêmes non installés, et les packages qui ne sont contenus dans aucune collection.

Si vous appelez "tlmgr check collections", ce test sera effectué à la place car
les anciennes versions de "tlmgr" l'appelaient ainsi.

exécute
Vérifiez que les fichiers référencés par les directives « executer » dans la base de données TeX Live sont
présent.

fichiers d'exécution
Répertoriez les noms de fichiers qui apparaissent plusieurs fois dans les fichiers d'exécution.

Options:

--use-svn
Utilisez la sortie de "svn status" au lieu de lister les fichiers ; pour vérifier le TL
référentiel de développement.

conf [texmf|tlmgr|updmap [--conffile filet] [--effacer] [clé [Plus-value]]]
Avec uniquement "conf", affichez les informations de configuration générales pour TeX Live, y compris les informations actives
fichiers de configuration, paramètres de chemin, etc. C'est comme l'appel "texconfig conf", mais
fonctionne sur toutes les plates-formes prises en charge.

Avec "conf texmf", "conf tlmgr", ou "conf updmap" donnés en plus, montre tout
les paires clé/valeur (c'est-à-dire tous les paramètres) enregistrées dans "ROOT/texmf.cnf", la configuration tlmgr
(voir ci-dessous), ou le premier fichier trouvé (via kpsewhich) "updmap.cfg", respectivement.

If clé est donné en plus, montre la valeur de seulement que clé dans le fichier respectif. Si
option --effacer est également donné, le fichier de configuration -- il est supprimé, pas seulement commenté
en dehors!

If Plus-value est donné en plus, clé est fixé à Plus-value dans le fichier respectif. Non erreur
vérification is terminé!

Dans tous les cas le fichier utilisé peut être explicitement spécifié via l'option "--conffile déposer",
au cas où l'on voudrait opérer sur un fichier différent.

Application pratique : si l'exécution de (certaines ou toutes) commandes système via "\write18"
a été laissé activé lors de l'installation, vous pouvez le désactiver par la suite :

tlmgr conf texmf shell_escape 0

Un exemple plus compliqué : l'arborescence "TEXMFHOME" (voir le guide principal de TeX Live,
<http://tug.org/texlive/doc.html>) peut être défini sur plusieurs répertoires, mais ils doivent être
entouré d'accolades et séparé par des virgules, donc citer la valeur au shell est une bonne
idée. Ainsi:

tlmgr conf texmf TEXMFHOME "{~/texte,~/texmfbis}"

Attention : la facilité générale est là, mais bricoler les paramètres de cette manière est très
fortement déconseillé. Encore une fois, aucune vérification d'erreur sur les clés ou les valeurs n'est effectuée, donc tout
une sorte de casse est possible.

dump-tlpdb [--local|--distant]
Videz la TLPDB locale ou distante complète sur la sortie standard, telle quelle. La sortie est analogue à
la sortie "--machine-readable" ; voir la section "SORTIE LISIBLE EN MACHINE".

Options:

--locale
Videz le tlpdb local.

--à distance
Videz le tlpdb distant.

Exactement l'un de "--local" et "--remote" doit être donné.

Dans les deux cas, la première ligne de la sortie spécifie l'emplacement du référentiel, dans ce
Format:

"emplacement-url" "\t" emplacement

où "location-url" est le nom du champ littéral, suivi d'une tabulation, et Localisation est le
fichier ou URL vers le référentiel.

Les fins de ligne peuvent être LF ou CRLF selon la plate-forme actuelle.

générer [option] ... est ce que nous faisons
générer langue
générer langue.dat
générer langue.def
générer langue.dat.lua

L'action « générer » écrase toute modification manuelle effectuée dans les fichiers respectifs : elle
les recrée à partir de zéro en fonction des informations des packages installés, plus locaux
adaptations. Le programme d'installation de TeX Live et "tlmgr" appellent régulièrement "generate" pour tous ces
fichiers.

Pour gérer vos propres polices, veuillez lire les informations "updmap --help" et/ou
<http://tug.org/fonts/fontinstall.html>.

Pour gérer vos propres formats, veuillez lire les informations "fmtutil --help".

Plus en détail : "generate" refait n'importe lequel des fichiers de configuration "language.dat",
"language.def", et "language.dat.lua" à partir des informations présentes dans la TLPDB locale,
ainsi que des fichiers gérés localement.

Les fichiers gérés localement sont "language-local.dat", "language-local.def", ou
"language-local.dat.lua", recherché dans "TEXMFLOCAL" dans les répertoires respectifs. Si
des ajouts locaux sont présents, le fichier final se fait en commençant par le fichier principal,
en omettant toutes les entrées que le fichier local spécifie comme étant désactivées, et enfin en ajoutant
le fichier local.

(Note historique : les "updmap-local.cfg" et "fmtutil-local.cnf" anciennement pris en charge ne sont pas
lecture plus longue, car "updmap" et "fmtutil" lisent et prennent désormais en charge plusieurs configurations
des dossiers. Ainsi, les ajouts locaux peuvent et doivent être placés dans un "updmap.cfg" de "fmtutil.cnf"
fichier dans "TEXMFLOCAL". Les actions "generate updmap" et "generate fmtutil" ne sont plus
exister.)

Les fichiers locaux spécifient les entrées à désactiver avec une ligne de commentaire, à savoir l'une de celles-ci :

%!NOM
--!NOM

où "language.dat" et "language.def" utilisent "%" et "language.dat.lua" utilisent "--". Dans tout
cas, les prénom est le nom de format respectif ou l'identifiant du modèle de césure.
Exemples :

%!Allemand
--!useenglishmax

(Bien sûr, il est peu probable que vous souhaitiez réellement désactiver ces éléments particuliers. Ils sont
juste des exemples.)

Après une telle ligne de désactivation, le fichier local peut inclure une autre entrée pour le même élément,
si une définition différente est souhaitée. En général, à l'exception des lignes spéciales de blocage,
les fichiers locaux suivent la même syntaxe que les fichiers maîtres.

Le formulaire « generate language » recrée les trois fichiers « language.dat », « language.def » et
"language.dat.lua", tandis que les formulaires avec une extension recrée uniquement cette langue donnée
fichier.

Options:

--dest fichier de sortie
spécifie le fichier de sortie (par défaut à l'emplacement respectif dans "TEXMFSYSVAR"). Si
"--dest" est donné à "generate language", il sert de nom de base sur lequel ".dat"
sera ajouté pour le nom du fichier de sortie "language.dat", ".def" sera
ajouté à la valeur pour le nom du fichier de sortie "language.def", et ".dat.lua"
au nom du fichier "language.dat.lua". (Ceci est juste pour éviter l'écrasement ; si
vous voulez un nom spécifique pour chaque fichier de sortie, nous vous recommandons d'appeler "tlmgr" deux fois.)

--localcfg fichier_conf_local
spécifie les ajouts locaux (facultatifs) (par défaut à l'emplacement respectif dans
"TEXMFLOCAL").

--rebuild-sys
indique à tlmgr d'exécuter les programmes nécessaires une fois les fichiers de configuration régénérés. Ces
sont : "fmtutil-sys --all" après "generate fmtutil", "fmtutil-sys --byhyphen
.../language.dat" après "generate language.dat" et "fmtutil-sys --byhyphen
.../language.def" après "generate language.def".

Ces appels ultérieurs entraînent l'application effective des fichiers nouvellement générés. Cette
n'est pas fait par défaut car ces appels sont de longs processus et on peut vouloir
effectué plusieurs modifications connexes successivement avant d'invoquer ces programmes.

Les emplacements respectifs sont les suivants :

tex/generic/config/language.dat (et language-local.dat);
tex/generic/config/language.def (et language-local.def);
tex/generic/config/language.dat.lua (et language-local.dat.lua);

gui
Démarrez l'interface utilisateur graphique. Voir GUI ci-dessous.

info [option...] [collections|schémas|pkg...]
Sans argument, répertorie tous les packages disponibles dans le référentiel de packages, en préfixant ceux
déjà installé avec "i".

Avec le seul mot "collections" ou "schemes" comme argument, répertorie le type de demande
au lieu de tous les packages.

Avec tout autre argument, affiche des informations sur pkg: le nom, la catégorie, abrégé et
description longue, état de l'installation et numéro de révision TeX Live. Si pkg n'est pas
installé localement, recherche dans la source d'installation à distance.

If pkg n'est pas trouvé localement ou à distance, l'action de recherche est utilisée et les listes correspondant
paquets et fichiers.

Il affiche également des informations extraites du catalogue TeX, à savoir la version du package,
date et licence. Considérez-les, en particulier la version du package, comme des approximations
uniquement, en raison du décalage temporel des mises à jour des différentes pièces. En revanche, le
La valeur de "révision" provient directement de TL et est fiable.

Les anciennes actions « afficher » et « liste » sont fusionnées dans cette action, mais sont toujours prises en charge
pour la compatibilité descendante.

Options:

--liste
Si l'option "--list" est donnée avec un package, la liste des fichiers contenus est également
affichés, y compris ceux pour les dépendances spécifiques à la plate-forme. Lorsqu'il est donné avec des schémas
et collections, "--list" affiche leurs dépendances de la même manière.

--seulement-installé
Si cette option est donnée, la source d'installation ne sera pas utilisée ; seulement localement
les packages, collections ou schémas installés sont répertoriés. (Ne fonctionne pas pour la liste des
paquets pour l'instant)

init-usertree
Met en place une arborescence texmf pour ce qu'on appelle la gestion du mode utilisateur, soit l'arborescence utilisateur par défaut
("TEXMFHOME"), ou celui spécifié sur la ligne de commande avec "--usertree". Voir "MODE UTILISATEUR"
ci-dessous.

installer [option] ... pkg
Installez chaque pkg donné sur la ligne de commande, s'il n'est pas déjà installé. (Ce ne est pas
toucher les packages existants ; voir l'action "mettre à jour" pour savoir comment obtenir la dernière version d'un
paquet.)

Par défaut, cela installe également tous les packages sur lesquels le pkgs sont dépendants.
Options:

- à sec
Rien n'est réellement installé ; à la place, les actions à effectuer sont écrites dans le
Terminal.

--déposer
Au lieu de récupérer un package à partir du référentiel d'installation, utilisez les fichiers de package
donné sur la ligne de commande. Ces fichiers doivent être des fichiers de package TeX Live standard (avec
contenu du fichier tlpobj).

--Obliger
Si des mises à jour de "tlmgr" lui-même (ou d'autres parties de l'infrastructure de base) sont présentes,
"tlmgr" se renflouera et n'effectuera pas l'installation à moins que cette option ne soit donnée.
Non recommandé.

--no-dépend
N'installez pas de dépendances. (Par défaut, l'installation d'un package garantit que tous
les dépendances de ce package sont remplies.)

--pas-depend-du-tout
Normalement, lorsque vous installez un package contenant des fichiers binaires, le fichier binaire respectif
package sera également installé. C'est-à-dire que pour un package "foo", le package
"foo.i386-linux" sera également installé sur un système "i386-linux". Cette option
supprime ce comportement et implique également "--no-depends". Ne l'utilisez pas sauf si vous
êtes sûr de ce que vous faites.

--réinstaller
Réinstaller un package (y compris les dépendances pour les collections) même s'il semble déjà
à installer (c'est-à-dire qu'il est présent dans la TLPDB). Ceci est utile pour récupérer de
suppression accidentelle de fichiers dans la hiérarchie.

Lors de la réinstallation, seules les dépendances sur les packages normaux sont suivies (c'est-à-dire pas celles
de catégorie Régime ou Collection).

--avec-doc
--avec-src
Bien qu'il ne soit pas recommandé, le programme "install-tl" offre une option pour omettre
installation de toute la documentation et/ou des fichiers sources. (Par défaut, tout est
installé.) Après une telle installation, vous souhaiterez peut-être que la documentation
ou des fichiers source pour un package donné après tout. Vous pouvez les obtenir en utilisant ces
options en conjonction avec "--reinstall", comme dans (en utilisant le package "fontspec" comme
Exemple):

tlmgr install --reinstall --with-doc --with-src fontspec

option
option [montrer]
option Afficher tout
option clé [Plus-value]

Le premier formulaire affiche les paramètres globaux de TeX Live actuellement enregistrés dans la TLPDB avec un
brève description et la "clé" utilisée pour la modifier entre parenthèses.

La deuxième forme est similaire, mais montre également des options qui peuvent être définies mais ne le sont pas
actuellement défini sur n'importe quelle valeur.

Dans la troisième forme, si Plus-value n'est pas donné, le réglage de clé est affiché. Si Plus-value is
cadeau, clé est fixé à Plus-value.

Valeurs possibles pour clé are (exécutez "tlmgr option showall" pour la liste définitive):

référentiel (référentiel de packages par défaut),
formats (créer des formats au moment de l'installation),
code postal (exécuter les blobs de code postinst)
docfiles (installer les fichiers de documentation),
srcfiles (installer les fichiers sources),
backupdir (répertoire par défaut pour les sauvegardes),
autobackup (nombre de sauvegardes à conserver).
sys_bin (répertoire auquel les exécutables sont liés par l'action path)
sys_man (répertoire auquel les pages de manuel sont liées par l'action path)
sys_info (répertoire auquel les fichiers Info sont liés par l'action path)
desktop_integration (Windows uniquement : créer des raccourcis dans le menu Démarrer)
fileassocs (Windows uniquement : modifier les associations de fichiers)
multi-utilisateurs (Windows uniquement : installer pour tous les utilisateurs)

Une utilisation courante de « option » est de modifier définitivement l'installation pour aller plus loin
mises à jour à partir d'Internet, après l'installation initiale à partir du DVD. Pour ce faire, vous pouvez exécuter

référentiel d'options tlmgr http://mirror.ctan.org/systems/texlive/tlnet

La documentation "install-tl" contient plus d'informations sur les valeurs possibles pour
"dépôt". (Pour une compatibilité descendante, « emplacement » peut être utilisé comme nom alternatif pour
"dépôt".)

Si "formats" est défini (il s'agit de la valeur par défaut), alors les formats sont régénérés lorsque le
moteur ou les fichiers de format ont changé. Ne désactivez cette option que lorsque vous savez ce que vous êtes
Faire.

L'option "postcode" contrôle l'exécution du code d'action de post-installation par package. Ce
est défini par défaut, et encore une fois, la désactivation ne sera probablement pas intéressante, sauf peut-être pour
les développeurs.

Les options "docfiles" et "srcfiles" contrôlent l'installation de leurs fichiers respectifs
d'un paquet. Par défaut, les deux sont activés (1). Cela peut être désactivé (défini sur 0) si le disque
l'espace est (très) limité.

Les options "autobackup" et "backupdir" déterminent les valeurs par défaut des actions "update",
"sauvegarde" et "restauration". Ces trois actions ont besoin d'un répertoire dans lequel lire ou écrire
les sauvegardes. Si "--backupdir" n'est pas spécifié sur la ligne de commande, le "backupdir"
la valeur de l'option est utilisée (si elle est définie).

L'option "autobackup" (dés)active la génération automatique de sauvegardes. Sa valeur est un
entier. Si la valeur "autobackup" est "-1", aucune sauvegarde n'est supprimée. Si "autobackup" est 0
ou plus, il spécifie le nombre de sauvegardes à conserver. Ainsi, les sauvegardes sont désactivées si le
la valeur est 0. Dans le mode "--clean" de l'action "backup", cette option spécifie également le
numéro à conserver.

Pour configurer « autobackup » sur « -1 » sur la ligne de commande, utilisez :

option tlmgr -- sauvegarde automatique -1

Le "--" évite d'avoir le "-1" traité comme une option. ("--" arrête l'analyse des options à
le point où il apparaît ; il s'agit d'une fonctionnalité générale dans la plupart des programmes Unix.)

Les options "sys_bin", "sys_man" et "sys_info" sont utilisées sur les systèmes de type Unix pour contrôler
la génération de liens pour les exécutables, les fichiers d'informations et les pages de manuel. Voir l'action "chemin"
pour en savoir plus.

Les trois dernières options contrôlent le comportement sur les installations Windows. Si
"desktop_integration" est défini, alors certains packages installeront des éléments dans un sous-dossier du
Menu démarrer pour "tlmgr gui", documentation, etc. Si "fileassocs" est défini, le fichier Windows
des associations sont faites (voir aussi l'action "postaction"). Enfin, si "multi-utilisateur" est défini,
puis les adaptations au registre et aux menus sont effectuées pour tous les utilisateurs du système à la place
de l'utilisateur actuel uniquement. Les trois options sont activées par défaut.

papier
papier [a4|lettre]
[xdvi|pdftex|dvips|dvipdfmx|contexte|psutils] papier [taille de papier|--liste]

Sans argument ("tlmgr paper"), affiche le paramètre de format de papier par défaut pour tous les
programmes.

Avec un argument (par exemple, "tlmgr paper a4"), définit la valeur par défaut pour tous les programmes connus sur
ce format de papier.

Avec un programme donné comme premier argument et aucun format de papier spécifié (par exemple, "tlmgr dvips
paper"), indique le format de papier par défaut pour ce programme.

Avec un programme donné comme premier argument et une taille de papier comme dernier argument (par exemple,
"tlmgr dvips paper a4"), définissez la valeur par défaut de ce programme sur ce format de papier.

Avec un programme donné comme premier argument et "--list" donné comme dernier argument (par exemple,
"tlmgr dvips paper --list"), affiche tous les formats de papier valides pour ce programme. La première taille
affiché est la valeur par défaut.

Incidemment, cette syntaxe consistant à avoir un nom de programme spécifique avant le mot-clé "papier" est
inhabituel. Il est hérité du script de longue date "texconfig", qui prend en charge d'autres
paramètres de configuration de certains programmes, notamment "dvips". "tlmgr" ne prend pas en charge ces
paramètres supplémentaires.

chemin [--w32mode=utilisateur|admin] [ajouter|supprimer]
Sous Unix, ajoute ou supprime simplement des liens symboliques pour les binaires, les pages de manuel et les pages d'informations dans le
répertoires système spécifiés par les options respectives (voir la description "option"
dessus). Ne modifie aucun fichier d'initialisation, qu'il soit système ou personnel.

Sous Windows, la partie du registre dans laquelle le répertoire binaire est ajouté ou supprimé est déterminée
de la manière suivante:

Si l'utilisateur a des droits d'administrateur et que l'option "--w32mode" n'est pas donnée, le paramètre
w32_multi_user détermine l'emplacement (c'est-à-dire, s'il est activé, alors le chemin du système, sinon
le chemin utilisateur est modifié).

Si l'utilisateur a des droits d'administrateur et que l'option "--w32mode" est donnée, cette option détermine
le chemin à ajuster.

Si l'utilisateur n'a pas les droits d'administrateur, et l'option "--w32mode" n'est pas donnée, et le
mise w32_multi_user est désactivé, le chemin utilisateur est modifié, tandis que si le paramètre
w32_multi_user est activé, un avertissement est émis indiquant que l'appelant n'a pas suffisamment de privilèges.

Si l'utilisateur n'a pas les droits d'administrateur, et que l'option "--w32mode" est donnée, elle doit être
utilisateur et le chemin de l'utilisateur sera ajusté. Si un utilisateur sans droits d'administrateur utilise l'option
"--w32mode admin" un avertissement est émis indiquant que l'appelant n'a pas suffisamment de privilèges.

épingler
L'action "épingler" gère le fichier d'épinglage, voir "Épingler" ci-dessous.

"émission d'épinglage"
Affiche les données d'épinglage actuelles.

"épingler ajouter" repo pkgglob
Épingle les packages correspondant au pkgglob(s) au référentiel repo.

"épingler supprimer" repo pkgglob
Tous les packages enregistrés dans le fichier d'épinglage correspondant au s pour le donné
dépôt repo sont enlevés.

"épingler supprimer repo --tous"
Supprimer toutes les données épinglées pour le référentiel repo.

plateforme liste|ajouter|supprimer plateforme
plateforme set plateforme
plateforme set auto
"liste de plates-formes" répertorie les noms TeX Live de toutes les plates-formes (aka architectures),
("i386-linux", ...) disponible dans le référentiel de packages.

"ajout de plate-forme" plateforme... ajoute les exécutables pour chaque plate-forme donnée plateforme à la
l'installation à partir du référentiel.

"supprimer la plate-forme" plateforme... supprime les exécutables pour chaque plate-forme donnée plateforme
de l'installation, mais conserve dans tous les cas la plate-forme en cours d'exécution.

"ensemble de plate-forme" plateforme bascule TeX Live pour toujours utiliser la plate-forme donnée au lieu de l'auto
détection.

"platform set auto" fait passer TeX Live en mode de détection automatique pour la plate-forme.

La détection de plate-forme est nécessaire pour sélectionner les bons binaires "xz", "xzdec" et "wget" qui
sont livrés avec TeX Live.

« arche » est un synonyme de « plateforme ».

Options:

- à sec
Rien n'est réellement installé ; à la place, les actions à effectuer sont écrites dans le
Terminal.

post-action [--w32mode=utilisateur|admin] [--fileassocmode=1|2] [--tous] [installer|supprimer]
[raccourci|fileassoc|script] [pkg] ...
Exécutez la postaction "raccourci", "fileassoc" ou "script" donné comme deuxième requis
argument en mode d'installation ou de suppression (qui est le premier argument requis), soit pour le
packages donnés sur la ligne de commande, ou pour tous si "--all" est donné.

Si l'option "--w32mode" a la valeur "user", toutes les actions ne seront effectuées que
dans les parties accessibles par l'utilisateur du registre/système de fichiers, tandis que la valeur "admin" sélectionne
les parties du registre à l'échelle du système pour les associations de fichiers. Si vous n'avez pas
suffisamment d'autorisations, l'utilisation de "--w32mode=admin" ne réussira pas.

"--fileassocmode" spécifie l'action pour les associations de fichiers. S'il est défini sur 1 (le
par défaut), seules les nouvelles associations sont ajoutées ; s'il est défini sur 2, toutes les associations sont définies sur
les programmes TeX Live. (Voir aussi "option fileassocs".)

plate-forme d'impression
Imprimer l'identifiant TeX Live de la plate-forme détectée (matériel/système d'exploitation)
combinaison à la sortie standard, et sortie. "--print-arch" est un synonyme.

supprimez [option] ... pkg
Supprimer chaque pkg spécifié. La suppression d'une collection supprime toutes les dépendances de package (à moins que
"--no-depends" est spécifié), mais pas les dépendances de collection de cette collection.
Cependant, lors de la suppression d'un package, les dépendances ne sont jamais supprimées. Options :

--no-dépend
Ne supprimez pas les packages dépendants.

--pas-depend-du-tout
Voir ci-dessus sous installer (et méfiez-vous).

--Obliger
Par défaut, la suppression d'un package ou d'une collection qui est une dépendance d'un autre
la collecte ou le schéma n'est pas autorisé. Avec cette option, le package sera supprimé
inconditionnellement. A utiliser avec précaution.

Un package qui a été supprimé à l'aide de l'option "--force" car il est toujours répertorié
dans une collection ou un schéma installé ne sera pas mis à jour et sera mentionné comme
de force enlevé à la sortie de tlmgr Mise à jour --liste.

- à sec
Rien n'est réellement supprimé ; à la place, les actions à effectuer sont écrites dans le
Terminal.

dépôt
dépôt liste
dépôt liste chemin|balise
dépôt ajouter chemin [Étiquette]
dépôt supprimez chemin|balise
dépôt set chemin[#Étiquette] [chemin[#Étiquette] ...]
Cette action gère la liste des référentiels. Voir « PLUSIEURS RÉPERTOIRES » ci-dessous pour
explications détaillées.

Le premier formulaire ("liste") répertorie tous les référentiels configurés et les balises respectives si
ensemble. Si un chemin, une URL ou une balise est donné après le mot-clé "list", il est interprété comme
source d'où initialiser une base de données TeX Live et répertorie les packages contenus.
Cela peut également être un référentiel non utilisé jusqu'à présent, à la fois localement et à distance. Si un
passer en plus "--with-platforms", pour chaque package les plateformes disponibles (le cas échéant)
sont également répertoriés.

La troisième forme ("ajouter") ajoute un référentiel (en attachant éventuellement une balise) à la liste des
référentiels. La quatrième forme ("supprimer") supprime un référentiel, soit par
chemin/url, ou par balise. La dernière forme ("set") définit la liste des référentiels sur les éléments
donné sur la ligne de commande, ne gardant pas les paramètres précédents

Dans tous les cas, l'un des référentiels doit être étiqueté comme « principal » ; sinon, tout
les opérations échoueront !

restaurer [--rép_sauvegarde dir] [--tous | pkg [tour]]
Restaurez un package à partir d'une sauvegarde effectuée précédemment.

Si "--all" est donné, essayez de restaurer la dernière révision de toutes les sauvegardes de packages trouvées dans
le répertoire de sauvegarde.

Sinon, si ni l'un ni l'autre pkg ni tour sont donnés, répertoriez les révisions de sauvegarde disponibles pour tous
paquets. Avec pkg donné mais non tour, répertorie toutes les révisions de sauvegarde disponibles de pkg.

Lors de la liste des packages disponibles, tlmgr affiche la révision et entre parenthèses la création
heure si disponible (au format aaaa-mm-jj hh:mm).

Si (et seulement si) les deux pkg et un numéro de révision valide tour sont spécifiés, essayez de restaurer
le package à partir de la sauvegarde spécifiée.

Options:

--tout
Essayez de restaurer la dernière révision de toutes les sauvegardes de package trouvées dans la sauvegarde
annuaire. Des arguments non optionnels supplémentaires (comme pkg) ne sont pas permis.

--répertoire de sauvegarde annuaire
Spécifiez le répertoire où se trouvent les sauvegardes. S'il n'est pas donné, il sera pris
à partir du paramètre de configuration dans la TLPDB.

- à sec
Rien n'est réellement restauré ; à la place, les actions à effectuer sont écrites dans le
Terminal.

--Obliger
Ne posez pas de questions.

recherche [option...] est ce que nous faisons
recherche [option...] --déposer est ce que nous faisons

recherche [option...] --tout est ce que nous faisons

Par défaut, recherchez les noms, les descriptions courtes et les descriptions longues de tous localement
packages installés pour l'argument est ce que nous faisons, interprétée comme une expression régulière (Perl).

Options:

--déposer
Lister tous les noms de fichiers contenant est ce que nous faisons.

--tout
Recherchez tout : noms de packages, descriptions et noms de fichiers.

--mondial
Recherchez la base de données TeX Live du support d'installation, au lieu de la
installation.

--mot
Restreindre la recherche de noms de packages et de descriptions (mais pas de noms de fichiers) pour qu'ils correspondent
seulement des mots pleins. Par exemple, la recherche de "table" avec cette option n'affichera pas
paquets contenant le mot « tables » (à moins qu'ils ne contiennent également le mot « table » sur
sa propre).

Désinstaller
Désinstalle toute l'installation de TeX Live. Options :

--Obliger
Ne demandez pas de confirmation, supprimez immédiatement.

Mise à jour [option] ... [pkg] ...
Met à jour les packages donnés en arguments vers la dernière version disponible sur le
source d'installation. Soit "--all" ou au moins un pkg le nom doit être spécifié. Options :

--tout
Mettez à jour tous les packages installés à l'exception de "tlmgr" lui-même. Ainsi, si les mises à jour vers "tlmgr"
lui-même sont présents, cela donnera simplement une erreur, à moins que l'option "--force"
ou "--self" est donné. (Voir ci-dessous.)

En plus de la mise à jour des packages installés, lors de la mise à jour d'une collection le
l'installation locale est (par défaut) synchronisée avec l'état de la collection sur le
serveur, à la fois pour les ajouts et les suppressions.

Cela signifie que si un paquet a été supprimé sur le serveur (et a donc également été
supprimé de la collection respective), "tlmgr" supprimera le package dans le local
installation. Ceci s'appelle ``auto-remove'' et est annoncé comme tel lors de l'utilisation du
l'option "--list". Cette suppression automatique peut être supprimée à l'aide de l'option
"--no-auto-remove" (non recommandé, voir la description de l'option).

De même, si un package a été ajouté à une collection sur le serveur qui est également
installé localement, il sera ajouté à l'installation locale. C'est appelé
``auto-install'' et est annoncé comme tel lors de l'utilisation de l'option "--list". Cette auto-
l'installation peut être supprimée à l'aide de l'option "--no-auto-install".

Une exception aux contrôles de dépendance de collection (y compris l'auto-installation de
paquets qui viennent d'être mentionnés) sont ceux qui ont été « retirés de force » par vous, qui
est, vous avez appelé "tlmgr remove --force" sur eux. (Voir l'action "supprimer"
documentation.) Pour réinstaller de tels packages supprimés de force, utilisez
"--reinstall-force-removed".

Si vous souhaitez exclure certains packages de l'exécution de la mise à jour actuelle (par exemple, en raison d'une lenteur
lien), voir l'option "--exclude" ci-dessous.

--soi
Mettez à jour "tlmgr" lui-même (c'est-à-dire les packages d'infrastructure) si des mises à jour y sont
présent. Sous Windows, cela inclut les mises à jour de l'interpréteur Perl privé livré
dans TeX Live.

Si cette option est donnée avec "--all" ou une liste de packages, alors
"tlmgr" sera mis à jour en premier et, si cette mise à jour réussit, la nouvelle version sera
redémarré pour terminer le reste des mises à jour.

En bref:

tlmgr update --self # met à jour l'infrastructure uniquement
tlmgr update --self --all # mettre à jour l'infrastructure et tous les packages
tlmgr update --force --all # met à jour tous les packages mais *pas* l'infrastructure
# ... ce dernier à vos risques et périls, déconseillé !

- à sec
Rien n'est réellement installé ; à la place, les actions à effectuer sont écrites dans le
Terminal. Il s'agit d'un rapport plus détaillé que "--list".

--liste [pkg]
Répertoriez de manière concise les packages qui seraient mis à jour, nouvellement installés ou supprimés,
sans vraiment rien changer. Si "--all" est également indiqué, toutes les mises à jour disponibles
sont répertoriés. Si "--self" est donné, mais pas "--all", seules les mises à jour
les packages (tlmgr, texlive infrastructure, perl sous Windows, etc.) sont répertoriés. Si
ni "--all" ni "--self" n'est donné, et en plus aucune pkg est donné, puis "--all"
est supposé (ainsi, "tlmgr update --list" est identique à "tlmgr update --list --all").
Si ni "--all" ni "--self" n'est donné, mais que des noms de paquets spécifiques sont donnés, ces
les paquets sont vérifiés pour les mises à jour.

--exclure pkg
Exclure les pkg du processus de mise à jour. Si cette option est donnée plus d'une fois, son
les arguments s'accumulent.

Une dispute pkg exclut à la fois le forfait pkg lui-même et toute sa plate-forme connexe-
forfaits spécifiques paquet.ARCH. Par exemple,

mise à jour tlmgr --all --exclude a2ping

ne mettra pas à jour "a2ping", "a2ping.i386-linux", ou tout autre "a2ping".CAMBRE paquet.

Si cette option spécifie un package qui serait autrement un candidat pour l'auto-
installation, suppression automatique ou réinstallation d'un package supprimé de force, "tlmgr"
quitte avec un message d'erreur. Les exclusions ne sont pas prises en charge dans ces circonstances.

--pas de suppression automatique [pkg] ...
Par défaut, "tlmgr" essaie de supprimer les packages qui ont disparu sur le serveur, car
décrit ci-dessus sous "--all". Cette option empêche de telles suppressions, que ce soit pour tous
packages (avec "--all"), ou juste pour le pkg noms. Cela peut conduire à un
installation TeX incohérente, car les packages ne sont pas rarement renommés ou remplacés
par leurs auteurs. Par conséquent, ce n'est pas recommandé.

--no-installation automatique [pkg] ...
Dans des circonstances normales, "tlmgr" installera les packages qui sont nouveaux sur le serveur,
comme décrit ci-dessus sous "--all". Cette option empêche de tels
l'installation, soit pour tous les packages (avec "--all"), soit pour le pkg des noms.

De plus, après la fin de l'exécution de "tlmgr" à l'aide de ceci, les packages qui
ont été installés automatiquement sera be considéré as de force enlevé. Donc, si "foobar" est
le seul nouveau package sur le serveur, alors

mise à jour tlmgr --all --no-auto-install

équivaut à

tlmgr mise à jour --all
tlmgr supprimer --force foobar

--reinstall-forcely-removed
Dans des circonstances normales, "tlmgr" n'installera pas les packages qui ont été forcés
supprimé par l'utilisateur ; c'est-à-dire supprimé avec "remove --force", ou dont l'installation a été
interdit par "--no-auto-install" lors d'une mise à jour antérieure.

Cette option permet à "tlmgr" d'ignorer les suppressions forcées et de réinstaller tous ces
paquets. Cela peut être utilisé pour synchroniser complètement une installation avec le serveur
idée de ce qui est disponible:

mise à jour tlmgr --reinstall-forcely-removed --all

--sauvegarde et votre --répertoire de sauvegarde annuaire
Ces deux options contrôlent la création de sauvegardes de packages avant mise à jour; cette
c'est-à-dire la sauvegarde des packages tels qu'ils sont actuellement installés. Si aucune de ces options n'est proposée,
aucun package de sauvegarde ne sera enregistré. Si "--backupdir" est donné et spécifie un
répertoire, une sauvegarde sera effectuée à cet emplacement. Si seul "--backup" est donné,
puis une sauvegarde sera faite dans le répertoire précédemment défini via l'action "option"
(voir ci-dessous). Si les deux sont donnés, une sauvegarde sera effectuée sur le annuaire.

Vous pouvez définir des options via l'action "option" pour créer automatiquement des sauvegardes pour tous
packages et/ou ne conserver qu'un certain nombre de sauvegardes. S'il vous plaît voir la "option"
action pour plus de détails.

"tlmgr" effectue toujours une sauvegarde temporaire lors de la mise à jour des packages, en cas de téléchargement ou
autre échec lors d'une mise à jour. En revanche, le but de cette option "--backup" est
pour vous permettre d'enregistrer une sauvegarde persistante au cas où le réel contenu de la mise à jour
cause des problèmes, par exemple, introduit une incompatibilité.

L'action "restaurer" explique comment restaurer à partir d'une sauvegarde.

--no-dépend
Si vous appelez pour mettre à jour un package, normalement tous les packages dépendants seront également
vérifié les mises à jour et mis à jour si nécessaire. Ce commutateur supprime ce comportement.

--pas-depend-du-tout
Voir ci-dessus sous installer (et méfiez-vous).

--Obliger
Forcer la mise à jour des packages normaux, sans mettre à jour "tlmgr" lui-même (à moins que le "--self"
option est également donnée). Non recommandé.

De plus, "update --list" est toujours exécuté quelle que soit cette option.

Si le package sur le serveur est plus ancien que le package déjà installé (par exemple, si le
miroir sélectionné est obsolète), "tlmgr" ne rétrograde pas. Aussi, des forfaits pour
les plates-formes désinstallées ne sont pas installées.

"tlmgr" enregistre une copie du fichier "texlive.tlpdb" utilisé pour une mise à jour avec un suffixe
représentant l'url du référentiel, comme dans "tlpkg/texlive.tlpdb."chaîne de hachage longue. Ceux-ci peuvent
être utile pour les informations de secours, mais si vous n'aimez pas qu'elles s'accumulent (par exemple, sur chaque
exécuter "mirror.ctan.org" peut se résoudre en un nouvel hôte, ce qui entraîne un hachage différent), c'est
inoffensif de les supprimer.

UTILISATEUR MODE

"tlmgr" fournit un moyen restreint, appelé ``mode utilisateur'', pour gérer des arbres texmf arbitraires
de la même manière que l'installation principale. Par exemple, cela permet aux personnes sans écriture
autorisations sur l'emplacement d'installation pour mettre à jour/installer des packages dans une arborescence de leurs
posséder.

"tlmgr" passe en mode utilisateur avec l'option de ligne de commande "--usermode". Ce ne est pas
basculer automatiquement, et il n'y a pas non plus de paramètre de fichier de configuration pour cela. Ainsi, ce
L'option doit être explicitement donnée à chaque fois que le mode utilisateur doit être activé.

Ce mode de "tlmgr" fonctionne sur une arborescence d'utilisateurs, par défaut la valeur du "TEXMFHOME"
variable. Cela peut être remplacé avec l'option de ligne de commande "--usertree". Dans le
après, lorsque nous parlons de l'arbre utilisateur, nous entendons soit "TEXMFHOME" soit celui donné sur
la ligne de commande.

Toutes les actions ne sont pas autorisées en mode utilisateur ; "tlmgr" vous avertira et n'effectuera aucune
actions problématiques. Actuellement non pris en charge (et ne le sera probablement jamais) est le
action « plate-forme ». L'action "gui" n'est actuellement pas prise en charge, mais pourrait l'être dans le futur
libérer.

Certaines actions "tlmgr" n'ont besoin d'aucune autorisation d'écriture et fonctionnent donc de la même manière en mode utilisateur
et mode normal. Actuellement, ce sont : "check", "help", "list", "print-platform",
"rechercher", "afficher", "version".

D'un autre côté, la plupart des actions traitant de la gestion des paquets nécessitent une écriture
autorisations, et ainsi se comporter différemment en mode utilisateur, comme décrit ci-dessous : "installer",
"mettre à jour", "supprimer", "option", "papier", "générer", "sauvegarder", "restaurer", "désinstaller",
"liens symboliques".

Avant d'utiliser "tlmgr" en mode utilisateur, vous devez configurer l'arborescence des utilisateurs avec le
action "init-usertree". Cela crée arborescence utilisateur"/web2c" et arborescence utilisateur"/tlpkg/tlpobj", et un
minimal arborescence utilisateur"/tlpkg/texlive.tlpdb". À ce stade, vous pouvez dire à "tlmgr" de faire le
actions (prises en charge) en ajoutant l'option de ligne de commande "--usermode".

En mode utilisateur, le fichier arborescence utilisateur"/tlpkg/texlive.tlpdb" ne contient que les packages qui ont
été installé dans l'arborescence des utilisateurs à l'aide de "tlmgr", ainsi que des options supplémentaires du
Package ``virtual'' "00texlive.installation" (similaire à celui de l'installation principale
"texlive.tlpdb").

Toutes les actions sur les packages en mode utilisateur ne peuvent être effectuées que sur les packages dits
"déplaçable". Cela exclut tous les packages contenant des exécutables et quelques autres noyaux
paquets. Sur les quelque 2500 packages actuellement dans TeX Live, la grande majorité sont
déplaçable et peut être installé dans une arborescence d'utilisateurs.

Description des changements d'actions en mode utilisateur :

Utilisateur mode installer
En mode utilisateur, l'action "installer" vérifie que le package et toutes les dépendances sont tous
soit déplacé ou déjà installé dans l'installation du système. Si tel est le cas, il
décompresse tous les conteneurs à installer dans l'arborescence des utilisateurs (pour répéter, c'est soit
"TEXMFHOME" ou la valeur de "--usertree") et ajoutez les packages respectifs à l'utilisateur
tree's "texlive.tlpdb" (en le créant si besoin).

L'installation actuelle d'une collection en mode utilisateur installe tous les packages dépendants, mais dans
contrairement au mode normal, pas installer des collections dépendantes. Par exemple, en temps normal
le mode "tlmgr install collection-context" installerait "collection-basic" et d'autres
collections, en mode utilisateur, uniquement les packages mentionnés dans "collection-context" sont
installé.

Utilisateur mode sauvegarde restaurer, supprimer, Mise à jour
En mode utilisateur, ces actions vérifient que tous les packages sur lesquels agir sont installés dans le
arborescence des utilisateurs avant de continuer ; sinon, ils se comportent comme en mode normal.

Utilisateur mode produire, option, papier
En mode utilisateur, ces actions n'agissent que sur les fichiers de configuration de l'arborescence des utilisateurs et/ou
"texlive.tlpdb". crée des fichiers de configuration dans l'arborescence des utilisateurs

CONFIGURATION DOSSIER POUR TLMGR

Un petit sous-ensemble des options de ligne de commande peut être défini dans un fichier de configuration pour "tlmgr" qui
réside dans "TEXMFCONFIG/tlmgr/config". Par défaut, le fichier de configuration est dans
"~/.texliveYYYY/texmf-config/tlmgr/config" (en remplaçant " AAAA " par l'année de votre TeX
installation en direct). C'est pas "TEXMFSYSVAR", pour que le fichier soit spécifique à un seul
utilisateur.

Dans ce fichier, les lignes vides et les lignes commençant par # sont ignorées. Toutes les autres lignes doivent
ressembler

clé = valeur

où les clés autorisées sont "gui-expertmode" (valeur 0 ou 1), "persistent-downloads" (valeur
0 ou 1), "auto-remove" (valeur 0 ou 1) et "gui-lang" (valeur comme dans la ligne de commande
option).

"persistant-downloads", "gui-lang" et "auto-remove" correspondent à la commande respective
options de ligne du même nom. "gui-expertmode" bascule entre l'interface graphique complète et un
GUI simplifiée avec uniquement les paramètres importants et les plus utilisés.

PLUSIEURS REPOSITOIRES

Le référentiel principal de TeX Live contient une vaste gamme de packages. Néanmoins, des compléments
les référentiels locaux peuvent être utiles pour fournir des ressources installées localement, telles que
polices propriétaires et styles maison. De plus, des référentiels de packages alternatifs distribuent
paquets qui ne peuvent pas ou ne doivent pas être inclus dans TeX Live, pour quelque raison que ce soit.

La méthode la plus simple et la plus fiable consiste à définir temporairement la source d'installation sur n'importe quel
référentiel (avec les options de ligne de commande "-repository" ou "option repository"), et
effectuer vos opérations.

Lorsque vous utilisez plusieurs référentiels sur une période prolongée, cependant, explicitement
basculer entre eux devient gênant. Ainsi, il est possible de dire à "tlmgr" à propos de
référentiels supplémentaires que vous souhaitez utiliser. La commande de base est "tlmgr repository add".
Le reste de cette section explique plus en détail.

Lors de l'utilisation de plusieurs référentiels, l'un d'eux doit être défini comme référentiel principal, ce qui
distribue la plupart des packages installés. Lorsque vous passez d'un référentiel unique
installation sur une installation à plusieurs référentiels, le référentiel unique précédent sera
défini comme référentiel principal.

Par défaut, même si plusieurs référentiels sont configurés, les packages sont toujours uniquement
installé à partir du référentiel principal. Ainsi, le simple ajout d'un deuxième référentiel ne
permettre réellement l'installation de quoi que ce soit à partir de là. Vous devez également préciser quel
les packages doivent être extraits du nouveau référentiel, en spécifiant ce que l'on appelle ``pinning''
règles, décrites ci-après.

Épingler
Lorsqu'un package "foo" est épinglé dans un référentiel, un package "foo" dans n'importe quel autre référentiel,
même s'il a un numéro de révision plus élevé, ne sera pas considéré comme un candidat installable.

Comme mentionné ci-dessus, par défaut, tout est épinglé dans le référentiel principal. Allons maintenant
à travers un exemple de configuration d'un deuxième référentiel et d'activation des mises à jour d'un package
à partir de cela.

Tout d'abord, vérifiez que nous prenons en charge plusieurs référentiels et que nous n'en avons qu'un seul activé (comme
est le cas par défaut):

$ liste de référentiels tlmgr
Liste des référentiels (avec balises si définies) :
/var/www/norbert/tlnet

D'accord. Ajoutons le référentiel "tlcontrib" (il s'agit d'un véritable référentiel, hébergé sur
<http://tlcontrib.metatex.org>, maintenu par Taco Hoekwater et al.), avec la balise
"tlcontrib":

$ dépôt tlmgr ajouter http://tlcontrib.metatex.org/2012 tlcontrib

Vérifiez à nouveau la liste des dépôts :

$ liste de référentiels tlmgr
Liste des référentiels (avec balises si définies) :
http://tlcontrib.metatex.org/2012 (tlcontrib)
/var/www/norbert/tlnet (principal)

Maintenant, nous spécifions une entrée d'épinglage pour obtenir le package "context" de "tlcontrib":

$ tlmgr épinglant ajouter un contexte tlcontrib

Vérifiez que nous pouvons trouver "context":

$ tlmgr affiche le contexte
tlmgr : référentiels de packages :

paquet : contexte
référentiel : tlcontrib/26867


- installer "context":

$ tlmgr contexte d'installation
tlmgr : référentiels de packages :

[1/1, ???:??/??:??] installation : contexte @tlcontrib [

Dans la sortie ici, vous pouvez voir que le package "context" a été installé à partir du
Dépôt "tlcontrib" (@tlcontrib).

Enfin, "tlmgr pinning" prend également en charge la suppression de certains ou de tous les packages d'un
dépôt:

$ tlmgr épinglant supprimer le contexte tlcontrib # supprimer uniquement le contexte
$ tlmgr épinglant remove tlcontrib --all # ne prend rien de tlcontrib

Un résumé des actions « épinglage tlmgr » est donné ci-dessus.

GUI POUR TLMGR

L'interface utilisateur graphique de "tlmgr" nécessite l'installation de Perl/Tk. Pour Windows le
les modules nécessaires sont expédiés dans TeX Live, pour tous les autres systèmes (c'est-à-dire basés sur Unix)
Perl/Tk (ainsi que Perl bien sûr) doit être installé.
<http://tug.org/texlive/distro.html#perltk> a une liste d'appels pour certaines distributions.

Au démarrage avec "tlmgr gui", l'interface utilisateur graphique sera affichée. La fenêtre principale
contient une barre de menus, l'affichage principal et une zone d'état où les messages normalement affichés sur
la console s'affiche.

Dans l'affichage principal, il y a trois parties principales : la zone "Configuration de l'affichage", le
liste des packages et les boutons d'action.

De plus, en haut à droite, le référentiel actuellement chargé est affiché ; cela agit également comme un
et lorsque vous cliquez dessus, il essaiera de charger le référentiel par défaut. Pour charger un autre
référentiel, voir l'élément de menu "tlmgr".

Enfin, la zone d'état en bas de la fenêtre donne des informations supplémentaires sur
que se passe-t-il.

Entrée l’affichage
Présentoir paramétrage la surface

La première partie de l'affichage principal vous permet de spécifier (filtrer) quels packages sont
montré. Par défaut, tous sont affichés. Les changements ici sont reflétés immédiatement.

Statut
Sélectionnez si vous souhaitez afficher tous les packages (par défaut), uniquement ceux installés, uniquement ceux
pas installés, ou uniquement ceux avec mise à jour disponible.

Catégories
Sélectionnez les catégories à afficher : packages, collections et/ou schémas. Ceux-ci sont
brièvement expliqué dans la section "DESCRIPTION" ci-dessus.

Match
Sélectionnez les packages correspondant à un modèle spécifique. Par défaut, cela recherche à la fois
descriptions et noms de fichiers. Vous pouvez également sélectionner un sous-ensemble pour la recherche.

Sélection
Sélectionnez les packages parmi ceux sélectionnés, ceux non sélectionnés ou tous. Ici, ``sélectionné''
signifie que la case au début de la ligne d'un paquet est cochée.

Affichage des boutons de configuration
À droite, il y a trois boutons : sélectionnez tous les packages, sélectionnez aucun (aka
désélectionnez tout) et réinitialisez tous ces filtres aux valeurs par défaut, c'est-à-dire afficher tous les disponibles.

Forfait liste la surface

Le second est l'affichage principal répertorie tous les packages installés. Si un référentiel est
chargées, celles qui sont disponibles mais non installées sont également répertoriées.

En double-cliquant sur une ligne de colis, une fenêtre d'information s'ouvre avec plus de détails :
la description longue, les fichiers inclus, etc.

Chaque ligne de la liste des packages comprend les éléments suivants :

une case à cocher
Utilisé pour sélectionner des packages particuliers ; certains des boutons d'action (voir ci-dessous) fonctionnent uniquement
sur les forfaits sélectionnés.

nom du paquet
Le nom (identifiant) du package tel qu'il est indiqué dans la base de données.

révision locale (et version)
Si le package est installé, le numéro de révision TeX Live du package installé
sera affiché. S'il existe une version de catalogue donnée dans la base de données pour ce
package, il sera indiqué entre parenthèses. Cependant, la version catalogue, contrairement à la
La révision TL n'est pas garantie de refléter ce qui est réellement installé.

révision (et version) à distance
Si un référentiel a été chargé, la révision du package dans le référentiel (si
présent) est affiché. Comme pour la colonne locale, si une version catalogue est fournie, elle
sera affiché. Et aussi comme pour la colonne locale, la version catalogue peut être
vicié.

brève description
La brève description du paquet.

Entrée l’affichage action boutons

Sous la liste des packages se trouvent plusieurs boutons :

Mettre à jour tous les installés
Cela appelle "tlmgr update --all", c'est-à-dire essaie de mettre à jour tous les packages disponibles. Au dessous de
ce bouton est une bascule pour permettre la réinstallation des packages précédemment supprimés dans le cadre
de cette action.

Les quatre autres boutons ne fonctionnent que sur les packages sélectionnés, c'est-à-dire ceux où le
case à cocher au début de la ligne du paquet est cochée.

Mises à jour
Mettre à jour uniquement les packages sélectionnés.

Installer
Installez les packages sélectionnés ; agit comme "tlmgr install", c'est-à-dire qu'il installe également
dépendances. Ainsi, l'installation d'une collection installe tous ses packages constitutifs.

Effacer
Supprime les packages sélectionnés ; agit comme "tlmgr remove", c'est-à-dire qu'il supprimera également
dépendances des collections (mais pas des dépendances des packages normaux).

Backup
Effectue une sauvegarde des packages sélectionnés ; agit comme une "sauvegarde tlmgr". Cette action a besoin
l'option "backupdir" définie (voir "Options -" Général>).

Menu Bar
Les entrées suivantes se trouvent dans la barre de menu :

menu "tlmgr"
Les éléments ici chargent divers référentiels : la valeur par défaut comme spécifié dans le TeX Live
base de données, le référentiel réseau par défaut, le référentiel spécifié sur la ligne de commande
(le cas échéant) et une entrée arbitrairement saisie manuellement. A également le "quitter" si nécessaire
fonctionnement.

"Menu Options"
Donne accès à plusieurs groupes d'options : "Papier" (configuration du papier par défaut
tailles), "Plateformes" (uniquement sous Unix, configuration du support supporté/installé
plates-formes), "GUI Language" (sélectionnez la langue utilisée dans l'interface GUI) et "Général"
(tout le reste).

Plusieurs bascules sont également ici. Le premier est "Options expert", qui est défini par
défaut. Si vous désactivez cette option, la prochaine fois que vous démarrez l'interface graphique, un écran simplifié
s'affichera qui n'affiche que la fonctionnalité la plus importante. Ce paramètre est
enregistré dans le fichier de configuration de "tlmgr" ; voir "FICHIER DE CONFIGURATION POUR TLMGR" pour
détails.

Les autres bascules sont toutes désactivées par défaut : pour la sortie de débogage, pour désactiver le
l'installation automatique de nouveaux packages et pour désactiver la suppression automatique de
packages supprimés du serveur. Jouer avec les choix de ce qui est ou n'est pas
installé peut conduire à une installation de TeX Live incohérente ; par exemple, lorsqu'un paquet est
renommé.

"Menu Actions"
Donne accès à plusieurs actions : mettre à jour la base de données des noms de fichiers (aka "ls-R",
"mktexlsr", "texhash"), reconstruire tous les formats ("fmtutil-sys --all"), mettre à jour la carte des polices
base de données ("updmap-sys"), restauration à partir d'une sauvegarde d'un package et utilisation de liens symboliques
dans les répertoires système (pas sous Windows).

L'action finale consiste à supprimer l'intégralité de l'installation de TeX Live (pas non plus sous Windows).

"Menu d'aide"
Donne accès au manuel TeX Live (également sur le Web à l'adresse
<http://tug.org/texlive/doc.html>) et la boîte ``À propos'' habituelle.

LISIBLE EN MACHINE SORTIE

Avec l'option "--machine-readable", "tlmgr" écrit sur stdout dans la ligne fixe orientée
format décrit ici, et les messages d'information habituels pour la consommation humaine sont
écrit sur stderr (normalement, ils sont écrits sur stdout). L'idée est qu'un programme peut
obtenir toutes les informations dont il a besoin en lisant stdout.

Actuellement, cette option ne s'applique qu'aux actions de mise à jour, d'installation et d'"option".

lisible par machine "mettre à jour" et votre "installer" sortie
Le format de sortie est le suivant :

nom de champ "\t" valeur

"fin d'en-tête"
pkgname status localrev serverrev taille runtime esttot

"fin des mises à jour"
autre sortie des actions post, pas sous forme lisible par machine

La section d'en-tête comporte actuellement deux champs : « location-url » (la source du référentiel de
quelles mises à jour sont dessinées), et "total-bytes" (le nombre total d'octets à
téléchargé).

Notre rev local et votre serveurrev les champs pour chaque paquet sont les numéros de révision dans le local
l'installation et le référentiel du serveur, respectivement. Les Taille le champ est le nombre d'octets
à télécharger, c'est-à-dire la taille du fichier tar compressé pour une installation en réseau,
pas la taille déballée. Les champs runtime et esttot ne sont présents que pour les mises à jour et
les packages d'installation automatique et contiennent le temps actuellement écoulé depuis le début de
l'installation/les mises à jour et le temps total estimé.

Les fins de ligne peuvent être LF ou CRLF selon la plate-forme actuelle.

"emplacement-url" Localisation
Notre Localisation peut être une URL (y compris "file:///foo/bar/..."), ou un nom de répertoire
("/foo/bar"). Il s'agit du référentiel de packages à partir duquel les nouvelles informations de package ont été
tiré.

"total-octets" compter
Notre compter est simplement un nombre décimal, la somme des tailles de tous les paquets qui
besoin d'une mise à jour ou d'une installation (qui sont répertoriées par la suite).

Vient ensuite une ligne avec uniquement la chaîne littérale "end-of-header".

Chaque ligne suivante jusqu'à ce qu'une ligne avec une chaîne littérale « fin de mise à jour » rapporte sur un
emballer. Les champs de chaque ligne sont séparés par une tabulation. Voici les champs.

nom_paquet
L'identifiant du package TeX Live, avec un suffixe de plate-forme possible pour les exécutables. Pour
exemple, "pdftex" et "pdftex.i386-linux" sont donnés comme deux packages distincts, l'un sur
chaque ligne.

statuts
L'état de la mise à jour du package. Un caractère, comme suit :

"d" Le package a été supprimé sur le serveur.

"f" Le paquet a été supprimé dans l'installation locale, même si une collection
en dépendait. (Par exemple, l'utilisateur a exécuté "tlmgr remove --force".)

"u" Une mise à jour normale est nécessaire.

"r" Inversé sans mise à jour : la version installée localement est plus récente que la version
sur le serveur.

"a" Besoin d'installation déterminé automatiquement, le package est nouveau sur le
serveur et fait (très probablement) partie d'une collection installée.

Le package "i" sera installé et n'est pas présent dans l'installation locale (action
installer).

Le package "I" est déjà présent mais sera réinstallé (action install).

rev local
Le numéro de révision du package installé, ou "-" s'il n'est pas présent localement.

serveurrev
Le numéro de révision du package sur le serveur, ou "-" s'il n'est pas présent sur le
serveur.

Taille
La taille en octets du package sur le serveur. La somme de toutes les tailles d'emballage est
donné dans le champ d'en-tête "total-bytes" mentionné ci-dessus.

d'exécution
Le temps d'exécution depuis le début des installations ou des mises à jour.

esttot
Le temps total estimé.

lisible par machine "option" sortie
Le format de sortie est le suivant :

clé "\t" valeur

Si une valeur n'est pas enregistrée dans la base de données, la chaîne "(non définie)" est affichée.

Si vous développez un programme qui utilise cette sortie et constatez que des changements seraient
utile, n'hésitez pas à écrire la liste de diffusion.

AUTEURS ET DROIT D'AUTEUR

Ce script et sa documentation ont été écrits pour la distribution TeX Live
(<http://tug.org/texlive>) et les deux sont sous licence GNU General Public License
Version 2 ou ultérieure.

Utilisez tlmgr en ligne à l'aide des services onworks.net