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.