This makes sure the HTML output for
<function>foo<parameter>bar</parameter><parameter>baz</parameter></function>
includes parentheses, although it doesn't seem to add empty parentheses
after a plain <function>foo</function> which perhaps it should.
Some DocBook mark-up changes. Also avoided absolute path-names for
sources as people tend to put them in different places! Also changed
instructions for submitting drivers for review.
Mention that the stuff that relies on the COMEDI_TRIG ioctl, including
the slowly varying input (comedi_sv_...) functions no longer work with
current versions of the Comedi kernel layer.
Removed subdevice_struct as it is internal to comedilib. Removed
struct comedi_t_struct, leaving only the comedi_t typedef as
applications only see it as a pointer to an opaque, incomplete type.
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.
info in the demo directory. I've made it a bit more verbose
and also took into account that now the generic_timed command
takes more than one channel so that a user can experiment which
sampling rates are possible with different channel numbers.
I've also added an option to set the sampling rate for the generic_timed
command. That sould actually not be needed but I'm sure there
are drivers out there which do not correct the sampling rate
downwards automatically.
Changed handling of --with-pdf-backend[=yes] to avoid picking the default
xmlto backend for PDF generation because it's broken.
The default xmlto backend for PDF generation can still be selected using
--with-pdf-backend=default if you really want to try it.
also updated the tutorial. I've simplified the tut2.c
by using comedi2phys instead of comedi2physical. The use of
polynomials as a 2nd comedi program is a bit too difficult
for a novice and might deter the user to dig deeper into
the coding. Also, I've added tut3.c which is a stripped
down version of cmd.c and of that again the relevant lines
for the handbook to save space.
just left udev as the only hotplug mechanism. I've also added
an option to disable the installation of the firmware. This
is useful for debian or ubuntu packages where the firmware
is now provided by a package accompanying the staging kernel.
All usbdux files are included in the kernel firmware packages.
Package maintainers should use the --disable-firmware option.
The PDF output of the table of configurations was awful. Fiddled with
the column widths a bit and simplified the layout "Meanings of data[1],..."
column to allow it to wrap.
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.
Rebuilt "doc/drivers.txt" using "make Documentation/comedi/drivers.txt"
in the Comedi package. Note: this scans the driver sources included
with the comedi.org Comedi package, not the Linux "staging" Comedi
sources, so some newer, staging-only drivers are missing.
Signed-off-by: Ian Abbott <abbotti@mev.co.uk>
