Documentation production from a formal database

  • Authors:
  • Christopher Hartsough;Yuzo Yamamoto;E. David Callender

  • Affiliations:
  • Jet Propulsion Laboratory, California Institute of Technology;Jet Propulsion Laboratory, California Institute of Technology;Jet Propulsion Laboratory, California Institute of Technology

  • Venue:
  • SIGDOC '82 Proceedings of the 1st annual international conference on Systems documentation
  • Year:
  • 1982

Quantified Score

Hi-index 0.00

Visualization

Abstract

This paper reports on an existing, operational prototype system, TG/TF2, for the generation of typeset quality documentation from a formal database. TG/TF2 directly supports the conceptual separation of system design, document content design, and document format design. Specifically, support for system design is supplied by Problem Statement Language/Problem Statement Analyzer (PSL/PSA), a development of the ISDOS Project at the University of Michigan. Document content design support is provided by the Text Generator (TG) language system. Text Formatter, Version 2 (TF2) supports document format design. TG is a programming language system specifically tailored for accessing a PSL/PSA database. TG supports document content design through an outline facility that allows the specification of both the order and conceptual content of each section of the document. TF2 provides typeset quality output from the text generated by TG. Though similar in flavor to most “pretty printer”/RUNOFF programs, TF2 has been tailored to the requirements of automatic document production without human intervention. The paper describes the improvements needed in both concept and implementation before the prototype system can be made into an operational tool. The motivation, genesis, and conceptual basis of TG/TF2 are treated, not the details of the software.