Texinfo からの借用

[201] DanC が明言しているように最初に追加された語句化内容要素群は基本的に Texinfo からの借用です (>>161)。

[232] GNU Texinfo は GNUプロジェクトのドキュメントシステムです。 GNU Emacs など GNU 製品のドキュメントで使われています。 テキスト系の専用のマーク付け言語で記述しますが、 TeX のマクロとして実装されていることから Texinfo の名があり、印刷物形態のマニュアルを生成することもできますし、 専用プログラム等で画面表示することもできます。

[233] 書籍版は TeX の提供する高品質な組版機能に預かることができる一連なりの静的な頁媒体であるのに対して、 画面表示は章節ごとに区切られ前後・上層・下層に移動できる閲覧ソフトウェア内で、 当時の貧弱な (しかもプラットフォームごとに違いの大きい) 基礎的な文字表示機能だけの文章が上下スクロールしつつ表示されるという構造であります。 この2系統の性質が大きく異なる媒体で同一の文書ファイルを利用するため、 Texinfo は文字の書体や大きさを直接記述するよりは、 章節の構造や語句の性格を記述する言語として発達しました。

[234] この Texinfo の装置非依存の記述的マーク付け的性質こそ、 様々な異なるプラットフォームで利用され特定の書体や文字サイズへの対応を強制し得ない HTML の開発者達が求めていたものでした。しかもマニュアル等の技術文書の表現は初期の HTML の主要な応用分野であり、そのものまさに GNU Texinfo から HTML への変換ソフトウェアも開発されていましたから、 技術文書の記述に実績のある GNU Texinfo の語彙は HTML にとって魅力的なものだったのです。

[202] DanC が参照した Texinfo のドキュメントからの引用がありますが >>158、 改めて当時のドキュメントを確認してみます。 DanC が参照したものがどのように入手したどのドキュメントだったのかまでは不明ですが、 当時の GNU Texinfo のドキュメントは GNU Emacs に同梱されて配布されていて、現在も近い時期のものが残っています。

• [203] emacs-history/ftp.gnu.org/old-gnu/emacs/emacs-18.59.tar.gz at sources · larsbrinkhoff/emacs-history · GitHub, 2024-09-30T13:44:44.000Z https://github.com/larsbrinkhoff/emacs-history/blob/sources/ftp.gnu.org/old-gnu/emacs/emacs-18.59.tar.gz

[204] >>203 のファイルの中身のファイルの日付は、 ChangeLog が1992-10-31となっています。他はそれより古いファイルです。

[205] man/texinfo.texi という日付が1990-09-26のファイルがあります。 Texinfo 1.1 と題されており、

This file documents Texinfo, a documentation system that uses a single
source file to produce both on-line help and a printed manual.  

This is edition 1.1 of the Texinfo documentation, and is for the Texinfo
that is distributed as part of Version 18 of GNU Emacs.

Copyright (C) 1988 Free Software Foundation, Inc.

@center The GNU Documentation Format
@sp 2
@center by Richard M. Stallman and Robert J. Chassell
@sp 2
@center Edition 1.1
@sp 2
@center May 1988

と冒頭にあります。

[206] その内容を見ると、 DanC の引用とよく似た箇所があります。 引用した部分以外にも多くの説明があります。分量が多いですが、 重要なので引いておきます。

[207] いわゆる論理要素に相当するもの:

@section Specifying Definitions, Files, Commands etc.
@cindex Highlighting
@cindex Specifying commands, files and the like
@cindex Definitions, specifying them within text
@cindex Commands, specifying them within text
@cindex Files, specifying them within text

Texinfo has a variety of commands for specifying just what kind of object a
piece of text refers to.  Metasyntactic variables, for example, are marked
by one @@-command and code by another.  Texinfo uses this information to
determine how to highlight the text.  Since the pieces of text are labelled
by commands that tell what kind of object they are, it is easy to change
the way Texinfo formats and typesets such text.  For example, code is
usually illustrated in a typewriter font, but it would be easy to change
the way Texinfo highlights code to use another font.  This change would not
effect how metasyntatic variables are highlighted.  If straight typesetting
commands were used in the body of the file, you would have to check every
single occurrence to make sure that you were changing code and not
something else that should not be changed.

In addition, the commands can be used to generate useful information from
the file, such as lists of functions or file names.  It is possible, for
example, to write code in Emacs Lisp (or a keyboard macro) to insert an
index entry after every paragraph that contains the text labelled by a
specified command.  You could do this to construct an index of functions if
you had not already made the entries.

