Texinfo 4.0

Texinfoは，オンライン情報と印刷された出力を作成するため，単一のソースファ イルを使うドキュメントシステムです．

このマスターメニューの最初の部分で，このInfoドキュメントの主なノードを列 挙し，それは，@-コマンドと概念の索引を含みます．メニューの残りはすべて， このドキュメントの下位レベルのノードです．

これは，Texinfoマニュアルのエディション4.0で， 28 September 1999に更新しました．

Texinfoのコピー条件		Your rights.
1. Texinfoの概要		Texinfo in brief.
2. Texinfoモードを使う		How to use Texinfo mode.
3. Texinfoファイルを始める		What is at the beginning of a Texinfo file?
4. Texinfoファイルを終える		What is at the end of a Texinfo file?
5. 章の構造		How to create chapters, sections, subsections, appendices, and other parts.
6. ノード		How to write nodes.
7. メニュー		How to write menus.
8. 相互参照		How to write cross references.
9. 単語と句のマーキング		How to mark words and phrases as code, keyboard input, meta-syntactic variables, and the like.
10. 引用と例		How to write quotations, examples, etc.
11. リストと表		How to write lists and tables.
12. 索引		How to create indices.
13. 特別の挿入		How to insert @-signs, braces, etc.
14. 改行，改ページの作成と阻止		How to force and prevent line and page breaks.
15. コマンドの定義		How to describe functions and the like in a uniform manner.
16. 目に見えるテキストの条件		How to specify text for either TeX or Info.
17. 国際化
18. 新しいTexinfoコマンドの定義
19. 書式化とハードコピーの出力		How to convert a Texinfo file to a file for printing and how to print that file.
20. Infoファイルの作成とインストール
A. @-コマンドリスト		All the Texinfo @-commands.
B. チップとヒント		Hints on how to write a Texinfo document.
C. Texinfoファイルの見本		A sample Texinfo file to look at.
D. 許可の見本		Tell readers they have the right to copy and distribute.
E. インクルードファイル		How to incorporate other Texinfo files.
F. ページ見出し		How to write page headings and footings.
G. 書式化の失敗		How to find formatting mistakes.
H. 段落の補充		All about paragraph refilling.
I. @-コマンドの構文		A description of @-Command syntax.
J. TeXの入手方法		How to Obtain TeX.
コマンドと変数の索引		A menu containing commands and variables.
概念の索引		A menu covering many topics.

 -- The Detailed Node Listing ---

Texinfoの概要

1.1 バグの報告		Submitting effective bug reports.
1.2 Texinfoを使う		Create printed or online output.
1.3 Infoファイル		What is an Info file?
1.4 印刷された本		Characteristics of a printed book or manual.
1.5 @-コマンド		@-commands are used for formatting.
1.6 一般的な構文の慣習		General rules for writing a Texinfo file.
1.7 コメント		Writing comments and ignored text in general.
1.8 Texinfoファイルが必要とするもの		What a Texinfo file must have.
1.9 Texinfoファイルの6つの部分		Usually, a Texinfo file has six parts.
1.10 Texinfoの短いサンプル		A short sample Texinfo file.
1.11 感謝と歴史		Contributors and genesis.

Texinfoモードの使用

Texinfoモードの概観		How Texinfo mode can help you.
2.1 通常の，GNU Emacsエディットコマンド		Texinfo mode adds to GNU Emacs' general purpose editing features.
2.2 良く使うコマンドの挿入		How to insert frequently used @-commands.
2.3 ファイルのセクションの構造を見る		How to show the structure of a file.
2.4 ノードとメニューの更新		How to update or create new nodes and menus.
2.5 Infoの書式化		How to format for Info.
2.6 書式化と印刷		How to format and print part or all of a file.
2.7 Texinfoモードの概要		Summary of all the Texinfo mode commands.

ノードとメニューの更新

更新コマンド		Five major updating commands.
2.4.1 必要条件の更新		How to structure a Texinfo file for using the updating command.
2.4.2 他の更新コマンド		How to indent descriptions, insert missing nodes lines, and update nodes in sequence.

Texinfoファイルの開始

ファイルの始めの4つの部分		Four parts begin a Texinfo file.
3.1 Texinfoファイルの始まりのサンプル		Here is a sample beginning for a Texinfo file.
3.2 Texinfoファイルのヘッダ		The very beginning of a Texinfo file.
3.3 Infoの著作権許可の概要		Summary and copying permissions for Info.
3.4 タイトルと著作権ページ		Creating the title and copyright pages.
3.5 `Top'ノードとマスターメニュー		Creating the `Top' node and master menu.
3.6 ソフトウェアコピーの許可		Ensure that you and others continue to have the right to use and share software.

