diff --git a/Doc/perl/python.perl b/Doc/perl/python.perl
index 2b6fa189f2f..67bac7262fe 100644
--- a/Doc/perl/python.perl
+++ b/Doc/perl/python.perl
@@ -1081,12 +1081,16 @@ sub do_cmd_seemodule{
my $key = next_optional_argument();
my $module = next_argument();
my $text = next_argument();
+ my $period = '.';
$key = $module
unless $key;
- return '
"
+ if ($text =~ /\.$/) {
+ $period = '';
+ }
+ return ''
+ . "\n - Module "
+ . "$module:"
+ . "\n
- $text$period\n
"
. $_;
}
diff --git a/Doc/texinputs/python.sty b/Doc/texinputs/python.sty
index 30fef216ed4..c8d3691f746 100644
--- a/Doc/texinputs/python.sty
+++ b/Doc/texinputs/python.sty
@@ -821,28 +821,34 @@
% Cross-referencing (AMK, new impl. FLD)
% Sample usage:
% \begin{seealso}
-% \seemodule{rand}{Uniform random number generator}; % Module xref
-% \seetext{\emph{Encyclopedia Britannica}}. % Ref to a book
+% \seemodule{rand}{Uniform random number generator.}; % Module xref
+% \seetext{\emph{Encyclopedia Britannica}}. % Ref to a book
%
% % A funky case: module name contains '_'; have to supply an optional key
-% \seemodule[copyreg]{copy_reg}{pickle interface constructor registration}
-%
+% \seemodule[copyreg]{copy_reg}{Interface constructor registration for
+% \module{pickle}.}
% \end{seealso}
+%
+% Note that the last parameter for \seemodule and \seetext should be complete
+% sentences and be terminated with the proper punctuation.
\@ifundefined{pdfannotlink}{%
\newcommand{\py@seemodule}[3][\py@modulebadkey]{%
\par%
\ifx\py@modulebadkey#1\def\py@modulekey{#2}\else\def\py@modulekey{#1}\fi%
- \ref{module-\py@modulekey}:\quad %
- Module \module{#2}%
- \quad (#3)%
+ \begin{fulllineitems}
+ \item[Module \module{#2} (section \ref{module-\py@modulekey}):]
+ #3
+ \end{fulllineitems}
}
}{\newcommand{\py@seemodule}[3][\py@modulebadkey]{%
\par%
\ifx\py@modulebadkey#1\def\py@modulekey{#2}\else\def\py@modulekey{#1}\fi%
- \ref{module-\py@modulekey}:\quad %
- \py@linkToName{label-module-\py@modulekey}{ Module \module{#2} }
- \quad (#3)%
+ \begin{fulllineitems}
+ \item[\py@linkToName{label-module-\py@modulekey}{Module \module{#2}}
+ (section \ref{module-\py@modulekey}):]
+ #3
+ \end{fulllineitems}
}
}
\newenvironment{seealso}[0]{