libopencm3/doc
Karl Palsson 0f39bc6e80 doc: remove duplicate l4 generation
Doesn't fix l4 docs, but pointless regeneration anyway
2018-02-13 23:05:21 +00:00
..
efm32g doc: drop latex support 2017-10-18 20:05:14 +00:00
efm32gg doc: drop latex support 2017-10-18 20:05:14 +00:00
efm32lg doc: drop latex support 2017-10-18 20:05:14 +00:00
efm32tg doc: drop latex support 2017-10-18 20:05:14 +00:00
lm3s doc: drop latex support 2017-10-18 20:05:14 +00:00
lm4f doc: drop latex support 2017-10-18 20:05:14 +00:00
lpc13xx doc: drop latex support 2017-10-18 20:05:14 +00:00
lpc17xx doc: drop latex support 2017-10-18 20:05:14 +00:00
lpc43xx doc: drop latex support 2017-10-18 20:05:14 +00:00
sam3a doc: drop latex support 2017-10-18 20:05:14 +00:00
sam3n doc: drop latex support 2017-10-18 20:05:14 +00:00
sam3s doc: drop latex support 2017-10-18 20:05:14 +00:00
sam3u doc: drop latex support 2017-10-18 20:05:14 +00:00
sam3x doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f0 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f1 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f2 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f3 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f4 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32f7 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32l0 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32l1 doc: drop latex support 2017-10-18 20:05:14 +00:00
stm32l4 doc: drop latex support 2017-10-18 20:05:14 +00:00
vf6xx doc: drop latex support 2017-10-18 20:05:14 +00:00
Doxyfile Fix a number of top level doxygen issues. 2014-01-15 22:19:52 +01:00
Doxyfile_common Strip the BEGIN_DECLS definition from the first function in a module documentation. 2013-07-07 16:12:03 -07:00
DoxygenLayout.xml doc: drop the standalone cm3/usb documents 2017-10-18 20:05:14 +00:00
HACKING Fix a number of top level doxygen issues. 2014-01-15 22:19:52 +01:00
Makefile doc: remove duplicate l4 generation 2018-02-13 23:05:21 +00:00
README docs: note dependencies for PDF generation 2014-02-12 15:21:09 +00:00
index.html [DOXYGEN] Add links to the HTML pages for easy debugging of pages 2013-08-24 14:20:13 +02:00

README

libopencm3 Documentation
14 September 2012 (C) K Sarkies
-------------------------------

To generate all documentation run 'make doc' in the doc directory, or
for html documentation only run 'make html' (much faster). This runs doxygen
for each of the processor families then integrates the whole.

Alternatively run 'make doc' in the top directory to make html documentation.
LaTeX and pdf documentation is currently very large in size.

This requires doxygen v 1.8.2 or later.

HTML, LaTeX, and pdf output can be produced.

Generation of HTML
------------------

To view HTML, point a browser to libopencm3/doc/html/index.html.

Generation of PDF
-----------------

The pdf is generated via LaTeX. The pdf files are placed in the
doc directory. Each file contains all documentation for the core and common
features. The resulting files are huge.


Requirements
------------
On Fedora 19, the following packages (at least!) are needed to build the pdf
output

    texlive texlive-sectsty texlive-tocloft texlive-xtab texlive-multirow