Texinfoファイルのヘッダ

3.2.1 Texinfoファイルの最初の行		The first line of a Texinfo file.
3.2.2 ヘッダを始める		Formatting a region requires this.
3.2.3 @setfilename		Tell Info the name of the Info file.
3.2.4 @settitle		Create a title for the printed work.
3.2.5 @setchapternewpage		Start chapters on right-hand pages.
3.2.6 段落の字下げ		Specify paragraph indentation.
3.2.7 @exampleindent:環境に応じた字下げ		Specify environment indentation.
3.2.8 ヘッダの終り		Formatting a region requires this.

タイトルと著作権のページ

3.4.1 @titlepage		Create a title for the printed document.
3.4.2 @titlefont，@centerと，@sp		The @titlefont, @center, and @sp commands.
3.4.3 @title，@subtitleと，@author		The @title, @subtitle, and @author commands.
3.4.4 著作権ページと許可		How to write the copyright notice and include copying permissions.
3.4.5 見出しの生成		Turn on page headings after the title and copyright pages.
3.4.6 @headingsコマンド		An option for turning headings on and off and double or single sided printing.

`Top'ノードとマスターメニュー

3.5.1 `Top'ノードのタイトル		Sketch what the file is about.
3.5.2 マスターメニュー部		A master menu has three or more parts.

Texinfoファイルの終り

4.1 索引メニューと索引の印刷		How to print an index in hardcopy and generate index menus in Info.
4.2 目次の生成		How to create a table of contents.
4.3 ファイルの終りの@bye		How to mark the end of a file.

章の構造

5.1 セクションのツリー構造		A manual is like an upside down tree ...
5.2 構造化コマンドの型		How to divide a manual into parts.
5.3 @top		The @top command, part of the `Top' node.
5.4 @chapter
5.5 @unnumberedと@appendix
5.6 @majorheading，@chapheading
5.7 @section
5.8 @unnumberedsec，@appendixsec，@heading
5.9 @subsectionコマンド
5.10 @subsectionのようなコマンド
5.11 `subsub'コマンド		Commands for the lowest level sections.
5.12 @raisesectionsと@lowersections		How to change commands' hierarchical level.

ノード

6.1 2つのパス		Different commands to structure Info output and printed output.
6.2 ノードとメニューの図		A diagram, and sample nodes and menus.
6.3 @nodeコマンド		Creating nodes, in detail.
6.4 makeinfoでポインタの作成		Letting makeinfo determine node pointers.
6.5 @anchor: 相互参照のターゲット任意に定義する(Defining Arbitrary Cross-reference Targets)		Defining arbitrary cross-reference targets.

@nodeコマンド

6.3.1 ノードの選択とポインタ名		How to choose node and pointer names.
6.3.2 @node行の書き方		How to write an @node line.
6.3.3 @node行の助言		Keep names short.
6.3.4 @node行の必要事項		Keep names unique, without @-commands.
6.3.5 最初のノード		How to write a `Top' node.
6.3.6 @topセクションコマンド		How to use the @top command.
6.3.7 `Top'ノードのまとめ		Write a brief description for readers.

メニュー

短いノードが必要なメニュー		Put a menu in a short node.
7.1 メニューを書く		What is a menu?
7.2 メニューの部分		A menu entry has three parts.
7.3 バラバラでないメニュー項目		Two part menu entry.
7.4 メニューの例		Two and three part menu entries.
7.5 他のInfoファイルへの参照		How to refer to a different Info file.

相互参照

参照されるもの		What cross references are for.
8.1 異なる相互参照コマンド		A summary of the different commands.
8.2 相互参照の部分		A cross reference has several parts.
8.3 @xref		Begin a reference with `See' ...
8.4 `Top'ノードに名前を付ける		How to refer to the beginning of another file.
8.5 @ref		A reference for the last part of a sentence.
8.6 @pxref		How to write a parenthetical cross reference.
8.7 @inforef		How to refer to an Info-only file.
8.8 @uref{url[, text][, replacement]}		How to refer to a uniform resource locator.

@xref

