*tlmgr [#y0e2a3d4]
*tlmgr [#headline]

**使い方 [#nbbacf1d]
tlmgr は [[TeX Live]] のパッケージ管理ツールで，コマンドラインで使用します．
GUI 版としては [[TeX Live Shell (GUI 版 TeX Live Manager)>TeX Live Shell]] や macOS の [[TeX Live Utility]] もあります．


**使い方 [#usage]

公式ドキュメントに解説があります．

-http://www.tug.org/texlive/tlmgr.html
-http://www.tug.org/texlive/doc/tlmgr.html
-http://www.fugenji.org/~thomas/texlive-guide/tlmgr.html
-http://www.preining.info/blog/2013/04/tlmgr-user-mode/

***アップデート [#xb3b4aaa]
 $ tlmgr --help

コマンドラインから以下のコマンドを実行します．~
でもマニュアルが表示されます．

■ Windows, Cygwin の場合
***TeX Live のアップデート [#update]

コマンドラインから以下のコマンドを実行します．

-Windows (Windows, Cygwin) の場合（「管理者として実行」しなければならない場合があります）
 tlmgr update --self --all

■ OS X, Linux の場合

-macOS, Linux の場合
 sudo tlmgr update --self --all

***インストールされているパッケージの情報を見る（ライセンス・バージョン確認など） [#info]

たとえば [[geometry]] パッケージについて調べる場合は，以下のコマンドを実行します．

 $ tlmgr info geometry
 package:     geometry
 category:    Package
 shortdesc:   Flexible and complete interface to document dimensions.
 longdesc:    The package provides an easy and flexible user interface (以下略)
 installed:   Yes
 revision:    47638
 sizes:       src: 157k, doc: 465k, run: 45k
 relocatable: No
 cat-version: 5.8
 cat-date:    2018-05-07 13:41:20 +0200
 cat-license: lppl
 cat-topics:  geometry
 cat-related: vmargin typearea
 collection:  collection-latex

***過去のパッケージを復元する [#dcbeb630]

ときどき，tlmgr で更新したパッケージに不具合が混入したり，他のパッケージとの共存で不都合が生じたりすることもあります．
問題のなかった古いバージョンを復元したくなることがあると思います．

たとえば，tlmgr でパッケージを一斉にアップデートしたところ，luatexja の r39527 で不都合が生じたとして，以前にインストールされていたバージョンに復旧したいとします．
その場合，以下のコマンドを実行します．

 $ tlmgr restore luatexja

バックアップが残っている場合は，ローカルに保存されているリビジョン番号が表示されます．

 Available backups for luatexja: 39105 (2016-02-02 15:45)

確認したら，そのリビジョン番号を復元します．

 $ sudo tlmgr restore luatexja 39105

一度確認されます．

 Do you really want to restore luatexja to revision 39105 (y/N):

y で進むと

 Restoring luatexja, 39105 from /usr/local/texlive/2015/tlpkg/backups/luatexja.r39105.tar.xz

などと表示され，過去のパッケージが展開されます．

なお，フォーマット作成時に読まれるファイルを復元した場合（たとえば LaTeX 本体に不具合が生じ，過去のバージョンを復元した場合）は，手動でフォーマットを再作成する必要が生じます．

-実際の例：[[LuaLaTeX (2016/02/01) で数式が化ける>forum:1819]]


**関連リンク [#links]

-[[tlmgr オンラインアップデータ:http://www.fugenji.org/~thomas/texlive-guide/tlmgr.html]]
-[[tlmgr user mode - There and back again:http://www.preining.info/blog/2013/04/tlmgr-user-mode/]]