「Man ページ」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(Pkg/AUR テンプレートの更新)
(同期)
4行目: 4行目:
 
[[en:Man page]]
  
[[en:Man page]]
 
[[es:Man page]]
  
[[es:Man page]]
  +
[[id:Man page]]
 
[[ko:Man page]]
  
[[ko:Man page]]
  +
[[pt:Man page]]
 
[[ru:Man page]]
  
[[ru:Man page]]
 
[[zh-hans:Man page]]
  
[[zh-hans:Man page]]
  +
{{Related articles start}}
  +
{{Related|コンソールのカラー出力#man}}
  +
{{Related articles end}}
 
'''man ページ''' ("マニュアルページ"の略) は Arch Linux を含む、ほとんどの主要な UNIX ライクなオペレーティングシステムで最初からインストールされているドキュメントです。man ページを表示するには {{Ic|man}} コマンドを使います。
  
'''man ページ''' ("マニュアルページ"の略) は Arch Linux を含む、ほとんどの主要な UNIX ライクなオペレーティングシステムで最初からインストールされているドキュメントです。man ページを表示するには {{Ic|man}} コマンドを使います。
   
28行目: 33行目:
 
# システム管理コマンド (通常は root 権限を必要とします) とデーモン
  
# システム管理コマンド (通常は root 権限を必要とします) とデーモン
   
−
基本的に Man ページはページの名前で呼ばれ、括弧で囲まれたセクション番号が後ろに付きます。man(1) と man(7) のように、同じ名前の man ページが存在することも時々あります。この場合は、man を呼び出すときにセクション番号と man ページの名前を指定します。例:
 +
基本的に Man ページはページの名前で呼ばれ、括弧で囲まれたセクション番号が後ろに付きます。{{man|1|man}} と {{man|7|man}} のように、同じ名前の man ページが存在することも時々あります。この場合は、man を呼び出すときにセクション番号と man ページの名前を指定します。例:
   
 
$ man 5 passwd
  
$ man 5 passwd
75行目: 80行目:
 
$ man -K password
  
$ man -K password
   
−
== man ページのカラー出力 ==
 +
== ページ幅 ==
  +
man ページの幅は {{Ic|MANWIDTH}} 環境変数で制御できます。
−
[[コンソールのカラー出力#man]] を見てください。
  
  +
  +
ターミナルのカラム数が小さすぎる場合 (例: ウィンドウの幅が小さい場合)、間違ったところで改行されることがあります。{{Ic|man}} を実行するときに MANWIDTH を設定することで読みやすくすることが可能です:
  +
  +
{{Hc|~/.bashrc|<nowiki>
  +
man() {
  +
local width=$(tput cols)
  +
[ $width -gt $MANWIDTH ] && width=$MANWIDTH
  +
env MANWIDTH=$width \
  +
man "$@"
  +
}
  +
</nowiki>}}
   
 
== ローカルの man ページを読む ==
  
== ローカルの man ページを読む ==
90行目: 106行目:
   
 
=== ブラウザで表示できる HTML に変換する ===
  
=== ブラウザで表示できる HTML に変換する ===
−
==== mdocml ====
 +
==== mandoc ====
−
[[AUR]] から {{AUR|mdocml}}{{Broken package link|パッケージが存在しません}} をインストールします。例えば {{ic|free(1)}} のページを変換するなら:
 +
{{AUR|mandoc}} パッケージをインストールしてください。例えば {{ic|free(1)}} のページを変換するなら:
 
$ gunzip -c /usr/share/man/man1/free.1.gz | mandoc -Thtml -Ostyle=style.css 1> free.html
  
$ gunzip -c /usr/share/man/man1/free.1.gz | mandoc -Thtml -Ostyle=style.css 1> free.html
   
122行目: 138行目:
   
 
{{Note|基本的にフォントは決まったサイズの Times に制限されています。ハイパーリンクは存在しません。man ページによってはターミナルでの表示に特化されていることがあり、PS や PDF のような形だと上手くいかないことがあります。}}
  
{{Note|基本的にフォントは決まったサイズの Times に制限されています。ハイパーリンクは存在しません。man ページによってはターミナルでの表示に特化されていることがあり、PS や PDF のような形だと上手くいかないことがあります。}}
−  
−
以下の perl スクリプトは man ページを PDF に変換して、PDF を {{ic|$HOME/.manpdf/}} ディレクトリにキャッシュし、PDF ビューア (特に {{Pkg|mupdf}}) を起動します。
  
−  
−
{{hc|Usage: manpdf [<section>] <manpage>|<nowiki>
  
−
#!/usr/bin/perl
  
−
use File::stat;
  
−  
−
$pdfdir = $ENV{"HOME"}."/.manpdf";
  
−
-d $pdfdir || mkdir $pdfdir || die "can't create $pdfdir";
  
−
$manpage = $ARGV[0];
  
−
chop($manpath = `man -w $manpage`);
  
−
die if $?;
  
−  
−
$maninfo = stat($manpath) or die;
  
−
$manpath =~ s@.*/man./(.*)(\.(gz|bz2))?$@$1@;
  
−
$pdfpath = "$pdfdir/$manpath.pdf";
  
−
$pdftime = 0;
  
−
if (-f $pdfpath) {
  
−
$pdfinfo = stat($pdfpath) or die;
  
−
$pdftime = $pdfinfo->mtime;
  
−
}
  
−
if (!-f $pdfpath || $maninfo->mtime > $pdftime) {
  
−
system "man -t $manpage | ps2pdf -dPDFSETTINGS=/screen - $pdfpath";
  
−
}
  
−
die if !-f $pdfpath;
  
−
if (!fork) {
  
−
open(STDOUT, "/dev/null");
  
−
open(STDERR, "/dev/null");
  
−
exec "mupdf", "-r", "96", $pdfpath;
  
−
#exec "acroread", $pdfpath;
  
−
}
  
−
</nowiki>}}
  
   
 
== オンラインの Man ページ ==
  
== オンラインの Man ページ ==
 
man ページのオンラインデータベース:
  
man ページのオンラインデータベース:
−
*[http://man7.org/linux/man-pages/index.html Man7.org] Arch Linux の {{pkg|man-pages}}
 +
* [http://man7.org/linux/man-pages/index.html man7.org] - Arch Linux の {{pkg|man-pages}} で使われています。
−
*[https://manned.org/pkg/arch ''Arch Linux man pages'']
 +
* [https://manned.org/pkg/arch Arch Linux man pages]
−
*[http://manpages.debian.net/ ''Debian GNU/Linux man pages'']
 +
* [http://manpages.debian.net/ Debian GNU/Linux man pages]
−
*[http://leaf.dragonflybsd.org/cgi/web-man ''DragonFlyBSD manual pages'']
 +
* [http://leaf.dragonflybsd.org/cgi/web-man DragonFlyBSD manual pages]
−
*[http://www.freebsd.org/cgi/man.cgi ''FreeBSD Hypertext Man Pages'']
 +
* [http://www.freebsd.org/cgi/man.cgi FreeBSD man pages]
−
*[http://www.manpages.spotlynx.com/ ''Linux and Solaris 10 Man Pages'']
 +
* [http://www.manpages.spotlynx.com/ Linux and Solaris 10 man pages]
−
*[http://linux.die.net/man/ ''Linux man pages at die.net'']
 +
* [http://linux.die.net/man/ Linux man pages at die.net]
−
*[http://www.kernel.org/doc/man-pages/ The Linux man-pages project at kernel.org]
 +
* [http://netbsd.gw.com/cgi-bin/man-cgi NetBSD manual pages]
−
*[http://netbsd.gw.com/cgi-bin/man-cgi ''NetBSD manual pages'']
 +
* [http://developer.apple.com/documentation/Darwin/Reference/ManPages/index.html Mac OS X manual pages]
−
*[http://developer.apple.com/documentation/Darwin/Reference/ManPages/index.html ''Mac OS X Manual Pages'']
 +
* [http://unixhelp.ed.ac.uk/alphabetical/index.html On-line UNIX manual pages]
−
*[http://unixhelp.ed.ac.uk/alphabetical/index.html ''On-line UNIX manual pages'']
 +
* [http://www.openbsd.org/cgi-bin/man.cgi OpenBSD manual pages]
−
*[http://www.openbsd.org/cgi-bin/man.cgi ''OpenBSD manual pages'']
 +
* [http://man.cat-v.org/plan_9/ Plan 9 Manual — Volume 1]
−
*[http://man.cat-v.org/plan_9/ ''Plan 9 Manual — Volume 1'']
 +
* [http://man.cat-v.org/inferno/ Inferno Manual — Volume 1]
  +
* [http://sfdoccentral.symantec.com/sf/5.0MP3/linux/manpages/index.html Storage Foundation man pages]
−
*[http://man.cat-v.org/inferno/ ''Inferno Manual — Volume 1'']
  
  +
* [http://www.unix.com/man-page/OpenSolaris/1/man/ The UNIX and Linux forums man page repository]
−
*[http://sfdoccentral.symantec.com/sf/5.0MP3/linux/manpages/index.html ''Storage Foundation Man Pages'']
  
  +
* [http://manpages.ubuntu.com/ Ubuntu manpage リポジトリ]
−
*[http://www.unix.com/man-page/OpenSolaris/1/man/ ''The UNIX and Linux Forums Man Page Repository'']
  
−
*[http://manpages.ubuntu.com/ ''Ubuntu Manpage Repository'']
  
   
 
{{Warning|ディストリビューションによっては、Arch が使っているのとは異なる man ページを使用していることがあります (パッチを適用していたり単純に古くなっているなど)。オンラインの man ページを使用するときはそのことに注意してください。}}
  
{{Warning|ディストリビューションによっては、Arch が使っているのとは異なる man ページを使用していることがあります (パッチを適用していたり単純に古くなっているなど)。オンラインの man ページを使用するときはそのことに注意してください。}}
189行目: 172行目:
 
* {{man|7|hier}}
  
* {{man|7|hier}}
 
* {{man|1|systemd}}
  
* {{man|1|systemd}}
−
* {{man|1p|locale|url=http://man7.org/linux/man-pages/man1/locale.1p.html}}, {{man|5|locale}}, {{man|7|locale}}
 +
* {{man|1p|locale}}, {{man|5|locale}}, {{man|7|locale}}
 
* {{man|3|printf}}
  
* {{man|3|printf}}
 
* {{man|5|proc}}
  
* {{man|5|proc}}
203行目: 186行目:
   
 
Arch Linux 特有のページ:
  
Arch Linux 特有のページ:
−
* {{man|7|archlinux|url=}}
 +
* {{man|7|archlinux}}
−
* {{man|8|mkinitcpio|url=}}
 +
* {{man|8|mkinitcpio}}
−
* {{man|8|pacman|url=https://www.archlinux.org/pacman/pacman.8.html}}
 +
* {{man|8|pacman}}
−
* {{man|8|pacman-key|url=https://www.archlinux.org/pacman/pacman-key.8.html}}
 +
* {{man|8|pacman-key}}
−
* {{man|5|pacman.conf|url=https://www.archlinux.org/pacman/pacman.conf.5.html}}
 +
* {{man|5|pacman.conf}}
   
 
== 参照 ==
  
== 参照 ==
213行目: 196行目:
 
* [[一般的な推奨事項]] - Arch の一般的な推奨事項
  
* [[一般的な推奨事項]] - Arch の一般的な推奨事項
 
* [https://wiki.gentoo.org/wiki/Man_page man page - Gentoo Wiki] - Gentoo wiki の記事
  
* [https://wiki.gentoo.org/wiki/Man_page man page - Gentoo Wiki] - Gentoo wiki の記事
−
* [http://unix.stackexchange.com/a/147 Setting colors for less] and [http://unix.stackexchange.com/a/6357 solving related problems] (threads on StackExchange)
  
 
* [https://linuxtidbits.wordpress.com/2013/08/21/wtfm-write-the-fine-manual-with-pod2man-text-converter/ Write The Fine Manual with pod2man]
  
* [https://linuxtidbits.wordpress.com/2013/08/21/wtfm-write-the-fine-manual-with-pod2man-text-converter/ Write The Fine Manual with pod2man]

2017年10月11日 (水) 21:02時点における版

関連記事

man ページ ("マニュアルページ"の略) は Arch Linux を含む、ほとんどの主要な UNIX ライクなオペレーティングシステムで最初からインストールされているドキュメントです。man ページを表示するには man コマンドを使います。

man ページのカバーする範囲の如何を問わず、man ページは完結型のドキュメントとして作られており、必然的に、関連する話題を述べるときに他の man ページを参照するということが控えられています。このことはハイパーリンクを使用する info ファイルと対象的であり、GNU は info ファイルで伝統的な man ページ形式を置き換えようとしています。

man で使用されるデフォルトのページャは less です。

Man ページの表示

man ページを読むには、次を入力してください: 

$ man page_name

マニュアルは複数のセクションに分類されています:

  1. 一般的なコマンド
  2. システムコール (カーネルによって提供されている関数)
  3. ライブラリコール (C ライブラリの関数)
  4. 特殊ファイル (通常は /dev 以下に存在します) とドライバー
  5. ファイルのフォーマットと規則
  6. ゲーム
  7. その他 (約束事など)
  8. システム管理コマンド (通常は root 権限を必要とします) とデーモン

基本的に Man ページはページの名前で呼ばれ、括弧で囲まれたセクション番号が後ろに付きます。man(1) と man(7) のように、同じ名前の man ページが存在することも時々あります。この場合は、man を呼び出すときにセクション番号と man ページの名前を指定します。例: 

$ man 5 passwd

上記のコマンドを実行すると passwd ユーティリティではなく、/etc/passwd についての man ページが表示されます。

whatis コマンドを使用することで man ページの一行説明を表示できます。例えば、ls の man ページセクションの簡単な説明を見るには、次を入力: 

$ whatis ls
ls (1p)              - list directory contents
ls (1)               - list directory contents

形式

全ての Man ページは標準の書式に従って書かれており、読みやすいようになっています。よく出てくるセクションは以下の通り:

  • NAME - コマンドの名前、コマンドの使用目的について一行の説明。
  • SYNOPSIS - コマンドが受け付けるオプションや引数のリスト、または関数が使用するパラメータやヘッダーファイル。
  • DESCRIPTION - コマンドや関数の目的・動作に関する詳しい説明。
  • EXAMPLES - 一般的な例。シンプルなコマンドからやや複雑なコマンドまで様々。
  • OPTIONS - コマンドが受け付けるオプションの説明、何が変わるのか。
  • EXIT STATUS - 様々な終了コードの意味。
  • FILES - コマンドや関数に関連するファイル。
  • BUGS - 解決が棚上げされているコマンドや関数の問題。いわゆる既知のバグ。
  • SEE ALSO - 関連するコマンドや関数のリスト。
  • AUTHOR, HISTORY, COPYRIGHT, LICENSE, WARRANTY - プログラムに関する情報、プログラムの履歴、利用条件、開発者。

マニュアルの検索

man ユーティリティを使えば man ページを表示することはできますが、そもそも読みたいマニュアルページの名前を知らない場合に問題が起こります。幸いに、-k または --apropos オプションを使うことで、キーワードを指定してマニュアルページの説明文を検索することができます。

検索機能は専用のキャッシュを使っています。デフォルトでは、キャッシュが作成されていないために、何を検索しても該当するページは見つからないという結果になってしまいます。次を実行することでキャッシュを生成または更新することが可能です: 

# mandb

新しい man ページをインストールしたら上のコマンドを実行するようにしてください。

キャッシュを作成したら検索をすることができます。例えば、"password" に関する man ページを検索するには: 

$ man -k password

または: 

$ man --apropos password

上記のコマンドは以下のように apropos コマンドを実行するのと同じです: 

$ apropos password

デフォルトでは、指定したキーワードは正規表現として解釈されます。

ページ全体でキーワードが検索されるように細かく検索して欲しい場合、-K オプションを使います: 

$ man -K password

ページ幅

man ページの幅は MANWIDTH 環境変数で制御できます。

ターミナルのカラム数が小さすぎる場合 (例: ウィンドウの幅が小さい場合)、間違ったところで改行されることがあります。man を実行するときに MANWIDTH を設定することで読みやすくすることが可能です: 

~/.bashrc
man() {
    local width=$(tput cols)
    [ $width -gt $MANWIDTH ] && width=$MANWIDTH
    env MANWIDTH=$width \
    man "$@"
}

ローカルの man ページを読む

標準のインターフェイスの代わりに、lynx や Firefox などのブラウザを使って man ページを見ることで info ページの利点 (ハイパーリンク) を得ることができます。

KDE ユーザーは次のようにして Konqueror で man ページを読めます: 

man:<name>

他に、公式リポジトリには2つの選択肢があります:

1. xorg-xman は X で man ページをカテゴライズされた形で見ることができます。

2. GNOME のヘルプブラウザ yelp はさらに小奇麗な方法ですが依存パッケージが複数存在します。

ブラウザで表示できる HTML に変換する

mandoc

mandocAUR パッケージをインストールしてください。例えば free(1) のページを変換するなら: 

$ gunzip -c /usr/share/man/man1/free.1.gz | mandoc -Thtml -Ostyle=style.css 1> free.html

free.html ファイルをお好きなブラウザで開いて下さい。

man2html

まず、公式リポジトリから man2html をインストールします。

そして、man ページを変換: 

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

他の使い方として印刷しやすいように man2html でプレーンテキストにすることもできます: 

$ man free | man2html -bare > ~/free.txt

man -H

Arch のリポジトリに入っている man の GNU 実装には HTML で表示する機能が付いています: 

$ man -H free

使用されるブラウザは BROWSER 環境変数によって決まります。-H オプションにバイナリを渡すことで上書きできます。

roffit

AUR から roffitAUR をインストールしてください。

man ページを変換するには: 

$ gunzip -c /usr/share/man/man1/free.1.gz | roffit > free.html

PDF に変換する

man ページは基本的に印刷ができるようになっています。man ページは troff で書かれており、troff はもともと組版言語だからです。ghostscript をインストールしていれば、man ページを PDF に変換するのはとても簡単に行えます: man -t <manpage> | ps2pdf - <pdf>。どんな風になるかは google で画像検索 してみればわかります。これは万人向けとは言えないでしょう。

ノート: 基本的にフォントは決まったサイズの Times に制限されています。ハイパーリンクは存在しません。man ページによってはターミナルでの表示に特化されていることがあり、PS や PDF のような形だと上手くいかないことがあります。

オンラインの Man ページ

man ページのオンラインデータベース:

警告: ディストリビューションによっては、Arch が使っているのとは異なる man ページを使用していることがあります (パッチを適用していたり単純に古くなっているなど)。オンラインの man ページを使用するときはそのことに注意してください。

特筆すべき man ページ

以下は読む価値があるページの部分的なリストであり、様々なことを深く理解するのに役立ちます。リファレンスとして役立つページもあります (ascii テーブルなど)。

他のページは、カテゴリ 7 ページを見て下さい: 

$ man -s 7 -k ".*"

Arch Linux 特有のページ:

参照

「https://wiki.archlinux.jp/index.php?title=Man_ページ&oldid=9992」から取得