sandbox/infrastructure/README.txt

   1 ==========================
   2  Docutils_ Infrastructure
   3 ==========================
   4
   5 :Author: Lea Wiemann
   6 :Contact: grubert@users.sourceforge.net
   7 :Revision: $Revision$
   8 :Date: $Date$
   9 :Copyright: This document has been placed in the public domain.
  10
  11
  12 The `infrastructure <.>`_ sandbox directory stores any scripts that
  13 are needed for the development of the Docutils project.
  14
  15 TODOs:
  16
  17 * subversion is now on sourceforge
  18   - change release and update
  19
  20 * sourceforge does not have cron, but berlios installation
  21   did not work since long time.
  22
  23 * clean up.
  24
  25 Overview:
  26
  27 Everything below this needs rework.
  28
  29 :`<docutils-update.local>`_: The script to update the `web site`_
  30     from a developer machine. *The* current way to go.
  31
  32 :`<release.sh>`_: The script to make releases_ of Docutils.
  33
  34 :`<uploaddocutils.sh>`_: Upload files to http://docutils.sf.net/tmp/
  35     using ``scp``, inserting the current date in the file name.
  36
  37 :`<update-htmlfiles>`_: Used to initialise a docutils-update upload directory.
  38     Generating html-files from txt-files first time.
  39
  40 :`<htmlfiles.lst>`_: The list of files for ``update-htmlfiles``.
  41
  42 and are these used by anyone.
  43
  44 :`<dbackport.sh>`_: Back-port changes from the trunk to the
  45     maintenance branch.
  46
  47 :`<fsfsbackup.sh>`_: Backup (mirror) an FSFS Subversion repository via
  48     SSH.  Used to backup the `Docutils Subversion repository`_.
  49
  50 .. _Docutils: http://docutils.sourceforge.net/
  51 .. _Docutils check-in mailing list:
  52    http://docutils.sf.net/docs/user/mailing-lists.html#docutils-checkins
  53 .. _web site: http://docutils.sourceforge.net/docs/dev/website.html
  54 .. _Docutils Subversion repository:
  55    http://docutils.sourceforge.net/docs/dev/repository.html
  56 .. _releases: http://docutils.sourceforge.net/docs/dev/release.html