doc: add missing -lm option to command line for compiling tut1

doc: Bump to version 0.10.2.

configure.ac: Bump to 0.10.2

Bump the comedilib libtool version code to 10:2:10, so the comedilib
version becomes 0.10.2.

include/comedi.h: synced with comedi

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

lib/calib_lex.l: Add #define YY_NO_INPUT to C pre-amble

This suppresses a compiler warning about 'input' defined but not used.

lib/calib_yacc.y: Move comedi_parse_calibration_file()

Move the comedi_parse_calibration_file() function definition to the
bottom of the file.  It calls calib_yyparse() and the declaration might
not be in scope since we removed the declaration from
"lib/libinternal.h", but we know it will be declared somewhere above the
bottom of the generated "lib/calib_yacc.c" above the new location of
comedi_parse_calibration_file().

lib: fix calib_yyparse() conflict

For newer versions of Bison, the declaration of our calib_yyparse()
function in "lib/libinternal.h" clashes with that in the generated
"lib/calib_yacc.h".

Remove the declarations of calib_yyerror() and calib_yyparse() from
"lib/libinternal.h" and declare them in "lib/calib_yacc.c".

configure.ac: Replaced AM_CONFIG_HEADER() with AC_CONFIG_HEADERS()

AM_CONFIG_HEADER is obsolete and doesn't work with Automake 1.13.  Use
AC_CONFIG_HEADERS instead.

configure.ac: Move AS_LIBTOOL() and SCXI_SO_VERSION

Move the call to AS_LIBTOOL() to avoid warnings from automake 1.12.6.
Move SCXI_SO_VERSION as it is nearby!

On Gentoo Linux:
$ WANT_AUTOMAKE=1.12 ./autogen.sh
configure.ac:101: warning: LT_INIT was called before AM_PROG_AR
/usr/share/aclocal-1.12/ar-lib.m4:13: AM_PROG_AR is expanded from...
configure.ac:101: the top level
configure.ac:101: warning: AC_PROG_LIBTOOL was called before AM_PROG_AR
/usr/share/aclocal-1.12/ar-lib.m4:13: AM_PROG_AR is expanded from...
configure.ac:101: the top level
configure.ac:101: warning: LT_INIT was called before AM_PROG_AR
aclocal.m4:8669: AM_PROG_AR is expanded from...
configure.ac:101: the top level
configure.ac:101: warning: AC_PROG_LIBTOOL was called before AM_PROG_AR
aclocal.m4:8669: AM_PROG_AR is expanded from...
configure.ac:101: the top level

configure.ac: Add AM_PROG_AR for automake-1.12

This is what automake told me to do:

  $ ./autogen.sh
  ...
  automake: warnings are treated as errors
  /usr/share/automake-1.12/am/ltlibrary.am: warning: 'libcomedi.la': linking libtool libraries using a non-POSIX
  /usr/share/automake-1.12/am/ltlibrary.am: archiver requires 'AM_PROG_AR' in 'configure.ac'
  lib/Makefile.am:2:   while processing Libtool library 'libcomedi.la'
  ...
  autoreconf-2.69: automake failed with exit status: 1

AM_PROG_AR is new in automake-1.11.2.  For further details, see:

  http://lists.gnu.org/archive/html/bug-automake/2012-05/msg00009.html

doc: Add Éric Piel to comedilib manual authors and copyright

AUTHORS: Add Éric Piel

Éric started a section on language bindings (for Python in particular)
to the Comedilib manual.

doc: add a section about Python bindings

This section goes into a "Language bindings" section where description
for Perl and Ruby could also go.

comedi_board_info: improve display of external ranges.

The units for a range with internal unit code `RF_EXTERNAL | UNIT_volt` is currently
displayed as " (unknown unit 256)", for example an external bipolar
voltage range -1 to 1 is displayed as:

[-1 (unknown unit 256),1 (unknown unit 256)]

Change it to be displayed as:

[-1*EXT V,1*EXT V]

comedi_board_info: reset n_chans_for_generic_timed for each subdevice

Add variable `def_n_chans_for_generic_timed` to hold the preferred
number of channels to use in calls to `comedi_get_cmd_generic_timed()`.
Reset the `n_chans_for_generic_timed` variable to this value each time
around the loop for each subdevice before clipping the value to the
number of channels the subdevice has.

comedi_board_info: increased length of strtmp[]

`strtmp` is currently declared as `char strtmp[16]`, but that may be too
short for the calls to `unit_to_desc()` when the type of unit is
unknown.  Increase its length to 32.

doc/Makefile.am: fix maintainer-clean-local rule.

The maintainer-clean-local rule was removing the wrong file for
comedilib.pdf.

doc: Bump to version 0.10.1.

doc/install.xml: Describe comedi_num_legacy_minors.

Add some info to the Install section about reserving devices for manual
configuration using the comedi_num_legacy_minors module parameter.

etc/udev: Add z99_comedi.rules to EXTRA_DIST

Mark z99_comedi.rules to be added to the released sources, but don't
install it.

udev: Add commented out rule to set group owner to "iocard".

There is already a commented out rule in the example udev rules file
"z99_comedi.rules" to set the mode to 0660 and set the group owner to
"comedi".  Add an almost identical commented out rule to set the group
owner to "iocard" as this is favoured by Debian.

README.Git: Add dblatex to optional dependencies

configure.ac: Minor correction to example package version sequence.

Removed a stray '.'.

configure.ac: Expand rules for setting package/library version.

The comedilib manual version is usually only updated if the manual has
changed since the previous release (although it ought to change anyway
if any library interfaces have changed).  Allow a lower-case letter (or
sequence of letters) to be appended to the comedilib package version if
the only changes are outside the library sources and language bindings.

configure.ac: Bump to 0.10.1

