mirror of
https://github.com/python/cpython.git
synced 2025-09-11 03:07:01 +00:00
2a691a8149
svn+ssh://pythondev@svn.python.org/python/trunk ........ r62021 | benjamin.peterson | 2008-03-28 18:11:01 -0500 (Fri, 28 Mar 2008) | 2 lines NIL => NULL ........ r62029 | amaury.forgeotdarc | 2008-03-28 20:42:31 -0500 (Fri, 28 Mar 2008) | 3 lines Correctly call the base class tearDown(); otherwise running test_logging twice produce the errors we see on all buildbots ........ r62035 | raymond.hettinger | 2008-03-29 05:42:07 -0500 (Sat, 29 Mar 2008) | 1 line Be explicit about what efficient means. ........ r62036 | georg.brandl | 2008-03-29 06:46:18 -0500 (Sat, 29 Mar 2008) | 2 lines Fix capitalization. ........ r62037 | amaury.forgeotdarc | 2008-03-29 07:42:54 -0500 (Sat, 29 Mar 2008) | 5 lines lib2to3 should install a logging handler only when run as a main program, not when used as a library. This may please the buildbots, which fail when test_lib2to3 is run before test_logging. ........ r62043 | benjamin.peterson | 2008-03-29 10:24:25 -0500 (Sat, 29 Mar 2008) | 3 lines #2503 make singletons compared with "is" not == or != Thanks to Wummel for the patch ........ r62044 | gerhard.haering | 2008-03-29 14:11:52 -0500 (Sat, 29 Mar 2008) | 2 lines Documented the lastrowid attribute. ........ r62052 | benjamin.peterson | 2008-03-30 14:35:10 -0500 (Sun, 30 Mar 2008) | 2 lines Updated README regarding doc formats ........ r62053 | georg.brandl | 2008-03-30 14:41:39 -0500 (Sun, 30 Mar 2008) | 2 lines The other download formats will be available for 2.6 too. ........ |
||
|---|---|---|
| .. | ||
| HelpIndexingTool | ||
| README | ||
| setup.py | ||
In this directory you can build the Python documentation in a form that is suitable for access with Apple Help Viewer. This will enable the "Python Documentation" menu entries in the MacPython IDE Help menu. Unfortunately the procedure to build the docs is not very streamlined. First, edit setup.py. At the top, edit MAJOR_VERSION and MINOR_VERSION, and check that DESTDIR makes sense. The documentation will be installed inside PythonIDE.app. In DocBuild.initialize_options, set self.download to True if you want to download the docs. Set it to False if you want to build the docs from the source tree, but this requires LaTex and lots of other stuff. Doable, but not easy. Second, if you want to download the docs you may need to do a couple more edits. The way the docs are packaged will often change between major releases. Fiddle DocBuild.downloadDocs to make it do the right thing (download the docs from python.org, unpack them, rename the directory to "build/html"). After these edits you should be ready to roll. "pythonw setup.py build" should download and unpack (or build) the docs. Next, it will do some magic to make the docs indexable. Finally, it will run the Apple Help Indexing Tool. (This last step is the reason you must use "pythonw" as opposed to "python"). Usually it will time out while waiting for AHIT to do its work. Wait until AHIT is done. Now you're ready to install with "python setup.py install". After this is done test your work. Fire up PythonIDE, and check that Help->Python Documentation brings up the documentation in the Help Viewer. Also open an IDE edit window, type something like "import sys", select "import", and use Help->Lookup in Python Documentation to check that the index has been generated correctly.