Name
dtinfogen [-h]
dtinfogen admin [-h]
dtinfogen build [-h] [-T TmpDir] [-m CatalogFile] -l Library -d LibraryDescription -n LibraryShortName Bookcase ...
dtinfogen tocgen [-h] [-T TmpDir] [-m CatalogFile] [-id TOCid] [-title TOCtitle] document ... -f TOCfile
dtinfogen update [-h] [-T TmpDir] [-m CatalogFile] -b BookcaseName -l library stylesheet
dtinfogen validate [-h] [-T TmpDir] [-m CatalogFile] SGMLdocument
The DtInfo Toolkit command, dtinfogen, is used to create and modify hypertext information libraries. dtinfogen implements its functions through a set of subcommands:
The following options are available:
The admin subcommand is an interactive script for modifying an existing information library without rebuilding it. It displays a command line menu from which you select one of the following administration functions to perform on a specified information library:
Enter the dtinfogen admin command in a shell window:
CWdtinfogen admin
The following menu appears:
CW1) Copy a bookcase from another library 2) Remove a bookcase 3) List bookcases in a library 4) Rename a bookcase 5) Rearrange bookcases in a library 6) Exit Please enter your choice [1-6]
Enter the number associated with the administrative task you want to perform. dtinfogen admin prompts for additional input as required.
The build subcommand compiles a bookcase specification into a hypertext database. It validates the hypertext links, the identifier uniqueness, and the hierarchical structure of the bookcase elements. It also creates a full-text search index.
Enter the dtinfogen build command in a shell window.
To build an information library containing multiple bookcases, an example command might be:
CWbuild -l UNIXLib -T /usr/pers ProgBooks RefBooks UAdminBooks
This build command creates a document database from three bookcases (ProgBooks, RefBooks, and UAdminBooks) and reports any errors. It uses /usr/pers to store temporary intermediate files, and it deposits the database in a directory (library) called UNIXLib.
The tocgen subcommand reads the SGML-conforming source file(s) for a book and generates a hypertext table of contents.
Enter the dtinfogen tocgen command in a shell window.
To generate a hypertext table of contents for a book containing six SGML book source files, each of which contains a separate chapter, an example command might be:
CWdtinfogen tocgen -T /usr/pers -f Perl.TOC -id Perl0594 -title "Perl Table of Contents" Perl.01 Perl.02 Perl.03 Perl.04 Perl.05 Perl.06
This tocgen command generates a table of contents file named Perl.TOC with the unique identifier Perl0594 and the title PerlTable of Contents. tocgen parses the files Perl.01, Perl.02, Perl.03, Perl.04, Perl.05, and Perl.06 to produce the TOC.
The tocgen process uses /usr/pers to store temporary intermediate files during processing.
The dtinfogen update command dynamically replaces existing style sheets in the DtInfo document database.
Enter the dtinfogen update command in a shell window.
Here is an example of a dtinfogen update command used to reformat the documents and/or document sections that use the specified style sheet:
CWdtinfogen update -T /usr/pers -b ICE9 -l Brunn style
This update command reformats the documents or document sections in the Brunn information library that use the style sheet named style, that is specified in the bookcase named ICE9.
The dtinfogen validate command performs SGML validation on bookcase specifications, on individual book source files, or any SGML document.
Enter the dtinfogen validate in a shell window.
Here is an example of a dtinfogen validate command that performs validation on three SGML book source files:
CWdtinfogen validate 03.Structure.N 04.Process.N 05.BookArea.N
This validate command verifies the SGML compliance of the three files, 03.Structure.N, 04.Process.N, and 05.BookArea.N, based on their DTD(s).
dtinfo(1) , dtinfoBook.dtd - dtinfoBookdtd(5) , dtinfoStyle.dtd - dtinfoStyledtd(5) , dtinfoTOC.dtd - dtinfoTOCdtd(5)