When you use this switch you should always also specify an include option for the current output format as the first option. If you leave out the /I= switch the include options set the last time you published the project manually will be used.

Add the /I= include options switch after the output format switch. Follow it with all the include options you want to use, separated by commas. Don't use quotes or spaces (a space would identify a new switch).

Examples:

HELPMAN.EXE D:\Projects\widgethelp.hmxz /CHM /I=CHM,FINALBUILD,USVERSION

HELPMAN.EXE D:\Projects\widgethelp.hmxp /CHM /I=CHM,PDF,DEMO

Both these examples output to HTML Help files (CHM). Note that the CHM include option is included in both cases. The output format itself should always be included as the first include option.

The second example also includes items specifically tagged for PDF in the HTML Help output, which would normally only be included when you publish to PDF.

Normally, include options operate with OR logic. This means that if content is tagged with multiple include options only ONE of those options needs to evaluate as true to include the content. Sometimes, however, you may also want to exclude content on the basis of a single option, no matter what other options the content is tagged with. This is not possible when publishing directly from Help+Manual, but you can do it with command line publishing with the /E= exclude switch.

For example, suppose you have a project with a large number of topics intended only for Client A, which you tag with a build option you have called CLIENTA. In addition to this, you have also defined a build option called BETA, which you use for some content that is not yet final. Your project includes the following three topics, with these build option tags:

Topic A: CLIENTA
Topic B: CLIENTA
Topic C: CLIENTA,BETA

If you only use /I= include options there is no way to include all the normal CLIENTA topics but exclude Topic C, which is also tagged with BETA. Due to the OR logic, activating CLIENTA as an include option would also include Topic C, because only one option needs to be true to include the content.

You solve this problem by adding the /E= exclude switch with the BETA build, as follows:

/I=HTML,CLIENTA /E=BETA

The above switches in your command line will include Topic A and Topic B, but will exclude topic C.

Output format include options (i.e. for the output formats supported by Help+Manual) and user-defined include options are both used in exactly the same way. Just type the options after the /I= switch, separated by commas. The examples below show the user-defined options in red.

Examples:

HELPMAN.EXE D:\Projects\widgethelp.hmxz /CHM /I=CHM,FINALBUILD,USVERSION

HELPMAN.EXE D:\Projects\widgethelp.hmxp /CHM /I=CHM,PDF,DEMO