[comp.sources.apple2] v001ADM17: Apple Archive Format

jac@yoko.rutgers.edu (Jonathan A. Chandross) (10/29/90)

Submitted-by: jac
Posting-number: Volume 1, Administrivia: 17

I would like to thank Doug Gwyn and Peter da Silva for their help in
developing the Apple Archive Format.


	Apple Archive Format

COPYRIGHT 1990 by Jonathan A. Chandross.
All rights reserved.

The AAF is a simple archive format designed for shipping around Apple
source code.  An archive consists of a series of lines.  Each line is
interpreted according to the first character of the line.  The
interpretations are:
	=	the name of the unpacked file starting here
	-	a source line to be unpacked into the current file
	+	end of archive.
Lines beginning with any other character are simply output to the console.

A simple example of this format:
	From: reagan@ciavax.mil
	To: freeworld
	Subject: My first program.
	Here's some great code.  Haven't had this much fun since
	I almost started WWIII.
	-	printf("Hello World\n");
	-Test out a C compiler; just compile and execute.
	+ All done.

This file would create the files "helloworld.c" and "Read.Me".  When
the archive was unpacked, all of the non-source and non-file-name
lines would be output to the console until the '+' was encountered.

Using '=' to specify a file name and '-' to specify a line of source
allows a standard USENET or email file to be unpacked without removing
any preamble or trailing information.

The '+' at the end of the file indicates the end of an archive.  Lines
occurring past this point will not be processed at all.

The '=' and "+" sentinels are due to Doug Gwyn.



To get something posted to comp.sources.apple2, send it to:
	Internet: jac@paul.rutgers.edu
	UUCP: rutgers!paul.rutgers.edu!jac

Please mark comments that are not to be posted with "Not for Posting".
Otherwise, I often can't tell.

Jonathan A. Chandross
Internet: jac@paul.rutgers.edu
UUCP: rutgers!paul.rutgers.edu!jac