steve holden gsdszholdenwebcom paul moore wrote 04032008 nick coghlan wrote need new appendix tutorial goes detail cpython interpreters command line options environment variables details executed python man page covers command line usage however separate documentation isnt bundled windows installers real pain least id suggest taking man page adding information executing zip files directories putting whole lot formal documentation big problem isnt really anywhere docs formally cpythonspecific preference would put language reference new chapter current chapters 1 2 called invoking python interpreter could also make manpage new document called invoking python bit small warrant ful document appendix tutorial ok guess personally never think looking tutorial ive using python long feel need tutorial although quality code probably says otherwise hesitate suggest change magnitude theres something recommend old ibm mainframe approach separating principles operation would reference manuals pythons case language library refs users guide contains practical stuff need actually make use product ive always found rather counterintuitive go library reference manual find information pythons builtin types example though whole point libraries arent built represent baggage carried necessary trips lets get started import statement spent time trying work might get rid embarrassing xxx cant bothered spell right mess come conclusion thorough review complete rewrite thing topic justice hope brett plans make start part rework import code youre reading brett id like help doesnt help motivation import mechanism change yet though happy regular easier understand next change believe 30 biggest improvement could make language newcomers would reorganize documentation things live places belong rather place landed got stuck time please note isnt rant sense believe perfectly comprehensible reasons docs got shape fear possibly blinded inappropriate nature closeness familiarity think major effort revise structure lesser degree content could pay back many times increased user friendliness georgs recent revision technology puts us better position prepare would still major project regards steve steve holden 1 571 484 6266 1 800 494 3119 holden web llc httpwwwholdenwebcom _______________________________________________ pythondev mailing list zvlllneumpythonorg httpmailpythonorgmailmanlistinfopythondev unsubscribe httpmailpythonorgmailmanoptionspythondevpythondev40tangomucom tue 05 aug 2008 213911 0500 pythondev documentation ability execute zipfiles directories