(LOGO.JPG) Python for OpenVMS

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"]
Arguments:
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.

Examples:

$ @CVT__HTML
%CVT__HTML-I-CVTFIL, converting file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]CFG_BUILTIN.HTML;27\
%CVT__HTML-I-CVTFIL, converting file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]CFG_INTRO.HTML;13\
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]CFG_MODULE_METHODS.HTML;20\
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]CVT_DOC.HTML;10\
%CVT__HTML-I-NOCVT, converting not necessary for file
[...]
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]HTML2RNO.HTML;9\
%CVT__HTML-W-CVTREJ, file conversion rejected due to <RNO NOCONVERT>
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]IDX_GEN.HTML;44\
%CVT__HTML-W-CVTREJ, file conversion rejected due to <RNO NOCONVERT>
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]INDEX.HTML;5\
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]INTRO_GEN.HTML;68\
[...]
%CVT__HTML-I-NOCVT, converting not necessary for file
 \DKA100:[PYTHON.PYTHON-1_5_2.VMS.DOC.GENMAN]VMSVER2MAR.HTML;8\
%CVT__HTML-I-CVTCNT, converted 2 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
$

(go to: table of contents, Tools in TOC, index)

27-OCT-1999 ZE.