SGML Project 						Jan. 24 1992
						revised Feb. 19 1992
						revised Feb. 20 1992


arcsgml

Appended below is the README file included with the orginal distribution of
ARCSGML parser materials from the SGML Users's Group.  

The original files were intended to run on a PC under DOS.  However, this
directory also contains a port of the files from DOS to UNIX, performed
by James Clark (arcsgml-1.0jclark.tar.Z), and a port to the Macintosh by
Wally Wedel.

You may get copies of the original files packed into a single file, or
individually.  See below for details.


NAME			TYPE		CONTENTS

arc-sgml-10.hqx.Z	File		All the original files ported to
					Mac by Wally Wedel
					(see note *1 at end of file)

arcsgml.tar.Z		File		All the original files (DOS)
					(packed using tar and compress)

arcsgml-1.0jclark.tar.Z File		All the original files ported to 
					UNIX by James Clark
					(packed using tar and compress)

arcrexx.exe		File		Original file (packed with pkzip)

arcsgmlc.exe		File		Original file (packed with pkzip)

arcsgmlh.exe		File		Original file (packed with pkzip)

arctest.exe		File		Original file (packed with pkzip)

arcvm2.exe		File		Original file (packed with pkzip)

pkz110ex.exe		File		Shareware - required to unpack 
					the above files.

(NB1. despite what the orginal readme file says, several people have reported 
that when they unpacked the self-extracting archive files using these
instructions, the files were unpacked into the current directory rather than
any they specified).

(NB2. several users who have down-loaded these files and examined the code
have reported finding bugs.  Various patches, ports and updates of the ARCSGML
code are now in existence. It is hoped that some of these will be made 
available via the SGML Project's SGML Library.  In the meantime, please keep 
an eye on the various SGML-related newsgroups and discussion lists.)


++++++++++++++++++++++++++ Original readme file ++++++++++++++++++++++++++++++



      Standard Generalized Markup Language Users' Group (SGMLUG)
                 SGML Parser Materials (ARCSGML 1.0)

In addition to this README file, there are six "self-extracting"
archive files in the ARCSGML 1.0 distribution.

ARCVM2.EXE    Executable SGML markup validator (sample application).
ARCSGMLH.EXE  Documentation and C language header files (read LICENSE.DOC).
ARCSGMLC.EXE  C language source code for the ARCSGML toolkit.
ARCREXX.EXE   Source code for Personal REXX interfacing to ARCSGML.
ARCTEST.EXE   Contains test cases for use with the toolkit.

PKZ10EX.EXE  Explained below (not part of ARCSGML)

A "self-extracting archive" is an executable program (in this case,
for PC DOS machines) that when executed extracts multiple files from
an archive within itself, and stores them on a disk specified by you.

Usage: ARCSGML [options] [d:path] [file...]

Options are:
  -o = overwrite existing files          -t = test zipfile integrity
  -n = extract only newer files          -e = extract files (default)

d:path = Output drive and/or path.
file   = Name(s) of files to extract. Wildcards *,? ok. Default is ALL files.

If you just type the drive and filename of the archive
the files will be extracted into your current directory.
You will probably want a separate directory for each archive, just to
keep things straight.  For example, if the archives are on a floppy in drive A, then:
you could do something like this:

c:
md \arcsgml
md \arcsgml\source
md \arcsgml\test
md \arcsgml\rexx
a:arcvm2   c:\arcsgml
a:arcsgmlh c:\arcsgml\source
a:arcsgmlc c:\arcsgml\source
a:arctest  c:\arcsgml\test
a:arcrexx  c:\arcsgml\rexx

The archives are in the popular "PKZIP" format.  More information (and
the code for creating and unpacking archives) can be found in
PKZ10EX.EXE, which is itself a self-extracting archive.  Note that the ARCSGML
archives are self-extracting and do not require PKZ10EX.EXE.  It is being
distributed only to comply with the license conditions for non-profit
organizations that use PKZIP.

NOTE: PKZIP is not part of the ARCSGML package.  PKZIP is shareware
which is distributed for evaluation, but which must be paid for if you
decide to keep and use it.  There is no charge for ARCSGML (see
LICENSE.DOC in the ARCSGMLH archive).


---------------------------- Notes ------------------------------------

*1 Once you have got the files, unpack them using the "uncompress" utility.
   (Check that the file has not been corrupted in transmission.  All the
   lines should be 80 characters long; we found that the trailing spaces
   on the very last line of the file had been removed by a `helpful'
   mailing system!  We had to restore them before converting the file.)

   Transfer the files to a Mac and convert them using BinHex 4.0.

   Run the resulting self extracting archive file (.sea)

   Run the resulting make files etc. (it helps to have Programmers Workbench
   and a (Think) C compiler + library).