Bugs item #469773, was opened at 2001-10-10 02:28 Message generated for change (Comment added) made by akuchling You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=469773&group_id=5470
Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: Documentation Group: Feature Request Status: Open Resolution: None Priority: 5 Private: No Submitted By: Anthony Baxter (anthonybaxter) Assigned to: Fred L. Drake, Jr. (fdrake) >Summary: Write 'Using Python on Platform X' documents Initial Comment: Some stuff that's in the man page (e.g. the syntax for the -W switch) doesn't appear to be in the HTML documentation. If it is there, it's _very_ well hidden away. ---------------------------------------------------------------------- >Comment By: A.M. Kuchling (akuchling) Date: 2006-12-21 09:50 Message: Logged In: YES user_id=11375 Originator: NO Changing summary to be more accurate. ---------------------------------------------------------------------- Comment By: Anthony Baxter (anthonybaxter) Date: 2004-11-11 02:27 Message: Logged In: YES user_id=29957 What about instead a new "Using Python" document. There's a bunch of overlap between the platforms. We can then also have separate chapters for Mac, Win, Unix. I think trying to produce platform specific docs is going to be a headache in the long run. ---------------------------------------------------------------------- Comment By: Fred L. Drake, Jr. (fdrake) Date: 2004-11-11 01:33 Message: Logged In: YES user_id=3066 I'll note that the "Macintosh Library Modules" document deals with this sort of issue for the Mac (though it may be out of date for Mac OS X; not sure). The first chapter is an introduction to using Python on the Mac, and the remaining chapters provide module reference documentation. What's needed is something like the first chapter of that for Unix and Windows. I'm not sure where it should go, though; I don't want that material in the main library reference. This almost makes me want three platform-specific documents, one for Windows, one for Unix, and the existing Mac OS document, each containing the relevant "Using Python on ..." chapter, followed by chapters containing platform-specific modules. Modules that apply to two or more of the platforms would continue to be documented in the main library reference. The distutils modules are already documented in the distutils documentation as well. This should be fine since the "global" module index is the normal general entry point anyway. ---------------------------------------------------------------------- Comment By: Anthony Baxter (anthonybaxter) Date: 2001-10-25 02:17 Message: Logged In: YES user_id=29957 See, that's the problem :) It's not clear where this might go - it's almost a "Using Python" section, which, as far as I can see, doesn't really exist. This might also include stuff about the Windows GUI and other interfaces for using python. If a shorter-term "just get the -W stuff in" approach is wanted, then extended the lib/module-warnings might be the approach... but it really does seem like it needs to be somewhere central. ---------------------------------------------------------------------- Comment By: Fred L. Drake, Jr. (fdrake) Date: 2001-10-24 22:12 Message: Logged In: YES user_id=3066 I agree. Where would you suggest the information be added? ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=469773&group_id=5470 _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
