Missing docs for module knee

[davidabrahams]

BPO	515745
Nosy	@gvanrossum, @tim-one, @loewis, @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 = 'https://github.com/loewis'
closed_at = <Date 2002-04-08.05:26:40.000>
created_at = <Date 2002-02-11.05:38:28.000>
labels = []
title = 'Missing docs for module knee'
updated_at = <Date 2002-04-08.05:26:40.000>
user = 'https://bugs.python.org/davidabrahams'

bugs.python.org fields:

activity = <Date 2002-04-08.05:26:40.000>
actor = 'fdrake'
assignee = 'loewis'
closed = True
closed_date = None
closer = None
components = ['Demos and Tools']
creation = <Date 2002-02-11.05:38:28.000>
creator = 'david_abrahams'
dependencies = []
files = []
hgrepos = []
issue_num = 515745
keywords = []
message_count = 10.0
messages = ['9212', '9213', '9214', '9215', '9216', '9217', '9218', '9219', '9220', '9221']
nosy_count = 5.0
nosy_names = ['gvanrossum', 'tim.peters', 'loewis', 'fdrake', 'david_abrahams']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue515745'
versions = ['Python 2.3']

[davidabrahams]

3.21.1 in the lib manual sez: "A more complete example
that implements hierarchical module names and includes
a reload() function can be found in the standard
module knee (which is intended as an example only --
don't rely on any part of it being a standard
interface)."

...but knee is not in the module list, though it
appears to be in the distribution.

[freddrake]

Logged In: YES
user_id=3066

Like it says, the knee module is supposed to be an example
only. I don't think it should be included in the library at
all; it should be somewhere in Demo/.

I think Guido has resisted moving it before, but I don't
recall clearly. I'll assign this to Tim since Guido's not
available now.

[davidabrahams]

Logged In: YES
user_id=52572

If you move it, please change the docs so that it no longer
says it's a standard module.

[tim-one]

Logged In: YES
user_id=31435

Sorry, I can't channel Guido here -- AFAICT, this is the
first time I ever heard about knee! Reassigned to Guido.

[gvanrossum]

Logged In: YES
user_id=6380

knee.py itself is mostly intended as documentation -- it's
working code that demonstrates how the import process works!

It's fine if it gets moved to the Demo directory.

[loewis]

Logged In: YES
user_id=21627

knee.py is now moved to Demo/imputil.

[davidabrahams]

Logged In: YES
user_id=52572

Moving it without changing the docs isn't much good. Is
someone changing the docs?

[gvanrossum]

Logged In: YES
user_id=6380

What docs?

[davidabrahams]

Logged In: YES
user_id=52572

Please see my comment below from 2002-02-14 12:24

[freddrake]

Logged In: YES
user_id=3066

Description of knee's status has been changed as of
Doc/lib/libimp.tex revisions 1.28.4.1, 1.30.14.1, and 1.31.