                 _________________________________________________
                |                                                 |
                |  New VEDIT PLUS Macro Language Commands         |
                |  For VEDIT PLUS Ver. 5.16                       |
                |  VEDIT Manual 5.2 revision: June 22, 1999       |
                |  VEDIT PLUS Manual 5.1 revision: Dec. 16, 1997  |
                |_________________________________________________|


This file briefly lists the macro language commands which have been added
since version 5.0 and are not documented in the VEDIT PLUS macro language
reference manual. Please refer to the on-line help for detailed information
about these commands.

It also lists new invocation options.


New Commands or Command Options
-------------------------------

App_Height              New internal values return the size and origin of the
App_Width               VEDIT application. Use Win_Move() to move or resize
App_X_Org               VEDIT. (Windows only)
App_Y_Org

Buf_Org_Filetype(n)     Saves the file-type and window number, or any other
Buf_Org_Window(n)       two values, into the current edit buffer. Each edit
                        buffer has its own set of values. Used by
                        HEXSPLIT.VDM.

Buf_Org_Filetype        Returns the previously saved file-type and window
Buf_Org_Window          number, or other values, from the current edit
                        buffer.

Buf_Win_Next            Returns the ID number of the next/previous window
Buf_Win_Previous        attached to the current edit buffer. If only one
                        window is attached, it returns the ID number of the
                        primary window. See also Win_Next and Win_Previous.

Clip_Copy_Block()       Copies a block to the Windows clipboard, similar to
                        Reg_Copy_Block(). (Win32 only)

Clip_Ins()              Inserts the Windows clipboard at the edit position,
                        similar to Reg_Ins(). (Win32 only)

Color_Highlight         Return an appropriate color for highlighting
                        selection letters and key names.

Color_Prompt            Return an appropriate color for highlighting simple
                        prompt lines.

Config(P_W_PAPER_L)     Sets the paper length for Windows printers. When set
                        to "0=Auto", Printer_LPP returns the "lines per page"
                        as calculated from the current paper size and font.

Config(P_W_PAPER_O)     Sets the Windows printer orientation. When set to
                        "0=Default" the default Windows setup is used. "1"
                        forces printing in Portrait mode; "2" forces printing
                        in Landscape mode.

Config_String()         New Config_String(PR_W_CURRENT) changes the default
                        Windows printer used in VEDIT.

Date()                  Date(BEGIN) display the date as dd-mm-yyyy instead of
                        as mm-dd-yyyy.

Desktop_Height          Returns the height of the desktop, e.g. 640, 800 or
                        1024. (Windows only)

Desktop_Width           Returns the width of the desktop, e.g. 480, 600 or
                        768. (Windows only)

Dialog_Input_1          Create a dialog box with text, an optional input
                        string and up to six buttons. The installation macro
                        INSTALLW.VDM uses this command extensively.
                        (Windows only)

File_Mkdir()            Makes (creates) a new directory.

File_Rmdir()            Removes (deletes) a directory. It must be an
                        empty directory with no files.

File_Open()             File_Open("file",CHGDIR) changes the default
                        directory to the directory containing 'file'.

File_Open("file",MRU)   The new "MRU" option adds the file(s) to the
                        Most-Recently-Used list in the {FILE} menu when the
                        file is closed. However, if VEDIT is exited with
                        "Quit All" or the Qall() command, files are not added
                        to the MRU list. (Windows only)

Font_Height             Height in pixels of the current display font,
                        including any additional "LineSpacing" set in the
                        VEDIT.INI file. (Windows only)

Font_Width              Width in pixels of the current display font.
                        (Windows only)

Group_Add_Item()        Adds an item to the Program group on the Windows
                        desktop created/opened with Group_Create().
                        (Windows only)

Group_Create()          Creates/opens a Program group on the Windows desktop.
                        (Windows only)

Ins_File()              Ins_File(file,1,ALL,COLUMN) inserts 'file' as a
                        columnar block.

Is_Expired              Returns TRUE if VEDIT is running as a trial version
                        and the trial period is expired, or if the support
                        period for the VEDIT product is expired.


Is_Quiet                Returns "1" if VEDIT was invoked with the "-q"
                        option. Returns "2" if the Windows version of VEDIT
                        is currently minimized.

Is_Redirect_Input       Returns TRUE if "keyboard" input to the macro
                        language is currently being redirected from a file.

Is_Support              Returns TRUE if the support period for the VEDIT
                        product is expired.

Is_VEDIT_PLUS           Returns TRUE for VEDIT PLUS, FALSE for plain VEDIT.

Is_Win32_Version        Returns TRUE if the 32-bit Windows version of VEDIT
                        is running. (Use OS_Type to determine if either
                        16-bit or 32-bit Windows version is running.)

Is_WinNT                Returns TRUE if the 32-bit Windows version of VEDIT
                        is running under Windows NT.

Mark_Word()             Marks the word at the edit positions as a highlighted
                        block.

Message()               With Message("...\<vm>...",EXTRA) the key assigned to
                        edit function 'vm' is displayed highlighted. The
                        on-line help has examples.

