New submission from anatoly techtonik <techto...@gmail.com>:

http://docs.python.org/library/cmd.html#

Documentation for cmd module is poor to explain the value of this module to 
users. Intro is too abstract - phrase "simple framework for writing 
line-oriented command interpreters" doesn't mean much. Perhaps word 
"interactive" is missing?

So, there is no part explaining the what cmd does exactly (intro fails) and no 
part explaining the main principle - How exactly does this framework allows to 
do this in a simple way? (I guess reference part under 'Cmd objects -> 
Cmd.cmdloop([intro]) -> p[4]` does that, but it is not the place you'd usually 
expect this info.

At the very least what could be done is a link to Doug's tutorial 
http://www.doughellmann.com/PyMOTW/cmd/

----------
assignee: docs@python
components: Documentation
messages: 152010
nosy: docs@python, techtonik
priority: normal
severity: normal
status: open
title: cmd: no user documentation

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue13875>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to