[Epydoc-commits] SF.net SVN: epydoc: [1226] trunk/epydoc/Makefile
Brought to you by:
edloper
Menu
▾
▴
[Epydoc-commits] SF.net SVN: epydoc: [1226] trunk/epydoc/Makefile
|
From: <ed...@us...> - 2006-04-12 19:53:47
|
Revision: 1226 Author: edloper Date: 2006-04-12 12:53:44 -0700 (Wed, 12 Apr 2006) ViewCVS: http://svn.sourceforge.net/epydoc/?rev=1226&view=rev Log Message: ----------- - enable pdf api generation - added code to use profiling info (but currently not used -- it crashes with python 2.4 for some reason) - replaced man-to-html generating code - add all builtin modules to stdlib-html Modified Paths: -------------- trunk/epydoc/Makefile Modified: trunk/epydoc/Makefile =================================================================== --- trunk/epydoc/Makefile 2006-04-12 19:51:25 UTC (rev 1225) +++ trunk/epydoc/Makefile 2006-04-12 19:53:44 UTC (rev 1226) @@ -102,8 +102,7 @@ cp -r $(DOCS) $(WEBDIR) cp -r $(HTML_API) $(WEBDIR)/api cp -r $(HTML_EXAMPLES) $(WEBDIR)/examples - @echo "Skipping pdf generation (not implemented yet)" -# cp $(LATEX_API)/api.pdf $(WEBDIR)/epydoc.pdf + cp $(LATEX_API)/api.pdf $(WEBDIR)/epydoc.pdf touch .webpage.up2date # Use plaintext docformat by default. But this is overridden by the @@ -111,18 +110,17 @@ # xml.dom.minidom and a few Docutils modules get plaintext # docstrings). api-html: .api-html.up2date -.api-html.up2date: $(PY_SRCFILES) +.api-html.up2date: $(PY_SRCFILES) #profile.out rm -rf $(HTML_API) mkdir -p $(HTML_API) $(EPYDOC) -o $(HTML_API) --name epydoc --css white \ - --url http://epydoc.sourceforge.net \ + --url http://epydoc.sourceforge.net --pstat profile.out \ --inheritance=listed --navlink "epydoc $(VERSION)"\ - --docformat plaintext -v --graph classtree $(PY_SRC) + --docformat plaintext -v --graph all $(PY_SRC) touch .api-html.up2date api-pdf: .api-pdf.up2date .api-pdf.up2date: $(PY_SRCFILES) - @echo "Skipping pdf generation (not implemented yet)" rm -rf $(LATEX_API) mkdir -p $(LATEX_API) $(EPYDOC) --pdf -o $(LATEX_API) --docformat plaintext \ @@ -135,33 +133,36 @@ mkdir -p $(HTML_EXAMPLES) $(EPYDOC) -o $(HTML_EXAMPLES) --name epydoc \ --url http://epydoc.sourceforge.net \ - --css blue --top example --docformat=plaintext \ + --css white --top epytext_example --docformat=plaintext \ --navlink 'epydoc examples' doc/epytext_example.py sre $(EPYDOC) -o $(HTML_EXAMPLES)/grouped \ --inheritance=grouped \ --name epydoc --url http://epydoc.sourceforge.net \ - --css blue --debug \ + --css white --debug \ --navlink 'epydoc examples' doc/inh_example.py $(EPYDOC) -o $(HTML_EXAMPLES)/listed \ --inheritance=listed \ --name epydoc --url http://epydoc.sourceforge.net \ - --css blue --debug \ + --css white --debug \ --navlink 'epydoc examples' doc/inh_example.py $(EPYDOC) -o $(HTML_EXAMPLES)/included \ --inheritance=included \ --name epydoc --url http://epydoc.sourceforge.net \ - --css blue --debug \ + --css white --debug \ --navlink 'epydoc examples' doc/inh_example.py touch .examples.up2date # Generate the HTML version of the man page. Note: The # post-processing clean-up that I do is probably *not* very portable. doc/epydoc-man.html: man/epydoc.1 - wget http://localhost/cgi-bin/man2html?epydoc -O - \ - 2>/dev/null \ - | sed 's/<\/HEAD><BODY>/<link rel="stylesheet" href="epydoc.css" type="text\/css"\/><\/HEAD><BODY>/'\ + man2html man/epydoc.1 \ + | sed 's/<\/HEAD>/<link rel="stylesheet" href="epydoc.css" type="text\/css"\/><\/HEAD>/' \ + | sed 's/<H1>EPYDOC<\/H1>/<H1>epydoc (1)<\/H1>/' \ + | sed 's/<BODY>/<BODY><DIV CLASS="BODY">/'\ + | sed 's/Content-type:.*//' \ + | sed '/Section: User Commands/,/<HR>/{s/.*//;}'\ + | sed 's/<\/BODY>/<\/DIV><\/BODY>/'\ | sed '/<DD>/{s/<DD>//; :loop; n; b loop;}'\ - | sed '/<H1>/,/<HR>/{s/.*//;}'\ | sed 's/\(<A NAME=".*">\) <\/A>/\1/'\ | sed 's/<\/H2>/<\/H2><\/A>/'\ | sed 's/"\/cgi-bin\/man2html?epydocgui+1"/"epydocgui-man.html"/'\ @@ -169,16 +170,28 @@ > doc/epydoc-man.html doc/epydocgui-man.html: man/epydocgui.1 - wget http://localhost/cgi-bin/man2html?epydocgui -O - \ - 2>/dev/null \ - | sed 's/<\/HEAD><BODY>/<link rel="stylesheet" href="epydoc.css" type="text\/css"\/><\/HEAD><BODY>/'\ - | sed '/<H1>/,/<HR>/{s/.*//;}'\ + man2html man/epydocgui.1 \ + | sed 's/<\/HEAD>/<link rel="stylesheet" href="epydoc.css" type="text\/css"\/><\/HEAD>/' \ + | sed 's/<H1>EPYDOCGUI<\/H1>/<H1>epydocgui (1)<\/H1>/'\ + | sed 's/<BODY>/<BODY><DIV CLASS="BODY">/'\ + | sed 's/Content-type:.*//' \ + | sed '/Section: User Commands/,/<HR>/{s/.*//;}'\ + | sed 's/<\/BODY>/<\/DIV><\/BODY>/'\ + | sed '/<DD>/{s/<DD>//; :loop; n; b loop;}'\ | sed 's/\(<A NAME=".*">\) <\/A>/\1/'\ | sed 's/<\/H2>/<\/H2><\/A>/'\ - | sed 's/"\/cgi-bin\/man2html?epydoc+1"/"epydoc-man.html"/'\ + | sed 's/"\/cgi-bin\/man2html?epydocgui+1"/"epydocgui-man.html"/'\ | sed 's/<A HREF="\/cgi-bin\/man2html">man2html<\/A>/man2html/'\ > doc/epydocgui-man.html +# [XX] A bug in the profiler for py 2.4 prevents this from working!! +profile.out: $(PY_SRCFILES) + $(EPYDOC) -o profile.tmp --name epydoc --css white \ + --url http://epydoc.sourceforge.net --profile-epydoc \ + --inheritance=listed --navlink "epydoc $(VERSION)"\ + --docformat plaintext -v --graph all $(PY_SRC) + rm -rf profile.tmp + ##////////////////////////////////////////////////////////////////////// ## Standard Library docs ##////////////////////////////////////////////////////////////////////// @@ -190,15 +203,18 @@ |grep -v "/$(PYTHON)/lib-old/" \ |grep -v "/$(PYTHON)/site-packages/" \ |grep -v "/$(PYTHON)/__phello__\.foo\.py" ) +PY_PRINT_BUILTINS = "import sys; print ' '.join(sys.builtin_module_names)" +SLBUILTINS = $(shell $(PYTHON) -c $(PY_PRINT_BUILTINS)) + export TZ='XXX00XXX;000/00,000/00' # So tzparse won't die. stdlib-html: .stdlib-html.up2date .stdlib-html.up2date: $(PY_SRCFILES) rm -rf $(HTML_STDLIB) mkdir -p $(HTML_STDLIB) @echo "Building stdlib html docs..." - @$(EPYDOC) -o $(HTML_STDLIB) --css white \ - --name $(SLNAME) --url $(SLURL) --debug \ - --show-imports __builtin__ $(SLFILES) + @$(EPYDOC) -o $(HTML_STDLIB) --css white --name $(SLNAME) \ + --url $(SLURL) --debug --graph classtree \ + --show-imports $(SLBUILTINS) $(SLFILES) touch .stdlib-html.up2date # (this will typically cause latex to run out of resources) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
