From: Fred Drake <fdrake@acm.org>
Date: Wed, 31 Mar 2004 08:08:34 +0000 (+0000)
Subject: add a heavy box around warning notices to make them really stand out in the
X-Git-Tag: v2.4a1~544
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=862b46bbc10a87eb2f4dc8bef80ab134d4d14a88;p=python

add a heavy box around warning notices to make them really stand out in the
PDF and PostScript versions of the docs (the CSS already does this for HTML)
---

diff --git a/Doc/texinputs/howto.cls b/Doc/texinputs/howto.cls
index 14e357ad30..936e1faf3a 100644
--- a/Doc/texinputs/howto.cls
+++ b/Doc/texinputs/howto.cls
@@ -7,6 +7,7 @@
              [1998/02/25 Document class (Python HOWTO)]
 
 \RequirePackage{pypaper}
+\RequirePackage{fancybox}
 
 % Change the options here to get a different set of basic options,  This
 % is where to add things like "a4paper" or "10pt".
diff --git a/Doc/texinputs/manual.cls b/Doc/texinputs/manual.cls
index 49693e6205..e28d87f850 100644
--- a/Doc/texinputs/manual.cls
+++ b/Doc/texinputs/manual.cls
@@ -7,6 +7,7 @@
              [1998/03/03 Document class (Python manual)]
 
 \RequirePackage{pypaper}
+\RequirePackage{fancybox}
 
 % Change the options here to get a different set of basic options, but only
 % if you have to.  Paper and font size should be adjusted in pypaper.sty.
diff --git a/Doc/texinputs/python.sty b/Doc/texinputs/python.sty
index 770499eaa1..5e1ea2bdc1 100644
--- a/Doc/texinputs/python.sty
+++ b/Doc/texinputs/python.sty
@@ -979,11 +979,39 @@
   \end{tabular}
 }
 
+\newlength{\py@noticelength}
+
+\newcommand{\py@heavybox}{
+  \setlength{\fboxrule}{2pt}
+  \setlength{\fboxsep}{7pt}
+  \setlength{\py@noticelength}{\linewidth}
+  \addtolength{\py@noticelength}{-2\fboxsep}
+  \addtolength{\py@noticelength}{-2\fboxrule}
+  \setlength{\shadowsize}{3pt}
+  \Sbox
+  \minipage{\py@noticelength}
+}
+\newcommand{\py@endheavybox}{
+  \endminipage
+  \endSbox
+  \fbox{\TheSbox}
+}
+
+% a 'note' is as plain as it gets:
 \newcommand{\py@noticelabel@note}{Note:}
+\newcommand{\py@noticestart@note}{}
+\newcommand{\py@noticeend@note}{}
+
+% a 'warning' gets more visible distinction:
 \newcommand{\py@noticelabel@warning}{Warning:}
+\newcommand{\py@noticestart@warning}{\py@heavybox}
+\newcommand{\py@noticeend@warning}{\py@endheavybox}
+
 \newenvironment{notice}[1][note]{
+  \def\py@noticetype{#1}
+  \csname py@noticestart@#1\endcsname
   \par\strong{\csname py@noticelabel@#1\endcsname}
-}{}
+}{\csname py@noticeend@\py@noticetype\endcsname}
 \newcommand{\note}[1]{\strong{\py@noticelabel@note} #1}
 \newcommand{\warning}[1]{\strong{\py@noticelabel@warning} #1}