Hey, Emacs, we're -*-Text-*- mode!

ftape-tools version 1.05, Copyright (C) 1998 Claus-Justus Heine 

The `ftape-tools' package comes with ABSOLUTELY NO WARRANTY; for
details see the file `COPYING'. This is free software, and you are
welcome to redistribute it under certain conditions; see the file
`COPYING'.

This is the ftape-tools package, for use with the ftape floppy tape
device driver for Linux. This package contains some useful utilities
for use with ftape.

NOTE:

This package alone does not suffice to use your floppy tape
streamer. You need the `ftape' device driver as well. See
`Downloading' below.


Contents
========

1. Programs contained in this package
2. Configuration options
3. Downloading

1. Programs contained in this package
=====================================

src/swapout/swapout -- force de-fragmentation of the system's RAM by
                 allocating a huge chunk of mem and releasing it
                 afterwards.

src/ftmt/ftmt -- a modified version of the GNU mt utility as comes
                 with the GNU cpio package. Tape control program. See
                 man-page for further details.

src/vtblc/vtblc -- tool for rudimentary manipulation of a floppy
                 tape's volume table segment. Try `vtblc --help'.

src/ftformat/ftformat -- Format utility for floppy tape drives. See
                 man-page and `ftformat --help'.

src/scripts/listtape.pl -- perl script to show "contents" of a tape by
                 means of the special ftape ioctl
                 "MTIOCVOLINFO". Needs `ftmt' in your PATH to work.

src/sripts/listtape.sh -- Bourne shell script that does approximately
                 the same as does listtape.pl

src/scripts/MAKEDEV.ftape -- Bourne shell script to create the device
                 nodes for the ftape driver.

src/ftape-tool/ftape-tool -- Tcl/Tk front-end for `ftmt', `ftformat'
                 and `vtblc'. Needs wish4.2.


2. Configuration options
========================

Please refer to the file `INSTALL' in this directory for generic
installation instructions. This chapter simply lists the additional
options which are understood by the `configure' script in this
directory; if you never before have used GNU autoconf generated
configure scripts then you really should read the file `INSTALL'
first. `configure --help' will give you almost the same description as
given below. The defaults for each options are given in square
brackets. PREFIX refers to the installation prefix, i.e. the directory
into which's subdirectories this package will be installed (can be
tuned with `configure --prefix=PREFIX')

Testing the programs
~~~~~~~~~~~~~~~~~~~~

  --enable-tapetests      Enable tests which require a working floppy tape
                          streamer and a spare tape cartridge. All
                          data on the tape cartridge will be erased.
                          The tests require the DejaGnu package to be
                          installed. Try `which expect' and `man 1
                          expect' to find out whether DejaGnu is
                          available. If it isn't the tests simply will 
                          be skipped.
                          [disabled]

  --with-testdev=NR       Which tape device to use for testing. Give only
                          the number, i.e. DON'T say
                          `--with-testdev=/dev/qft0' but use
                          `--with-testdev=0'. Tests will be disabled
                          if the value isn't valid.
                          [0]

Formatting the documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Pre-formatted documentation can be obtained from my web page (see
  below) in case you want to make hardcopies and can't format the
  documents yourself. If you want to make hardcopies then you need to
  use the `--enable-postscript' option. See below. The following
  extra-configuration options are available for this package (default
  values are given in square brackets).

  --with-htmldir=DIR      where the html documentation should be installed.
                          [PREFIX/share/ftape-tools/html]

  --with-sgmldir=DIR      where the sgml documentation should be installed.
                          [PREFIX/share/ftape-tools/sgml]

  --with-papersize=SIZE   paper size to use, SIZE is either a4 or letter
                          [a4]

  --with-info2html=URL    info-to-html url to use for inforef macros in
                          TeXinfo source code. There are some cgi
                          scripts which can convert info files to HTML
                          format on the fly. I know of the `info2html'
                          package and of the `info2www' package.
                          [http://localhost/cgi-bin/info2html]

  --without-infoserver    Disable the above feature.

  --with-pslatex          use postscript fonts for LaTeX. This
                          requires the pslatex package. Only meaningful
                          for the SGML derived formatted documentation [yes]

  --enable-postscript     Create and install a Postscript version of
			  the manual as well. Have a good look at the
			  `--with-papersize' option. Pre-formatted
			  versions in either Letter or A4 format can
			  be downloaded from the ftape home page (see
			  below) [disabled]

  --enable-sgml-docs      install sgml derived documentation even when
                          the same format can be derived directly from
                          the TeXinfo source code (PS, HTML). This is
                          just a fun option. I think that one should
                          use it, as the documentation is written in
                          TeXinfo; SGML is used by default to convert
                          it to a plain ASCII format.
                          [no]


Native language related options
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Please read the file `ABOUT-NLS' in this directory for information
about the following options.

  --disable-nls           do not use Native Language Support
  --with-included-gettext use the GNU gettext library included here
  --with-catgets          use catgets functions if available

Downloading
===========

Recent versions of the `ftape' driver and the related packages
mentioned above can be obtained from

                ftp://sunsite.unc.edu/pub/Linux/kernel/tapes/

or from the ftape home page

                http://www-math.math.rwth-aachen.de/~LBFM/claus/ftape/

The ftape home page

                http://www-math.math.rwth-aachen.de/~LBFM/claus/ftape/

also contains some useful links to related software and documentation.


Claus-Justus Heine <heine@math1.rwth-aachen.de>, August 1998

 LocalWords:  ftape Justus Linux src swapout ftmt mt cpio vtblc ftformat pl sh
 LocalWords:  listtape perl MTIOCVOLINFO sripts MAKEDEV Tcl Tk autoconf DejaGnu
 LocalWords:  tapetests testdev NR dev qft htmldir DIR html sgmldir sgml URL PS
 LocalWords:  papersize url inforef TeXinfo cgi www http localhost infoserver
 LocalWords:  pslatex docs NLS nls gettext catgets heine rwth aachen sunsite
 LocalWords:  unc edu LBFM claus LocalWords
