RCONN@WSMR-SIMTEL20.ARMY.MIL (Rick Conn) (03/07/91)
For those of you interested, here is a copy of the release notice
on the DID templates in the Ada Software Repository. While they can
be used with any text formatting system (with some effort), they are
designed to be used with the Portable Text Formatter (PTF), the source
code to which is also in the ASR.
Rick Conn, ASR Manager
Ada Software Repository Release Notice
Release of: DoD-STD-2167A Templates
------------------------------
1. Taxonomy:
TEXT MANIPULATION
DOD-STD-2167A DOCUMENT GENERATION
DID TEMPLATES FOR PTF
------------------------------
2. Author:
Richard Conn
Ada Software Repository
------------------------------
3. Rights:
PUBLIC DOMAIN
------------------------------
4. Abstract:
This system is a collection of templates for all the
Data Item Descriptors (DIDs) documented in DoD-STD-2167A.
These templates are to be edited and tailored by the user
for his specific project. They contain instructions to the
user, telling him what items of information to insert at
various points in the template. The user replaces these
instructions with the information itself, transforming the
template into the document. Once the tailoring is complete
and all items required by the DID are filled in by the user,
the user may then execute the Portable Text Formatter (PTF)
to process the edited template into the formatted
deliverable document. The required section numbering, page
numbering, headers, table of contents, list of figures, list
of tables, and index will be generated automatically by PTF
in the format required by the DID.
This system consists of two sets of files: (1) the
common files, which are filled in once by the user and are
then read by the templates during their processing by PTF,
and (2) the DID templates themselves, where each
DoD-STD-2167A DID maps to one of the DID templates. The
common files provide information, such as the name of the
system, an overview of the system, and a list of acronyms,
which are needed by all or most of the DID templates. The
common files eliminate duplication of effort on the part of
the user by putting information needed by one or more DID in
a common location that can be read by the template. The DID
templates contain all the PTF commands and instructions to
the user for their use. The user instructions are always
enclosed in square brackets ([]), and, as the user works
with a template, he can read the instructions, input the
required information, and then delete everything within the
square brackets as he goes. The instructions in the square
brackets are, in effect, replaced by the information of the
DID itself. In some cases, the DID templates are
stand-alone; the user does not need to refer to the
DoD-STD-2167A DID to fill out the template. In other cases,
the DID template refers to the DoD-STD-2167A DID for more
information.
The documentation provided with this system is a
Software User's Manual (DID DI-MCCR-80019A) and a Version
Description Document (DID DI-MCCR-80013A). This
documentation was prepared as outlined above from the
respective DID templates and provides a living example of
this system in action. Other examples of this system in
action can be found in the Ada Software Repository (ASR) in
the Proposed MIL-HDBK-1804 documents and in the
documentation for the Portable Text Formatter (PTF).
This system represents an interpretation of the
DoD-STD-2167A document and its DIDs, and, while great care
was taken to be correct, errors may have been introduced.
Please report any such errors to the Manager, Ada Software
Repository. This system is a project of the Ada Software
Repository activity at White Sands and is not necessarily
endorsed by the United States Department of Defense as an
official representation of DoD-STD-2167A.
------------------------------
5. Directory Listing:
Directory PD2:<ADA.DOD-STD-2167A>
File Name Bytes Lines
--------------- -------- ------
DID2167A.INC 816 36
DID2167A.PRO 5502 101
DID2167A.SRC 186913 6085
DIDDOC.INC 89 7
DIDDOC.SRC 55308 1883
DIDSUM.DOC 52748 1675
DIDVDD.DOC 27500 1117
=============== ======== ======
7 Files 328876 10904
-------