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/index.docbook
  16 - bump version in (1.14.1 -> 1.15)
  17   configure.ac
  18
  19 - update NEWS
  20   ./bugzilla.py general 1.12 gtk-doc >RELNOTES.txt
  21   git log --summary --format=short GTK_DOC_1_11.. >ChangeLog-1.12
  22   grep "Author:" ChangeLog-1.12 | sed 's/Author:\(.*\)\ <.*>/\1/' | sort | uniq >>RELNOTES.txt
  23   and then copy to NEWS
  24
  25 - commit
  26   git add configure.ac NEWS help/manual/C/index.docbook
  27   git commit -m"release: update news and date in manual"
  28   git push
  29
  30 - dist
  31    TAR_OPTIONS="--owner=root --group=root" make distcheck
  32
  33 - tag
  34   git tag -a GTK_DOC_1_12 -m"release: 1.12"
  35   git push origin GTK_DOC_1_12
  36
  37 - release
  38   scp gtk-doc-1.12.tar.xz <user>@master.gnome.org:
  39   scp NEWS <user>@master.gnome.org:gtk-doc-1.12.news
  40   scp ChangeLog-1.12 <user>@master.gnome.org:gtk-doc-1.12.changes
  41   ssh <user>@master.gnome.org
  42   ftpadmin install gtk-doc-1.12.tar.xz
  43   exit
  44
  45 - bump versions in:
  46   configure.ac
  47   help/manual/C/index.docbook
  48   NEWS
  49
  50 - commit
  51   git add configure.ac NEWS help/manual/C/index.docbook
  52   git commit -m"release: bump versions and back to development"
  53   git push
  54
  55 - update web-pages (gtk-web/gtk-doc)
  56   git add gtk-doc/news.php
  57   git commit -m"gtk-doc: new release (1.15)"
  58   git push
  59
  60 - if we want a icon on the newsfeed, we should copy a icon like on
  61   http://ftp.acc.umu.se/pub/GNOME/sources/rhythmbox/rhythmbox.png
  62   e.g. /usr/share/icons/hicolor/48x48/apps/devhelp.png
  63
  64 Optimizing & Meassuring
  65 =======================
  66
  67 cd tests/gobject/docs/html
  68 time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "tester" --stringparam gtkdoc.version "1.12" ../../../../gtk-doc.xsl ../tester-docs.xml
  69 ~ 3 sec.
  70 time saxon ../tester-docs.xml ../../../../gtk-doc.xsl gtkdoc.bookname="tester" gtkdoc.version="1.12"
  71 ~ 53 sec.
  72
  73 Troubles with parsing regexps
  74 =============================
  75 Test regexps online:
  76 http://www.solmetra.com/scripts/regex/index.php
  77