[[PageOutline(2-5,Contents,pullout)]]

= GTK-Doc Plugin for Trac

== Description

This plugin integrates gtkdoc books into Trac's interface. This is accomplished by displaying the actual html output of gtkdoc, as well as integrating into the search engine in Trac.

There are three new user permissions in this plugin: `GTKDOC_SEARCH`, `GTKDOC_VIEW` and `GTKDOC_ADMIN`. `GTKDOC_VIEW` and `GTKDOC_SEARCH` is obviously to view and respectively to search in the API, where `GTKDOC_ADMIN` allows the addition and removal of books.

As mentioned above the admin_interface provides an interface for adding and removing books. Books are keyed on a name given to them at the time they are added, as well as an absolute path on the local filesystem of where the book actually is. This way, you can update the documentation (with rsync for example) and not have to touch a thing in Trac.

See also: [http://gary-kramlich.livejournal.com/10776.html original announcement].

== Bugs/Feature Requests

Existing bugs and feature requests for GtkDocPlugin are 
[report:9?COMPONENT=GtkDocPlugin here].

If you have any issues, create a 
[/newticket?component=GtkDocPlugin new ticket].

[[TicketQuery(component=GtkDocPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:gtkdocplugin here].

== Source

You can check out GtkDocPlugin from [/svn/gtkdocplugin here] using Subversion, or [source:gtkdocplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Example

See [http://www.gnugts.org/ gnugts.org]

== Recent Changes

[[ChangeLog(gtkdocplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:lsaavedr] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' Gary Kramlich [http://hg.guifications.org/extras/file/2bc8f2aedef7/trac/gtkdoc/tracgtkdoc tracgtkdoc]