# HG changeset patch
# User paulb
# Date 1111666991 0
# Node ID a85852d18d35b1779b38c986ef9ccff5a47beaa0
# Parent  784b9a6f36b81cbb90f2aab1c08ce7b1d3845327
[project @ 2005-03-24 12:23:08 by paulb]
Replaced the pydoc-based apidocs.py with the epydoc-based tools/apidocs.sh.

diff -r 784b9a6f36b8 -r a85852d18d35 apidocs.py
--- a/apidocs.py	Sat Feb 19 22:39:58 2005 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,159 +0,0 @@
-#!/usr/bin/env python
-
-"Make the API documentation."
-
-import pydoc
-import os, sys
-
-_apache = """
-"Placeholder for the real _apache module exported within the server itself."
-def log_error(s, x=None): pass
-def config_tree(): pass
-def server_root(): pass
-def mpm_query(i): pass
-def parse_qs(s, x): pass
-def parse_qsl(s, x): pass
-table = None
-SERVER_RETURN = None
-"""
-
-http = """
-"Placeholder for javax.servlet.http."
-class Cookie:
-    def __init__(self, *args):
-        pass
-"""
-
-internet = """
-"Placeholder for javax.mail.internet."
-class MimeMessage:
-    def __init__(self, *args):
-        pass
-"""
-
-mail = """
-"Placeholder for javax.mail."
-class Session:
-    pass
-"""
-
-util = """
-"Placeholder for java.util."
-class Properties:
-    pass
-"""
-
-net = """
-"Placeholder for java.net."
-class URLDecoder:
-    pass
-"""
-
-if __name__ == "__main__":
-
-    # The list of packages should coincide with that found in setup.py.
-
-    names = [
-        "WebStack", "WebStack.__init__",
-        "WebStack.BaseHTTPRequestHandler", "WebStack.CGI", "WebStack.Generic",
-        "WebStack.JavaServlet", "WebStack.ModPython", "WebStack.Twisted",
-        "WebStack.Webware", "WebStack.Zope",
-        "WebStack.Adapters", "WebStack.Adapters.__init__",
-        "WebStack.Adapters.BaseHTTPRequestHandler", "WebStack.Adapters.CGI",
-        "WebStack.Adapters.JavaServlet", "WebStack.Adapters.ModPython",
-        "WebStack.Adapters.Twisted", "WebStack.Adapters.Webware",
-        "WebStack.Adapters.Zope",
-        "WebStack.Helpers", "WebStack.Helpers.__init__",
-        "WebStack.Helpers.Auth", "WebStack.Helpers.Environment",
-        "WebStack.Helpers.Request", "WebStack.Helpers.Response",
-        "WebStack.Helpers.Session",
-        "WebStack.Resources", "WebStack.Resources.__init__",
-        "WebStack.Resources.Login", "WebStack.Resources.LoginRedirect"
-        ]
-
-    dirname = "apidocs"
-
-    # Set the PYTHONPATH to find the WebStack package and others.
-
-    sys.path.insert(0, os.getcwd())
-    sys.path.insert(1, os.path.join(os.path.abspath(".."), "Zope", "lib", "python"))
-    sys.path.insert(2, os.path.join(os.path.abspath(".."), "Webware"))
-
-    # Make the documentation directory if necessary.
-
-    if not os.path.exists(dirname):
-        print "Making", dirname
-        os.mkdir(dirname)
-
-    # Change into the directory - pydoc.writedoc depends on that.
-
-    os.chdir(dirname)
-
-    # Fake some modules.
-
-    f = open("_apache.py", "w")
-    f.write(_apache)
-    f.close()
-
-    os.mkdir("javax")
-    f = open(os.path.join("javax", "__init__.py"), "w")
-    f.close()
-
-    os.mkdir(os.path.join("javax", "servlet"))
-    f = open(os.path.join("javax", "servlet", "__init__.py"), "w")
-    f.close()
-    f = open(os.path.join("javax", "servlet", "http.py"), "w")
-    f.write(http)
-    f.close()
-
-    os.mkdir(os.path.join("javax", "mail"))
-    f = open(os.path.join("javax", "mail", "internet.py"), "w")
-    f.write(internet)
-    f.close()
-    f = open(os.path.join("javax", "mail", "__init__.py"), "w")
-    f.write(mail)
-    f.close()
-
-    os.mkdir("java")
-    f = open(os.path.join("java", "__init__.py"), "w")
-    f.close()
-    f = open(os.path.join("java", "util.py"), "w")
-    f.write(util)
-    f.close()
-    f = open(os.path.join("java", "net.py"), "w")
-    f.write(net)
-    f.close()
-
-    # Add the faked modules to the path.
-
-    sys.path.insert(0, os.getcwd())
-
-    for name in names:
-        pydoc.writedoc(name, forceload=1)
-
-    # Remove the faked modules.
-
-    os.remove("_apache.py")
-    os.remove("_apache.pyc")
-    os.remove(os.path.join("javax", "__init__.py"))
-    os.remove(os.path.join("javax", "__init__.pyc"))
-    os.remove(os.path.join("javax", "servlet", "__init__.py"))
-    os.remove(os.path.join("javax", "servlet", "__init__.pyc"))
-    os.remove(os.path.join("javax", "servlet", "http.py"))
-    os.remove(os.path.join("javax", "servlet", "http.pyc"))
-    os.remove(os.path.join("javax", "mail", "internet.py"))
-    os.remove(os.path.join("javax", "mail", "internet.pyc"))
-    os.remove(os.path.join("javax", "mail", "__init__.py"))
-    os.remove(os.path.join("javax", "mail", "__init__.pyc"))
-    os.remove(os.path.join("java", "__init__.py"))
-    os.remove(os.path.join("java", "__init__.pyc"))
-    os.remove(os.path.join("java", "util.py"))
-    os.remove(os.path.join("java", "util.pyc"))
-    os.remove(os.path.join("java", "net.py"))
-    os.remove(os.path.join("java", "net.pyc"))
-    os.rmdir(os.path.join("javax", "servlet"))
-    os.rmdir(os.path.join("javax", "mail"))
-    os.rmdir("javax")
-    os.rmdir("java")
-
-# vim: tabstop=4 expandtab shiftwidth=4
diff -r 784b9a6f36b8 -r a85852d18d35 tools/apidocs.sh
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tools/apidocs.sh	Thu Mar 24 12:23:11 2005 +0000
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+epydoc -o apidocs WebStack/Generic.py WebStack/Resources/*.py