参照のように見えるものと必要条件		What a reference looks like and requires.
8.3.1 1つの引数を用いた@xref		@xref with one argument.
8.3.2 2つの引数を用いた@xref		@xref with two arguments.
8.3.3 3つの引数を用いた@xref		@xref with three arguments.
8.3.4 4つと5つの引数を用いた@xref		@xref with four and five arguments.

単語と文節のマーキング

9.1 定義，コマンド等を示す		How to indicate definitions, files, etc.
9.2 テキストの強調(Emphasizing Text)		How to emphasize text.

定義，コマンド等の表示

便利な強調コマンド		Highlighting provides useful information.
9.1.1 @code{sample-code}		Indicating program code.
9.1.2 @kbd{keyboard-characters}		Showing keyboard input.
9.1.3 @key{key-name}		Specifying keys.
9.1.4 @samp{text}		Showing a literal sequence of characters.
9.1.5 @var{metasyntactic-variable}		Indicating metasyntactic variables.
9.1.6 @env{environment-variable}		Indicating environment variables.
9.1.7 @file{file-name}		Indicating file names.
9.1.8 @command{command-name}		Indicating command names.
9.1.9 @option{option-name}		Indicating option names.
9.1.10 @dfn{term}		Specifying definitions.
9.1.11 @cite{reference}		Referring to books not in the Info system.
9.1.12 @acronym{acronym}		Indicating acronyms.
9.1.13 @url{uniform-resource-locator}		Indicating a World Wide Web reference.
9.1.14 @email{email-address[, displayed-text]}		Indicating an electronic mail address.

テキストの強調

9.2.1 @emph{text}と@strong{text}		How to emphasize text in Texinfo.
9.2.2 @sc{text}: 小さい大文字フォント		How to use the small caps font.
9.2.3 Infoではなく印刷時のフォント		Various font commands for printed output.

引用と例

10.1 ブロックで囲むコマンド		Use different constructs for different purposes.
10.2 @quotation		How to write a quotation.
10.3 @example		How to write an example in a fixed-width font.
10.4 @noindent		How to prevent paragraph indentation.
10.5 @lisp		How to illustrate Lisp code.
10.6 @small...ブロックコマンド		Forms for @smallbook.
10.7 @displayと@smalldisplay		How to write an example in the current font.
10.8 @formatと@smallformat		How to write an example that does not narrow the margins.
10.9 @exdent: 行の字下げのアンドゥ		How to undo the indentation of a line.
10.10 @flushleftと@flushright		How to push text flushleft or flushright.
10.11 例の周りにCartouchを描く		How to draw cartouches around examples.

リストと表

リストの導入		Texinfo formats lists for you.
11.1 @itemize: 項目分けされたリストの作成		How to construct a simple list.
11.2 @enumerate: 数字や文字が付いたリストの作成		How to construct a numbered list.
11.3 2行の表の作成		How to construct a two-column table.
11.4 複数行の表		How to construct generalized tables.

2行の表の作成

@tableコマンドの使用		How to construct a two-column table.
11.3.1 @ftableと@vtable		Automatic indexing for two-column tables.
11.3.2 @itemx		How to put more entries in the first column.

複数行の作成

11.4.1 複数行の表の幅		Defining multitable column widths.
11.4.2 複数行の表の列		Defining multitable rows, with examples.

索引

12.1 索引項目の作成		Choose different words for index entries.
12.2 前もって定義されている索引		Use different indices for different kinds of entry.
12.3 索引の項目の定義		How to make an index entry.
12.4 索引の統合		How to combine indices.
12.5 新しい索引の定義		How to define your own indices.

索引の統合

12.4.1 @syncodeindex		How to merge two indices, using @code font for the merged-from index.
12.4.2 @synindex		How to merge two indices, using the default font of the merged-to index.

特別な挿入

