::XFM =========================================================================== =================== ================== =================== THE /F AND /M PARAMETERS ================== =================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /Ftext Finds the specified text SEE file /M Switches on monochrome (black and white) display ---------------------- --------------------------------------------------- This demonstration will load the file SEE.DOC (the SEE manual), find the words "has a space" and highlight the line. Since the text we are looking for contains spaces, we must enclose the search text in quotations. We will also use the /M switch to put SEE into monochrome (black and white) mode. If you have already put SEE in monochrome mode (via the SEESETUP program), the /M switch will have no effect. The command we will use is: SEE SEE.DOC /M /F"has a space" Since the /M switch only temporarily affects SEE, it will not affect the other demonstrations. After SEE has located the text, you can press the Esc (Escape) key to return to the examples menu. ::XK =========================================================================== ================== ================== ================== THE /K PARAMETER ================== ================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /Kkey-list Stacks keys to be "pressed automatically" ---------------------- --------------------------------------------------- This demonstration will load the file SEE.DOC (the SEE manual) and stack the "End" and "PgUp" key, so we will see the manual one screen up from the end of the file. The command to do this is: SEE SEE.DOC /K{END}{PGUP} After SEE has positioned itself, you can press the Esc (Escape) key to return to the examples menu. ::XO =========================================================================== ================== ================== ================== THE /O PARAMETER ================== ================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /Oconfig-list Temporarily modifies configuration items ---------------------- --------------------------------------------------- This demonstration will use the /O parameter to temporarily override configuration values for the main viewscreen color (code MVRGTX), the text of the end of file marker (code EOFMRK), and the color of the screen after the end of the file (code EOFBCO). We will view the file READ.ME (an introductory file supplied with the standard version of SEE) to see the difference. The command we will use is: SEE READ.ME /o"!MVRGTX!MbWk!EOFMRK! The End !EOFBCO!gbkL" We have to enclose the parameter specification in quotes, because it contains spaces. The changes could be saved to the current CFG file by including the /W (write configuration change) switch in the command. ::XU =========================================================================== ================== ================== ================== THE /U PARAMETER ================== ================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /Ufilename Specifies alternative menu (MNU) file ---------------------- --------------------------------------------------- SEE's default menu definition (MNU) file is named SEE.MNU. This demon- stration will use the /U parameter to point to a different MNU file, named SEESAMPL.MNU. The file we view will be the alternative MNU file itself, so you can study how it changes the behaviour of SEE. The command we use is: SEE SEESAMPL.MNU /uSEESAMPL The SEESAMPL.MNU file contains numerous comments, which explain what it does and how it works. One of the changes performed by the SEESAMPL.MNU menu definition file is to turn off the pull-down menus. So after viewing the file, the only way to get out is to press the Esc (Escape) key. ::XX =========================================================================== ================== ================== ================== THE /X PARAMETER ================== ================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /X Switches on raw text (binary file) display mode ---------------------- --------------------------------------------------- SEE normally displays text files in text mode. If, however, you wish to see a file in "raw text" mode, you can use the /X switch. This is useful for scanning executable (EXE) files. SEE normally detects non-text files automatically, but in the rare instances where it makes the wrong decision, the /X switch will force it into raw text mode. We will view the file SEESETUP.EXE, using this command: SEE SEESETUP.EXE /X While viewing the file, try out the "Textify" feature (on the Text pull-down menu -- short-cut key Alt-Y). The textify function filters out most of the non-human-readable material in binary files. This makes it easy to visually scan the file for intelligible text. ::XNQP =========================================================================== ================== ================== ================== THE /N /Q AND /P PARAMETERS ================== ================== ================== =========================================================================== COMMAND FORMAT PURPOSE ---------------------- --------------------------------------------------- SEE file /Nprefix-list Lists up to five prefixes for "no-show" lines SEE file /Ftext Finds the specified text (regular or no-show) SEE file /Qtext Stops reading in text when specified text is found SEE file /P Switches on printer-code filtering ---------------------- --------------------------------------------------- This demonstration will use the /N and /Q parameters to zero in on a particular section of the SEE manual (SEE.DOC), which includes special hyperdocumentation codes (e.g. ::HYPER). The SEE.DOC file contains the form feed character (ASCII 12) so that if it is printed, it will generate page ejects in appropriate places. To filter these out, we will use the /P switch to remove printer control characters. Thus, the command is: SEE SEE.DOC /N!:: /F::HYPER /Q /P When the /Q parameter is used in No-Show (/N) Mode without a specification (i.e. it is not given specific text to look for), SEE will stop reading text when it encounters the next No-Show line (or the end of file).