The commands serve a variety of purposes:

@table @code
@item @@code
Indicates text that is a literal example of a piece of a program.@refill

@item @@samp
Indicates text that is a literal example of a sequence of characters.@refill

@item @@file
Indicates the name of a file.@refill

@item @@kbd
Indicates the names of keys on the keyboard or characters you type.@refill

@item @@key
Used for the conventional name for a key on a keyboard.@refill

@item @@ctrl
Indicates an ASCII control character.

@item @@var
Indicates a metasyntactic variable.

@item @@dfn
Indicates the introductory or defining use of a term.

@item @@cite
Indicates the name of a book.
@end table



@menu
* Code::	A literal example of a piece of a program.
* Samp::	A literal example of a sequence of characters.
* File::	The name of a file.
* Kbd::		The names of keys or else characters you type.
* Key::		The conventional name for a key on a keyboard.
* Ctrl::	Indicates the ASCII control character.
* Var::		A variable.
* Dfn::		The introductory or defining use of a term.
* Cite::	The name of a book.
@end menu

@node     Code, Samp, , Specifying
@comment  node-name,  next,  previous,  up
@subsection @@code
@findex code

@code{@@code} is used to indicate text that is a piece of a program which
consists of entire syntactic tokens.  The text follows, enclosed in braces.

For example, @code{@@code} is used for an expression in a program, the name
of a variable or function used in a program, or a keyword.  @code{@@code}
is not used for a piece of a token, such as when speaking about the
characters used in a token; for example, when you are explaining what
letters or printable symbols can be used in the names of functions.  It is
also not used for input to programs unless the input is written in a
language that is like a programming language.  For example, it is not used
for the single character commands of GNU Emacs although it is used for the
names of Emacs Lisp functions that the keyboard commands invoke.

You should also @code{@@code} for command names in command languages that
resemble programming languages, such as Texinfo or the shell.  Note,
however, that @code{@@code} is not used for options such as @samp{-c} when
such options stand alone.  There is some argument as to whether an entire
shell command incorporating an option should be written using @code{@@code}
or @code{@@samp}.@refill

It is an error to alter the case of a word inside an @code{@@code}
command.  This is a particularly insidious error if the language being
documented is case sensitive.  If the command is @code{printf}, then
@code{Printf} is a misspelling.  If you do not like having such a command
with lower case at the beginning of a sentence, you may wish to rearrange
the sentence.

In the printed manual, @code{@@code} puts the argument in bold face.
In the Info file, it uses `@dots{}' quotation.  For example:

@example
To compare two files, showing text inserted or removed, use @@code@{diff@}.
@end example

@noindent
produces

@quotation
To compare two files, showing text inserted or removed, use @code{diff}.
@end quotation

@iftex
In the Info file, it looks like this:

@example
@dots{}, use `diff'
@end example
@end iftex

@node     Samp, File, Code, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@samp
@findex samp