13.1 @とカッコの挿入		How to insert braces, `@'.
13.2 空白の挿入		How to insert the right amount of space within a sentence.
13.3 アクセントの挿入		How to insert accents and special characters.
13.4 省略と黒点の挿入		How to insert dots and bullets.
13.5 TeXと著作権シンボルの挿入		How to insert the TeX logo and the copyright symbol.
13.6 @pounds{} (£): ポンド英貨		How to insert the pounds currency symbol.
13.7 @minus{} (-): 負記号の挿入		How to insert a minus sign.
13.8 @math: 数学表現の挿入		How to format a mathematical expression.
13.9 例のためのglyph		How to indicate results of evaluation, expansion of macros, errors, etc.
13.10 脚注		How to include footnotes.
13.11 画像の挿入		How to include graphics.

@とカッコの挿入

13.1.1 `@'を@@で挿入する		How to insert `@'.
13.1.2 `{'と`}'を@{と@}で挿入する		How to insert `{' and `}'.

スペースの挿入

13.2.1 文を終了しない		Sometimes a . doesn't end a sentence.
13.2.2 文を終える		Sometimes it does.
13.2.3 複数のスペース		Inserting multiple spaces.
13.2.4 @dmn{dimension}: 寸法単位の書式化		How to format a dimension.

省略，ドットと，黒点の挿入

13.4.1 @dots{} (...)と@enddots{} (....)		How to insert dots ...
13.4.2 @bullet{} (*)		How to insert a bullet.

TeXと著作権シンボルの挿入

13.5.1 @TeX{} (TeX)		How to insert the TeX logo.
13.5.2 @copyright{} ((C))		How to use @copyright{}.

例のためのglyph

glyphの概要
13.9.1 @result{} (=>): 評価結果を示す		How to show the result of expression.
13.9.2 @expansion{} (==>): 拡張を示す		How to indicate an expansion.
13.9.3 @print{} (-|): 印刷された出力を示す		How to indicate printed output.
13.9.4 @error{} (error-->): エラーメッセージを示す		How to indicate an error message.
13.9.5 @equiv{} (==): 等価を示す		How to indicate equivalence.
13.9.6 @point{} (-!-): バッファのポイントを示す		How to indicate the location of point.

glyphの概要

13.9.1 @result{} (=>): 評価結果を示す
13.9.2 @expansion{} (==>): 拡張を示す
13.9.3 @print{} (-|): 印刷された出力を示す
13.9.4 @error{} (error-->): エラーメッセージを示す
13.9.5 @equiv{} (==): 等価を示す
13.9.6 @point{} (-!-): バッファのポイントを示す

脚注

13.10.1 脚注コマンド		How to write a footnote in Texinfo.
13.10.2 脚注スタイル		Controlling how footnotes appear in Info.

改行改ページの作成と阻止

改行改ページコマンド		Cause and prevent splits.
14.1 @*: 改行の生成		How to force a single line to use two lines.
14.2 @-と@hyphenation: TeXのハイフネーションを助ける		How to tell TeX about hyphenation points.
14.3 @w{text}: 改行を妨げる		How to prevent unwanted line breaks.
14.4 @sp n: 空白行の挿入		How to insert blank lines.
14.5 @page: 新しいページの開始		How to force the start of a new page.
14.6 @group: 改ページを妨げる		How to prevent unwanted page breaks.
14.7 @need mils: 改ページを妨げる		Another way to prevent unwanted page breaks.

コマンドの定義

15.1 定義のテンプレート		How to structure a description using a definition command.
15.2 オプションと繰り返しの引数		How to handle optional and repeated arguments.
15.3 2つ以上の`最初の'行		How to group two or more `first' lines.
15.4 コマンドの定義		All the definition commands.
15.5 定義を書くための慣習		Conventions for writing definitions.
15.6 関数定義の見本

定義コマンド

15.4.1 関数と類似のエンティティ		Commands for functions and similar entities.
15.4.2 変数と類似のエンティティ		Commands for variables and similar entities.
15.4.3 型のある言語の関数		Commands for functions in typed languages.
15.4.4 型のある言語の変数		Commands for variables in typed languages.
15.4.5 オブジェクト指向プログラミング		Commands for object-oriented programming.
15.4.6 データの型		The definition command for data types.

表示されるテキストの条件

16.1 条件コマンド		Specifying text for HTML, Info, or TeX.
16.2 条件の否定コマンド		Specifying text for not HTML, Info, or TeX.
16.3 生の書式化コマンド		Using raw TeX or HTML commands.
16.4 @set，@clearと，@value		Designating which text to format (for all output formats); and how to set a flag to a string that you can insert.

@set，@clearと，@value

16.4.1 @ifsetと@ifclear		Format a region if a flag is set.
16.4.2 @setと@value		Expand a flag variable to a string.
16.4.3 @valueの例		An easy way to update edition information.

国際化

17.1 @documentlanguage cc:ドキュメントの言語をセットする		Declaring the current language.
17.2 @documentencoding enc:入力エンコードのセット		Declaring the input encoding.

新しいTexinfoコマンドの定義

18.1 マクロの定義		Defining and undefining new commands.
18.2 マクロの呼び出し		Using a macro, once you've defined it.
18.3 マクロの詳細		Beyond basic macro usage.
18.4 `@alias new=existing'		Command aliases.
18.5 `definfoenclose': 強調のカスタマイズ		Customized highlighting.

