CVT__HTML.COM is normally called from CVT_DOC.COM. It converts all '.HTML' files in the [.VMS.DOC.*] subdirectories except for those which have the '<RNO NOCONVERT>' tag in the first line. Because the conversion process takes some time CVT__HTML.COM does only convert those '.HTML' files which have a later creation date than the corresponding '.RNO' file.

Passing a "*" as parameter 1 to the procedure however means that CVT__HTML will ignore the dates on the files and translate all files (except those that use the <RUN NOCONVERT> tag mentioned above).

Beginning with version 1.5.2-V002 it is also possible to specify a filename as parameter 1 to convert a single file - no matter if the ".RNO" file is up to date or not.

One can also delete all versions of a '.RNO' file to force a new translation of the '.HTML' file.

It requires a working Python executable (named [.VMS]PYTHON_arch.EXE), the procedure SETUP.COM and HTML2RNO.PY. ('arch' can be "ALPHA" or "VAX").

The procedure contains only minimal error checking - e. g. it fails on an empty '.HTML' file.

Format:

    $ @CVT__HTML ["*"|"filespec"]

P1, optional

An asterisk ("*") means that all files will be translated whether the '.RNO' file is current or not.

A single filespecification (.HTML) is set automatically to translate this file only.

$ @CVT__HTML
%CVT__HTML-I-CVTFIL, converting file
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]BUILDING.HTML;97\
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]CVT__HTML.HTML;1\
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]DOC_ACCESS.HTML;18\
[...]
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]HTML2RNO.HTML;13\
%CVT__HTML-W-CVTREJ, file conversion rejected due to <RNO NOCONVERT>
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]IDX.HTML;32\
%CVT__HTML-I-NOCVT, converting not necessary for file
[...]
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5.VMS.DOC]VMS_SYS.HTML;66\
%CVT__HTML-I-CVTCNT, converted 1 files
$

$! .HTML is always set v--
$ @CVT__HTML INSBLD.HTMX
%CVT__HTML-I-CVTFIL, converting file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.INSMAN]INSBLD.HTML\
%CVT__HTML-I-CVTCNT, converted 1 files
$

$! .HTML is always set --------------v
$ @CVT__HTML [-.REFMAN]VMS_LIB_ATTACH
%CVT__HTML-I-CVTFIL, converting file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.REFMAN]VMS_LIB_ATTACH.HTML\
%CVT__HTML-I-CVTCNT, converted 1 files
$