The compiler can tell the difference between the two types of reference by the form of highlighting immediately before the cross-reference entry.
For a full list of the tags and their definitions, refer to Appendix A, ``DOSBook Formatting Tags''.
DOSBook Database Codes
There are special codes within DOSBook that are used to create
the links, pop-ups, and highlights. The codes are used for the following:
|In DOSBook||In ASCII|
|For a pop-up||<M=>word<D><$R[P#,reference]>|
|For a link||<MO>word<D><$R[P#,reference]>|
|Index Entry||<$Iprimary entry;secondary entry>|
@BULLET = <$IDisks;hard disks>If you are planning to <B>install<D> the operating system on your hard disk, the disk must be prepared (<M=>formatted<D><$R[P#,format]> and divided into <M=>partitions<D><$R[P#,parti]>). A DOS primary partition (normally drive C:) must exist on your hard disk for the operating system. If you are using a new disk that has not been prepared, however, the INSTALL program will automatically detect this and run a program called FDISK <$M[hard-disk]>to prepare the disk. Refer to the section called <MO>Preparing a Hard Disk (FDISK)<D><$R[P#,prep-disk]> in this chapter.
In this example, the codes have been inserted by the author. The codes are described in the following table.
|@BULLET=||A DOSBook formatting tag. Refer to the table in Appendix A, "DOSBook Formatting Tags" for a complete list of these.|
|<$IDisks;hard disks>||An index entry. The phrase "Disks;hard disks" will only appear on the index screen.|
|<B>install<D>||A bold. The phrase "install" will appear bold in the text.|
|<M=>partitions<D><$R[P#,parti]>||A pop-up. The phrase "partitions" will appear bold in the text. The database codes themselves are not visible.|
|<MO>Preparing a Hard Disk (FDISK)<D><$R[P#,prep-disk]>||A link. "Preparing a Hard Disk (FDISK)" will appear bold in the text. The database codes themselves are not visible.|
|<$M[hard-disk]>||A marker. Used in conjunction with a reference to complete a link.|
SVF2OLH [/?|/H] [d:][path]filename.ext [switches]Command Switches
|/? or /H||Displays the help text.|
|/L <name>||Specifies the name of the help on help (.HOH) source file; name can be any text string. If you do not specify a path to this file, the compiler assumes the file is located in the same directory as the .PUB file.|
|/T <title>||Specifies the database title. The title must always be given. Although you can use any text string, as the title is displayed at the top of the window, it is best to use the command name, in this case DOSBook, as the title.|
|/V||Verbose mode. As the compiler scans through the publication file, it lists the file it is currently reading.|
|/E||Produces a file containing all errors and warnings. The filename is the same as the publication filename but the extension is .ERR rather than .PUB.|
|/O||Produces a file listing locations of index entries, references and markers. The filename will be the same as the publication filename but the file extension will be .OUT rather than .PUB.|
|/C <name>||Country code.|
|/P <num>||Code page.|
SVF2OLH /V/E/L DOSBOOK /T ``DOSBOOK'' DRDOS.PUBThe .HOH file should be in the same directory as SVF2OLH.EXE unless you use the /L switch, in which case it must be in the same directory as the .PUB file.
OLH2CLH [/?|/H] [d:][path]filename.ext [switches]It will only compress languages which have spaces between words; therefore it would not compress a language such as Japanese.