ハードコピーの書式化と印刷

19.1 TeXの使用		Use TeX to format for hardcopy.
19.2 texとtexindexでの書式化		How to format with explicit shell commands.
19.3 texi2dviでの書式化		A simpler way to format.
19.4 lpr -dを使用したシェル印刷		How to print.
19.5 Emacsシェルからの実行		How to format and print from an Emacs shell.
19.6 Texinfoモードでの書式化と印刷		How to format and print in Texinfo mode.
19.7 ローカル変数リストの使用		How to print using Emacs's compile command.
19.8 TeX書式化の要求の要約		TeX formatting requirements summary.
19.9 TeXに対する準備		What to do before you use TeX.
19.10 Overfull "hboxes"		What are and what to do with overfull hboxes.
19.11 小さな本の印刷		How to print small format books and manuals.
19.12 A4用紙の印刷		How to print on European A4 paper.
19.13 @pagesizes [width][, height]:カスタムページサイズ		How to print with customized page sizes.
19.14 断裁トンボと拡大		How to print marks to indicate the size of pages and how to print scaled up output.
19.15 PDF出力		Portable Document Format output.

Infoファイルの作成とインストール

20.1 Infoファイルの作成
20.2 Infoファイルのインストール

Infoファイルの作成

20.1.1 makeinfoの利点		makeinfo provides better error checking.
20.1.2 シェルからmakeinfoを実行する		How to run makeinfo from a shell.
20.1.3 makeinfoのオプション		Specify fill-column and other options.
20.1.4 ポインタの一貫性		How to check that pointers point somewhere.
20.1.5 Emacsでmakeinfoの実行		How to run makeinfo from Emacs.
20.1.6 texinfo-format...コマンド		Two Info formatting commands written in Emacs Lisp are an alternative to makeinfo.
20.1.7 書式化のバッチ処理		How to format for Info in Emacs Batch mode.
20.1.8 タグファイルとスプリットファイル		How tagged and split files help Info to run better.
20.1.9 HTMLの生成		Generating HTML output.

Infoファイルのインストール

20.2.1 ディレクトリファイル`dir'		The top level menu for all Info files.
20.2.2 新しいInfoファイルをリストアップする		Listing a new info file.
20.2.3 他のディレクトリのInfoファイル		How to specify Info files that are located in other directories.
20.2.4 Infoディレクトリファイルのインストール		How to specify what menu entry to add to the Info directory.
20.2.5 install-infoの呼び出し		install-info options.

許可の見本

D.1 許可の挿入		How to put permissions in your document.
D.2 `ifinfo'コピー許可		Sample `ifinfo' copying permissions.
D.3 タイトルページのコピー許可		Sample Titlepage copying permissions.

インクルードファイル

E.1 インクルードファイルの使用方法		How to use the @include command.
E.2 texinfo-multiple-files-update		How to create and update nodes and menus when using included files.
E.3 インクルードファイルの必要条件		What texinfo-multiple-files-update expects.
E.4 @includeを用いたファイルの見本		A sample outer file with included files within it; and a sample included file.
E.5 インクルードファイルの進化		How use of the @include command has changed over time.

ページ見出し

見出しの導入		Conventions for using page headings.
F.1 標準的な見出しの書式		Standard page heading formats.
F.2 見出しの形式の指定		How to specify the type of page heading.
F.3 独自の見出しの作成方法		How to create your own headings and footings.

書式化の失敗

makeinfoが見つけるエラー		makeinfo finds errors.
G.1 Infoの書式化でエラーを捕らえる		How to catch errors with Info formatting.
G.2 TeX書式化でエラーを捕らえる		How to catch errors with TeX formatting.
G.3 texinfo-show-structureの使用		How to use texinfo-show-structure.
G.4 occurの使用		How to list all lines containing a pattern.
G.5 悪いノード参照を見つける		How to find badly referenced nodes.

悪いノード参照を見つける

G.5.1 Info-validateの実行		How to run Info-validate.
G.5.2 分けられていないファイルの作成		How to create an unsplit file.
G.5.3 ファイルのタグ付け		How to tagify a file.
G.5.4 ファイルを手動で分ける		How to split a file manually.

ドキュメントはSexに似ていて，いいときはとってもいいし，ダメなときは何も しないのと一緒だね．---Dick Brandon