gtk-doc has been slowly dying for the past few years; with gi-docgen we
have a nice successor.
This also makes sure the C documentation also uses the GIR file, which
in turn means faster build times (since all the C code doesn't have to
be parsed and recompiled again), and has a clear dependency graph.
See the [gi-docgen tutorial] for more info on how the system works.
[gi-docgen tutorial]: https://gnome.pages.gitlab.gnome.org/gi-docgen/tutorial.html
- Organize the rules in sections and subsections.
- Add some text about the linear git history (this can be seen as coding
style after all).
- Add comment coding style and non-public API documentation sections.
- A bit of section reordering.
- Move the configuration files info from HACKING into CODING_STYLE.md,
and make a new "Helping tools" section.
It never belonged inside "tools". Also rename its "pdb" subdirectory
to "groups". This had to happen before 2.10 so cherry-picking between
branches doesn't become a nightmare in the future.
2008-08-11 Sven Neumann <sven@gimp.org>
Please re-run autogen.sh after this update, and let me know if
there are any problems.
* po-*/Makefile.in.in: updated to a version that does not
require
mkinstalldirs to be present.
* autogen.sh: removed the call to glib-gettextize and call
intltoolize without the --force command-line option. This change
makes an end to the po/Makefile.in.in being overwritten.
* HACKING: changed the documentation accordingly.
svn path=/trunk/; revision=26500
2008-07-03 Sven Neumann <sven@gimp.org>
* INSTALL: mention the fact that intltool now needs to be
installed in order to build from tarball.
* HACKING: removed mentioning of intltoolize here.
svn path=/trunk/; revision=26041
2008-03-23 Mukund Sivaraman <muks@mukund.org>
* HACKING: Updated section on getting dependencies, as we don't
want to encourage using deps from svn for building GIMP.
svn path=/trunk/; revision=25188
2007-11-21 Sven Neumann <sven@gimp.org>
* HACKING
* autogen.sh: dropped support for automake 1.8 and require
automake >= 1.9.6. Require libtool 1.5 for all platforms.
svn path=/trunk/; revision=24210
2007-05-06 Sven Neumann <sven@gimp.org>
* HACKING: suggest to use pango-1-16.
* configure.in: added --enable-gtk-doc-app option and an
automake
conditional for it.
* devel-docs/Makefile.am: build the app directory conditionally.
* devel-docs/app/Makefile.am: override disthook since we don't
want to distribute any generated files.
svn path=/trunk/; revision=22426
2007-01-12 Sven Neumann <sven@gimp.org>
* configure.in
* app/sanity.c: depend on glib >= 2.12.3.
* HACKING: updated branches.
* libgimpwidgets/gimpintstore.c: added a construct-only property
that allows to specify the GType of the user-data column.
svn path=/trunk/; revision=21692
2006-08-07 Raphael Quinet <raphael@gimp.org>
* HACKING: Mention that the mailing list is a good place to
discuss patches (if they need to be discussed).
2005-02-07 Sven Neumann <sven@gimp.org>
* HACKING
* autogen.sh: dropped support for automake 1.6, automake >= 1.7 is
now required.
* configure.in: removed cruft that was there only for automake 1.6.
2005-01-20 Sven Neumann <sven@gimp.org>
* HACKING
* Makefile.am
* acinclude.m4
* autogen.sh: applied (modified) patch from Raphaël Quinet that
allows to build GIMP from CVS without having gtk-doc installed.
If you need to do this, pass --disable-gtk-doc to autogen.sh.
* configure.in: removed --disable-devel-docs option since it has
become obsolete now.
* devel-docs/Makefile.am: require gtk-doc when running 'make dist'.
2004-11-10 Sven Neumann <sven@gimp.org>
* app/dialogs/preferences-dialog.c: set the padding-mode to custom
color if a custom color is choosen. Fixes bug #157844.
2004-05-02 Sven Neumann <sven@gimp.org>
* menus/Makefile.am: added a rule to generate gtkuimanager XML
files using an XSL transformation.
* menus/menus.xsl: a simple XSLT to generate a menubar and a popup
menu with identical content.
* menus/image-menu.xml: removed this file from CVS ...
* menus/image-menu.xml.in: ... and added this instead.
* HACKING: xsltproc is now needed to build from CVS.
2004-03-04 Sven Neumann <sven@gimp.org>
* autogen.sh: follow the changes done for other modules such as
glib, pango and gtk+:
- exit with $? instead of 1 in case of failure
- exit with $? if ./configure failed
- removed --enable-gtk-doc option
- added $AUTOGEN_CONFIGURE_ARGS
* HACKING: document the new behaviour.
2004-01-25 Sven Neumann <sven@gimp.org>
* app/gui/info-window.c (info_window_create): don't update the fields
here...
* app/gui/view-commands.c (view_info_window_cmd_callback): ... but
here when the info window is connected to the display shell. Patch
from Shlomi Fish; fixes bug #132329.
* app/gui/info-window.c (info_window_update_extended): fixed update
of info window in automatic mode. Bug #118084, patch by Shlomi Fish.
* autogen.sh: check for automake-1.8 also.
* HACKING: note that automake-1.8 should work as well.
2003-09-03 Sven Neumann <sven@gimp.org>
* HACKING
* autogen.sh: require libtool version 1.5.0 or newer when building
on Win32. Completely untested but it should fix bug #120953.
2003-09-03 Dave Neary <bolsh@gimp.org>
* NEWS: Changed slightly - I overestimated/overanticipated
some things.
* HACKING: Updated to fix some indentation issues, and clear
up some small points (like not building as root) following
suggestions from Emmet Caulfield <emmet@netrogen.com>
2003-02-08 Sven Neumann <sven@gimp.org>
* HACKING: added a note about generating the developers
documentation and how to disable it in case of problems.
Niels De Graef