Doc/tools/push-docs.sh

   1 #! /bin/sh
   2
   3 #  Script to push docs from my development area to SourceForge, where the
   4 #  update-docs.sh script unpacks them into their final destination.
   5
   6 TARGETHOST=www.python.org
   7 TARGETDIR=/usr/home/fdrake/tmp
   8
   9 TARGET="$TARGETHOST:$TARGETDIR"
  10
  11 ADDRESSES='python-dev@python.org doc-sig@python.org python-list@python.org'
  12
  13 TOOLDIR="`dirname $0`"
  14 VERSION=`$TOOLDIR/getversioninfo`
  15
  16 # Set $EXTRA to something non-empty if this is a non-trunk version:
  17 EXTRA=`echo "$VERSION" | sed 's/^[0-9][0-9]*\.[0-9][0-9]*//'`
  18
  19 if echo "$EXTRA" | grep -q '[.]' ; then
  20     DOCLABEL="maintenance"
  21     DOCTYPE="maint"
  22 else
  23     DOCLABEL="development"
  24     DOCTYPE="devel"
  25 fi
  26
  27 EXPLANATION=''
  28 ANNOUNCE=true
  29
  30 while [ "$#" -gt 0 ] ; do
  31   case "$1" in
  32       -m)
  33           EXPLANATION="$2"
  34           shift 2
  35           ;;
  36       -q)
  37           ANNOUNCE=false
  38           shift 1
  39           ;;
  40       -t)
  41           DOCTYPE="$2"
  42           shift 2
  43           ;;
  44       -F)
  45           EXPLANATION="`cat $2`"
  46           shift 2
  47           ;;
  48       -*)
  49           echo "Unknown option: $1" >&2
  50           exit 2
  51           ;;
  52       *)
  53           break
  54           ;;
  55   esac
  56 done
  57 if [ "$1" ] ; then
  58     if [ "$EXPLANATION" ] ; then
  59         echo "Explanation may only be given once!" >&2
  60         exit 2
  61     fi
  62     EXPLANATION="$1"
  63     shift
  64 fi
  65
  66 if [ "$DOCTYPE" = 'maint' ] ; then
  67     # 'maint' is a symlink
  68     DOCTYPE='maint23'
  69 fi
  70
  71 START="`pwd`"
  72 MYDIR="`dirname $0`"
  73 cd "$MYDIR"
  74 MYDIR="`pwd`"
  75
  76 cd ..
  77
  78 # now in .../Doc/
  79 make --no-print-directory bziphtml || exit $?
  80 PACKAGE="html-$VERSION.tar.bz2"
  81 scp "$PACKAGE" tools/update-docs.sh $TARGET/ || exit $?
  82 ssh "$TARGETHOST" tmp/update-docs.sh $DOCTYPE $PACKAGE '&&' rm tmp/update-docs.sh || exit $?
  83
  84 if $ANNOUNCE ; then
  85     sendmail $ADDRESSES <<EOF
  86 To: $ADDRESSES
  87 From: "Fred L. Drake" <fdrake@acm.org>
  88 Subject: [$DOCLABEL doc updates]
  89 X-No-Archive: yes
  90
  91 The $DOCLABEL version of the documentation has been updated:
  92
  93     http://$TARGETHOST/dev/doc/$DOCTYPE/
  94
  95 $EXPLANATION
  96 EOF
  97     exit $?
  98 fi