Bump the comedilib libtool version code to 10:1:10, so the comedilib
version becomes 0.10.1.

The comedilib manual version hasn't been updated.

comedi_open has file descriptor leak

If something fails after a succesful open, cleanup fails to close the file.

The code

   cleanup:
         if(it)
                 free(it);

needs to be replaced with something like:

   cleanup:
         if (it) {
           if (it->fd >= 0) {
             close(it->fd);
           }
         free(it);

Regards

Anders Blomdell

configure.ac: Add reminder comment for updating documentation version.

The comedilib manual mentions the version of comedilib it applies to.
This is not done automatically; it is done by editing
"doc/comedilib.ent".  Add a comment to configure.ac as a reminder.

doc: Add Comedilib version number

In "comedilib.ent", Add an XML entity 'comedilib_version' expanding to
the Comedilib version '0.10.0'.  This is hard-edited in rather than set
dynamically.  Setting it dynamically would be nice but producing it from
an AC_OUTPUT() file isn't all that nice as it would end up in the
'build' tree and we'd some ugly 'make' rule to copy it to the 'source'
tree.  For now, just edit it manually as required.  At least having it
as an entity means it only needs to be set in a single documentation
file!

In "comedilib.xml", change the subtitle to mention Comedilib and the
version number, using the comediliv_version entity.

demo/tut3.c: memset options to 0 before modifying

options.verbose was used uninitialized.

demo/tut3: Removed a couple of unused variables.

demo/pwm: Removed an unused variable.

demo/pwm: Bug fix - should have called comedi_close()

The code called close(device) instead of comedi_close(device) where
device came from comedi_open.

demo/choose_clock: Fix a printf.

"Selecting master clock %d for channel %d on subdevice %d.\n"

The %d after subdevice was missing although the corresponding parameter
in the argument list was present.

comedi_board_info: Moved man page into ../man

I'm not sure if all man pages should go in the general 'man'
subdirectory or a more specific subdirectory, but as the general 'man'
subdirectory already contained a man page for comedi_config (which has
its own source subdirectory), I moved the man page for comedi_board_info
there for consistency.

Also changed the EXTRA_DIST line in man/Makefile.am.

doc/drivers.txt: Minor correction for USB-DUX-FAST.

The Devices line still showed USB-DUX-FAST as USB-DUX.

Updated the drivers.txt

Changed my e-mail address to the linux-usb-daq one to be
consistent with the driver e-mails which I also changed
to the company e-mails adress.

doc/funcref: Fix "Returns:" for comedi_to_physical.

There was a stray space before the "Returns:" heading so it wasn't
processed as intended.  Also, there was an empty line above it leading
to an empty paragraph in the DocBook funcref.xml.

doc/funcref: Add links between comedi_to_phys and comedi_set_global_oor_behavior.

doc/funcref: Moved in comedi_set_global_oor_behavior

Moved function comedi_set_global_oor_behavior out of the deprecated
section as it is associated with the comedi_to_phys function.

Moved comedi_to_phys and comedi_from_phys back to the main
section. Both comedi_to_phys and comedi_to_physical complement
each other. Comedi_to_phys is linear and very fast whereas
comedi_to_physical is more precise but requires polynomials
and calibration data.

doc/comedilib_html_config.xsl: Use numbered sections.

Change DocBook XSL parameters for HTML output to use numbered sections
(like it was before we switched from SGML to XML) and to use just the
numbers in cross references, rather than number and/or title.

doc/intro.xml: Replace a link to figure 1 with an xref.

demo/python/mmap.py: Fix buffer wraparound bug.

Fix bug reported by Ross Williamson where the code does not deal with
buffer wraparound within a chunk of data.

doc/other.xml: Add extra details about range and aref.

Add extra detail to the section on acquisition functions about the
range and aref parameters, and describe the comedi_range type.

The whole section is still a bit higgledy-piggledy and could do with
some rearrangement one day!

doc/other.xml: Small DocBook mark-up fix.

Use proper mark-up for sqrt function in slowly varying inputs section.

doc/comedilib_dblatex_config.xsl: Set function.parens to "1".

Persuades dblatex to output parentheses for all the <function> tags,
even those without <parameter> tags inside.

doc/comedilib_html_config.xsl: Set function.parens to "1".

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.

doc/reference.xml: Added CR_PACK_FLAGS()

Added description of CR_PACK_FLAGS() macro and the various flag bits.

doc/glossary.xml: A few DocBook mark-up changes.

doc/driverwriting.xml: Various changes.

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.

doc/extensions_funcref.txt: Some DocBook mark-up changes.

doc/error_funcref.txt: Some DocBook mark-up changes.

doc/dio_funcref.txt: Some DocBook mark-up changes.

doc/deprecated_funcref.txt: Some DocBook mark-up changes.

doc/calibration_funcref.txt: Some DocBook mark-up changes.

doc/command_funcref.txt: Some DocBook mark-up changes.

doc/funcref: Some DocBook mark-up changes.

doc/install.xml: Fixed a link.

doc/reference.xml: Minor change.

Used a proper cross reference to driver structures.

doc/other.xml: More DocBook mark-up changes.

More changes, mostly adding <structfield> tags.

doc/comedilib.ent: Got rid of a couple of redundant entities.

Got rid of the 'hellip' and 'uuml' entities in favour of predefined
versions of these entities.

doc/install.xml: A few DocBook mark-up changes.

doc/tutorial.xml: A few DocBook mark-up changes.

doc/other.xml, reference.xml: Slowly varying inputs and comedi triggers

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.

doc/reference.xml: Improve description of comedi_insnlist...

... by adding a link to the comedi_do_insnlist function.

doc/reference.xml: Removed some comedilib internals.

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.

doc/reference.xml: More DocBook mark-up changes.

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.