GNU Texinfo 4.3

@insertcopying

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

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ファイルの見本		Complete examples, including full texts.
D. インクルードファイル		How to incorporate other Texinfo files.
E. ページ見出し		How to write page headings and footings.
F. 書式化の失敗		How to find formatting mistakes.
G. 段落の補充		All about paragraph refilling.
H. @-コマンドの構文		A description of @-Command syntax.
I. TeXの入手方法		How to Obtain TeX.
J. このマニュアルのコピーに付いて		The GNU Free Documentation License.
コマンドと変数の索引		A menu containing commands and variables.
概念の索引		A menu covering many topics.

 -- 詳細なノードのリスト ---

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ファイルの六つの部品		Usually, a Texinfo file has six parts.
1.10 Texinfoの短いサンプル		A short sample Texinfo file.
1.11 歴史		Acknowledgements, contributors and genesis.

Texinfoモードを使用する

Texinfo Mode Overview		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ファイルを開始する

3.1 Texinfoファイルの始まりのサンプル		A sample beginning for a Texinfo file.
3.2 Texinfoファイルのヘッダ		The first lines.
3.3 ドキュメントの許可		Ensuring your manual is free.
3.4 タイトルと著作権ページ		Creating the title and copyright pages.
3.5 `Top'ノードとマスターメニュー		Creating the `Top' node and master menu.
3.6 大域的なドキュメントコマンド		Affecting formatting throughout.
3.7 ソフトウェアのコピーの許可		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 ヘッダの終り		Formatting a region requires this.

ドキュメントに対する許可

3.3.1 @copying:コピーの許可を宣言する		Declare the document's copying permissions.
3.3.2 @insertcopying:許可のテキストを含める		Where to insert the permissions.

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

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ノードの例
3.5.2 マスターメニューの部分

大域的なドキュメントコマンド

3.6.1 @documentdescription:概要のテキスト		Document summary for the HTML output.
3.6.2 @setchapternewpage:		Start chapters on right-hand pages.
3.6.3 段落の字下げ		Specify paragraph indentation.
3.6.4 @exampleindent:環境に応じた字下げ		Specify environment indentation.

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 二つのパス		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.

@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.

メニュー

Menus Need Short Nodes		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 References Are For		What cross references are for.
8.1 様々な相互参照コマンド		A summary of the different commands.
8.2 相互参照の部品		A cross reference has several parts.
8.3 `Top'ノードに名前を付ける		How to refer to the beginning of another file.
8.4 @ref		A reference for the last part of a sentence.
8.5 @pxref		How to write a parenthetical cross reference.
8.6 @inforef		How to refer to an Info-only file.
8.7 @uref{url[, text][, replacement]}		How to refer to a uniform resource locator.

@xref

参照のように見えるものと必要条件		What a reference looks like and requires.
8.2.1 一つの引数を用いた@xref		@xref with one argument.
8.2.2 二つの引数を用いた@xref		@xref with two arguments.
8.2.3 三つの引数を用いた		@xref with three arguments.
8.2.4 四つと五つの引数を用いた@xref		@xref with four and five arguments.

単語と文節に印を付ける

9.1 定義，コマンド等を示す		How to indicate definitions, files, etc.
9.2 テキストの強調		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}		A literal sequence of characters.
9.1.5 @verb{text}		A verbatim sequence of characters.
9.1.6 @var{metasyntactic-variable}		Indicating metasyntactic variables.
9.1.7 @env{environment-variable}		Indicating environment variables.
9.1.8 @file{file-name}		Indicating file names.
9.1.9 @command{command-name}		Indicating command names.
9.1.10 @option{option-name}		Indicating option names.
9.1.11 @dfn{term}		Specifying definitions.
9.1.12 @cite{reference}		Referring to books not in the Info system.
9.1.13 @acronym{acronym}		Indicating acronyms.
9.1.14 @url{uniform-resource-locator}		Indicating a World Wide Web reference.
9.1.15 @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 ブロックで囲むコマンド		Different constructs for different purposes.
10.2 @quotation		Writing a quotation.
10.3 @example: 例のテキスト		Writing an example in a fixed-width font.
10.4 @verbatim:リテラルテキスト		Writing a verbatim example.
10.5 @verbatiminclude file:ファイルをそのまま含める		Including a file verbatim.
10.6 @lisp:Lispの例の印付け		Illustrating Lisp code.
10.7 @small...ブロックコマンド		Forms for @smallbook.
10.8 @displayと@smalldisplay		Writing an example in the current font.
10.9 @formatと@smallformat		Writing an example without narrowed margins.
10.10 @exdent: 行の字下げの取り消し		Undo indentation on a line.
10.11 @flushleftと@flushright		Pushing text flush left or flush right.
10.12 @noindent: 字下げを行なわない		Preventing paragraph indentation.
10.13 @cartouche:例の周りに枠を描く		Drawing rounded rectangles around examples.

リストと表

Introducing Lists		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 二列の表の作成		How to construct a two-column table.
11.4 複数列の表		How to construct generalized tables.

二列の表の作成

@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

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

glyphの概要

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

脚注

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

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

14.1 改行，改ページコマンド		Summary of break-related commands.
14.2 @*: 改行の生成		Forcing line breaks.
14.3 @-と@hyphenation: TeXのハイフネーションを助ける		Helping TeX with hyphenation points.
14.4 @w{text}: 改行を妨げる		Preventing unwanted line breaks in text.
14.5 @tie{}: 改行されないスペースを挿入する		Inserting an unbreakable but varying space.
14.6 @sp n: 空白行の挿入		Inserting blank lines.
14.7 @page: 新しいページの開始		Forcing the start of a new page.
14.8 @group: 改ページを妨げる		Preventing unwanted page breaks.
14.9 @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 二つ以上の`最初の'行		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 @setと@value		Expand a flag variable to a string.
16.4.2 @ifsetと@ifclear		Format a region if a flag is set.
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 A4 or A5 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.

Texinfoファイルの見本

C.1 短い例
C.2 GNUの見本のテキスト
C.3 文字通りそのままのコピーライセンス
C.4 全く寛大なコピーライセンス

インクルードファイル

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

ページ見出し

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

書式化の失敗

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

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

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

このマニュアルのコピーについて

J.1 GNU Free Documentation License

License for copying this manual.

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