@code{@@samp} is used to indicate text that is a literal example of a
sequence of characters in a file, string, pattern, etc.  The text follows,
enclosed in braces.  The argument appears within `@dots{}' quotation in
both the Info file and the printed manual; in addition, it is printed in a
fixed-width font.

@example
To match @@samp@{foo@} at the end of the line, use the regexp @@samp@{foo$@}.
@end example

@noindent
produces

@quotation
To match @samp{foo} at the end of the line, use the regexp @samp{foo$}.
@end quotation

Any time you are referring to single characters, you should use @code{@@samp}
unless @code{@@kbd} is more appropriate.  Basically, @code{@@samp} is a
catchall for whatever is not covered by @code{@@code}, @code{@@file},
@code{@@kbd}.

Punctuation marks that are part of the English text that surrounds the
strings you are specifying are @emph{never} included within the braces.  In
the following sentence, for example, the commas and period are outside of
the braces:

@example
A symbol name ends in @@samp@{a@}, @@samp@{b@}, or @@samp@{c@}.
@end example

@node     File, Kbd, Samp, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@file
@findex file

@code{@@file} is used to indicate text that is the name of a file or
directory.  Currently, it is equivalent to @code{@@samp} in its effects on
the output.  For example,@refill

@example
The @@file@{.el@} files are in 
the @@file@{/gnu/emacs/lisp@} directory.
@end example

@noindent
produces

@quotation
The @file{.el} files are in 
the @file{/gnu/emacs/lisp} directory.
@end quotation

@node     Kbd, Key, File, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@kbd
@findex kbd

@code{@@kbd} is used much like @code{@@code}.  The difference is that
@code{@@kbd} is for names of keys on the keyboard, or of characters you can
type.  For example, to refer to the command @kbd{M-a}, you would use

@example
@@kbd@{M-a@}
@end example

@noindent
and to refer to @kbd{M-x shell}, you would use

@example
@@kbd@{M-x shell@}
@end example

The @code{@@kbd} command has the same effect as @code{@@code} in Info,
but may produce a different font in a printed manual.@refill

You can embed another @@-command inside the braces of a @code{@@kbd}
command.  This is the way to describe a command that would be described
more verbosely as ``press an @samp{r} and then press the @key{RET} key'':

@example
@@kbd@{r @@key@{RET@}@}  
@end example

@noindent
This produces: @kbd{r @key{RET}}

You also use the @code{@@kbd} command if you are spelling out the letters
you type; for example:

@example
To give the @@code@{logout@} command, 
type the characters @@kbd@{l o g o u t @@key@{RET@}@}.
@end example

@noindent
This produces

@quotation
To give the @code{logout} command, 
type the characters @kbd{l o g o u t @key{RET}}.
@end quotation

@node     Key, Ctrl, Kbd, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@key
@findex key

@code{@@key} is used for the conventional name for a key on a keyboard, as
in

@example
@@key@{RET@}
@end example

Often, @code{@@key} is used within the argument of a @code{@@kbd}
command, whenever the sequence of characters to be typed includes one or
more keys that are described by name.@refill

For example, to produce @kbd{C-x @key{ESC}} you would use 

@example
@@kbd@{C-x @@key@{ESC@}@}
@end example


The recommended names to use for keys are in upper case and are

@table @t
@item SPC
Space.
@item RET
Return.
@item LFD
Linefeed.
@item TAB
Tab.
@item BS
Backspace.
@item ESC
Escape.
@item DEL
Delete.
@item SFT
Shift.
@item CTL
Control.
@item META
Meta.
@end table

There are subtleties to handling words like `meta' or `ctrl' which are
names of shift keys.  When mentioning a character in which the shift key is
used, such as @kbd{Meta-a}, use the @code{@@kbd} command alone without the
@code{@@key} command, but when you are referring to shift key in isolation,
use the @code{@@key} command.  For example, you would use
@samp{@@kbd@{Meta-a@}} to produce @kbd{Meta-a} and @samp{@@key@{META@}} to
produce @key{META}.

@node     Ctrl, Var, Key, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@ctrl
@findex ctrl

@code{@@ctrl} is used to describe an ASCII control character.  The pattern
of usage is @code{@@ctrl@{@var{ch}@}}, where @var{ch} is an ASCII character
whose control-equivalent is wanted.  Thus, you put in an @samp{f} when
you want to indicate a @samp{control-f}

Thus, to specify @samp{control-f}, you would enter

@example
@@ctrl@{f@}
@end example

@noindent
which produces

@quotation
@ctrl{f}
@end quotation

