src/chapter08/man-db.ch

   1 %
   2 % This is part of LFSbookja package.
   3 %
   4 % This is a CTIE change file for the original XML source of the LFSbook.
   5 %
   6 @x
   7 <?xml version="1.0" encoding="ISO-8859-1"?>
   8 @y
   9 <?xml version="1.0" encoding="UTF-8"?>
  10 @z
  11
  12 @x
  13     <para>The Man-DB package contains programs for finding and viewing man
  14     pages.</para>
  15 @y
  16     <para>
  17     Man-DB パッケージは man ページを検索したり表示したりするプログラムを提供します。
  18     </para>
  19 @z
  20
  21 @x
  22     <title>Installation of Man-DB</title>
  23 @y
  24     <title>&InstallationOf1;Man-DB&InstallationOf2;</title>
  25 @z
  26
  27 @x
  28     <para>Prepare Man-DB for compilation:</para>
  29 @y
  30     <para>&PreparePackage1;Man-DB&PreparePackage2;</para>
  31 @z
  32
  33 @x
  34       <title>The meaning of the configure options:</title>
  35 @y
  36       <title>&MeaningOfOption1;configure&MeaningOfOption2;</title>
  37 @z
  38
  39 @x --disable-setuid
  40           <para>This disables making the <command>man</command> program setuid
  41           to user <systemitem class="username">man</systemitem>.</para>
  42 @y
  43           <para>
  44           これは <command>man</command> プログラムが <systemitem
  45           class="username">man</systemitem> ユーザーに対して setuid を実行しないようにします。
  46           </para>
  47 @z
  48
  49 @x --enable-cache-owner=bin
  50           <para>This makes the system-wide cache files be owned by user
  51           <systemitem class="username">bin</systemitem>.</para>
  52 @y
  53           <para>
  54           システムワイドなキャッシュファイルの所有ユーザーを <systemitem
  55           class="username">bin</systemitem> とします。
  56           </para>
  57 @z
  58
  59 @x --with-...
  60           <para>These three parameters are used to set some default programs.
  61           <command>lynx</command> is a text-based web browser (see
  62           BLFS for installation instructions), <command>vgrind</command>
  63           converts program sources to Groff input, and <command>grap</command>
  64           is useful for typesetting graphs in Groff documents. The
  65           <command>vgrind</command> and <command>grap</command> programs are
  66           not normally needed for viewing manual pages. They are not part of
  67           LFS or BLFS, but you should be able to install them yourself after
  68           finishing LFS if you wish to do so.</para>
  69 @y
  70           <para>
  71           この三つのオプションはデフォルトで利用するプログラムを指定します。
  72           <command>lynx</command> はテキストベースの Web ブラウザーです。
  73           (BLFS でのインストール手順を参照してください。)
  74           <command>vgrind</command> はプログラムソースを Groff の入力形式に変換します。
  75           <command>grap</command> は Groff 文書においてグラフを組版するために利用します。
  76           <command>vgrind</command> と <command>grap</command> は man ページを見るだけであれば必要ありません。
  77           これらは LFS や BLFS には含まれません。
  78           もし利用したい場合は LFS の構築を終えた後に自分でインストールしてください。
  79           </para>
  80 @z
  81
  82 @x --with-systemd...
  83           <para>These parameters prevent installing unneeded systemd
  84           directories and files.</para>
  85 @y
  86           <para>
  87           これらのパラメーターは systemd に関する不要なディレクトリやファイルはインストールしないようにします。
  88           </para>
  89 @z
  90
  91 @x
  92     <para>Compile the package:</para>
  93 @y
  94     <para>&CompileThePackage;</para>
  95 @z
  96
  97 @x
  98    <para>To test the results, issue:</para>
  99 @y
 100    <para>コンパイル結果をテストするには以下を実行します。</para>
 101 @z
 102
 103 %@x
 104 %    <para>One test, man-missing-locales, is known to fail in the LFS chroot envirnment.</para>
 105 %@y
 106 %    <para>
 107 %    man-missing-locales というテストが LFS chroot 環境下では失敗します。
 108 %    </para>
 109 %@z
 110
 111 @x
 112     <para>Install the package:</para>
 113 @y
 114     <para>&InstallThePackage;</para>
 115 @z
 116
 117 %@x
 118 %    <para revision="systemd">Remove a reference to a non-existent user:</para>
 119 %@y
 120 %    <para revision="systemd">
 121 %    存在しないユーザーへの参照を削除します。
 122 %    </para>
 123 %@z
 124
 125 @x
 126     <title>Non-English Manual Pages in LFS</title>
 127 @y
 128     <title>LFS における英語以外のマニュアルページ</title>
 129 @z
 130
 131 @x
 132     <para>The following table shows the character set that Man-DB assumes
 133     manual pages installed under
 134     <filename class="directory">/usr/share/man/&lt;ll&gt;</filename> will be
 135     encoded with.  In addition to this, Man-DB correctly determines if manual
 136     pages installed in that directory are UTF-8 encoded.</para>
 137 @y
 138     <para>
 139     以下に示す表は <filename
 140     class="directory">/usr/share/man/&lt;ll&gt;</filename> 配下にインストールされる man ページとそのエンコーディングを示します。
 141     Man-DB は man ページが UTF-8 エンコーディングかどうかを正しく認識します。
 142     </para>
 143 @z
 144
 145 @x
 146 <title>Expected character encoding of legacy 8-bit manual pages</title>
 147 @y
 148 <title>
 149 8 ビット man ページのキャラクターエンコーディング
 150 </title>
 151 @z
 152
 153 @x
 154             <entry>Language (code)</entry>
 155             <entry>Encoding</entry>
 156             <entry>Language (code)</entry>
 157             <entry>Encoding</entry>
 158 @y
 159             <entry>言語 (コード)</entry>
 160             <entry>エンコーディング</entry>
 161             <entry>言語 (コード)</entry>
 162             <entry>エンコーディング</entry>
 163 @z
 164
 165 @x
 166             <entry>Danish (da)</entry>
 167             <entry>ISO-8859-1</entry>
 168             <entry>Croatian (hr)</entry>
 169             <entry>ISO-8859-2</entry>
 170 @y
 171             <entry>デンマーク語 (da)</entry>
 172             <entry>ISO-8859-1</entry>
 173             <entry>クロアチア語 (hr)</entry>
 174             <entry>ISO-8859-2</entry>
 175 @z
 176
 177 @x
 178             <entry>German (de)</entry>
 179             <entry>ISO-8859-1</entry>
 180             <entry>Hungarian (hu)</entry>
 181             <entry>ISO-8859-2</entry>
 182 @y
 183             <entry>ドイツ語 (de)</entry>
 184             <entry>ISO-8859-1</entry>
 185             <entry>ハンガリー語 (hu)</entry>
 186             <entry>ISO-8859-2</entry>
 187 @z
 188
 189 @x
 190             <entry>English (en)</entry>
 191             <entry>ISO-8859-1</entry>
 192             <entry>Japanese (ja)</entry>
 193             <entry>EUC-JP</entry>
 194 @y
 195             <entry>英語 (en)</entry>
 196             <entry>ISO-8859-1</entry>
 197             <entry>日本語 (ja)</entry>
 198             <entry>EUC-JP</entry>
 199 @z
 200
 201 @x
 202             <entry>Spanish (es)</entry>
 203             <entry>ISO-8859-1</entry>
 204             <entry>Korean (ko)</entry>
 205             <entry>EUC-KR</entry>
 206 @y
 207             <entry>スペイン語 (es)</entry>
 208             <entry>ISO-8859-1</entry>
 209             <entry>韓国語 (ko)</entry>
 210             <entry>EUC-KR</entry>
 211 @z
 212
 213 @x
 214             <entry>Estonian (et)</entry>
 215             <entry>ISO-8859-1</entry>
 216             <entry>Lithuanian (lt)</entry>
 217             <entry>ISO-8859-13</entry>
 218 @y
 219             <entry>エストニア語 (et)</entry>
 220             <entry>ISO-8859-1</entry>
 221             <entry>リトアニア語 (lt)</entry>
 222             <entry>ISO-8859-13</entry>
 223 @z
 224
 225 @x
 226             <entry>Finnish (fi)</entry>
 227             <entry>ISO-8859-1</entry>
 228             <entry>Latvian (lv)</entry>
 229             <entry>ISO-8859-13</entry>
 230 @y
 231             <entry>フィンランド語 (fi)</entry>
 232             <entry>ISO-8859-1</entry>
 233             <entry>ラトビア語 (lv)</entry>
 234             <entry>ISO-8859-13</entry>
 235 @z
 236
 237 @x
 238             <entry>French (fr)</entry>
 239             <entry>ISO-8859-1</entry>
 240             <entry>Macedonian (mk)</entry>
 241             <entry>ISO-8859-5</entry>
 242 @y
 243             <entry>フランス語 (fr)</entry>
 244             <entry>ISO-8859-1</entry>
 245             <entry>マケドニア語 (mk)</entry>
 246             <entry>ISO-8859-5</entry>
 247 @z
 248
 249 @x
 250             <entry>Irish (ga)</entry>
 251             <entry>ISO-8859-1</entry>
 252             <entry>Polish (pl)</entry>
 253             <entry>ISO-8859-2</entry>
 254 @y
 255             <entry>アイルランド語 (ga)</entry>
 256             <entry>ISO-8859-1</entry>
 257             <entry>ポーランド語 (pl)</entry>
 258             <entry>ISO-8859-2</entry>
 259 @z
 260
 261 @x
 262             <entry>Galician (gl)</entry>
 263             <entry>ISO-8859-1</entry>
 264             <entry>Romanian (ro)</entry>
 265             <entry>ISO-8859-2</entry>
 266 @y
 267             <entry>ガリシア語 (gl)</entry>
 268             <entry>ISO-8859-1</entry>
 269             <entry>ルーマニア語 (ro)</entry>
 270             <entry>ISO-8859-2</entry>
 271 @z
 272
 273 @x
 274             <entry>Indonesian (id)</entry>
 275             <entry>ISO-8859-1</entry>
 276             <entry>Russian (ru)</entry>
 277             <entry>KOI8-R</entry>
 278 @y
 279             <entry>インドネシア語 (id)</entry>
 280             <entry>ISO-8859-1</entry>
 281             <entry>ロシア語 (ru)</entry>
 282             <entry>KOI8-R</entry>
 283 @z
 284
 285 @x
 286             <entry>Icelandic (is)</entry>
 287             <entry>ISO-8859-1</entry>
 288             <entry>Slovak (sk)</entry>
 289             <entry>ISO-8859-2</entry>
 290 @y
 291             <entry>アイスランド語 (is)</entry>
 292             <entry>ISO-8859-1</entry>
 293             <entry>スロバキア語 (sk)</entry>
 294             <entry>ISO-8859-2</entry>
 295 @z
 296
 297 @x
 298             <entry>Italian (it)</entry>
 299             <entry>ISO-8859-1</entry>
 300             <entry>Slovenian (sl)</entry>
 301             <entry>ISO-8859-2</entry>
 302 @y
 303             <entry>イタリア語 (it)</entry>
 304             <entry>ISO-8859-1</entry>
 305             <entry>スロベニア語 (sl)</entry>
 306             <entry>ISO-8859-2</entry>
 307 @z
 308
 309 @x
 310             <entry>Norwegian Bokmal (nb)</entry>
 311             <entry>ISO-8859-1</entry>
 312             <entry>Serbian Latin (sr@latin)</entry>
 313             <entry>ISO-8859-2</entry>
 314 @y
 315             <entry>ノルウェー語 ブークモール (Norwegian Bokmal; nb)</entry>
 316             <entry>ISO-8859-1</entry>
 317             <entry>セルビア Latin (sr@latin)</entry>
 318             <entry>ISO-8859-2</entry>
 319 @z
 320
 321 @x
 322             <entry>Dutch (nl)</entry>
 323             <entry>ISO-8859-1</entry>
 324             <entry>Serbian (sr)</entry>
 325             <entry>ISO-8859-5</entry>
 326 @y
 327             <entry>オランダ語 (nl)</entry>
 328             <entry>ISO-8859-1</entry>
 329             <entry>セルビア語 (sr)</entry>
 330             <entry>ISO-8859-5</entry>
 331 @z
 332
 333 @x
 334             <entry>Norwegian Nynorsk (nn)</entry>
 335             <entry>ISO-8859-1</entry>
 336             <entry>Turkish (tr)</entry>
 337             <entry>ISO-8859-9</entry>
 338 @y
 339             <entry>ノルウェー語 ニーノシュク (Norwegian Nynorsk; nn)</entry>
 340             <entry>ISO-8859-1</entry>
 341             <entry>トルコ語 (tr)</entry>
 342             <entry>ISO-8859-9</entry>
 343 @z
 344
 345 @x
 346             <entry>Norwegian (no)</entry>
 347             <entry>ISO-8859-1</entry>
 348             <entry>Ukrainian (uk)</entry>
 349             <entry>KOI8-U</entry>
 350 @y
 351             <entry>ノルウェー語 (no)</entry>
 352             <entry>ISO-8859-1</entry>
 353             <entry>ウクライナ語 (uk)</entry>
 354             <entry>KOI8-U</entry>
 355 @z
 356
 357 @x
 358             <entry>Portuguese (pt)</entry>
 359             <entry>ISO-8859-1</entry>
 360             <entry>Vietnamese (vi)</entry>
 361             <entry>TCVN5712-1</entry>
 362 @y
 363             <entry>ポルトガル語 (pt)</entry>
 364             <entry>ISO-8859-1</entry>
 365             <entry>ベトナム語 (vi)</entry>
 366             <entry>TCVN5712-1</entry>
 367 @z
 368
 369 @x
 370             <entry>Swedish (sv)</entry>
 371             <entry>ISO-8859-1</entry>
 372             <entry>Simplified Chinese (zh_CN)</entry>
 373             <entry>GBK</entry>
 374 @y
 375             <entry>スウェーデン語 (sv)</entry>
 376             <entry>ISO-8859-1</entry>
 377             <entry>中国語 簡体字 (Simplified Chinese) (zh_CN)</entry>
 378             <entry>GBK</entry>
 379 @z
 380
 381 @x
 382             <entry>Belarusian (be)</entry>
 383             <entry>CP1251</entry>
 384             <entry>Simplified Chinese, Singapore (zh_SG)</entry>
 385             <entry>GBK</entry>
 386 @y
 387             <entry>ベラルーシ語 (be)</entry>
 388             <entry>CP1251</entry>
 389             <entry>中国語 簡体字 (Simplified Chinese), シンガポール (zh_SG)</entry>
 390             <entry>GBK</entry>
 391 @z
 392
 393 @x
 394             <entry>Bulgarian (bg)</entry>
 395             <entry>CP1251</entry>
 396             <entry>Traditional Chinese, Hong Kong (zh_HK)</entry>
 397             <entry>BIG5HKSCS</entry>
 398 @y
 399             <entry>ブルガリア語 (bg)</entry>
 400             <entry>CP1251</entry>
 401             <entry>中国語 繁体字 (Traditional Chinese), 香港 (zh_HK)</entry>
 402             <entry>BIG5HKSCS</entry>
 403 @z
 404
 405 @x
 406             <entry>Czech (cs)</entry>
 407             <entry>ISO-8859-2</entry>
 408             <entry>Traditional Chinese (zh_TW)</entry>
 409             <entry>BIG5</entry>
 410 @y
 411             <entry>チェコ語 (cs)</entry>
 412             <entry>ISO-8859-2</entry>
 413             <entry>中国語 繁体字 (Traditional Chinese) (zh_TW)</entry>
 414             <entry>BIG5</entry>
 415 @z
 416
 417 @x
 418             <entry>Greek (el)</entry>
 419             <entry>ISO-8859-7</entry>
 420             <entry></entry>
 421             <entry></entry>
 422 @y
 423             <entry>ギリシア語 (el)</entry>
 424             <entry>ISO-8859-7</entry>
 425             <entry></entry>
 426             <entry></entry>
 427 @z
 428
 429 @x
 430       <para>Manual pages in languages not in the list are not supported.</para>
 431 @y
 432       <para>
 433       上に示されていない言語によるマニュアルページはサポートされません。
 434       </para>
 435 @z
 436
 437 @x
 438     <title>Contents of Man-DB</title>
 439 @y
 440     <title>&ContentsOf1;Man-DB&ContentsOf2;</title>
 441 @z
 442
 443 @x
 444       <segtitle>Installed programs</segtitle>
 445       <segtitle>Installed libraries</segtitle>
 446       <segtitle>Installed directories</segtitle>
 447 @y
 448       <segtitle>&InstalledProgram;</segtitle>
 449       <segtitle>&InstalledLibrary;</segtitle>
 450       <segtitle>&InstalledDirectory;</segtitle>
 451 @z
 452
 453 @x
 454         <seg>accessdb, apropos (link to whatis), catman, lexgrog, man,
 455         man-recode, mandb, manpath, and whatis</seg>
 456         <seg>libman.so and libmandb.so (both in /usr/lib/man-db)</seg>
 457         <seg>/usr/lib/man-db, /usr/libexec/man-db,
 458         and /usr/share/doc/man-db-&man-db-version;</seg>
 459 @y
 460         <seg>accessdb, apropos (whatis へのリンク), catman, lexgrog, man,
 461         man-recode, mandb, manpath, whatis</seg>
 462         <seg>libman.so, libmandb.so (いずれも /usr/lib/man-db ディレクトリ内)</seg>
 463         <seg>/usr/lib/man-db, /usr/libexec/man-db,
 464         /usr/share/doc/man-db-&man-db-version;</seg>
 465 @z
 466
 467 @x
 468       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 469 @y
 470       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 471 @z
 472
 473 @x accessdb
 474           <para>Dumps the <command>whatis</command> database contents in
 475           human-readable form</para>
 476 @y
 477           <para>
 478           <command>whatis</command> データベースの内容をダンプして読みやすい形で出力します。
 479           </para>
 480 @z
 481
 482 @x apropos
 483           <para>Searches the <command>whatis</command> database and displays
 484           the short descriptions of system commands that contain a given
 485           string</para>
 486 @y
 487           <para>
 488           <command>whatis</command> データベースを検索して、指定した文字列を含むシステムコマンドの概略説明を表示します。
 489           </para>
 490 @z
 491
 492 @x catman
 493           <para>Creates or updates the pre-formatted manual pages</para>
 494 @y
 495           <para>
 496           フォーマット済マニュアルページを生成、更新します。
 497           </para>
 498 @z
 499
 500 @x lexgrog
 501           <para>Displays one-line summary information about a given manual
 502           page</para>
 503 @y
 504           <para>
 505           指定されたマニュアルページについて、一行のサマリー情報を表示します。
 506           </para>
 507 @z
 508
 509 @x man
 510           <para>Formats and displays the requested manual page</para>
 511 @y
 512           <para>
 513           指定されたマニュアルページを整形して表示します。
 514           </para>
 515 @z
 516
 517 @x man-recode
 518           <para>Converts manual pages to another encoding</para>
 519 @y
 520           <para>
 521           マニュアルページを別のエンコーディングに変換します。
 522           </para>
 523 @z
 524
 525 @x mandb
 526           <para>Creates or updates the <command>whatis</command> database</para>
 527 @y
 528           <para>
 529           <command>whatis</command> データベースを生成、更新します。
 530           </para>
 531 @z
 532
 533 @x manpath
 534           <para>Displays the contents of $MANPATH or (if $MANPATH is not set)
 535           a suitable search path based on the settings in man.conf and the
 536           user's environment</para>
 537 @y
 538           <para>
 539           $MANPATH の内容を表示します。
 540           あるいは ($MANPATH が設定されていない場合は) man.conf 内の設定とユーザー設定に基づいて適切な検索パスを表示します。
 541           </para>
 542 @z
 543
 544 @x whatis
 545           <para>Searches the <command>whatis</command> database and displays
 546           the short descriptions of system commands that contain the given
 547           keyword as a separate word</para>
 548 @y
 549           <!--
 550           日本語訳註： 2009-09-07 matsuand
 551           separate word の意味が分からなかったため訳出しなかった。
 552           -->
 553           <para>
 554           <command>whatis</command> データベースを検索して、指定されたキーワードを含むシステムコマンドの概略説明を表示します。
 555           </para>
 556 @z
 557
 558 % @x zsoelim
 559 %           <para>Reads files and replaces lines of the form <emphasis>.so
 560 %           file</emphasis> by the contents of the mentioned
 561 %           <emphasis>file</emphasis></para>
 562 % @y
 563 %           <para>
 564 %           ファイルの内容を読み込んで、<emphasis>.so file</emphasis> の形で書かれている記述行を、その <emphasis>file</emphasis> の内容に置き換えます。
 565 %           </para>
 566 % @z
 567
 568 @x libman
 569           <para>Contains run-time support for <command>man</command></para>
 570 @y
 571           <para>
 572           <command>man</command> に対しての実行時のサポート機能を提供します。
 573           </para>
 574 @z
 575
 576 @x libmandb
 577           <para>Contains run-time support for <command>man</command></para>
 578 @y
 579           <para>
 580           <command>man</command> に対しての実行時のサポート機能を提供します。
 581           </para>
 582 @z