Define a new environment, classdesc*, which can be used to document a

class without providing any information about the constructor.  This
should be used for classes which only exist to act as containers rather
than as factories for instances.
This commit is contained in:
Fred Drake 2001-05-11 01:00:30 +00:00
parent 986badae1e
commit 06a01e84b9
2 changed files with 23 additions and 0 deletions

View File

@ -906,6 +906,17 @@ sub do_env_classdesc{
return handle_classlike_descriptor(@_[0], "class"); return handle_classlike_descriptor(@_[0], "class");
} }
sub do_env_classdescstar{
local($_) = @_;
$THIS_CLASS = next_argument();
$idx = make_str_index_entry(
"<tt class='class'>$THIS_CLASS</tt> (class in $THIS_MODULE)" );
$idx =~ s/ \(.*\)//;
return ("<dl><dt><b>class $idx</b>\n<dd>"
. $_
. '</dl>');
}
sub do_env_excclassdesc{ sub do_env_excclassdesc{
return handle_classlike_descriptor(@_[0], "exception"); return handle_classlike_descriptor(@_[0], "exception");
} }

View File

@ -623,6 +623,15 @@
\index{#1@{\py@idxcode{#1}} (class in \py@thismodule)}] \index{#1@{\py@idxcode{#1}} (class in \py@thismodule)}]
}{\end{fulllineitems}} }{\end{fulllineitems}}
% \begin{classdesc*}{name}
\newenvironment{classdesc*}[1]{
% Using \renewcommand doesn't work for this, for unknown reasons:
\global\def\py@thisclass{#1}
\begin{fulllineitems}
\item[\strong{class }\code{\bfcode{#1}}%
\index{#1@{\py@idxcode{#1}} (class in \py@thismodule)}]
}{\end{fulllineitems}}
% \begin{excclassdesc}{name}{constructor args} % \begin{excclassdesc}{name}{constructor args}
% but indexes as an exception % but indexes as an exception
\newenvironment{excclassdesc}[2]{ \newenvironment{excclassdesc}[2]{
@ -633,6 +642,9 @@
\index{#1@{\py@idxcode{#1}} (exception in \py@thismodule)}] \index{#1@{\py@idxcode{#1}} (exception in \py@thismodule)}]
}{\end{fulllineitems}} }{\end{fulllineitems}}
% There is no corresponding {excclassdesc*} environment. To describe
% a class exception without parameters, use the {excdesc} environment.
\let\py@classbadkey=\@undefined \let\py@classbadkey=\@undefined