freeipa/doc/guide
Jan Cholasta ab9d1e75fc logging: do not reference loggers in arguments and attributes
Remove logger arguments in all functions and logger attributes in all
objects, with the exception of API object logger, which is now deprecated.
Replace affected logger calls with module-level logger calls.

Reviewed-By: Martin Basti <mbasti@redhat.com>
2017-07-14 15:55:59 +02:00
..
guide.org logging: do not reference loggers in arguments and attributes 2017-07-14 15:55:59 +02:00
Makefile Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
netgroup.js Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
README Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
role.py.txt Rename included snippets to avoid problems with pylint 2011-11-22 17:04:03 +02:00
wsgi.py.txt logging: do not reference loggers in arguments and attributes 2017-07-14 15:55:59 +02:00

Extending FreeIPA
-----------------

"Extending FreeIPA" is a developer guide to understand how FreeIPA core 
framework is built and how to extend it.

The Guide is written using Emacs Org Mode, see http://orgmode.org/org.html
for extensive manual of supported markup features.

You don't need to use Emacs to edit it, the markup is a plain text.

Building the guide
------------------

There is Makefile which can be used to convert the Guide from
Emacs Org Mode format to different targets.

Prerequisites:
==============
On Fedora system following packages are required to generate The Guide:

docbook-style-xsl
fop
emacs
xmlto

HTML, Docbook, and plain text
---
As Org Mode is part of Emacs since version 22, building HTML, TXT, and 
Docbook targets requires Emacs v22 and above (tested with v23.3 in Fedora).

PDF
---
Building PDF is done first generating Docbook source, converting it to FO format,
and then running 'fop' processor.