CRLF3 vers 1.3.0 16 October 1993 Copyright 1993, Windsong Software 1. About CRLF3 One of the best things about the computer age is standardisation. Everyone has their own. One "standard" is the format of "plain" text files. If a file is described as "text", you can usually safely assume that the data is encoded using the ASCII character set. However there are at least three different "standard" ways of marking the end-of-line in a text file: Apple: lines are terminated with Carriage Return ($0D) *nix: lines are terminated with Line Feed ($0A) MS-DOS: lines are terminated with both ($0D, $0A) I often find myself unpacking archives from cyberspace on my GS which turn out to contain text files in a non-Apple format. CRLF3 is a desktop program to quickly and easily determine the format of a file, and to convert files from one format to another. Warning: CRLF3 will not work with any release of GS/OS prior to 6.0 2. Installation If you've gotten as far as reading this documentation, you've probably unpacked the archive and found that it also contains the CRLF3 program file, and an icon file. If you want to use the icon, move the icon file to a folder called ICONS on the disk you intend to place CRLF3. Then put CRLF3 anywhere you like - except the trash can. 3. Detailed Instructions I've bent over backwards to make CRLF3 easy to use, and most of it should be pretty self-evident. To convert a file, you specify an input file and an output file, and CRLF3 will rip through and swap every occurence of the "source" mode end-of-line marker to the "destination" mode end-of-line marker. To set the source and destination modes, use the Set Modes option in the Options menu. To analyse a file to determine what sort of end-of-line markers it has, use the Analyse option under File. Note that only files with these filetypes can be opened for use with CRLF3: UNK filetype $00 BIN filetype $06 TXT filetype $04 SRC filetype $B0 A file can be deleted using Delete from the File menu. Files can be viewed using View from the File menu, and converted using Convert from the same menu. Output files are saved with filetype TXT ($04). 4. Distribution Details CRLF3 is distributed as Freeware. Copy it as far and wide as you wish - the further the better! You are under no obligation to pay WindSong Software for the right to use the program. However copyright is retained by WindSong Software, and the program cannot be sold, or included with any package for sale without licensing from WindSong Software. Finally, this document must be distributed with the program. If you have any comments about or problems with CRLF3 or (gasp!) bugs to report, please feel free to contact WindSong Software as detailed below. In fact, I'm interested to see just how far from Brisbane the program spreads - so treat any copy like a tagged bird - let me know where you got it from and when! WindSong Software can be contacted by e-mail via: Robert Hook, Apple-Q BBS, 61 07 851 1711 rahook@ozspace.brisnet.org.au cashook@cc.uq.edu.au (but not for much longer) or by writing to Robert Hook, WindSong Software, c/o 17 Bargo St, Arana Hills, Qld, 4054 Australia. 5. Release Notes Version numbers consist of a major and minor revision number. Changes in a major revisision number indicate a dramatic modification to the program, while minor revisions are bug fixes and minor modifications. The '3' in CRLF3 is because there is an APW/ORCA shell program from WindSong which can be used to convert files in a similar fashion. It's distributed as part of the WindSong Utilities set, which is a slowly growing set of *nix look-a-like tools. And since the shell program was at version 2.x, then the desktop program became 3.0... 1.0 (3/3/93) First public Release 1.01 (11/3/93) Delete option correctly reports result of actions. Corrected some grammatical errors in this document. 1.2 (11/4/93) Made a lot of internal modifications to bring CRLF3 into line with the GS/OS 6.0 way of doing things, and made a bunch of things resources rather than hard-coding them. This results in some minor changes in the user interface, (such as supporting system sounds) but doesn't affect how you use CRLF3. 1.2.1 (15/4/93) Oops - some calls to SysBeep2 should stay silent if the Sound CDev or some other system facility to handle special sounds isn't running - otherwise it produces a really annoying beep. 1.3 (16/10/93) Extend filetypes used to include $00. Modified to use SFMultiGet2 and thus convert multiple files. 6. Acknowledgements CRLF3 was developed using ORCA/C. Some code was generated using DesignMaster. This program contains material from the ORCA/C Run-Time Libraries, copyright 1987-1993 by Byte Works, Inc. 7. Coming Soon Depending on the response I get from this release, and my own requirements, CRLF3 may be extended to convert to/from Appleworks and Teach documents. The other major project in the pipeline is a desktop QWK reader/mailer system, and an improved backup program. Keep your eyes open also for YAC.NDA and FAMOD from WindSong. The former is an analogue clock (you know, with hands), and FAMOD is a little NDA allowing modification of most file attributes. Both have been released for a while, and hopefully have spread far. 8. Easter Egg For all you Easter Egg hunters out there - there's an egg in the About option.