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.

doc/other.xml: Moved a few tags around and minor changes.

Moved <link> tags inside <function>, <type>, <constant> etc. tags so
fonts stay a bit more consistent.

Merge branch 'master' of git://comedi.org/git/comedi/comedilib

Removed a para from the section about proc which mentioned an NI
card but that's now the dux board from above actually.

Just spotted that the documentation also talks about board_info.
I've updated it as well: explained the new command comedi_board_info.

Added a couple of sentences about async acquisition and the
two modes cards do it and then mentioned our new board_info.

Changed some of the descriptions for the SDF flags which were
a bit misleading.

Just what I said in the git log is now also actually in the man page
namely that the frequency option is only there for debugging.

Added comedi_board_info which has been inspired by the original
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.

Added info that '-n' is used to select the waveform.

Merge branch 'master' of ssh://comedi.org/git/comedi/comedilib

Created a PWM demo using the newly introduced defines to
manipulate PWM frequency.

doc/other.xml: More fiddling about.

More documentation tidy-ups.  I'll probably get bored eventually!

doc/comedilib.xml: Add myself (Ian Abbott) to list of authors.

doc/tutorial.xml: Fix a broken link.

doc/other.xml: Use comedi_dio_bitfield2 instead of comedi_dio_bitfield.

Rework text to use comedi_dio_bitfield2 as comedi_dio_bitfield is marked
as deprecated elsewhere in the document.

I've added a bit more "meat" to the asynchronous acquisition section
and added myself to the authors section.

configure: Avoid PDF generation by default if don't have dblatex

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.

doc/funcref: Added missing comedi_data_read_n

There was a broken link to the comedi_data_read_n function from
elsewhere, so we'd better add a section for it.

doc: Use ansi style funcsynopsis for html output.

Set XSL parameter "funcsynopsis.style" to "ansi" in the XSL stylesheet
used for HTML output (comedilib_html_config.xsl).

doc/mkref: Add some refmiscinfo for man pages

Make the man pages a bit neater.

doc/other.xml: Some DocBook markup changes.

doc: A few whitespace tweaks in program listings

doc/other.xml: Replaced simplelists

Replaced some simplelists with variablelists to fix some dblatex layout
problems.

I've updated the manual in the section configuration and
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.

Removed old hotplug install which is no longer used at all and
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.

doc/other.xml: Make table of configuration instructions less ugly.

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.

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.

doc/drivers.txt: Rebuilt from comedi

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>

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.

etc/hotplug/usbduxsigma: Remove Makefile and Makefile.in ...

... but keep Makefile.am of course!

Updated usbdux firmware files. The udev hotplug mechanism
now takes binary files and no longer hex files. Also
added the firmware for usbduxsigma.

Fixed an issue reported by Graeme Hattan that the udev
rules were installed in the etc directory and not the lib.
See also:
http://lintian.debian.org/tags/udev-rule-in-etc.html
./configure --with-udev-hotplug=/lib places now all
files in /lib. The scripts were wrongly prefixed with the
sysconf directory which is /etc but should be /lib.
The directory is now also taken from --with-udev-hotplug=/lib.

Fixed a path issue with comedilib.pdf. Got correctly
saved into the pdf subfolder but install exprected
it in the doc folder.

Removed two scripts which are no longer used by hotplug.
In the early udev days the firmware had to be uploaded
by comedi_config. However now the driver requests the
firmware by itself and there is no need to have dedicated
scripts for every kernel module in udev.

automake now checks for dblatex and the pdf version
of the comedi manual is now generated

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.

Generate ChangeLog from git log during 'make dist'

Generate the ChangeLog using git log in the dist-hook target of the main
Makefile.  The git command used is:

git log --stat --name-only --date=iso

The format of the resulting ChangeLog is different to the old one that
was produced with cvs2cl.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

doc/reference.xml: Added section for comedi_polynomial_t.

The tutorial.xml contained links to a missing section for the
comedi_polynomial_t type, so I added one.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

doc/Makefile: Remove *.css files on uninstallation.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

Makefile.am: Remove 'debian' from EXTRA_DIST.

The 'debian' target doesn't exist and there is no rule to make it, so
remove it from EXTRA_DIST.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

Makefile.am: Don't bother removing CVS directories in dist-hook.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

todo: Added note about Ruby bindings disabled by default.

Signed-off-by: Ian Abbott <abbotti.mev.co.uk>

configure.ac: Use AS_HELP_STRING()

Use AS_HELP_STRING() to make the HELP-STRING arguments for the
AC_ARG_ENABLE() and AC_ARG_WITH() macro calls.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