In the Info file, this generates the specified control character, output
literally into the file.  This is done so a user can copy the specified
control character (along with whatever else he or she wants) into another
Emacs buffer and use it.  Since the `control-h',`control-i', and
`control-j' characters are formatting characters, they should not be
indicated this way.@refill

In a printed manual, this generates text to describe or identify that
control character: an uparrow followed by the character @var{ch}.

@node     Var, Dfn, Ctrl, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@var
@findex var

@code{@@var} is used to indicate metasyntactic variables.  A metasyntactic
variable is something that stands for another piece of text.  You would use
a metasyntactic variable in the documentation of a function to describe the
arguments that are passed to that function.

@code{@@var} is not used for names of particular variables in programming
languages.  For example, the Texinfo variable @code{texinfo-tex-command} is
not a metasyntactic variable.

Its effect in the Info file is to upcase the argument; in the printed
manual, to italicize it.  Example:

@example
To delete file @@var@{filename@}, type @@code@{rm @@var@{filename@}@}.
@end example

@noindent
produces

@quotation
To delete file @var{filename}, type @code{rm @var{filename}}.
@end quotation

In some documentation styles, metasyntactic variables are shown with angle
brackets, for example: 

@example
@dots{}, type rm <filename>
@end example

@node     Dfn, Cite, Var, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@dfn
@findex dfn

@code{@@dfn} is used to identify the introductory or defining use of a
technical term.  The command should be used only in a passage whose purpose
is to introduce a term which will be used again or which the reader ought
to know.  Mere passing mention of a term for the first time doesn't deserve
@code{@@dfn}.  It generates italics in the printed manual, and double
quotation marks in the Info file.  Example:

@example
Getting rid of a file is called @@dfn@{deleting@} it.
@end example

@noindent
produces

@quotation
Getting rid of a file is called @dfn{deleting} it.
@end quotation

@node     Cite, , Dfn, Specifying
@comment  node-name,  next,  previous,  up
@subsection @@cite
@findex cite

@code{@@cite} is used for the name of a book.  It produces italics
in the printed manual, and quotation marks in the Info file.

[208] 強調と物理要素に相当するもの:

@node     Emphasis, , Dots Bullets Tex, Marking Text
@comment  node-name,  next,  previous,  up
@section Emphasizing Text
@cindex  Emphasizing text

Usually, Texinfo changes the font automatically to mark words in the text
according to what category the words belong to.  The @code{@@code} command,
for example, does this.  Most often, this is the best way to mark specified
words.  However, sometimes you will want to emphasize text directly.
Texinfo has two ways to do this: commands that tell Texinfo to emphasize
the text but leave the method to the program, and commands that specify the
font to use.  The first method is generally the best and it makes it
possible to change the style of a document without have to re-edit it line
by line.

@menu
* Emph and Strong::	Emphasizing text.
* Fonts::		Selecting italic, bold or typewriter fonts.
@end menu

@node     Emph and Strong, Fonts, , Emphasis
@comment  node-name,  next,  previous,  up
@subsection @@emph and @@strong
@findex emph
@findex strong

@code{@@emph} and @code{@@strong} are two forms of emphasis.  @code{@@strong}
is stronger.

In printed output, @code{@@emph} produces @emph{italics} and @code{@@strong}
produces @strong{bold}.

In the Info file, both of these commands put asterisks around the
argument.

@node     Fonts, , Emph and Strong, Emphasis
@comment  node-name,  next,  previous,  up
@subsection @@i,  @@b and @@t
@findex i (italic font)
@findex b (bold font)
@findex t (typewriter font)

These three commands specify font changes in the printed manual and have no
effect in the Info file.  @code{@@i} requests @i{italic} font (in some
versions of @TeX{}, a slanted font is used), @code{@@b} requests @b{bold}
face, and @code{@@t} requests the @t{fixed-width} font used by
@code{@@kbd}.  All three commands apply to an argument that follows,
surrounded by braces.@refill

If possible, you should avoid using these three commands.  If you find a
need to use one, it probably indicates a lack in the Texinfo language.

[237] GNU Texinfo はこの時点で既に何年にもわたって多くのソフトウェアドキュメントの記述、 そしてソフトウェアに付属させての配布や印刷物としての出版の実績を積み重ねていて、 そのために必要な語彙がある程度整備されており、 しかもそれぞれの用法について詳しく説明されています。

[209] この詳細な説明が全文 HTML の要素一覧にも引かれていれば、 その後の展開もまた違ったものになっていたでしょうね。

[240] GNU Texinfo のマニュアルの記述を要約すると:

• [241] Texinfo には文章text片pieceがどのような種類のものkind of objectを指すかを指定する命令がいろいろある
  • [242] 文章をどのように highlight するかの決定にこれを使う
    • [243] 符号は他のフォントにするがメタ構文変数はそのまま、のようなことが容易にできる
  • [244] 文書ファイルから有用な情報を生成するためにもこれを使える
    • [245] 関数やファイル名の一覧など
  • [324] 通常は分類categoryを示すこの方法が最善
• [325] 時々、文章を直接強調emphasizeしたいこともあるので、2つの方法がある
  • [326] 強調することを知らせ、方法はプログラムに任せる命令
    • [328] 通常はこちらが良い
      • [329] いちいち再編集せずに文書の様式styleを変更できる
  • [327] 利用するフォントを指定する命令
    • [352] これらの命令は避けるべき
    • [353] これらが必要になるとしたら、 Texinfo 言語の不足を表しているのかもしれない
• [246] @code
  • [247] 概要: 文章がプログラム片pieceのそのままのliteral例であると示す
  • [266] 構文的字句全体であるようなプログラムの一片a pieceたるような文章 (プログラミング言語に似た命令言語、例えば Texinfo やシェルの命令名を含む。) を示す
    • [267] 適当な例: プログラム中の式、 あるいはプログラム中の変数や関数の名前、あるいはキーワード
    • [268] 不適当な例: 字句の一片a piece、 あるいはプログラムへの入力 (入力がプログラム言語的な言語で書かれている場合を除く。)
      • [269] 不適当な具体例: 字句中で使われる文字について話すとき、 例えば関数名で使える文字letterや印字可能記号printable symbolの説明
      • [270] 不適当な具体例: GNU Emacs の1文字命令
        • [271] 適当な具体例: その鍵盤命令で呼び出される Emacs Lisp 関数の名前
      • [272] 不適当な具体例: -c のような命令のオプションが単独で出現するとき
        • [273] オプションを含むシェル命令全体については、 @code がよいか @samp がよいか議論がある
  • [274] 大文字と小文字を置き換えるのは適切ではない
    • [275] 文頭を小文字にしたくないときは文を書き換えるのがいい
  • [276] 表示: 印刷されたマニュアルでは太字bold face
  • [277] 表示: Info ファイルでは `...' で引用
