home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / sgml / unix / rexxsgml / rexxsgml.doc < prev    next >
Encoding:
Text File  |  1991-07-03  |  2.7 KB  |  60 lines
  1.       Standard Generalized Markup Language Users' Group (SGMLUG)
  2.                    REXX API for ARCSGML (REXXSGML)
  3.  
  4. REXX is a user-friendly interpreted programming language that allows
  5. rapid development of programs.  It is particularly strong in parsing
  6. and string manipulation, and is therefore self-recommending as a tool
  7. for "translating" SGML documents for processing by non-SGML
  8. applications such as word processors.  It is also convenient to use,
  9. as you simply create the program with a text editor and then run it --
  10. no compilation or linking is necessary.  (This despite the fact that
  11. REXX programs can be highly structured, with both internal and
  12. external functions.)
  13.  
  14. The Personal REXX product is required in order to use REXXSGML.  For
  15. information, contact:
  16.  
  17.   Mansfield Software Group
  18.   P.O. Box 532
  19.   Storrs, CT 06268
  20.   U.S.A.
  21.   Phone: +1 203 429-8402
  22.   Fax:   +1 203 487-1185
  23.  
  24. The ARCSGML materials allow the construction of interfaces between
  25. REXX programs ("macros") and the services of parsers constructed with
  26. ARCSGML.  They include source code (in C) for one such interface,
  27. called REXXSGML.  It was compiled with the C compiler of the Borland
  28. C++ IDE, but could be converted to Microsoft C by changing the names
  29. of the predefined macros that identify the memory model.  The small
  30. memory model was tested, but the low-level subroutines supplied by
  31. Personal REXX also appear to support the medium and large models.
  32. (Those routines -- FINDINT and REXCALL -- are required in order to
  33. build REXXSGML.  The header file, REXCALL.H, is required in order to
  34. compile REXXSGML.)
  35.  
  36. Also included is a sample REXX program (RSDEMO) that illustrates the
  37. use of REXXSGML by printing some of the information returned by
  38. ARCSGML.  REXXSGML and RSDEMO have been tested on PC-DOS 4.01 with
  39. Release 2.0 of Personal REXX, by Mansfield Software Group.  (However,
  40. there is no reason to suspect release dependencies.)
  41.  
  42. The REXXSGML materials were designed and developed by Roy Engehausen.
  43. Conversion to ANSI C was performed by Jack Steitz.
  44.  
  45. The REXXSGML archive includes the following files:
  46.  
  47. Documentation
  48.    rexxsgml.doc  Documentation for REXX API (this file)
  49.    rexxsgml.chr  Function call hierarchy report (courtesy of Pierre Richard)
  50.    rexxsgml.mak  Build list ("makefile") for REXXSGML.EXE
  51.  
  52. Ready-to-run REXX application: RSDEMO (requires REXXSGML)
  53.    rs      .bat  Runs RSDEMO.REX on SGML documents of your choosing
  54.    rsdemo  .rex  Sample REXX program using REXX API to ARCSGML
  55.  
  56. REXX to SGML interface: REXXSGML
  57.    rexxsgml.exe  Executable REXX to ARCSGML interface: runs REXX programs
  58.    rexxsgml.c    Establishes SGML "resident environment" for REXX programs
  59.    sgmlapir.c    Provides SGML API functions, returns results as REXX variables
  60.