configure: Disable Ruby bindings by default.

The SWIG Ruby bindings do not build cleanly from scratch.  They need an
existing installation of comedilib.  So disable them in the default
configuration.  They can be enabled with the --enable-ruby-bindings
configure option.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

include/comedi.h: synced with comedi

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

driverwriting.xml: COMEDI_CB_EOA is also used to report end-of-output.

driverwriting.xml: COMEDI_CB_OVERFLOW is also used to report underflows.

Add myself to the comedi.i copyright, since I just tweaked it.

I also added 2010 for:

  commit 3fe8e6baac051d80906c6fac6c18c04c8df9ce4a
  Author: Ian Abbott <abbotti@mev.co.uk>
  Date:   Mon Dec 20 14:50:21 2010 +0000

    Add sampl_t and lsampl_t array_class()es to comedi.i.
    ...
    Patch from W. Trevor King.

Suggest people use `PYTHONPATH` rather than adjusting `sys.path` internally.

The old method only worked out of the box if you were running Python
2.1 on a 586.  I imagine that is too small a slice of current users to
be worth hard coding ;).

Add myself to the old Python demo copyrights, since I just tweaked each demo.

Oops, fix copyright month on `demo/python/insn.py`.

Cast the period to an integer in `demo/python/mmap.py`'s command setup.

This avoids:

   Traceback (most recent call last):
     ...
     File ".../mmap.py", line 96, in prepare_cmd
       C.scan_begin_arg = 1e9/freq
     ...
   TypeError: in method 'comedi_cmd_struct_scan_begin_arg_set',
      argument 2 of type 'unsigned int'

Adjust `sys.path` before importing `mmap` in `demo/python/mmap.py`.

With the previous implementation, `mmap` was importing the demo
script, not the standard `mmap` library module.  From the docs [1]:

  The directory containing the script being run is placed at the
  beginning of the search path, ahead of the standard library
  path. This means that scripts in that directory will be loaded
  instead of modules of the same name in the library directory.

I'm not sure when this changed in Python, since the demo script
presumably worked with an earlier version.

[1]: http://docs.python.org/tutorial/modules.html#the-module-search-path

Cast the period to an integer in `demo/python/cmd.py`'s command setup.

This avoids:

  TypeError: in method 'comedi_get_cmd_generic_timed',
    argument 5 of type 'unsigned int'

Add serial and PWM subdevice types to `demo/python/info.py`.

This catches it up for the folowing commits to the comedi repository:

  commit 311e9c540217d60bdf56a1dba9eafe474fd3b218
  Author: Bernd Porr <Bernd.Porr@f2s.com>
  Date:   Sun Jan 13 23:07:02 2008 +0000

    Added a proper PWM subdevice for comedi.

  commit 8092ed57ff38e1fcaf75a7e0bf3b8c4f5372f3d7
  Author: Frank Mori Hess <fmhess@speakeasy.net>
  Date:   Sat Jan 31 22:13:09 2004 +0000

    serial dio (SCXI) support from Caleb Tennis

Add `chanlist_len` to `comedi_get_cmd_generic_timed()` calls in Python demos.

This catches the Python demos up to:

  commit 003b9ec501b5c69f25bfbc68e8b3f923d482bb04
  Author: Ian Abbott <abbotti@mev.co.uk>
  Date:   Mon Nov 8 11:01:42 2010 +0000

    Add chanlist_len parameter to comedi_get_cmd_generic_timed.

Add `demo/python/insn.py`, a Python clone of `demo/insn.c`.

Add an `insn_array` array_class to `comedi.i`.

This makes it possible to populate `comedi_insnslist_struct` for use
with `comedi_do_insnlist`.

I also removed my earlier re-typedefs of `sampl_array` and
`lsampl_array`.  I didn't understand the reason for the underlying
`TypeError` when I added them.  The proper way to avoid that error is
to use the `.cast()` and `.frompointer()` methods.  See
`demo/python/insn.py` (coming soon) for details.

Removed comedi_calibrate.8 man page.

The comedi_calibrate.8 man page has been moved to the comedi_calibrate
package where it belongs.  Thanks to W. Trevor King for pointing it out.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

libcomedi: don't ignore channel in comedi_set_clock_source()

Fix bug reported by Finn Hoffman on comedi email list.

m4/am-check-python-headers.m4: Python 3 wrapper for comedi

Here's a small patch to make the configure script compatible with Python
3. The wrapper itself (swig/python/comedi_python_wrap.c) will have to be
generated with SWIG >= 2.0.0 for Python 3 compatibility.

