Updated Spanish translation
[gtk-doc.git] / HACKING
blob5b6af19d1dbac25638410308b154e59966764ebe
1 Testing
2 =======
4 jhbuild --no-interact build 2>&1 | tee build.log
5 grep "gtkdoc-* line" build.log
7 jhbuild buildone --no-net glib
9 Releasing
10 =========
12 http://live.gnome.org/MaintainersCorner/Releasing
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
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
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
30 - dist
31   make dist
33 - tag
34   git tag -a GTK_DOC_1_12 -m"release: 1.12"
35   git push origin GTK_DOC_1_12
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
45 - bump versions in:
46   configure.ac
47   help/manual/C/gtk-doc-manual.xml
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
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
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 =======================
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.
72 Troubles with parsing regexps
73 =============================
74 Test regexps online:
75 http://www.solmetra.com/scripts/regex/index.php