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>Greek (el)</entry>
 277             <entry>ISO-8859-7</entry>
 278             <!--<entry>Russian (ru)</entry>-->
 279             <!--<entry>KOI8-R</entry>-->
 280 @y
 281             <entry>インドネシア語 (id)</entry>
 282             <entry>ISO-8859-1</entry>
 283             <entry>ギリシア語 (el)</entry>
 284             <entry>ISO-8859-7</entry>
 285             <!--<entry>ロシア語 (ru)</entry>-->
 286             <!--<entry>KOI8-R</entry>-->
 287 @z
 288
 289 @x
 290             <entry>Icelandic (is)</entry>
 291             <entry>ISO-8859-1</entry>
 292             <entry>Slovak (sk)</entry>
 293             <entry>ISO-8859-2</entry>
 294 @y
 295             <entry>アイスランド語 (is)</entry>
 296             <entry>ISO-8859-1</entry>
 297             <entry>スロバキア語 (sk)</entry>
 298             <entry>ISO-8859-2</entry>
 299 @z
 300
 301 @x
 302             <entry>Italian (it)</entry>
 303             <entry>ISO-8859-1</entry>
 304             <entry>Slovenian (sl)</entry>
 305             <entry>ISO-8859-2</entry>
 306 @y
 307             <entry>イタリア語 (it)</entry>
 308             <entry>ISO-8859-1</entry>
 309             <entry>スロベニア語 (sl)</entry>
 310             <entry>ISO-8859-2</entry>
 311 @z
 312
 313 @x
 314             <entry>Norwegian Bokmal (nb)</entry>
 315             <entry>ISO-8859-1</entry>
 316             <entry>Serbian Latin (sr@latin)</entry>
 317             <entry>ISO-8859-2</entry>
 318 @y
 319             <entry>ノルウェー語 ブークモール (Norwegian Bokmal; nb)</entry>
 320             <entry>ISO-8859-1</entry>
 321             <entry>セルビア Latin (sr@latin)</entry>
 322             <entry>ISO-8859-2</entry>
 323 @z
 324
 325 @x
 326             <entry>Dutch (nl)</entry>
 327             <entry>ISO-8859-1</entry>
 328             <entry>Serbian (sr)</entry>
 329             <entry>ISO-8859-5</entry>
 330 @y
 331             <entry>オランダ語 (nl)</entry>
 332             <entry>ISO-8859-1</entry>
 333             <entry>セルビア語 (sr)</entry>
 334             <entry>ISO-8859-5</entry>
 335 @z
 336
 337 @x
 338             <entry>Norwegian Nynorsk (nn)</entry>
 339             <entry>ISO-8859-1</entry>
 340             <entry>Turkish (tr)</entry>
 341             <entry>ISO-8859-9</entry>
 342 @y
 343             <entry>ノルウェー語 ニーノシュク (Norwegian Nynorsk; nn)</entry>
 344             <entry>ISO-8859-1</entry>
 345             <entry>トルコ語 (tr)</entry>
 346             <entry>ISO-8859-9</entry>
 347 @z
 348
 349 @x
 350             <entry>Norwegian (no)</entry>
 351             <entry>ISO-8859-1</entry>
 352             <entry>Ukrainian (uk)</entry>
 353             <entry>KOI8-U</entry>
 354 @y
 355             <entry>ノルウェー語 (no)</entry>
 356             <entry>ISO-8859-1</entry>
 357             <entry>ウクライナ語 (uk)</entry>
 358             <entry>KOI8-U</entry>
 359 @z
 360
 361 @x
 362             <entry>Portuguese (pt)</entry>
 363             <entry>ISO-8859-1</entry>
 364             <entry>Vietnamese (vi)</entry>
 365             <entry>TCVN5712-1</entry>
 366 @y
 367             <entry>ポルトガル語 (pt)</entry>
 368             <entry>ISO-8859-1</entry>
 369             <entry>ベトナム語 (vi)</entry>
 370             <entry>TCVN5712-1</entry>
 371 @z
 372
 373 @x
 374             <entry>Swedish (sv)</entry>
 375             <entry>ISO-8859-1</entry>
 376             <entry>Simplified Chinese (zh_CN)</entry>
 377             <entry>GBK</entry>
 378 @y
 379             <entry>スウェーデン語 (sv)</entry>
 380             <entry>ISO-8859-1</entry>
 381             <entry>中国語 簡体字 (Simplified Chinese) (zh_CN)</entry>
 382             <entry>GBK</entry>
 383 @z
 384
 385 @x
 386             <entry>Belarusian (be)</entry>
 387             <entry>CP1251</entry>
 388             <entry>Simplified Chinese, Singapore (zh_SG)</entry>
 389             <entry>GBK</entry>
 390 @y
 391             <entry>ベラルーシ語 (be)</entry>
 392             <entry>CP1251</entry>
 393             <entry>中国語 簡体字 (Simplified Chinese), シンガポール (zh_SG)</entry>
 394             <entry>GBK</entry>
 395 @z
 396
 397 @x
 398             <entry>Bulgarian (bg)</entry>
 399             <entry>CP1251</entry>
 400             <entry>Traditional Chinese, Hong Kong (zh_HK)</entry>
 401             <entry>BIG5HKSCS</entry>
 402 @y
 403             <entry>ブルガリア語 (bg)</entry>
 404             <entry>CP1251</entry>
 405             <entry>中国語 繁体字 (Traditional Chinese), 香港 (zh_HK)</entry>
 406             <entry>BIG5HKSCS</entry>
 407 @z
 408
 409 @x
 410             <entry>Czech (cs)</entry>
 411             <entry>ISO-8859-2</entry>
 412             <entry>Traditional Chinese (zh_TW)</entry>
 413             <entry>BIG5</entry>
 414 @y
 415             <entry>チェコ語 (cs)</entry>
 416             <entry>ISO-8859-2</entry>
 417             <entry>中国語 繁体字 (Traditional Chinese) (zh_TW)</entry>
 418             <entry>BIG5</entry>
 419 @z
 420
 421 @x
 422             <entry>Greek (el)</entry>
 423             <entry>ISO-8859-7</entry>
 424             <entry></entry>
 425             <entry></entry>
 426 @y
 427             <entry>ギリシア語 (el)</entry>
 428             <entry>ISO-8859-7</entry>
 429             <entry></entry>
 430             <entry></entry>
 431 @z
 432
 433 @x
 434       <para>Manual pages in languages not in the list are not supported.</para>
 435 @y
 436       <para>
 437       上に示されていない言語によるマニュアルページはサポートされません。
 438       </para>
 439 @z
 440
 441 @x
 442     <title>Contents of Man-DB</title>
 443 @y
 444     <title>&ContentsOf1;Man-DB&ContentsOf2;</title>
 445 @z
 446
 447 @x
 448       <segtitle>Installed programs</segtitle>
 449       <segtitle>Installed libraries</segtitle>
 450       <segtitle>Installed directories</segtitle>
 451 @y
 452       <segtitle>&InstalledProgram;</segtitle>
 453       <segtitle>&InstalledLibrary;</segtitle>
 454       <segtitle>&InstalledDirectory;</segtitle>
 455 @z
 456
 457 @x
 458         <seg>accessdb, apropos (link to whatis), catman, lexgrog, man,
 459         man-recode, mandb, manpath, and whatis</seg>
 460         <seg>libman.so and libmandb.so (both in /usr/lib/man-db)</seg>
 461         <seg>/usr/lib/man-db, /usr/libexec/man-db,
 462         and /usr/share/doc/man-db-&man-db-version;</seg>
 463 @y
 464         <seg>accessdb, apropos (whatis へのリンク), catman, lexgrog, man,
 465         man-recode, mandb, manpath, whatis</seg>
 466         <seg>libman.so, libmandb.so (いずれも /usr/lib/man-db ディレクトリ内)</seg>
 467         <seg>/usr/lib/man-db, /usr/libexec/man-db,
 468         /usr/share/doc/man-db-&man-db-version;</seg>
 469 @z
 470
 471 @x
 472       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 473 @y
 474       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 475 @z
 476
 477 @x accessdb
 478           <para>Dumps the <command>whatis</command> database contents in
 479           human-readable form</para>
 480 @y
 481           <para>
 482           <command>whatis</command> データベースの内容をダンプして読みやすい形で出力します。
 483           </para>
 484 @z
 485
 486 @x apropos
 487           <para>Searches the <command>whatis</command> database and displays
 488           the short descriptions of system commands that contain a given
 489           string</para>
 490 @y
 491           <para>
 492           <command>whatis</command> データベースを検索して、指定した文字列を含むシステムコマンドの概略説明を表示します。
 493           </para>
 494 @z
 495
 496 @x catman
 497           <para>Creates or updates the pre-formatted manual pages</para>
 498 @y
 499           <para>
 500           フォーマット済マニュアルページを生成、更新します。
 501           </para>
 502 @z
 503
 504 @x lexgrog
 505           <para>Displays one-line summary information about a given manual
 506           page</para>
 507 @y
 508           <para>
 509           指定されたマニュアルページについて、一行のサマリー情報を表示します。
 510           </para>
 511 @z
 512
 513 @x man
 514           <para>Formats and displays the requested manual page</para>
 515 @y
 516           <para>
 517           指定されたマニュアルページを整形して表示します。
 518           </para>
 519 @z
 520
 521 @x man-recode
 522           <para>Converts manual pages to another encoding</para>
 523 @y
 524           <para>
 525           マニュアルページを別のエンコーディングに変換します。
 526           </para>
 527 @z
 528
 529 @x mandb
 530           <para>Creates or updates the <command>whatis</command> database</para>
 531 @y
 532           <para>
 533           <command>whatis</command> データベースを生成、更新します。
 534           </para>
 535 @z
 536
 537 @x manpath
 538           <para>Displays the contents of $MANPATH or (if $MANPATH is not set)
 539           a suitable search path based on the settings in man.conf and the
 540           user's environment</para>
 541 @y
 542           <para>
 543           $MANPATH の内容を表示します。
 544           あるいは ($MANPATH が設定されていない場合は) man.conf 内の設定とユーザー設定に基づいて適切な検索パスを表示します。
 545           </para>
 546 @z
 547
 548 @x whatis
 549           <para>Searches the <command>whatis</command> database and displays
 550           the short descriptions of system commands that contain the given
 551           keyword as a separate word</para>
 552 @y
 553           <!--
 554           日本語訳註： 2009-09-07 matsuand
 555           separate word の意味が分からなかったため訳出しなかった。
 556           -->
 557           <para>
 558           <command>whatis</command> データベースを検索して、指定されたキーワードを含むシステムコマンドの概略説明を表示します。
 559           </para>
 560 @z
 561
 562 % @x zsoelim
 563 %           <para>Reads files and replaces lines of the form <emphasis>.so
 564 %           file</emphasis> by the contents of the mentioned
 565 %           <emphasis>file</emphasis></para>
 566 % @y
 567 %           <para>
 568 %           ファイルの内容を読み込んで、<emphasis>.so file</emphasis> の形で書かれている記述行を、その <emphasis>file</emphasis> の内容に置き換えます。
 569 %           </para>
 570 % @z
 571
 572 @x libman
 573           <para>Contains run-time support for <command>man</command></para>
 574 @y
 575           <para>
 576           <command>man</command> に対しての実行時のサポート機能を提供します。
 577           </para>
 578 @z
 579
 580 @x libmandb
 581           <para>Contains run-time support for <command>man</command></para>
 582 @y
 583           <para>
 584           <command>man</command> に対しての実行時のサポート機能を提供します。
 585           </para>
 586 @z