Proposed new macros: see comments. These are not yet used.

These are intended to support semantic markup.  There are a number
	of places in the documentation where the exact meaning of an
	indentifier marked \code{} in the running text is ambiguous (could
	be a module or a class, a function or a method, etc.).  These are
	intended to clarify the intent of the identifier for processing
	applications and more intelligent style processing.
This commit is contained in:
Fred Drake 1998-01-20 05:07:19 +00:00
parent cb42f7c295
commit 311c19688d
1 changed files with 20 additions and 0 deletions

View File

@ -182,6 +182,7 @@
%% {\command}. This works better with the texinfo translation. %% {\command}. This works better with the texinfo translation.
\newcommand{\ABC}{{\sc abc}} \newcommand{\ABC}{{\sc abc}}
\newcommand{\UNIX}{{\sc Unix}} \newcommand{\UNIX}{{\sc Unix}}
\newcommand{\POSIX}{POSIX}
\newcommand{\ASCII}{{\sc ascii}} \newcommand{\ASCII}{{\sc ascii}}
\newcommand{\Cpp}{C\protect\raisebox{.18ex}{++}} \newcommand{\Cpp}{C\protect\raisebox{.18ex}{++}}
\newcommand{\C}{C} \newcommand{\C}{C}
@ -208,6 +209,25 @@
\newif\iftexi\texifalse \newif\iftexi\texifalse
\newif\iflatex\latextrue \newif\iflatex\latextrue
% Proposed new macros: These should be used for all references to identifiers
% which are used to refer to instances of specific language constructs. See
% the names for specific semantic assignments.
%
% For now, don't do anything really fancy with them, but note that \func and
% \method append trailing parentheses.
%
\let\module=\code
\let\kw=\code
\let\exc=\code
\let\class=\code
\newcommand{\func}[1]{\code{#1()}}
\newcommand{\method}[1]{\code{#1()}}
\newcommand{\manpage}[2]{{\emph{#1}(#2)}}
\let\email=\code
\let\url=\code
\newenvironment{tableii}[4]{\begin{center}\def\lineii##1##2{\csname#2\endcsname{##1}&##2\\}\begin{tabular}{#1}\hline#3&#4\\ \newenvironment{tableii}[4]{\begin{center}\def\lineii##1##2{\csname#2\endcsname{##1}&##2\\}\begin{tabular}{#1}\hline#3&#4\\
\hline}{\hline\end{tabular}\end{center}} \hline}{\hline\end{tabular}\end{center}}