PyPy web pages
--------------

vision: The pypy web pages (especially documentation and news items) should be
easily deployable on client machine, like starting a script that prints
out a URL and ... there you are and can use it: when you modify/add a
documentation or news item with your favourite editor the web presenter
will automatically present it.  problem is the xpython dependability:
you have to install it (unless Armin can think of a way to do it without
modifying parser.c/ceval.c :-). Maybe some way of automatically
compiling xpython (without installing it anywhere on system paths) could
remedy this problem. 

Alternatively, the web system could present a wiki-way of modifying the
web page (especially for news and documentation items). Possibly 
we can use 'kupu' for this, a browser wysiwig editor. 

meanwhile the htdocs/index.cgi script is the main entrance point ...

File organization
-----------------

    pypy/src
        source codes for pypy 

    pypy/www
        htdocs  index.cgi  <- can be linked to from apache file hierarchy, 
                              as location independent as possible 
        pypywww/...           web views 
            __init__.py 
            #bin/httpserver.py server that can be started at client side
            bin/convrest.py   script to manually convert a single file or (Default) 
                              the whole hierarchy of documents into rest-html
                              possibly with WCDIR TARGETDIR arguments 
            more templates helper stuff for web site 
        std/                  [svn-external] a version of the standard library [external]
        xpy/                  [svn-external] xpython templating helper library 
        moincode/             code for the moinmoin wiki
        moininstance/         moinmoin instance data
        issues/               roundup issue tracker instance data