wxPython/docs/bin/makeapidocs

   1 #!/bin/bash
   2
   3 #----------------------------------------------------------------------
   4
   5 if [ ! -d wxPython ]; then  # TODO: make this test more robust
   6     echo "Please run this script from the root wxPython directory."
   7     exit 1
   8 fi
   9
  10 VERSION=`python -c "import setup;print setup.VERSION"`
  11
  12
  13 # cleanup old build
  14 rm -r docs/api/*
  15
  16 # build the docs
  17 export PTYHONPATH=$PWD
  18 /opt/python/bin/epydoc --name wxPython \
  19     --html \
  20     --output docs/api \
  21     --ignore-param-mismatch \
  22     --inheritance none \
  23     --no-expand-subpackages \
  24     --no-private \
  25     --css docs/wxPython-epydoc.css \
  26     --docformat restructuredtext \
  27     --url http://wxPython.org/ \
  28     --no-frames \
  29     $* \
  30     wxversion/wxversion.py \
  31     wx
  32
  33 #    wx/__init__.py \
  34
  35 #    wx/calendar.py wx/grid.py wx/html.py wx/wizard.py \
  36 #    wx/gizmos.py wx/ogl.py wx/stc.py wx/xrc.py
  37
  38
  39 #    --no-frames \
  40 #    --docformat epytext \
  41 #    --debug \
  42 #    --inheritance grouped \
  43
  44
  45 # TODO:
  46 #   1. Should rebuild the top-level docs too (but we need more of them first!)
  47
  48
  49
  50 # bundle it all up into a tarball
  51 DEST=wxPython-$VERSION/docs
  52 mkdir -p _build_docs/$DEST
  53 cp -R --link docs/api _build_docs/$DEST
  54 cd _build_docs
  55 rm -f ../dist/wxPython-newdocs-$VERSION.tar.bz2
  56 tar cf ../dist/wxPython-newdocs-$VERSION.tar $DEST
  57 bzip2 -9 ../dist/wxPython-newdocs-$VERSION.tar
  58
  59 # Cleanup
  60 cd ..
  61 rm -r _build_docs
  62