Num_Eval_Date()         Evaluates a date mm/dd/yyyy or dd-mm-yyyy as the
                        number of days since 01-01-0001 assuming the Julian
                        calendar and leap years. Used to perform calculations
                        based on dates within a file. (Win32 only.)

Num_Ins(n,FILL)         Use "0" for any padding, instead of spaces.

Num_Ins(n,FORCE)        Use a field width of 10 columns for all positive
                        numbers; negative numbers use a width of 11
                        columns.

Num_Ins(n,EXTRA)        Use extra padding for positive numbers so that they
                        have the same width (6 or 11 columns) as negative
                        numbers.

Num_Ins(n,FORCE+EXTRA)  Use a field width of 11 columns for all positive and
                        negative numbers.

Num_Ins_Date(n)         Inserts 'n' as a date, e.g. mm-dd-yyyy, where 'n' is
                        the number of days since 01-01-0001 assuming the
                        Julian calendar and leap years. (Win32 only.)

Num_Type(n,FILL)        Use "0" for any padding, instead of spaces.

Num_Type(n,FORCE)       Use a field width of 10 columns for all numbers;
                        negative numbers use a width of 11 columns.

Num_Type(n,EXTRA)       Use extra padding for positive numbers so that they
                        have the same width (6 or 11 columns) as negative
                        numbers.

Num_Type(n,FORCE+EXTRA) Use a field width of 11 columns for all positive and
                        negative numbers.

Printer_Line            Returns the line number on the printed page that the
                        next Print() command will print to, e.g. 1 - 66.

Printer_CPL             Returns the printer's "Characters per line",
                        depending upon the printer font and size.

Printer_LPP             Returns the printer's "Lines per page".

Redirect_Input()        Use specified file as "keyboard" input redirection
                        for the macro language Get_ input commands.

Registry_Delete_Item()  Deletes the specified item from a registry key.
                        (All Registry_ commands are Win32 only. See the
                        REGISTRY.VDM macro for examples.)

Registry_Delete_Key()   Deletes the specified registry key.

Registry_Get_Item()     Reads a registry item as a string value into a text
                        register.

Registry_Get_Number()   Reads a registry item as a numeric value into a
                        numeric register.

Registry_Set_Item()     Changes an existing registry item or creates a new
                        key and/or item. Also Registry_Set_Number().

Screen_Size()           New command resizes VEDIT so that a full-sized
                        editing window has 'l' lines and 'c' columns.

Search("ss",EBCDIC)     The new "EBCDIC" option specifies that the search
                        string is EBCDIC text.

Search("ss",HEX)        The new "HEX" option specifies the search string as
                        hexadecimal bytes, words, double-words or quad-words.

SR_Set("","",RESET)     The new "RESET" option clears the current search
                        and replace strings and reset the {SEARCH, Next}
                        function.

Time_Tick()             Has been changed to return the time in milliseconds
                        since VEDIT was started.

Translate_Char()        Return the resulting character after translation,
                        e.g. from ASCII to EBCDIC.

Win_Create()            New option PIXEL allows specifying the new window's
                        origin and size in exact pixels, instead of in text
                        rows and columns. (Windows only)

Win_Height              New internal values return the size and origin of the
Win_Width               current editing window. Use Win_Move() to move or
Win_X_Org               resize the window. (Windows only)
Win_Y_Org

Win_Move()              New command moves or resizes any editing window or
                        the entire VEDIT application. (Windows only)

Win_Reserved_Bottom     Return the number of lines in the reserved window
Win_Reserved_Top        at the bottom/top of the screen; return 0 if none.

Win_Reserved_Bottom_ID  Return the window ID number of the reserved window
Win_Reserved_Top_ID     at the bottom/top of the screen; return 0 if none.



Other Macro Language Changes
----------------------------

Numeric XOR             The new numeric "^" operator performs a bitwise
Operator                Exclusive-OR operation of two numbers. It follows the
                        C syntax. "10 ^ 6" has value 12. ("10 | 6" has value
                        14.)



New Startup (Invocation) Options
--------------------------------

-g              The "-g" invocation option starts up VEDIT without auto-
                loading the VEDIT.CFG and VEDIT.KEY files.

-k              The "-k" invocation option prevents VEDIT from reading the
                VEDIT.INI file when it starts and saving a new VEDIT.INI file
                when it exits. (The VEDIT size and font are therefore not
                saved.)

-kinifile       The invocation option "-kinifile" allows changing the name of
                the VEDIT.INI file to 'inifile'. The full pathname must be
                specified and there must be NO SPACE between "-k" and
                'inifile'. (This allows "-k filename" to turn off the
                VEDIT.INI file and open 'filename' for editing.)

-p              The "-p" invocation option prints the specified file and
                immediately exits.

-q              Runs VEDIT in "quiet" mode without displaying anything on the
                screen. It is typically followed by the "-x" or "-c" options
                to execute a macro. When the macro is done, it automatically
                saves all files and exits.

                Note: When run in quiet mode or minimized, any pending "edit
                      session restore" files are left untouched.
