[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
mandb.8 in man-db

From: UCHIDA Norihiro <KY4N-UCD@xxxxxxxxxxxxxxx>
Subject: mandb.8 in man-db
Date: Tue, 3 Oct 2000 01:24:16 +0900
X-dispatcher: imput version 20000228(IM140)
X-ml-info: If you have a question, send e-mail with the body "help" (without quotes) to the address debian-doc-ctl@debian.or.jp; help=<mailto:debian-doc-ctl@debian.or.jp?body=help>
X-ml-name: debian-doc
X-mlserver: fml [fml 3.0pl#17]; post only (only members can post)
Message-id: <20001003012053K.KY4N-UCD@xxxxxxxxxxxxxxx>
X-mail-count: 02112
X-mailer: Mew version 1.94.2 on Emacs 20.7 / Mule 4.1 (AOI)
最後です。mandb.8です。

これも、FSSTNDという記述がありましたが、そのままです。

また、エラーメッセージの部分ですが、コマンドが日本語化されて
いるので、もとの訳では原文のままでしたが.poファイルの
メッセージにおきかえました。

あと、.poファイルの原文のほうのメッセージが変ったものが
あるらしく、日本語メッセージがでないものがありました。
こっちの作業はまだやってません。


'\" t
.\" Man page for mandb
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man_db distribution.
.\" 
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@xxxxxxxxxxxxxxx) 
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri 25 Sep 1998 by NAKANO Takeo <nakano@xxxxxxxxxxxxxxxx>
.\" Modified Sun 6 Dec 1998 by NAKANO Takeo <nakano@xxxxxxxxxxxxxxxx>
.\" Updated Mon 2 Oct 2000 by UCHIDA Norihiro <KY4N-UCD@xxxxxxxxxxxxxxx>
.\"
.\"WORD:	hierarchy	階層
.\"

.\"O .TH mandb 8 "Wed Feb 23 00:00:00 EET 2000" "" "Manual pager utils"
.\"O .SH NAME
.\"O mandb \- create or update the manual page index caches
.\"O .SH SYNOPSIS
.\"O .B mandb  
.\"O .RB [\| \-dqsuc \||\| \-h \||\| \-V\c
.\"O .RI "\|] [\|" manpath \|] 


.TH mandb 8 "Wed Feb 23 00:00:00 EET 2000" "" "Manual pager utils"
.SH 名前
mandb \- マニュアルページのインデックスキャッシュを作成・更新する。
.SH 書式
.B mandb  
.RB [\| \-dqsuc \||\| \-h \||\| \-V\c
.RI "\|] [\|" manpath \|] 

.\"O .SH DESCRIPTION
.\"O .B mandb
.\"O is used to initialise or manually update
.\"O .B index 
.\"O database caches that are usually maintained by 
.\"O .BR man .
.\"O The caches contain information relevant to the current state of the manual
.\"O page system and the information stored within them is used by the man_db 
.\"O utilities to enhance their speed and functionality.

.SH 説明
.B mandb
はデータベースのキャッシュ
.B index
を初期化したり、手動で更新するときに用いる。通常はこのキャッシュは
.B man
によって管理されている。
キャッシュには、現在のマニュアルページシステムに関する情報が含まれている。
この情報は man_db ユーティリティ群によって用いられ、速度と機能の向上に
貢献している。

.\"O When creating or updating an
.\"O .BR index ,
.\"O .B mandb
.\"O will warn of bad ROFF .so requests, bogus manual page filenames and 
.\"O manual pages from which the 
.\"O .B whatis 
.\"O cannot be parsed.

.B index
が生成・更新されるとき、
.B mandb
は ROFF の .so 命令の間違いや、マニュアルページのファイル名の重複、
.B whatis
によって情報を抽出できないマニュアルページなどにたいして警告を発する。

.\"O Supplying 
.\"O .B mandb 
.\"O with an optional colon delimited path will override the internal `global'
.\"O manual page hierarchy search path, determined from information found within 
.\"O the man_db configuration file.

.B mandb
に、コロンで区切ったパスのリストを与えることもできる。
これは man_db 設定ファイルの情報から決定された、プログラム
内部の `global' なマニュアルページ階層検索パスを上書きする。

.\"O .SH "DATABASE CACHES"
.\"O .B mandb
.\"O can be compiled with support for any one of the following database types.

.SH データベースキャッシュ
.B mandb
は以下のデータベース形式のいずれか一つをサポートするように
コンパイルすることができる。

.\"O .TS
.\"O tab (@);
.\"O l l l l.
.\"O Name@Type@Async@Filename
.\"O _
.\"O Berkeley db@Binary tree@Yes@\fIindex.bt\fR
.\"O GNU gdbm v >= 1.6@Hashed@Yes@\fIindex.db\fR
.\"O GNU gdbm v <  1.6@Hashed@No@\fIindex.db\fR
.\"O UNIX ndbm@Hashed@No@\fIindex.(dir|pag)\fR
.\"O .TE

.TS
tab (@);
l l l l.
名前@形式@非同期@ファイル名
_
Berkeley db@二分木@可@\fIindex.bt\fR
GNU gdbm v >= 1.6@ハッシュ@可@\fIindex.db\fR
GNU gdbm v <  1.6@ハッシュ@不可@\fIindex.db\fR
UNIX ndbm@ハッシュ@不可@\fIindex.(dir|pag)\fR
.TE

.\"O Those database types that support asynchronous updates provide enhanced
.\"O speed at the cost of possible corruption in the event of unusual
.\"O termination.
.\"O In an unusual case where this has occured, it may be necessary to rerun 
.\"O .B mandb 
.\"O with the 
.\"O .B \-c
.\"O option to re-create the databases from scratch. 

これらのデータベース形式のうち非同期な更新ができるものでは、
速度は向上するが、予期しない中断が起こったときにデータが壊れるかもしれない。
このような破壊が起こったときには、
.B mandb
を
.B \-c
オプションをつけて実行し、データベースを再構成しなおす必要が
あるだろう。

.\"O .SH OPTIONS
.\"O .TP
.\"O .B \-d, \-\-debug
.\"O Produce debugging information.

.SH オプション
.TP
.B \-d, \-\-debug
デバッグ情報を生成する。

.\"O .TP
.\"O .B \-q, \-\-quiet
.\"O Produce no warnings.

.TP
.B \-q, \-\-quiet
警告を発しない。

.\"O .TP
.\"O .B \-s, \-\-no-straycats
.\"O Do not spend time looking for or adding information to the databases
.\"O regarding stray cats.

.TP
.B \-s, \-\-no-straycats
stray cat (訳注: おそらく対応する roff ソースのない cat ページのこと
でしょう) を探したり、それに関する情報をデータに追加しようとは試みない。

.\"O .TP
.\"O .B \-c, \-\-create
.\"O By default, 
.\"O .B mandb
.\"O will try to update any previously created databases. If a database
.\"O does not exist, it will create it. This option forces 
.\"O .B mandb
.\"O to delete previous databases and re-create them from scratch. This may be
.\"O necessary if a database becomes corrupt or if a new database storage scheme
.\"O is introduced in the future.

.TP
.B \-c, \-\-create
デフォルトでは、
.B mandb
は以前に生成されたデータベースを更新しようとする。データベースが
存在しない場合には、始めから生成する。
このオプションを指定すると、
.B mandb
は以前のデータベースを消去し、データベースをゼロから再構成する。
これはデータベースが壊れた場合や、将来データベースの管理方法が
新しいものに変わったときなどに必要となろう。

.\"O .TP
.\"O .B \-u, \-\-user-db
.\"O Create user databases only, even with write permissions necessary to create
.\"O `global' databases.

.TP
.B \-u, \-\-user-db
ユーザーのデータベースしか生成しない。 `global' なデータベースを作成す
る権限があっても、こちらは生成しない。

.\"O .TP
.\"O .B \-h, \-\-help
.\"O Show the usage message, then exit.

.TP
.B \-h, \-\-help
使用法に関するメッセージを表示して終了する。

.\"O .TP
.\"O .B \-V, \-\-version
.\"O Show the version, then exit.

.TP
.B \-V, \-\-version
バージョンを表示して終了する。

.\"O .SH DIAGNOSTICS
.\"O The following warning messages can be emitted during database building.

.SH 診断メッセージ
データベースの構築中に、以下のような警告メッセージが出力されることがあ
る。

.\"O .TP 
.\"O .B <filename>: whatis parse for page(sec) failed
.\"O An attempt to extract whatis line(s) from the given
.\"O <filename> failed.  This is usually due to a poorly written manual
.\"O page, but if many such messages are emitted it is likely that the
.\"O system contains non-standard manual pages which are incompatible with
.\"O the man_db whatis parser.

.TP 
.B <filename>: whatis が page(sec) の解析に失敗しました
<filename> から whatis に必要な行を取り出すのに失敗した。これは通常マ
ニュアルページの書き方が悪いからであることが多いが、このようなメッセー
ジが多く出るようであれば、そのシステムには man_db の whatis パーザーと
互換性のない、非標準的なマニュアルページが含まれている可能性が高い。

.\"O .TP
.\"O .B <filename>: is a dangling symlink
.\"O <filename> does not exist but is referenced by a symbolic link. 
.\"O Further diagnostics are usually emitted to identify the <filename> of the
.\"O offending link. 

.TP
.B <filename>: はシンボリックリンクが切れています
<filename> がシンボリックリンクによって参照されているが、存在していな
い。通常、 <filename> を間違ってリンク対象としてしまっているリンク元に
関する診断メッセージが同時に表示される。

.\"O .TP
.\"O .B <filename>: bad symlink or ROFF `.so' request
.\"O <filename> is either a symbolic link to, or contains a ROFF include
.\"O request to, a non existent file.

.TP
.B <filename>: シンボリックリンクが不正であるか、ROFF `.so' 要求が不正です
<filename> はシンボリックリンクであるか、 ROFF のインクルー
ド命令を含んでいるが、リンク先・読み込み先のファイルが存在していない。

.\"O .TP
.\"O .B <filename>: ignoring bogus filename
.\"O The <filename> may or may not be a valid manual page but its name is
.\"O invalid.  This is usually due to a manual page with sectional extension <x>
.\"O being put in manual page section <y>. 

.TP
.B <filename>: セクションが違うファイル名を無視しています
<filename> はマニュアルページとして正しいかそうでないかに
かかわらず、その名前が正しくない。
通常これは、セクション拡張子 <x> のファイルが、
マニュアルページのセクション <y> に置かれている場合に起こる。

.\"O .TP
.\"O .B <filename_mask>: competing extensions
.\"O The wildcard <filename_mask> is not unique.  This is usually caused by
.\"O the existance of both a compressed and uncompressed version of the same
.\"O manual page.  All but the most recent are ignored.

.TP
.B <filename_mask>: 拡張子が競合しています
ワイルドカード <filename_mask> がユニークな名前でない。これは通常、同
じマニュアルページに対して、圧縮されたバージョンとされていないバージョ
ンが共存している場合に起こる。最新のもの以外は無視される。

.\"O .SH FILES
.\"O .TP
.\"O .I /etc/manpath.config
.\"O man_db configuration file.

.SH ファイル
.TP
.I /etc/manpath.config
man_db の設定ファイル。

.\"O .TP
.\"O .I /usr/man/index.(bt|db|dir|pag)
.\"O A traditional global
.\"O .I index
.\"O database cache.

.TP
.I /usr/man/index.(bt|db|dir|pag)
従来形式の、 global なデータベースキャッシュの
インデックス。

.\"O .TP
.\"O .I /var/catman/index.(bt|db|dir|pag)
.\"O An alternate or FSSTND
.\"O compliant global
.\"O .I index
.\"O database cache.

.TP
.I /var/catman/index.(bt|db|dir|pag)
新しい (FSSTND 準拠の)、 global なデータベースキャッシュの
インデックス。

.\" .I /var/cache/man/index.(bt|db|dir|pag)
.\" で、s/FSSTND/FHS/ だろう。たぶん。

.\"O .SH "SEE ALSO"
.\"O .BR man (1), 
.\"O .BR manpath (5),
.\"O .BR catman (8).

.SH 関連項目
.BR man (1), 
.BR manpath (5),
.BR catman (8)

.\"O .SH AUTHOR
.\"O Wilf. (G.Wilford@xxxxxxxxxxxxxxx).
.\"O Fabrizio Polacco (fpolacco@debian.org).

.SH 著者
Wilf. (G.Wilford@xxxxxxxxxxxxxxx).
Fabrizio Polacco (fpolacco@debian.org).

-----
内田憲宏 (UCHIDA Norihiro)
KY4N-UCD@xxxxxxxxxxxxxxx
Prev by Date: catman.8 in man-db
Next by Date: Re: link to missing pages, typo
Previous by thread: catman.8 in man-db
Next by thread: Re: link to missing pages, typo
Index(es):
- Date
- Thread