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 have the choice to read in minifont (default) or
larger font. Tested in ROM 1.23. Only HP49G+
in RPN mode.
What is new?
Version 7.2004. Now + and - are leafing through forward
and backward. 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 options are on hard keys 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, explained in more detail below. These
options works only on text files
(strings)
which may also be compressed. They will error
if no text file is scanned. They also error on a BZ-string not decompressing to a normal string.
Long text files are usually made on a PC and directly saved on the card.
There is an example CrDOCS in the package. Simply
load and execute it. This creates
the dicrectory DOCS on the card containing a compressed source of Docfiler.
It may be read also with Edocu to see that the code object (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 Paging is done with + (forward) and - (backward).
The page number to be set and the total page number are briefly flashed.
Important: + and - are repeaters. Hit these keys shortly, otherwise you may
leaf through several pages which sometimes is useful as well. Holding down long enough easily returns to the first/last page. 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 scrolling is necessary. However, for reading a technical paper
with more than 32 character lines or if reading in bigger font you have to
use the arrow keys and perhaps its right-shiftings for scrolling the current page. Reading a many-page text can always be postponed
by turning off as usual.
Remark. Ebook and Edocu are library commands in Headman. Thus, Docfiler isn't needed if
Headman is present
though the page-setter of Docfiler is faster and perhaps more convenient. 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