• [248] @samp
  • [249] 概要: 文章が文字の列sequenceのそのままのliteral例であると示す
  • [278] ファイル、文字列、パターン等における文字の列のそのままの例である文章を示す
    • [282] 基本的に @samp は @code, @file, @kbd でカバーされないすべてに使える
    • [281] 1字のとき、 @kbd がより適切な場合を除き、 @samp を使うのがいい
  • [283] 英文の一部として文字列を囲む句読点類 (@samp の直後に来る , や . など) は @samp 内に書かない
  • [279] 表示: Info ファイルでは `...' で引用、固定長フォント
  • [280] 表示: Info ファイルでは `...' で引用
• [250] @file
  • [251] 概要: ファイルの名前を示す
  • [284] ファイルやディレクトリーの名前である文章を示す
  • [285] 表示: @samp と同じ
• [252] @kbd
  • [253] 概要: 打鍵した鍵盤上の鍵や文字の名前群を示す
  • [286] @kbd は @code と同じ用に使うが、 鍵盤上の鍵の名前や、打鍵できる文字の名前に使う
  • [287] 具体例: @kbd{M-a}
  • [288] 具体例: @kbd{M-x shell}
  • [291] 他の命令を含められる
    • [292] 具体例: @kbd{r @key{RET}}
    • [293] 具体例: @kbd{l o g o u t @key{RET}}
  • [289] 表示: 印刷されたマニュアルでは太字bold face, 違うフォントのことも
  • [290] 表示: Info ファイルでは `...' で引用
• [254] @key
  • [255] 概要: 鍵盤上の鍵の通称conventional nameに使う
  • [294] 鍵盤上の鍵の通称に使う
    • [295] 具体例: @key{RET}
    • [296] 具体例: @kbd{C-x @key{RET}}
  • [297] 推奨recommended名: SPC (間隔), RET (復帰return), LFD (行送り), TAB (タブ), BS (後退), ESC (逃避), DEL (削除), SFT (シフト), CTL (制御), META (メタ)
  • [298] シフトキー名は単独のとき @key を使い、 組み合わせのとき @kbd だけで使う
    • [299] 具体例: @kbd{Meta-a}
      • [300] ctrl でも同様
    • [301] 具体例: @key{META}
• [256] @ctrl
  • [257] 概要: ASCII制御文字を示す
  • [302] ASCII制御文字を説明するため使う
    • [303] 対応するASCII文字で指定する
    • [304] 具体例: @ctrl{f} : control-f を表す
    • [307] 表示: 印刷されたマニュアルでは ^ + 指定されたASCII文字
    • [305] 表示: Info ファイルでは説明された制御文字
      • [308] なので読者がコピペできる
      • [306] control-h, control-i, control-j は書式付け文字なのでこの方法で示すべきではない
• [258] @var
  • [259] 概要: メタ構文変数を示す
  • [265] 概要: 変数
  • [309] メタ構文変数を示す。メタ構文変数というのは他の文章片を表すようなもの。
    • [310] 適当な具体例: 関数の説明で関数にわたす引数を表すためメタ構文変数を使う
    • [311] 不適当な例: プログラミング言語の特定の変数の名前
      • [312] 不適当な具体例: Texinfo の変数 @code{texinfo-tex-command} のように @var は不適当で @code を使うのが適当
  • [314] 表示: 印刷されたマニュアルでは italic 化
  • [313] 表示: Info ファイルでは大文字化
  • [315] 表示: 文書化スタイルによってはメタ構文変数は <..> で括って表示
• [260] @dfn
  • [262] 概要: 用語termの初回introductoryや定義としてのdefiningの利用を示す
  • [316] 技術用語technical termの初回や定義としての利用を識別する
  • [317] 再度使われる用語や読者が知っておくべき用語を導入するような場面でのみ使うべき
    • [318] 単に用語が初めて登場したというだけで使うものではない
  • [319] 表示: 印刷されたマニュアルでは italic 化
  • [320] 表示: Info ファイルでは二重引用符で括って表示
• [263] @cite
  • [264] 概要: 本の名前を示す
  • [321] 本の名前に使う
  • [322] 表示: 印刷されたマニュアルでは italic 化
  • [323] 表示: Info ファイルでは引用符で括って表示
• [330] @emph
  • [332] 強調emphasis
  • [335] 表示: 印刷されたマニュアルでは italic
  • [337] 表示: Info ファイルでは前後に *
• [331] @strong
  • [333] 強調emphasis
  • [334] @emph より強いstronger
  • [336] 表示: 印刷されたマニュアルでは太字bold
  • [338] 表示: Info ファイルでは前後に *
• [339] @i
  • [342] 概要: italic フォント
  • [345] 表示: 印刷されたマニュアルでは italic
    • [351] TeX の版によっては slant 化フォント
  • [346] 表示: Info ファイルでは変化なし
• [340] @b
  • [343] 概要: 太字boldフォント
  • [347] 表示: 印刷されたマニュアルでは太字bold face
  • [348] 表示: Info ファイルでは変化なし
• [341] @t
  • [344] 概要: タイプライターフォント
  • [349] 表示: 印刷されたマニュアルでは固定長フォント
  • [350] 表示: Info ファイルでは変化なし

[354] この語彙と説明の全体を眺めた感想:

• [355] ソフトウェアマニュアルの頻出の表現を、執筆者に過度な負担を求めない程度に、 しかし当時の表示環境を勘案しつつも美しく印刷できるように、 うまい塩梅の粒度だと思いました。
  • [373] 例えばもっと細かく、 関数名、 引数名、 プログラム中の変数名、 環境変数名、 といくらでも際限なく語彙を増やしていくことは可能で、 その方が関数一覧が生成できたりと便利なことはあるのですが、 便利さと引き換えにマニュアル執筆の負担も増していきます。
  • [377] 実のところ Texinfo のこれより新しい版には @command, @option, @env が追加されています。
• [356] @code と @samp は明らかに対照的、相補的に定められています。 誤解を恐れず一言でまとめてしまうなら、 プログラミング言語的なものの字句(群)としてそのまま意味を成すものが @code、 それ以外のすべてが @samp となります。
  • [357] この対応関係が HTML に伝わらなかったのは大きな不幸でした。
  • [358] @samp は名前と意味が合っていない気がします。 (でももっと適当な名は思いつかないですね。) 作られた頃はもっと違った整理だったのかもしれません。 これも不幸でした。
  • [361] @code と @samp は表示の違いもありますが、 索引的な処理で意味を持つのが @code、持たないのが @samp という整理もできそうです。
    • [367] 索引を自動生成したときに出てきて嬉しいか、嬉しくないか、というのはきっといい判断基準のはず。
• [359] @kbd はただ単に打鍵されるべき鍵・文字列を示すというよりは、 打鍵列を表す表記構文という1つのプログラミング言語的なもの用に特化した @code というべきかもしれません。
  • [360] ソフトウェアマニュアルならではの専用語彙といえます。
• [362] @ctrl は SGML 的には文字参照で表すのが正統的な方法で、 HTML が採らなかったのは自然な流れといえますが、 ソフトウェアマニュアルとしてこの機能が必要だった (特にこの時代には。) のは頷けます。
• [363] @file はソフトウェアマニュアルとして必要なことは確かですが、 なるほど HTML に持ち込むには具体的すぎると感じるのもわかります。
  • [364] ただ @code とはちょっと違っているので、「その他全部」の @samp にするしかなくなります。
    • [365] 設定ファイルの名前やアプリケーションのディレクトリー名など、 @file は二次利用が難しい「その他全部」枠よりは @code 枠に近い使われ方が多そうです。 (「索引」基準なら @code に入れたいですね。)
    • [366] でも @code には収容できないとなると、 ファイル名の他に URL や ISBN のようなものも含めた「識別子」 カテゴリーを新設するという手もあったかもしれませんね。 もう少し広げて正規表現や XPath のようなものも含んだ「式言語」 枠もありかもしれません。
• [368] @emph, @strong が推奨されない直接的な記述に分類されています。 これはちょっと意外ですね。
  • [369] HTML では論理スタイルと物理スタイルに2分して、 code 等と em, strong を論理スタイル側に、 b 等を物理スタイル側に分類し、 やがて物理スタイルは好ましくないという意識が生まれていくわけですが、 em, strong は好ましい論理スタイル側に属していました。
  • [370] ただし Texinfo でも @emph, @strong は次善で、 最終手段の @b, @i, @t とは区分けされています。
• [371] @emph より @strong が強いという関係が明記されています。
• [374] 下線を使う命令がなければ、表示にも使われていないことに気が付きます。
  • [375] ここに示していない Texinfo の命令で下線を使うものはありますが (見出しなど)、 次の行に =, - などを使って表現するとされています。 つまるところ、この時代には下線を表示するのが難しかった (少なくても可搬ではなかった) ので有効な表現方法と考えられなかったということなのでしょう。
  • [376] 太字や italic / slant も Info ファイルの画面表示には使っていないくらいなので、 下線が画面表示できないとしても印刷用だけは下線、 という命令は用意できたはずですが、それすらもないのは、 敢えて使うような表現方法とみなされていなかったのでしょうか。

LaTeX からの借用

[181] em と tt は、その要素名を LaTeX から借用したと考えられます (>>148 >>179)。

• [183] CTAN: /tex-archive/obsolete/macros/latex209/distribs, 2024-09-30T12:43:22.000Z https://ctan.org/tex-archive/obsolete/macros/latex209/distribs
  • [184] 2024-09-30T12:43:35.200Z https://mirrors.ctan.org/obsolete/macros/latex209/distribs/latex209.tar.gz

[185] >>184 に 1997-01-22 01:001997-01-22T01:00 付の latex209.tar.gz があります。 中身のファイルの日付は1992-03-19, 1992-03-20, 1992-04-01のいずれかの正時に揃っています。 どうにも不自然ですが、1997-01-22に過去のファイルを集めて作成したtar玉なのでしょう。

[186] DanC が参照したものが何だったのか、 LaTeX という以外に情報がありませんが、 この tar玉の中身とそう遠くはないものだろうと期待されます。

[187] general/latex.tex という1992-04-01のファイル LATEX VERSION 2.09 <25 March 1992> には、

%     ****************************************
%     *           COMMAND LIST               *
%     ****************************************

%  IN DOCUMENT :
%    FONT SELECTION:
%         SIZE: \normalsize \small \footnotesize \scriptsize \tiny
%               \large \Large \LARGE \huge \Huge
%         STYLE: \bf \it \rm \sl \ss \tt \mit[math mode only]

とあります。

[188] general/sfonts.tex という1992-03-19のファイル File SFONTS - Version of 25 November 1991 には、

% protected font names
\def\rm{\protect\prm}
\def\it{\protect\pit}
\def\bf{\protect\pbf}
\def\tt{\protect\ptt}
\def\sl{\@subfam\sl\it}
\def\sf{\@subfam\sf\rm}
\def\sc{\protect\psc}
 
\def\em{\protect\pem{}}
\def\pem{\relax\ifdim \fontdimen\@ne\font >\z@ \rm \else \it \fi}

とあります。

[189] general/lfonts.tex という1992-03-19のファイル File LFONTS - Version of 25 November 1991 には、

% \em is defined to be \it inside an unslanted style and \rm inside a
% slanted style.  An \em command in a section title will produce a \pem
% command in the table of contents.
%

\def\em{\protect\pem{}}
\def\pem{\relax\ifdim \fontdimen\@ne\font >\z@ \rm \else \it \fi}

% protected font names
\def\rm{\protect\prm}
\def\it{\protect\pit}
\def\bf{\protect\pbf}
\def\sl{\protect\psl}
\def\sf{\protect\psf}
\def\sc{\protect\psc}
\def\tt{\protect\ptt}

とあります。

[190] general/local.tex という1992-03-19のファイル local.tex -- released 26 February 1992 には、

Table~\ref{tab:fonts}
tells, for every type size, to which class of fonts each type style
belongs.  For example, in 14pt type, \verb|\bf| uses a preloaded
font and the other five type-style commands use load-on-demand fonts.
Roman (\verb|\rm|) and math italic (\verb|\mit|) fonts are all
preloaded; the \hbox{\verb|\em|} declaration uses either italic
(\verb|\it|) or roman.

とあってフォントとサイズの表があります。

[191] 以上、 DanC の引用 (>>138) と若干違うのが気になりますが、 \tt を含む7種類のフォントスタイルがあり、 \em が \it または \rm のどちらかとして実装されていることがわかります。

[192] local.tex には \tt や \em が大量に使われているので、 いくつか用法を見ておきましょう。

[193] \em で書名を強調

computers at SRC. It is not about \LaTeX\ itself, which is described by
the manual---{\em \LaTeX: A Document Preparation System}, published by
Addison-Wesley, available at fine book stores everywhere.

[194] \em で入力する文字列を強調、 \tt でファイル名

(You must type the space followed by the period at the end.  This
and all other Ultrix commands are ended by typing {\em return}.)
A copy of the file \mbox{\tt sample.tex} is now in your current
directory; you can edit it just like any other file.  If you destroy or

[195] \em で文書名を強調

You must use a text editor to prepare an input file for \LaTeX. The
document {\em Welcome to SRC\/} describes the text editors available
at SRC.  The easiest way to start learning about \LaTeX\ is by 

[196] \em で打鍵列を強調

because it is printing a seemingly unending string of uninformative
error messages, type {\em Control-C\/} (press $C$ while holding down
the key labeled {\em CTRL\/}).  This will make \LaTeX\ stop as if it

[197] \em で文中の語を強調、 \tt で LaTeX の機能名

Except for these differences, a \SLiTeX\ input file prepared for the
ordinary {\tt slides} style {\em should\/} work with the {\tt
ps-slides} style.  There are probably some \SLiTeX\ commands that will

[198] \em で可変部分を強調、 \tt で実行するコマンド

\begin{quote} \tt
     aptex -Pcolor {\em file-name}.dvi
\end{quote}

[199] 他にも用例が多数あります。 \tt はおおむね現在の HTML の code の役割で使われています。 \em はいろいろな意味で強調、 周りとの区別を表すために使われていて、現在の HTML でいえば em, strong, var, kbd など幅広く応用されています。

[200] これを現在視点から見ると code があるのに tt は要らなそうにも感じますが、 当時の code の意味と比べると、 \tt がないと困りそうです。 @file が省かれて \tt が採用された理由もこの辺りにあるのかもしれません。

[235] これらに出現するものを DanC の言及と比較すると、

と実にバラバラで、 DanC が参照したのはここで引いたどれでもなかったのかもしれませんが、 それにしても >>134 と >>148 で違うのは一体どういう理由によるものなのでしょう。

[236] >>134 と >>148 の違いは誤記、誤写、もしかすると手書きを経由している可能性すらあるのではとも思わせられますね。

初期要素のその後

[470] Texinfo の詳しい説明が引き継がれず HTML では短い簡潔な説明になりましたが、 それでは使い方がわからないということで、後続の仕様で少しずつ言い方が改められています。 しかしそれでも不明瞭な部分が多く、著者は解釈に悩まされ、色々な使い方をしてきました。

[471] HTML5 はその反省から、あるものは利用の実態に合わせて、 あるものは新たに利用目的を再設定することにより、 詳細な要素の意味の説明を0から決め直しました。

[445] Texinfo は必ずしも違った表示にしていませんでしたが、 HTML 2.0 は地の文と違った表示にすることを求めています:

User agents must render highlighted phrases distinctly from plain

text. Additionally, <EM> content must be rendered as distinct from

<STRONG> content, and <B> content must rendered as distinct from <I>

content.

[446] HTML 2.0 も指定されたままの表示を必須とまではしていません。例えば italic を表示できない環境で i を italic 表示せよと無理強いはしていません。 しかし地の文や b と違う表示は求めています。