37.3.1 Command-line switch -f format

The DCL -f switch specifies the output format, with an optional suffix that generates additional processing for certain formats.

The -f options have the following meanings: 

Format name	Optional suffix	Description
HTML	F L	HTML 4.0
XHTML	F L	XHTML 1.0
HTMLHelp	F L C I B	Microsoft HTML Help
JavaHelp	F L C I B	JavaHelp
OracleHelp	F L C I B	Oracle Help for Java
EclipseHelp	F L C I B	Eclipse Help
OmniHelp	F L C I B	Cross-platform OmniHelp
DITA	F L	DITA XML
DocBook	F L	DocBook XML
XML	F L	Generic XML
Word	F L	Word 8/97
7	F L	Word 7/95
P or WordPerfect	F L	WordPerfect
WinHelp	F L	WinHelp 4
3	F L	WinHelp 3
F		FrameMaker MIF only

Run wrap-and-ship tasks only

Where F and L are listed under Suffix, to run only wrap-and-ship tasks for a project you can append one of these letters to the format name (case does not matter):

F - For a single-file project, run just the wrap-and-ship tasks

L - For a book-level project, run just the wrap-and-ship tasks

You can use dummy names for the input, because wrap-and-ship tasks are independent of the content files. For example:

dcl -f htmlL StartAuto.mif

See §34 Automating Mif2Go conversions and §35 Producing deliverable results.

Merge contents and/or index

These suffix options apply to HTML-based Help systems for which Mif2Go can generate contents and/or index. For example: -f HTMLHelpB.

C - Merge contents

I - Merge index

B - Merge both contents and index

Letters C, I, and B represent three mutually exclusive options for the same merge operation, which can also (re-) create the project file (depending on configuration settings) while generating the other infrastructure files for the designated Help system.

Note:  When you specify suffix C, I, or B for the -f argument, the input file must have extension .lst; see §37.3.3 Command-line argument input ....

---

> 37 Converting via DCL > 37.3 DCL command-line syntax > 37.3.1 Command-line switch -f format