Devhelp

From Gramps
Revision as of 11:14, 30 November 2012 by Romjerome (talk | contribs) (Steps)
Jump to: navigation, search
Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Steps for including Gramps' API into devhelp index.

Gramps and Gtk3 APIs into devhelp browser

Devhelp

Devhelp is a Gtk+/Gnome browser for API documentation; it works natively with gtk-doc (which is the API reference format for Gtk+/Gnome documentation).

Paths

According base directories from freedesktop, the working patchs should be:

  • devhelp

~/.local/share/devhelp/books/gramps/gramps.devhelp

/usr/local/share/devhelp/books/gramps/gramps.devhelp

  • gtk-doc

/usr/share/gtk-doc/html/gramps/gramps.devhelp

Steps

1. Go to Gramps_SVN/docs folder

trunk: gen modules are OK, broken relative import for specific modules and interfaces related to Gramps.

2. modifiy 'makefile' for generating a devhelp file via 'devhelp' key for builder:

$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) _build/devhelp

3. copy the content of _build/devhelp directory into one of the above paths for devhelp index.

4. run a command (which one?) or wait for the next post installation (rebuild of indexes after new package)

See also