guide/upstream_update.rst

   1 ==================
   2 オリジナル更新方法
   3 ==================
   4
   5 JM リポジトリの構成は :doc:`git_repository` に書かれている通りです。
   6
   7 JM の翻訳の管理方法は
   8
   9 * roff を直接翻訳
  10 * po4a を使って翻訳
  11
  12 の 2 つの方法が混在しています。
  13
  14 オリジナルの更新方法もどちらの管理方法をとっているかによって異なります。
  15
  16 po4a を使用している場合には、各パッケージのディレクトリに po4a というフォルダが存在します。
  17 存在しない場合は、roff を直接編集して翻訳しています。
  18
  19 roff を直接翻訳
  20 ===============
  21
  22 後できちんと書きたいと思います。
  23
  24 関連するコマンド群は以下 (だったと思う)
  25
  26 * admin/JM-orig-upd.sh
  27 * admin/git2upd
  28 * admin/upd_tl.perl
  29
  30 .. warning::
  31
  32    ``git2upd`` コマンドは新しい git status の出力に対応していないので注意。
  33
  34    ``git2upd`` コマンドは、 ``git add`` コマンドで staged された原文を
  35    ``git status`` コマンドの出力に基づいて ``upd_tl.perl`` に渡すファイルを
  36    作成するが、以下のように staged されたファイルリストの前に空行があることを
  37    期待している。しかし、新しめの git ではこの空行が出力されないため、
  38    ``git2upd`` コマンドが期待通り動作しない。本来は ``git2upd`` コマンドを修正
  39    すべきだが、とりあえずの対処としては ``git status original`` の出力を保存
  40    した上で、必要な空行を挿入して対処する。
  41    (少なくとも git 2.25.1 では空行が出力されないことを確認している。)
  42
  43    .. code-block:: console
  44
  45       HEAD detached at 015f61e7
  46       Changes to be committed:
  47        (use "git restore --staged <file>..." to unstage)
  48
  49              modified:   original/Changes
  50              modified:   original/Changes.old
  51              modified:   original/README
  52              renamed:    original/man-pages-3.79.Announce -> original/man-pages-5.10.Announce
  53              renamed:    original/man-pages-3.79.lsm -> original/man-pages-5.10.lsm
  54              modified:   original/man1/getent.1
  55              modified:   original/man1/iconv.1
  56              ...
  57
  58
  59
  60 po4a を使って翻訳
  61 =================
  62
  63 (to be written)
  64
  65 LDP man-pages
  66 =============
  67
  68 :ref:`LDP_man-pages <ldp_original_update>` を参照。
  69
  70 GNU coreutils
  71 =============
  72
  73 :ref:`GNU_coreutils <coreutils_original_update>` を参照。
  74
  75 ``help2man`` の出力と、追加ファイル ``*.x`` の翻訳を合わせて、
  76 日本語マニュアルを生成しています。
  77 そのため、管理が他のものと異なっています。