WARNING WARNING WARNING 

this is horribly outdated and needs to be transformed
(if not deleted). 


Project Repository Structure
--------------------------------

repository base url http://codespeak.net:8080/svn

each project follows the following convention
and is located below the repository base url

projectname /
    trunk/    # head development
    branch/   # branch development  (merge-support?)
    tag/      # tagged versions

Codespeak directory structure  (under codespeak/trunk)
------------------------------------------------------

conf.py      # configuration file for storage/resource locations
             # ports 

model/       # used by www/email/cmdline interface 
    project.py # access/modify info about a codespeak project 
    cvs.py     # access cvs info
    svn.py     # access/modify? subversion info
    
www/         # web page handling
    htdocs/  # raw static documents (e.g. images, css, ...)
    server.py# standalone-server for http(s) service  

email/       # email handling


admin/       # administrative tools for the codespeak machine
    thoth/   # config files for thoth.codespeak.net
             # for example
        etc/init.d/roundup-codespeak  # initscript for roundup-server

    tool/ 
        kickapache/
        pam_hook/ # module to trigger programs after password changes
        nosync/   # wrapper to prevent programs from performing (f)syncs 
        logrotate # a shell script (files are executable via the #-line)
        crontab/  # 
        csctl/    # ? control codespeak services ? 

Codespeak project configuration (unfinished)
------------------------------------------------------

for the codespeak (web) part there are (or will be) dependencies
on other projects. To capture a snapshot configuration of a couple
of projects there is 

    .../svn/codespeak/trunk/update


Codespeak url namespace concept
------------------------------------------------------

- we don't use subdomains. 

- special services are in the root namespace like so

    /issues/      # roundup serving trackers 
    /cvs/         # serving viewcv
    /svn/         # serving subversion
    /moin/        # moin-moin instances

    /mailman/     # serving lists 
    /pipermail/   # serving lists 

- each project is also in the root namespace and has the root services
  mapped into it

    /pypy/        # home page (linked in /www/codespeak.net/htdocs/pypy
        issues  # -> redirected internally to /issues/pypy/

    /rlcompleter2/
        issues  # -> redirected internally to /issues/pypy/
        mailman/rl-dev # -> redirected internally to /mailman/listinfo/rl-dev
    /pyrepl/
        issues  # -> redirected internally to /issues/pypy/
        mailman/pyrepl-dev # -> redirected internally to /mailman/listinfo/rl-dev