Rautenberg Logo

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 †