textlif

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
REFERENCES
EXAMPLES
AUTHOR

NAME

textlif - convert an ASCII file to a LIF text file

SYNOPSIS

lifutils textlif [-s SIZE] [-l] LIFFILENAME INPUTFILE > Output file

lifutils textlif [-s SIZE] [-l] LIFFILENAME < Input file > Output file

lifutils textlif -?

DESCRIPTION

textlif generates a LIF file from a text file. The program reads the text from standard input or the file specified by the command line paramter INPUTFILE and writes the LIF file header and the LIF formatted text to standard output. This file type can be used on the HP-71 (TEXT) or the HP-41 extended Memory or HEPAX file system (ASCII).

If the text file is to be used on the HP-41, the -s option is mandatory. The file can be directly copied from a mass storage device to HEPAX memory with the HREADFL command. However, it must be preallocated with an appropriate size with the CRFLAS command, before being copied to extended memory with the READFL command.

Note: empty (zero length) lines are ignored when transferring from a mass storage device to the HP-41.

OPTIONS

-s

This option specifies the file size in registers which shall be allocated for the resulting file in the HP-41 extended memory or the HEPAX file system. If a value of 0 is specified the number of register is determined from the size of the input text file. According to the HEPAX documentation the maximum file size is 577 registers. The minimun and allocated number of registers is printed to standard error.

-l

Relax file name checking, allow underscores in LIF filename.

-?

Print a message giving the program usage to standard error.

REFERENCES

The HP text file format is documented in section 11.2.8.1 of the HP71 Software Internal Design Specifications Volume 1 (Hewlett-Packard)

EXAMPLES

If demo.txt is an ASCII text file then

cat demo.txt | lifutils textlif DEMO | lifutils lifput lifimage.dat

will put the LIF text file with the name DEMO into the LIF image file lifimage.dat

AUTHOR

textlif was written by Joachim Siebold, bug400@gmx.de using code from Tony Duell, ard@p850ug1.demon.co.uk and has been placed under the GNU Public License version 2.0