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   git push
  29
  30 - dist
  31   make dist
  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/gtk-doc-manual.xml
  48
  49 - commit
  50   git add configure.ac help/manual/C/gtk-doc-manual.xml
  51   git commit -m"release: bump versions and back to development"
  52   git push
  53
  54 - update web-pages (gtk-web/gtk-doc)
  55   git add gtk-doc/news.php
  56   git commit -m"gtk-doc: new release (1.15)"
  57   git push
  58
  59 - if we want a icon on the newsfeed, we should copy a icon like on
  60   http://ftp.acc.umu.se/pub/GNOME/sources/rhythmbox/rhythmbox.png
  61   e.g. /usr/share/icons/hicolor/48x48/apps/devhelp.png
  62
  63 Optimizing & Meassuring
  64 =======================
  65
  66 cd tests/gobject/docs/html
  67 time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "tester" --stringparam gtkdoc.version "1.12" ../../../../gtk-doc.xsl ../tester-docs.xml
  68 ~ 3 sec.
  69 time saxon ../tester-docs.xml ../../../../gtk-doc.xsl gtkdoc.bookname="tester" gtkdoc.version="1.12"
  70 ~ 53 sec.
  71
  72 Troubles with parsing regexps
  73 =============================
  74 Test regexps online:
  75 http://www.solmetra.com/scripts/regex/index.php
  76