Tom's eTextReader Version 1.8.2, May 2003 Copyright 1999-2003 Thomas Fellner, Vienna, Austria. Mail: http://www.fellnersoft.at/eTR.htm ================================================== Quick info: ---------------- Simply install the new version over any existing version. New features (more details below and in help.txt): Find text in files, page history, quick page jump / quick find, new options (Auto-open last file; activate font antialiasing), and more... --------------------- This program has been created for comfortable reading of text files, in particular Etexts from Project Gutenberg (http://www.gutenberg.net). They do a great job, in my opinion! ================================================== README CONTENTS: --------------------- INSTALLATION Setup version Zip version FEATURE HISTORY Version 1.8.2 Version 1.8.1 Version 1.8 Version 1.7 Version 1.6.9 Version 1.6.8 Version 1.6.6 COPYRIGHT INFORMATION Tom's eTextReader UPX - The Ultimate Packer for eXecutables InfoZip's UnZip32.dll UnZip32.pas ================================================== I N S T A L L A T I O N ================================================== Setup version: ------------------- Run eTRSetup.exe and follow the instructions. You do not have to uninstall any previous versions; an eTextReader.ini file already existing in your install path will not be overwritten. The setup program will associate the file extension *.etr with eTextReader. This is NOT a special file format, it rather offers a way to distinguish etexts from all the other *.txt files, which you might prefer opening with Notepad. If you rename your *.txt files (only plain text, NOT rtf, htm!) to *.etr, double clicking will open them in eTextReader. When you uninstall the program, the file eTextReader.ini will not be deleted automatically! If the saved settings are no longer needed (and to completely remove Tom's eTextReader), delete this file and the eTextReader directory. Zip version: ----------------- Extract the file eTextReader.zip into a directory of your choice. You can create a desktop symbol by right clicking on eTextReader.exe, then on Send To - Desktop. The zip-file contains these files: eTextReader.exe Help.txt Readme.txt Unzip32.dll eTextReader.exe is the main reader program. You can start it directly or create a shortcut. Help.txt describes the features of the program. Readme.txt (this file) contains version history and license information. UnZip32.dll (by InfoZip, see license statement below) must be present in the program path to open zip files. If necessary, the program will create the file eTextReader.ini, which contains global program settings and individual information for each text file (such as bookmarks or current page). If this file is missing or deleted, a new one will be created by the program with standard settings. ================================================== F E A T U R E H I S T O R Y ================================================== Version 1.8.2: ------------------- - Find text in files: Search text in all files of a selected directory (tree). The result of the search is a list of files containing the specified text. Open one of these files by double clicking on the list entry, and e.g. start a normal search to find all occurences within the file. - Page history: The left page numbers are stored in a history list, like in a web browser. Go back and forth using Alt + Left/Right arrow keys, or show/hide the whole list by right clicking on the left page number. You can also select a page from the history list. New options: - Auto-open last file: The most recent file will be opened automatically when the program starts. - Font antialiasing (Font smoothing): This option turns font antialiasing on/off. Note that this is a system-wide setting - its previous state will be restored, when eTextReader is closed. - Quick page / Quick find: Typing a number calls the "Jump to page" dialog, letters (a-z) start the "Find" dialog. Other improvements: - Copy/Paste/Find long text: Multiline text handling is improved: Copied text (Ctrl+C) contains no single line breaks; you can e.g. paste (Ctrl+V) it into the Find text field in order to search for rather long text. - HTML import: Text between emphasis tags (like B,STRONG,I,EM,DFN,VAR,CITE) is converted to capitals. - Font handling: Added several XP fonts (Mangal, Shruti, and others that do not contain Basic-Latin letters) to the internal list of excluded fonts. With these fonts, either too few or too many lines per page have been displayed. - Increased the max. page margin size from 30 to 99. - Larger and resizable zip-contents window. - Fixed a bug in rtf import. - Fixed a bug (Page, Font etc. not remembered) when starting the program via an associated file. __________________________________________________ Version 1.8.1: ------------------- - RTF and HTML import: The contents of RTF or HTML files are converted to simple text. - Multi-file zip archives: Previously, the reader always opened the first file in an archive. Now, if a zip archive contains more than one file, the contents will be shown in a list, where you can select the file to be opened. - Improved find function: Now long phrases are found, even if they span several lines or pages. The new dialog is positioned above the text area. - "Excluded Fonts" list added to eTextReader.ini. You can specify which fonts shouldn't be used by the reader, in addition to the reader's internal list of unusable fonts (already including Wingdings etc.). - "Excluded/Included Paths" lists added to eTextReader.ini. Files opened from an excluded path will leave no 'traces' in the ini-file, i.e. no file specific options are stored and the file doesn't show up in the recent files list. - The list of punctuation marks (used with the "Remove single line breaks" option) can now be edited in eTextReader.ini; colon and semi-colon have been added by default. - Window size, position and maximized state are remembered. - The table of contents now includes the beginning of each book as the first section. - Change: To abort TOC creation, you now have to press Space instead of Escape. - Minor enhancements and bug fixes. __________________________________________________ Version 1.8: ----------------- - The file Help.txt is included, providing more detailed information than 'Help' in the reader. - Increased speed. File opening, removing line breaks, fitting lines, page turning, and searching should be significantly faster now. - Table of contents: Click on 'Show TOC' (shortcut Ctrl+H), then 'Create TOC'. Click on a TOC entry to jump to a section (chapter). Click on the new symbols ('<<' and '>>') between Menu and Help or press Ctrl + Arrow key right/left to jump from one section to section. There are new options related to the TOC feature, which are stored for each file. Read Help.txt for more information about this and other features. - Because of the new 'jump to section' symbols ('<<' and '>>'), only one bookmark field remains visible, but you will still have three bookmarks if you click there repeatedly. - Right click on the empty bookmark field (between '<<' and '>>') to see the recent file list (same as Ctrl+R). - 'Disable control by mouse movement': If checked, then menu, help, TOC, and recent file list are shown/hidden by clicking rather than moving the mouse. - Page margins: You can change the margins without the pages being resized, then apply your changes by clicking 'Change to'. The 'Margins' checkbox turns them on or off. - Redesigned recent file list with shorter entries, because the base directory is removed from each path. Also, the base directory can now be changed in the reader ('Set to current path', below recent file list). - New shortcut Ctrl+Shift+R always (re-)opens the most recent file. - I wanted to spare the Ctrl+P shortcut for a future print function, therefore, I changed the 'Previous font' shortcut to Ctrl+Shift+N. - Added Space/Backspace for turning pages forward/back - Pressing Enter/Return no longer starts line fitting. - Added Tips to Help and changed some help texts. - Dashes at the ends of lines are treated in a special way: If there is a space before a dash (short '-' or long '--','---'), then there will also be one after the dash; if not, the dash will be connected immediately to the next word. - Open, Exit: Added confirmation dialogs to avoid loss of unsaved changes when a new file is opened or the program. - Save as: Now you can save the text either with or without single line breaks, if the 'Remove single line breaks' option is active. You will be asked for confirmation before overwriting an existing file. - Corrected the exit confirmation dialog. __________________________________________________ Version 1.7: ----------------- - New display mode 'Book style'. The page color is defined by the 'background color' setting. - New settings for page margins (left, right, top, bottom), measured in pixels. First set the margins, then check the 'Apply margins (pixels)' checkbox. When you change the margins, the box will become unchecked. Click the checkbox again to make the modified margin settings effective. (Note: The visible bottom margin also depends on whether another line would fit on the page. The bottom margin setting adds to any unused space below the last line.) - Redesigned menu panel, with hideable options. Click on the '>' button to show the program options (then '<' to hide). - Repositioned (more or less centered) menu and help. Both may be displayed at the same time, if you avoid the text area when moving the mouse pointer from Help to Menu (or vice versa). In that case the menu will be displayed below help. - Changed mode of hiding menu/help: In previous versions, moving the mouse pointer over bookmarks or the area above the text made the menu/help disappear, now they are only hidden when the pointer moves over the text area, or when you press the 'Esc' key, or (this is also new) when you click the right mouse button. - Fixed a bug where an indentation of the first line of a page was ignored. - Minor enhancements and bug fixes. __________________________________________________ Version 1.6.9: ------------------- - New option: Default font name and size. These settings are used for every 'unknown' text file (of which no settings are stored in the ini-file). You can change the default settings immediately after starting the program, before opening the first text file. - Recent text file shown: Now the most recent filename is displayed as a hint when the pointer is positioned over 'Recent'. __________________________________________________ Version 1.6.8: ------------------- - New options (related to 'Remove single line breaks') > Not before indentation (Space or TAB): In non-Gutenberg texts, paragraphs often start with an indentation, either made with blank space(s) or TAB(s). With this option checked, single line breaks before an indented line will not be removed. > Not after punctuation marks: For better results with those texts, where paragraphs are unindented and separated by single (rather than double) line breaks. If a line break follows a (final) punctuation mark, such as an exclamation mark, question mark, or quotation mark, then it will not be removed. - Recent files list: 'Read last' has been replaced by 'Recent', where left clicking still opens the most recent file, while right clicking brings up a list of recently opened files. Open one of these files by clicking (left) on the respective list item. Right clicking on an item deletes it from the list. The recent files list can also be accessed via a new menu item 'Recent' or by pressing Ctrl+R (Initially after starting the program, Ctrl+R will open the most recent file, later it will show the list). - Background and text colors are now persistant. - Changed editor font to Arial for more special characters. Improved editing of large files. - Info: Dragging a text file onto the program symbol, e.g. on your desktop or in Quickstart, would open that file in the eTextReader. A new instance of the reader is started for each file that you drop. The instances share the same ini-file. However, drag and drop onto the program window hasn't been implemented (yet). - Info: eTextReader provides filters for a special file extension (.etr) in the open and save dialogs. If you rename/save text files with the extension .etr, you could associate eTextReader with that extension (Folder Options/File types in Windows Explorer). All .etr files should then be displayed with the eTextReader icon (brown book symbol). Of course you could also associate the *.txt files themselves, but using the proprietary extension .etr offers a way to distinguish eTexts/books from all the other text files, which you might prefer opening in Notepad. __________________________________________________ Version 1.6.6 (versus 1.5.0): ---------------------------------- - Improved renumbering of pages: When you resize the window, change font settings, or change the 'remove line breaks' option, you should see (more or less) the part of text you've been reading before. The bookmarks are recalculated the same way. Renumbering is done by quick estimation, so don't expect the result to be perfect with every file. - Keyboard shortcuts for all menu functions, as well as for font settings, line length fitting, and opening the last read file. - Fixed page layout problem with different font styles (pages were too long or too short): Now almost any Windows font can be used, except graphical fonts like Marlett, Wingdings, etc., which are automatically thrown out of the list by the program. If you experience similar problems with any of your fonts, please send an email with the exact font name(s). I will either add those fonts to an internal 'exclude list' or maybe add a new feature, such as a user-defined font exclusion list (e.g. by ini-file). I have also added a vertical scrollbar which appears only if a page is too long for the size of the program window (so you can't miss any lines). In most cases this would mean that you have selected a graphical font, but Windows replaces the characters with a default font - so you can read the text but the line and page measures are wrong. - Rearranged / improved line break options: The former 'Break long lines' function is replaced by 'Fit line length to page width', because it can also increase line length by removing single line breaks (e.g. within paragraphs), if you selected that option. - New options (settings are stored in eTextReader.ini): > Remove single line breaks (see above). Your selection is stored for each text file in the eTextReader.ini. > Automatically fit line length: After every change of font style, font size, window size, or the 'Remove single line breaks' option the 'Fit line length ...' function is performed (for faster computers). > Fit when leaving menu: Perform line length fitting automatically if font settings have changed. > Open Menu/help only when clicked: If checked, you'll have to click on 'Menu' and 'Help' rather than just move the mouse pointer over it. > Activate keyboard shortcuts. Other changes: - Rearranged menu and help - Clicking the right mouse button over one of the pages now shows the menu at the position of the mouse pointer. - New: Text color can be changed. - New: Font settings are shown in the window title (important information for changing the font style or size with keyboard shortcuts). - Removed possibility of two text selections at the same time (on the left and right page), which might have caused confusion about which one is copied to the clipboard. - New exit confirmation request to avoid language conflicts with different versions of Windows. ================================================== C O P Y R I G H T I N F O R M A T I O N ================================================== Tom's eTextReader: ----------------------- This program is free. It is provided "as is". Though it is written with my best ability, I SHOULD NOT BE HELD LIABLE FOR ANY DAMAGE DIRECTLY OR INDIRECTLY CAUSED BY USE OF THIS SOFTWARE. You are encouraged to use, copy, and share this program free of charge. Use or distribution of this program for commercial purpose is prohibited unless you get my permission to do so. Thomas Fellner __________________________________________________ The executable and the UnZip32.dll have been compressed using UPX: The Ultimate Packer for eXecutables Copyright (c) 1996-2001 Markus Oberhumer & Laszlo Molnar http://wildsau.idv.uni-linz.ac.at/mfx/upx.html http://upx.sourceforge.net __________________________________________________ License for InfoZip's UnZip32.dll: --------------------------------------- This is version 1999-Oct-05 of the Info-ZIP copyright and license. The definitive version of this document should be available at ftp://ftp.cdrom.com/pub/infozip/license.html indefinitely. Copyright (c) 1990-1999 Info-ZIP. All rights reserved. For the purposes of this copyright and license, "Info-ZIP" is defined as the following set of individuals: Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White This software is provided "as is," without warranty of any kind, express or implied. In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of conditions. 2. Redistributions in binary form must reproduce the above copyright notice, definition, disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution. 3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must not be misrepresented as being the original source. Such altered versions also must not be misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names "Info-ZIP" (or any variation thereof, including, but not limited to, different capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the explicit permission of Info-ZIP. Such altered versions are further prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s). 4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "WiZ," "Pocket UnZip," "Pocket Zip," and "MacZip" for its own source and binary releases. __________________________________________________ I used the free Delphi translation of the InfoZip header files (Version 5.4, UnZip32.pas) done by Theo Bebekis Thanks Theo! __________________________________________________