HACKING

   1 Testing
   2 =======
   3
   4 jhbuild --no-interact build 2>&1 | tee build.log
   5 grep "gtkdoc-* line" build.log
   6
   7 jhbuild buildone --no-net glib
   8
   9 Releasing
  10 =========
  11
  12 http://live.gnome.org/MaintainersCorner/Releasing
  13
  14 - bump release date in:
  15   help/manual/C/gtk-doc-manual.xml
  16
  17 - update NEWS
  18   ./bugzilla.py general 1.12 gtk-doc >RELNOTES.txt
  19   git log --summary --format=short GTK_DOC_1_11.. >ChangeLog-1.12
  20   grep ChangeLog-1.12 "Author:" | sed 's/Author:\(.*\)\ <.*>/\1/' | sort | uniq >>RELNOTES.txt
  21   add then copy to NEWS
  22
  23 - dist
  24   make dist
  25
  26 - tag
  27   git tag -a GTK_DOC_1_12
  28   git push origin GTK_DOC_1_12
  29
  30 - release
  31   scp gtk-doc-1.12.tar.gz <user>@master.gnome.org:
  32   scp NEWS <user>@master.gnome.org:gtk-doc-1.12.news
  33   scp ChangeLog-1.12 <user>@master.gnome.org:gtk-doc-1.12.changes
  34   ssh <user>@master.gnome.org
  35   install-module gtk-doc-1.12.tar.gz
  36   exit
  37
  38 - bump versions in:
  39   configure.in
  40   help/manual/C/gtk-doc-manual.xml
  41
  42 - update web-pages (gtk-web/gtk-doc)
  43
  44 - if we want a icon on the newsfeed, we should copy a icon like on
  45   http://ftp.acc.umu.se/pub/GNOME/sources/rhythmbox/rhythmbox.png
  46   e.g. /usr/share/icons/hicolor/48x48/apps/devhelp.png
  47
  48 Optimizing & Meassuring
  49 =======================
  50
  51 cd tests/gobject/docs/html
  52 time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "tester" --stringparam gtkdoc.version "1.12" ../../../../gtk-doc.xsl ../tester-docs.xml
  53 ~ 3 sec.
  54 time saxon ../tester-docs.xml ../../../../gtk-doc.xsl gtkdoc.bookname="tester" gtkdoc.version="1.12"
  55 ~ 53 sec.
  56
  57 Troubles with parsing regexps
  58 =============================
  59 Test regexps online:
  60 http://www.solmetra.com/scripts/regex/index.php
  61