comedi_test: Remove unnecessary assignment of 'go' when checking data

The 'go' variable is only used by the 'while' loop that reads the data.
We don't need to set it in the 'for' loop that checks the data
afterwards.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

comedi_test: Fix buffer overrun in test_mmap()

If the command does not stop immediately after the last sample, there
can be more data to read than we have room for.  Make sure the 'while'
loop 'read()' does not overrun the end of the malloc'ed 'buf'.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

Fix a couple of typos.

A couple of the include files are missing the 'p' in 'published' in the
file header comment.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

COMEDILIB_CFLAGS: Fix for separate build directory.

When doing an out-of-tree build, the comedi_version.h file is in
the build tree, not in the source tree.  The CFLAGS needs an additional
-I option so the compiler can find it.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

INSTALL: Changed cvs reference to git.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

README: Update mailing list details.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

README: Changed CVS references to Git.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

README.CVS: Renamed to README.Git and edited slightly.

Signed-off-by: Ian Abbott <abbotti@mev.co.uk>

Add comedilib_version.h header, produced by ./configure,
included by comedilib.h, containing COMEDILIB_VERSION_MAJOR,
COMEDILIB_VERSION_MINOR, COMEDILIB_VERSION_MICRO, and
COMEDILIB_CHECK_VERSION(major,minor,micro).  This can be used to perform
C pre-processor checks for API changes in comedilib.

#include <sys/stat.h> needed for fstat().

Updated procedures for building with Python's distutils.  Also reduced
line-lengths for 80-character wide terminals.  Most of the updated text
supplied by W. Trevor King.  Ian Abbott added a note that it only applies
when building the wrappers separately from Comedilib without 'make'.

Add sampl_t and lsampl_t array_class()es to comedi.i.

This makes it easier (possible?) to setup comedi_insn_struct and
comedi_cmd_struct instances.

Patch from W. Trevor King.

Adjust setup.py to link against libtool's lib/.libs/.
Patch from W. Trevor King.

Revert previous commit, renaming comedi_wrap.c back to comedi_python_wrap.c.
Add "comedi_python.i" swig interface file which merely %includes the
"comedi.i" in the parent directory.  Fix paths in "setup.py" and set it up
to run swig directly (using "comedi_python.i" as the source).  Change
"_comedi.py" to "comedi.py" (but keep the underscore prefix on the .so
and .la files).
Based on a patch by W. Trevor King.

Use #ifdef SWIGRUBY around typemap(ruby,...) and remove the ruby argument.

Renamed comedi_python_wrap.c to the swig default comedi_wrap.c.

Tag comedi_sv_measure's data as a swig output in comedilib.h.
Patch from W. Trevor King.

Added W. Trevor King to AUTHORS.

Add -lm to comedilib.pc.in Libs.
Patch from W. Trevor King.

Import DESTDIR in swig/ruby/setup.rb for configurable rbconfig install paths.
Patch from W. Trevor King.

Change --disable-docbook-binding to --disable-docbook in configure options.
Patch from W. Trevor King.

Include chanlist length in call to comedi_get_cmd_generic_timed.
Truncate the Float period to an integer.

Add chanlist_len parameter to comedi_get_cmd_generic_timed.

Defined SWIG_USE_OLD_TYPEMAPS as a temporary measure to work with SWIG 2.0.

Specify EXTRA_DIST files in subdirectories explicitly.

Added channel parameter to comedi_set_clock_source() and
comedi_get_clock_source().  Bumped library version to 0.10.0.

comedi_find_range() should skip ranges that don't match specified units.

Check subdevice type.

Use negative options.value to set up time as a duty cycle.

Generates also binary format for the new comedi driver integrated into
the mainstrain linux kernel

Generates also binary format for the new kernel comedi drivers

Add brief note about dependencies for Python and Ruby bindings.

Added the installtion instructions from the Wiki and removed reference
to Debian woody packages. I had recently quite a lot of e-mails
asking about the permissions of the comedi files and every time the
the problem was that the udev rules were installed in /usr/local/etc.

comedi_get_default_calibration_path(): Check result of asprintf() for error.

Update setup.rb using i.loveruby.net/archive/setup/setup-3.4.1.tar.gz

Move "comedi_errno.h" into "include/" and install it.

Put __comedi_errno variable into thread-local storage if the compiler
supports it.  Configuration test uses Alan Woodland's 'ax_tls.m4' from
<http://autoconf-archive.cryp.to/ax_tls.html>.

Allow swig to include comedi.h and comedilib.h from comedi.i to avoid
duplication.