string exceptions are deprecated

[nnorwitz]

BPO	719367
Nosy	@freddrake

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2003-05-29.02:19:26.000>
created_at = <Date 2003-04-10.23:34:03.000>
labels = ['docs']
title = 'string exceptions are deprecated'
updated_at = <Date 2003-05-29.02:19:26.000>
user = 'https://bugs.python.org/nnorwitz'

bugs.python.org fields:

activity = <Date 2003-05-29.02:19:26.000>
actor = 'nnorwitz'
assignee = 'nnorwitz'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2003-04-10.23:34:03.000>
creator = 'nnorwitz'
dependencies = []
files = []
hgrepos = []
issue_num = 719367
keywords = []
message_count = 3.0
messages = ['15430', '15431', '15432']
nosy_count = 2.0
nosy_names = ['fdrake', 'nnorwitz']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue719367'
versions = ['Python 2.3']

[nnorwitz]

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.

[freddrake]

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}

[nnorwitz]

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