Syntax


BROWSE

[ file-name ]


[ .Profile-name ]


[ %imacro-name | %ON | %OFF | %NONE ]


[ /XForm-macro | /ON | /OFF | /NONE ]

       

Operands


file-name

The name of the file to be browsed. 


The filename may contain system variables ( %xxx% ) if desired, they will be substituted from the System variable settings. 


If the file-name does not exist, BROWSE will be cancelled.

.Profile-name

This optional operand allows you to specify an overriding Profile to be used for the Browse session. It simply consists of the name of the desired Profile, preceded by a . (period)

%imacro-name

This optional operand allows you to specify an IMACRO (a macro to be run immediately after the file is loaded). If an IMACRO is specified in the file's Profile, this imacro-name will override it.


You can use /OFF or /NONE to nullify an IMACRO specified in the Profile


You can use /ON to activate an IMACRO in the profile which is save in OFF mode.


See Profile IMACRO for details.

/XForm-macro

This optional operand allows you to specify an XFORM (a macro to allow access to non-standard file types). If an XFORM macro is specified in the file's Profile, this XForm-macro will override it.


You can use /OFF or /NONE to nullify an XFORM macro specified in the Profile


You can use /ON to activate an XFORM macro in the profile which is saved in OFF mode.


See Profile XFORM for details.


Abbreviations and Aliases


BROWSE can also be spelled as B or BRO

 

Description


The BROWSE command loads a file into the work space for Browsing. If no file-name operand is specified, a standard Windows File Open Dialog will be presented for you to select a file for Browsing. 


BROWSE will not allow you to make any modifications to the file. Primary commands, Line Commands and normal typing which would modify the file's data are suppressed. To remind you, the word Browse in the left-hand Status Bar box will be displayed as Browse. These restrictions prevent you from modifying files that might be important to you, when you wanted to be sure there was no possibility you could change them by accident.


If the current working Tab contains data, a new Tab will be opened to hold the Browse session; otherwise the current Tab will be used.


Default Directory


When no operand at all or only a simple unqualified filename is provided for the BROWSE command, the default directory used for searching for the file or for the file open dialog's starting directory will be determined as follows:


    • If there is an active file being edited in the tab where the command is issued, then the Path for THAT active file is used as the default for the command. 


    • If there is NO active file [when the tab header displays (New) then the current displayed directory of File Manager will be used. 


Overriding Profile


When you wish to use a different Profile from the one indicated by the file's extension, simply  provide the alternate profile name, preceded by a period, on the command line. For example, to Browse  MYSOURCE.BAS using the TXT profile the command would be


BROWSE MYSOURCE.BAS .TXT


The use of the alternate profile is for the duration of this session only. It does not alter any permanent Profile processing.

Created with the Personal Edition of HelpNDoc: Transform Your Documentation Workflow with HelpNDoc's Intuitive UI