adam olsen kjbnfagmailcom tue mar 4 2008 803 pm stephen j turnbull wrote adam olsen writes tue mar 4 2008 313 pm stephen j turnbull wrote would like see clear division language ie syntax builtin functionality maintained im sure like proposed title reason division would make unnecessarily hard find documentation true false none etc theyve become keywords pragmatic purposes prevent accidental modification think ideally syntax instead builtins python course practicality beats purity problem putting keywords builtin functionality section even boggle duplicate across two sections 1 duplicating anything provide links single location instead otherwise end two explanations thing different wording subtle differences missing details put separation syntax builtin functionality first started using documentation later came appreciate im relatively casual user python spare syntax section made much easier learn new syntax comprehensions generators suspect make lot easier learn differences python 2 python 3 want lose learned thirdparty docs even hard time finding list comprehensiongenerator expression docs apparently theyre expression section displays lists sets dictionaries neither anything list comprehension generator expression index term displays pretty obscure well something ive seen used besides list right documentation dont pretend speaking anyone else id surprised unique experiences shouldnt unique im afraid might another example use bnf although dominant field provides steep learning curve programmers im afraid turned rant seen experiences someone relies documentation great deal better way channel feedback documentation adam olsen aka rhamphoryncus _______________________________________________ pythondev mailing list zvlllneumpythonorg httpmailpythonorgmailmanlistinfopythondev unsubscribe httpmailpythonorgmailmanoptionspythondevpythondev40tangomucom tue 05 aug 2008 202740 0700 pythondev documentation reorganization