mirror of
https://github.com/python/cpython.git
synced 2025-09-26 18:29:57 +00:00
Added support for optional explanation parameter to the \versionadded
macro. Refactored do_cmd_versionadded() and do_cmd_versionchanged() to do most of the work in a helper function, with the do_cmd_*() wrappers just supplying a portion of the replacement text.
This commit is contained in:
parent
fdfb05bb0b
commit
c2b29d0fee
1 changed files with 15 additions and 14 deletions
|
@ -344,24 +344,25 @@ sub do_cmd_deprecated{
|
||||||
. $_);
|
. $_);
|
||||||
}
|
}
|
||||||
|
|
||||||
sub do_cmd_versionadded{
|
sub versionnote{
|
||||||
# one parameter: \versionadded{version}
|
# one or two parameters: \versionnote[explanation]{version}
|
||||||
local($_) = @_;
|
my $type = @_[0];
|
||||||
|
local $_ = @_[1];
|
||||||
|
my $explanation = next_optional_argument();
|
||||||
my $release = next_argument();
|
my $release = next_argument();
|
||||||
return ("\n<span class='versionnote'>New in version $release.</span>\n"
|
my $text = "$type in version $release.";
|
||||||
. $_);
|
if ($explanation) {
|
||||||
|
$text = "$type in version $release:\n$explanation.";
|
||||||
|
}
|
||||||
|
return "\n<span class='versionnote'>$text</span>\n" . $_;
|
||||||
|
}
|
||||||
|
|
||||||
|
sub do_cmd_versionadded{
|
||||||
|
return versionnote('New', @_);
|
||||||
}
|
}
|
||||||
|
|
||||||
sub do_cmd_versionchanged{
|
sub do_cmd_versionchanged{
|
||||||
# one parameter: \versionchanged{version}
|
return versionnote('Changed', @_);
|
||||||
local($_) = @_;
|
|
||||||
my $explanation = next_optional_argument();
|
|
||||||
my $release = next_argument();
|
|
||||||
my $text = "Changed in version $release.";
|
|
||||||
if ($explanation) {
|
|
||||||
$text = "Changed in version $release:\n$explanation.";
|
|
||||||
}
|
|
||||||
return "\n<span class='versionnote'>$text</span>\n" . $_;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
#
|
#
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue