sandbox/infrastructure/README.txt

   1 ==========================
   2  Docutils_ Infrastructure
   3 ==========================
   4
   5 :Author: Lea Wiemann
   6 :Contact: LeWiemann@gmail.com
   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 :`<dbackport.sh>`_: Back-port changes from the trunk to the
  28     maintenance branch.
  29
  30 :`<docutils-update>`_: The script that updates the `web site`_.
  31     Executed on berlios, by user wiemann.
  32
  33     Attention: The cron job is executed, but the script is
  34         doing nothing, because of the way to access sourceforge
  35         changed.
  36
  37 :`<docutils-update.local>`_: The script to update the `web site`_
  38     from a developer machine. *The* current way of to go.
  39
  40 :`<fsfsbackup.sh>`_: Backup (mirror) an FSFS Subversion repository via
  41     SSH.  Used to backup the `Docutils Subversion repository`_.
  42
  43 :`<release.sh>`_: The script to make releases_ of Docutils.
  44
  45 :`<uploaddocutils.sh>`_: Upload files to http://docutils.sf.net/tmp/
  46     using ``scp``, inserting the current date in the file name.
  47
  48 :`<update-htmlfiles>`_: Used to initialise a docutils-update upload directory.
  49     Generating html-files from txt-files first time.
  50
  51 :`<htmlfiles.lst>`_: The list of files for ``update-htmlfiles``.
  52
  53 .. _Docutils: http://docutils.sourceforge.net/
  54 .. _Docutils check-in mailing list:
  55    http://docutils.sf.net/docs/user/mailing-lists.html#docutils-checkins
  56 .. _web site: http://docutils.sourceforge.net/docs/dev/website.html
  57 .. _Docutils Subversion repository:
  58    http://docutils.sourceforge.net/docs/dev/repository.html
  59 .. _releases: http://docutils.sourceforge.net/docs/dev/release.html