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 - 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/gtk-doc-manual.xml
  27   git commit -m"release: update news and date in manual"
  28
  29 - dist
  30   make dist
  31
  32 - tag
  33   git tag -a GTK_DOC_1_12 -m"release: 1.12"
  34   git push origin GTK_DOC_1_12
  35
  36 - release
  37   scp gtk-doc-1.12.tar.gz <user>@master.gnome.org:
  38   scp NEWS <user>@master.gnome.org:gtk-doc-1.12.news
  39   scp ChangeLog-1.12 <user>@master.gnome.org:gtk-doc-1.12.changes
  40   ssh <user>@master.gnome.org
  41   install-module gtk-doc-1.12.tar.gz
  42   exit
  43
  44 - bump versions in:
  45   configure.ac
  46   help/manual/C/gtk-doc-manual.xml
  47
  48 - commit
  49   git add configure.ac help/manual/C/gtk-doc-manual.xml
  50   git commit -m"release: bump versions and back to development"
  51
  52 - update web-pages (gtk-web/gtk-doc)
  53   git add gtk-doc/news.html
  54   git commit -m"gtk-doc: new release (1.15)"
  55
  56 - if we want a icon on the newsfeed, we should copy a icon like on
  57   http://ftp.acc.umu.se/pub/GNOME/sources/rhythmbox/rhythmbox.png
  58   e.g. /usr/share/icons/hicolor/48x48/apps/devhelp.png
  59
  60 Optimizing & Meassuring
  61 =======================
  62
  63 cd tests/gobject/docs/html
  64 time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "tester" --stringparam gtkdoc.version "1.12" ../../../../gtk-doc.xsl ../tester-docs.xml
  65 ~ 3 sec.
  66 time saxon ../tester-docs.xml ../../../../gtk-doc.xsl gtkdoc.bookname="tester" gtkdoc.version="1.12"
  67 ~ 53 sec.
  68
  69 Troubles with parsing regexps
  70 =============================
  71 Test regexps online:
  72 http://www.solmetra.com/scripts/regex/index.php
  73