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>
This commit is contained in:
Ian Abbott 2012-02-13 11:36:13 +00:00
parent 2665ee5627
commit b09e05a776
2 changed files with 2 additions and 167 deletions

View file

@ -1,5 +1,5 @@
EXTRA_DIST = comedi.7 comedi_calibrate.8 comedi_config.8
EXTRA_DIST = comedi.7 comedi_config.8
man_MANS = comedi.7 comedi_calibrate.8 comedi_config.8
man_MANS = comedi.7 comedi_config.8

View file

@ -1,165 +0,0 @@
.TH comedi_calibrate 8 ""
.SH NAME
\fBcomedi_calibrate\fR - COMEDI calibration utility
.SH SYNOPSIS
\fBcomedi_calibrate\fR [-f /dev/comediN]
.br
.SH DESCRIPTION
\fBcomedi_calibrate\fR is used to autocalibrate \fBcomedi\fR
devices. Some \fBcomedi\fR devices have the ability to
measure internal stable voltage references and control
gains and offsets using programmable DACs. On these devices,
\fBcomedi_calibrate\fR determines the proper values to
feed into the programmable calibration
DACs. These calibration settings are then
saved to a file, which can be fed to comedi_apply_calibration()
and related functions.
If comedi_calibrate finds an existing calibration file, it
will not perform a new calibration by default. It will
simply read its calibration information from the file.
This behaviour
may be overriden with the
.B \-\-calibrate
option, to force a new calibration to be performed.
After obtaining the calibration information for the board,
comedi_calibrate will then apply a calibration setting
appropriate for the specified subdevice, channel, and
range (see the
.B \-\-subdevice
,
.B \-\-channel
, and
.B \-\-range
options below). See the comedilib documentation for
comedi_apply_calibration() for more information.
\fBcomedi_calibrate\fR prints a lot of debugging information
as it runs.
.SH LIMITATIONS
\fBcomedi_calibrate\fR only works on boards that it understands.
For boards that are known to have autocalibration ability,
but are not currently supported, \fBcomedi_calibrate\fR will
output basic debugging information that is useful for
the author to add support for your device. Please send this
output to him.
.SH EXAMPLES
.TP
.BI comedi_calibrate\ \-\-file\ /dev/comediN
If no default calibration for \fI/dev/comediN\fR already exists,
perform a calibration
and save results to default location.
.TP
.BI comedi_calibrate\ \-\-calibrate
Perform a calibration, using existing calibration (if it exists) as
starting point.
.TP
.BI comedi_calibrate\ \-\-reset\ \-\-calibrate
Perform a fresh calibration and save results to default location.
.TP
.BI comedi_calibrate\ \-\-no\-calibrate\ \-\-subdevice\ subd\ \-\-range\ range\ \-\-save\-file\ cal_file
Apply calibration for subdevice \fIsubd\fR, range \fIrange\fR, using
the settings in the calibration file \fIcal_file\fR.
.SH OPTIONS
\fBcomedi_calibrate\fR recognizes the following options:
.TP
.BI \-a\ aref ,\ \-\-aref\ aref
Along with \fB--channel\fR, \fB--range\fR
and \fB--subdevice\fR, this specifies which calibration you want comedi_calibrate
leave applied to the board. The default is 0.
.TP
.B \-\-[no\-]calibrate
Force calibration to be performed (or not).
By default, comedi_calibrate will only perform a new calibration if
no existing calibration file is found (see \fB--save-file\fR).
.TP
.BI \-c\ channel, \-\-channel\ channel
Along with \fB--subdevice\fR, \fB--range\fR
and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
to leave applied to the board. The default is 0.
.TP
.B \-\-[no\-]dump
Perform (or not) dump of various information about
state of calibration prior to performing new calibration.
.TP
.BI \-f\ /dev/comediN, \-\-file\ /dev/comediN
Perform calibration on device \fB/dev/comediN\fR.
.TP
.B \-\-help
Print help for options then exit.
.TP
.B \-q, \-\-quiet
Don't generate output to stdout.
.TP
.BI \-r\ range ,\ \-\-range\ range
Along with \fB--channel\fR, \fB--subdevice\fR
and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
to leave applied to the board. The default is 0.
.TP
.B \-\-[no\-]reset
Reset (or don't reset) calibration subdevice to
a reasonable starting point before
performing calibration. The default is \fB--no-reset\fR. If
\fB--no-reset\fR is used, the calibration routine will try to use
an existing calibration (see \fB--save-file\fR) as a starting point.
This is useful if
a single calibration
pass is not sufficient, and you wish to perform another calibration
pass starting from the results of the previous pass.
.TP
.B \-\-[no\-]results
Perform (or not) dump of various information about
state of calibration after performing new calibration.
.TP
.BI \-S\ file ,\ \-\-save-file\ file
Save calibration information to specified file,
instead of default location. If the file already exists, comedi_calibrate
will also use its contents as a starting point for the calibration pass (see
\fB--no-reset\fR).
.TP
.BI \-s\ subdevice ,\ \-\-subdevice\ subdevice
Along with \fB--channel\fR, \fB--range\fR
and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
to leave applied to the board. The default is 0.
.TP
.B \-v, \-\-verbose
Generate more verbose output to stdout, can be specified multiple times
.SH SEE ALSO
\fBcomedi\fR(7)
.SH VERSION
0.7.x
.SH AUTHOR
David Schleef, <ds@schleef.org>
Frank Mori Hess, <fmhess@users.sourceforge.net>