home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / sgml / unix / vm2 / vm2help.doc < prev   
Encoding:
Text File  |  1991-07-03  |  2.2 KB  |  46 lines
  1.                  VM2.EXE User-friendly Documentation
  2.                 (for Wimps who Can't Read Source Code)
  3.  
  4. Requires: SGML.MSG in the same directory as VM2 or on the DOS path, unless
  5.           the exact pathname is specified with the /M switch (see below).
  6.  
  7. Syntax: VMI [options] entity-id [options]
  8.  
  9. Options: (syntax example: /d /e /f /g /mSGML.MSG /p1 /r /t3)
  10.  
  11. /S  Show details of SGML parsing (default: error messages only, no details).
  12. /C  Data or PI chars to print if /S specified: 0 or more (default: 10).
  13.  
  14.     NOTE TO IMPLEMENTERS: The following options are supported by the
  15.     SGML parser for all text processors.  (The preceding are unique to VM2.)
  16.  
  17. /D  Report duplicate entity declarations (default: not reported).
  18. /E  Suppress entity stack trace in error msg (default: entity trace on).
  19. /F  Files located in current directory only (default: files anywhere on path).
  20. /G  Suppress GI stack trace in error messages (default: GI trace on).
  21. /M  Pathname of error message file (default: SGML.MSG).
  22. /P  Number of passes desired: 1 or more (default: 1 pass).
  23. /R  Give warning for defaulted entity references (default: no warning).
  24. /T  SGML wants an RS before each record and an RE after it.  DOS omits
  25.     the RS from the first record of a file, but appends an RE after
  26.     the end of file so that records are not merged when files are
  27.     concatenated.  Other systems do not.  ARCSGML lets the user specify
  28.     whether an RS should be inserted before the first record of an entity
  29.     (/T1), whether the trailing RE should be deleted (/T2), or both (/T3,
  30.     the default).  (System identifiers in markup declarations can begin
  31.     with "1=", "2=", or "3=" to accomplish the same thing for other
  32.     entities.)
  33.  
  34. Entity-id:
  35.  
  36. The "entity-id" is a normal DOS file specification (with or without a
  37. drive and/or path) that identifies the SGML document entity.  ARCSGML
  38. allows a single entity to be split over several DOS files (for
  39. example, the prolog could be in one file and the document instance in
  40. another).  In this case, the "entity-id" could be a sequence of file
  41. identifiers joined with semicolons in a quoted string, such as:
  42.  
  43.    "concat1;concat2"
  44.  
  45. (See the CONCAT1.GML test case in the TESTSGML.EXE archive.)
  46.