Commit graph

43 commits

Author SHA1 Message Date
Ian Abbott
7958fec6c5 doc: Makefile.am: rebuild manual when tutorial program source changes 2016-05-13 18:14:57 +01:00
Éric Piel
7d4ad9ad15 doc: add a section about Python bindings
This section goes into a "Language bindings" section where description
for Perl and Ruby could also go.
2012-10-29 17:08:09 +00:00
Ian Abbott
ba3117525a doc/Makefile.am: fix maintainer-clean-local rule.
The maintainer-clean-local rule was removing the wrong file for
comedilib.pdf.
2012-08-28 14:19:09 +01:00
Ian Abbott
a3c29c87a8 doc: Use a stylesheet for dblatex
Add comedilib_dblatex_config.xsl stylesheet and pass it to dblatex when
producing PDF output.  The current version of the stylesheet doesn't
make much difference to the output, but it's somewhere we can put stuff
later.

We probably want to do something similar for the other PDF backends, but
those are currently broken anyway.
2012-05-04 16:32:35 +01:00
Ian Abbott
be4e3b4007 configure: Allow choice of backend for PDF generation.
Add --with-pdf-backend=[yes|no|dblatex|fop|default] option which
defaults to "yes".  This controls the option passed to 'xmlto' to
generate PDFs.

If set to "yes" (the default) it looks for 'dblatex' and uses it as the
backend for 'xmlto' if found, otherwise 'xmlto' will use the default
backend.

If set to "no" (same as --without-pdf-backend), PDF generation is
disabled.

If set to "dblatex" it looks for 'dblatex' and uses it as the backend
for 'xmlto' if found, otherwise PDF generation is disabled.

If set to "fop" it looks for 'fop' and uses it as the backend
for 'xmlto' if found, otherwise PDF generation is disabled.

If set to "default", 'xmlto' will use the default backend.
2012-04-25 17:14:16 +01:00
Ian Abbott
31b558634a doc/Makefile.am: Create directory for pdf output
dblatex is passed the option `-o $(srcdir)/pdf`, but if this directory
does not exist, the PDF file is created with the name 'pdf' in
$(srcdir).  Make the directory so that the -o option treats the
specified name as an output directory instead of an output filename.
2012-04-23 17:52:06 +01:00
Bernd Porr
456421c4f6 Fixed a path issue with comedilib.pdf. Got correctly
saved into the pdf subfolder but install exprected
it in the doc folder.
2012-04-23 12:43:04 +01:00
Bernd Porr
9a76f63cd3 automake now checks for dblatex and the pdf version
of the comedi manual is now generated
2012-04-23 12:22:16 +01:00
Bernd Porr
0d8c6e9661 Comedilib.pdf can now be generated with
dblatex -t pdf ./comedilib.xml

There were two major issues in the comedilb.xml:
1) there were too many nested sections so that
   latex ran out of sub-sub-sub-sub-sections.
2) A section needs a title and can no longer
   exist without one. The first line
   of the textfiles contains now the title
   and will be inserted by mkref into the xml file.

