Short: AmigaGuide to text (v2). E & C source. Author: m88jrh@uk.ac.ox.ecs (Jason R. Hulance) Uploader: m88jrh@uk.ac.ox.ecs (Jason R. Hulance) Type: text/hyper Ag2Txt (v2) =========== Ag2Txt converts AmigaGuide files to highlighted text. This text may be read using a standard text reader, or may be sent to a suitable printer. (The Amiga printer drivers handle the ANSI codes produced.) There are three different versions of this program in the archive: two written in E (one for AmigaDOS 1.3 and one for 2.0+), and one in C. All three versions have the following syntax: ag2txt [ ] The is an optional output file. If it is not specified or cannot be opened then the output is written to the terminal (stdout). Version 2 of Ag2Txt knows a lot more AmigaGuide codes and handles them a lot better than version 1. Also, version 1 omitted the C version, which was subsequently requested by a number of people. You can customise the output by fiddling with the source. The ansi codes used are confined to the function 'write_ansi' near the top of the source. One list is for turning on the appropriate attribute, and the second is for turning it off. The C version is particularly dumb because the Xterms I use at work don't understand the 'turn off' codes so I took them out (and used just the 'set to plain' code, '\e[0m'). The AmigaDOS 2.0+ version uses the buffered I/O functions to gain a huge performance increase compared to the unbuffered I/O used in the AmigaDOS 1.3 version. Also, the 2.0+ version uses Michael Zucchi's excellent 'async' module that comes with E v3.0 to get an extra 1/3 speed up (for reading, since 'async' doesn't do writes... yet??). Legal stuff: The programs in this archive are Copyright (C) 1994, Jason R. Hulance. Apart from that the GNU Public License (Version 2) holds. ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 7485 2172 70.9% 16-Aug-94 09:49:12 ag2txt.c 4836 2516 47.9% 15-Aug-94 21:13:40 ag2txt13 7265 2191 69.8% 16-Aug-94 09:09:40 ag2txt13.e 5296 2877 45.6% 15-Aug-94 21:13:42 ag2txt20 7187 2198 69.4% 16-Aug-94 09:09:46 ag2txt20.e 1858 984 47.0% 16-Aug-94 09:50:00 ag2txt_v2.readme -------- ------- ----- --------- -------- 33927 12938 61.8% 17-Aug-94 03:36:32 6 files