Fix "Contributing to this document" for new HTML/PDF generation process

This commit is contained in:
Colomban Wendling 2014-08-18 00:07:43 +02:00
parent 874b019e4e
commit cf6724240a

View File

@ -5160,12 +5160,16 @@ Contributing to this document
This document (``geany.txt``) is written in `reStructuredText`__ This document (``geany.txt``) is written in `reStructuredText`__
(or "reST"). The source file for it is located in Geany's ``doc`` (or "reST"). The source file for it is located in Geany's ``doc``
subdirectory. If you intend on making changes, you should grab the subdirectory. If you intend on making changes, you should grab the
source right from Git to make sure you've got the newest version. After source right from Git to make sure you've got the newest version.
editing the file, to build the HTML document to see how your changes First, you need to configure the build system to generate the HTML
look, run "``make doc``" in the subdirectory ``doc`` of Geany's source documentation passing the *--enable-html-docs* option to the *configure*
directory. This regenerates the ``geany.html`` file. To generate a PDF script. Then after editing the file, run ``make`` (from the root build
file, use the command "``make pdf``" which should generate a file called directory or from the *doc* subdirectory) to build the HTML documentation
geany-|(version)|.pdf. and see how your changes look. This regenerates the ``geany.html`` file
inside the *doc* subdirectory. To generate a PDF file, configure with
*--enable-pdf-docs* and run ``make`` as for the HTML version. The generated
PDF file is named geany-|(version)|.pdf and is located inside the *doc*
subdirectory.
__ http://docutils.sourceforge.net/rst.html __ http://docutils.sourceforge.net/rst.html