todo: switch from xmlto to dblatex for the pdf generation
and re-enable it in the makefile.
2012-04-23 00:23:03 +01:00
Ian Abbott
4f21a64daa doc/Makefile: Remove *.css files on uninstallation.
Signed-off-by: Ian Abbott <abbotti@mev.co.uk>
2012-04-20 12:26:34 +01:00
Frank Mori Hess
6639f730fc Some minor tweaks. 2008-02-07 19:58:13 +00:00
Frank Mori Hess
064f43b4f8 Added css stylesheet for html docs. At the momment, it just gives a
light gray background to display of "programlisting" elements.
2008-01-28 19:30:01 +00:00
Frank Mori Hess
a0568092e7 Converted comedilib docs to docbook-xml 4.4, fixing a bunch of
parse errors along the way (mostly unclosed tags).
2008-01-24 01:32:41 +00:00
Frank Mori Hess
b3627840ac Added reference entries for new configuration instruction wrappers. 2008-01-17 17:03:01 +00:00
Frank Mori Hess
8e610500f3 Split function references into subsections. Always build docs in
$(srcdir).
2008-01-14 22:15:07 +00:00
Frank Mori Hess
d2708571d4 Patch from Tobias Blaser <tblaser@freesurf.ch>:
Here is a patch to CVS which adds the DESTDIR variable to the installation
rules in the comedilib doc Makefile. Convenient when creating packages.
2007-08-19 18:39:03 +00:00
Frank Mori Hess
2b73533b8b Got rid of doccomedilib, use "configure --docdir=blah" and related
options.  Fixed some problems with "make distcheck".
2007-07-31 17:43:18 +00:00
Bernd Porr
5ef66deba0 Documentation now goes in usr/share/doc/libcomedi0. This path
is just the same path debian is using for its own files
like README.debian or changlog. Thus, all the docu is then
in the same place.
2005-06-07 23:24:39 +00:00
Frank Mori Hess
4496652627 fix building of drivers.sgml and funcref.sgml when building out of
tree
2004-07-24 18:04:59 +00:00
Frank Mori Hess
53419b4e09 patch for out-of-tree builds from Caleb Tennis 2004-07-24 17:03:06 +00:00
Frank Mori Hess
57dc5de6d3 fix problem with html directory getting remade every time (at least
with automake1.8)
2004-01-12 00:03:45 +00:00
Frank Mori Hess
56027b2154 html_targets and man_targets not working out so hot 2004-01-04 16:06:51 +00:00
Frank Mori Hess
a264b821eb try to keep html_targets and man_targets up-to-date as automatically
as possible
2003-12-24 16:09:30 +00:00
Frank Mori Hess
663896f325 use files to keep track of html and man targets 2003-12-24 15:46:55 +00:00
Frank Mori Hess
af062d2865 put gif back in EXTRA_DIST 2003-12-24 15:00:47 +00:00
Frank Mori Hess
4581baf59a provide prebuilt docs in distribution tarballs 2003-12-24 01:48:51 +00:00
Frank Mori Hess
cb5e78da65 make dependency handling work for subdirs 2003-12-03 02:43:47 +00:00
David Schleef
73d5777300 rerefactor Makefile.am 2003-08-16 22:18:05 +00:00
David Schleef
8c7886ff0d don't dist acq-seg.gif 2003-08-16 00:20:54 +00:00
David Schleef
733da099a2 refactor build system for docs 2003-08-16 00:20:02 +00:00
Frank Mori Hess
605a5fa68b ignore install errors for manpages 2003-08-08 18:41:20 +00:00
Frank Mori Hess
092659f27d refined handling of built directories 2003-07-15 15:58:28 +00:00
Frank Mori Hess
dfdb0915aa ignore errors making manpages again 2003-07-11 23:25:10 +00:00
Frank Mori Hess
caa9fd4663 added symlink for figure 2003-07-11 23:07:42 +00:00
Frank Mori Hess
d53f8fb6b8 got rid of advanced.sgml 2003-07-09 19:49:59 +00:00
Frank Mori Hess
81df61bede make install-data-local target conditional, and use $(INSTALL_DATA)
instead of $(INSTALL)
2003-07-08 22:13:00 +00:00
David Schleef
7202fb8b74 add figure 2003-07-07 22:44:39 +00:00
David Schleef
a2e5d96ba6 Add conditional compilation. Use docbook found by autoconf. 2003-06-05 22:16:02 +00:00
David Schleef
2cdfa17091 Fixes to make python and docs build correctly 2003-06-04 02:42:08 +00:00
Frank Mori Hess
598fa693a6 removed obsolete advanced.sgml. Got rid of references to hard-coded
comedi_config paths
2003-06-01 18:58:55 +00:00
Frank Mori Hess
f905699fd7 fix broken dependencies, and man page generation 2003-05-08 00:34:29 +00:00
David Schleef
827370aa90 clean better 2003-05-02 08:06:17 +00:00
David Schleef
b28c52a42f autoconfiscation 2003-05-02 07:19:00 +00:00