[Python-bugs-list] [ python-Bugs-719367 ] string exceptions are deprecated

[SourceForge.net]

Bugs item #719367, was opened at 2003-04-10 19:34
Message generated for change (Comment added) made by nnorwitz
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=719367&group_id=5470

Category: Documentation
Group: Python 2.3
>Status: Closed
>Resolution: Fixed
Priority: 5
Submitted By: Neal Norwitz (nnorwitz)
Assigned to: Neal Norwitz (nnorwitz)
Summary: string exceptions are deprecated

Initial Comment:
The deprecation (or at least pending deprecation) of
string exceptions should be mentioned in the doc. 
There is no mention in ref 4.2:  Doc/ref/ref4.tex.  I'm
not sure if the references to using strings should be
removed or left in with a note/warning that string
exceptions are deprecated and should be removed.  I'll
make the fix.  Just let me know how to proceed.

----------------------------------------------------------------------

>Comment By: Neal Norwitz (nnorwitz)
Date: 2003-05-28 22:19

Message:
Logged In: YES 
user_id=33168

Ok, I've removed all the references I found.  Hope it looks
good.

Checked in as:
 * api/exceptions.tex: 1.15
 * doc/doc.tex: 1.72
 * lib/libexcs.tex: 1.52
 * lib/libsys.tex: 1.64
 * ref/ref4.tex: 1.36
 * ref/ref6.tex: 1.65


----------------------------------------------------------------------

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2003-04-10 22:51

Message:
Logged In: YES 
user_id=3066

I'll suggest this approach:

Remove all mention of string exceptions from the main text, 
and then add a child subsection (or whatever) or a "notice"** 
that describes string exceptions and their deprecated status.

The C API reference already discusses the deprecation, but 
that could stand to be updated to mention the 
PendingDeprecationWarning.

When your changes are ready, commit them to CVS; it's 
easier for me to look at them once their in.  And I'm sure 
you'll do reasonable things.  ;-)

** "notice" is a LaTeX environment in the Python styles:

\begin{notice}
  text goes here
\end{notice}

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=719367&group_id=5470