$Id: README,v 1.1 1995/09/09 20:21:28 schrod Exp $ ------------------------------------------------------------ STIL (`SGML Transformations in Lisp') is a style sheet language to create structure-controlled SGML applications. In these applications you have neither access to the DTD nor to the original document source, instead you operate on a tree representation of the document. If you know CoST (the tree mode version) or SGMLSpm, STIL uses the same concept as these style sheet languages. The most obvious difference is the use of Common Lisp instead of Tcl or Perl5. You define classes for elements that appear in a document, instances of these classes are the inner nodes of the tree. Automatic transformation of attributes to data structures more appropriate in your task domain than simple strings is available. Elaborate handling of PCDATA is supported, too. The document tree is traversed, you can specify operations (`callbacks') that are triggered at certain points in that traversal. Within these callbacks, you have access to the full tree. STIL is software on the beta-test level. In particular, distribution and installation leaves a lot to be deserved. This is the source distribution of STIL. It has _only_ the STIL source, you won't find everything herein that is needed to use it. (E.g., the SGML parser is missing.) For installation instructions, check the file INSTALL; this file lists also all the other systems needed. There exist binary distributions for -- Linux 1.2.x (a.out) on PCs and -- AIX 3.2 on IBM RS/6000. To use these distributions you need an installed Perl (4 or 5). Unlike the source distribution, all other needed systems (e.g., an SGML parser) are part of the binary distributions. Binary distributions for Solaris 2.4 on Sparc 4m/4c and HP-UX 9 on HP 700 are in preparation and should be available soon. You'll find a short one-liner about the purpose of most files in a comment block at the top of the Imakefile in that directory. In some directories, there are additional READMEs. We are interested in feedback, both problem reports and positive ones. Please tell us what you think of STIL. It might happen to you that it's hard to express an easy task -- then it's not your fault, it's a problem instead. Tell us, we like to hear about such experiences; this will enable us to improve our software or our documentation. For your information, the file TODO lists open problems, planned enhancements, and future ideas. In case of problems, you might want to look at it, to see if we know the problem already. Reference anonymous ftp site: ftp.th-darmstadt.de [130.83.47.112] directory pub/text/sgml/stil file stil-.tar.gz where is the current version number (a gzipped tar file) LEGALESE: This package is freely distributable software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License in the file License along with this package; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Enjoy, Joachim -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Joachim Schrod Email: schrod@iti.informatik.th-darmstadt.de Computer Science Department Technical University of Darmstadt, Germany