Docfiler
A tool for and reading long documents on the
SD-Card
This tool makes it easy to read books or other long documents, even
scientific papers, directly on
the calculator. Long documents may be located anywhere on the 49+ but should
preferably be stored on the SD-card. If no card is inserted, Docfiler scans
HOME. Not only in standard ports but also on the card they may be
spliitted in sections or chapters. Docfiler fully supports a directory
structure on the card. For instance, one may have a directory BIBLE with
files CHAPTER1, CHAPTER2,... and BIBLE itself may be a subdirectory of
a directory BOOKS, say. You may read in minifont (default) or
larger font. Tested in ROM 1.23. And you have the choice between Docfiler7
and Docfiler8 which have different page setters. Only HP49G+
in RPN mode.
What is new?
Version 8.2004. Like 7.2004 but leafing through the pages is done
in reading mode, like in Headman. An updated version 7.2003 remains in the
packe.
Version 7.2004. + and - are leafing through forward
and backward in the page setter. The arrow keys serve only scrolling text in technical
documents or if reading in fonts other than minifont.
Version 6.2004. Text scrolling in Edocu much faster. Option for read
in minifont or current font.
Version 5.2004. Selftest whether BZ-string file decompresses to string.
Version 4.2004. No flag dependance anymore by modifying the application
menu of Docfiler. This text revised.
Version 3.2004. Option Read distinguishes book mode (text will be
formated to fit the screen width) and technical document mode (author
formats the text himself) by user-flag 1.
First version 2.2004, made February 2004.
Docfiler is a browser related to the card browser of the
standard filer but
simpler. It immediately scans the card if present together with the one-page menu
Ebook Edocu COPY
PURGE RCL TREE
Options
in upper case are well known from the filer. These will probably seldom
be
used in Docfiler. Some additonal hard keys are active as in the filer. For instance,
the arrow key
enters a selected subdirectory,
goes UPDIR (mostly
to the TREE).
NXT just toggles the browser look since there is one menu page only. T (= COS)
is for type
sorting and may occasionally be useful. For other hard
keys consult a filer documentation. The most interesting menu options are Ebook
and Edocu
for reading long documents. These options are explained in more detail below
and work only on text files
(strings)
which may also be BZ-compressed. They will error
if no text file is scanned or if a BZ-string does not decompress to a normal string.
Long text files are usually made on a PC and directly saved on the card.
There is an example CrDocfiler.S in the package. Simply
load and execute it. This creates
the dicrectory DOCS on the card containing a compressed source text of Docfiler7.
It may be read also with Edocu to see that a code object (the decompressor)
has been broken in parts if reading in
minifont. Long text files are usually made on the PC and directly
stored on the card. Compressing on the PC is easily made with an emulator.
One may do
BZ-compression also on the 49+, e.g., with OT49. Such a file can be stored
anywhere, in particular in a card directory. The path of a file
foo in a card directory bar is a
tagged string.
:3:"bar1/bar2/.../bar/foo"
Only a path of this kind is a valid argument for STO and RCL.
Clearly, you may add stylings for parts of
your text with Style from the EDIT menu, e.g., underline or print in italic
etc.
Details on Ebook and Edocu
Ebook is for reading long flowing texts. It breaks the lines properly to match the screen
width like a HTML reader, thus making sidewards scrolling dispensable. Edocu
respects the original text format (more precisely, breaks only lines of more
than 80 characters). Suitable for technical documents containing
formulas or tables too broad for the screen width. Both options interpret
the first line of a
scanned string file as the title, the rest is divided into pages. First a page-selector is launched for choosing a
start page. By pressing the CHOOSE option or browsing with the +/- key
any page can be selected. Also numeric keys may be used for page selection.
Confirm with OK or ENTER Leafing through the pages is done with + (forward) and - (backward),
showing together page number and total page number.
In Docfiler8 this is done while reading, in Docfiler7 in its pages setter.
Important: + and - are repeaters. If hold longer you're
leafing through several pages. While reading one always
returns to the page selector with ENTER which toggles current page and page
number. In addition, the SPC key works as a magnifying-glass. It swaps
minifont (default) with display in larger font. When starting Ebook, the text
is cut for
minifont and no text scrolling is necessary. However, for reading a technical paper
with more than 32 character lines or if reading in bigger font the arrow keys and its right-shiftings
should be used for scrolling the current page. Reading or paging can always be postponed
by turning off as usual.
Remark. Ebook and Edocu are library commands in Headman. Thus, if
Headman is present, Docfiler8 isn't needed
though it's slightly faster. For reading text with mathematical formulas load LFONT
or Mathfont from this site. Both are much better than built-in fonts.
Credits. Thanks to Tim Wessman who proposed the
creation of a card reader tool in a mail to me.
Wolfgang Rautenberg - raut@math.fu-berlin.de
- www.math.fu-berlin.de/~raut