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 :`<docutils-update.local>`_: The script to update the `web site`_
  16     from a developer machine or on shell.sourceforge.
  17
  18     If a file ``ON_SOURCEFORGE`` exists in current dorectory, the
  19     script assumes being executed on shell.sourceforge.
  20
  21 :`<release.sh>`_: The script to make releases_ of Docutils.
  22     For usage details see `<release.txt>`_
  23
  24     TODO : less sudo ? must test-directory be installed ?NO?
  25
  26 :`<release-test.sh>`_: The script to run tests at release time, extracted
  27     from ``release.sh``.
  28
  29 Everything below this line needs rework
  30 ---------------------------------------
  31
  32 Overview:
  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 .. _release.txt: http://docutils.sourceforge.net/docs/dev/release.html