Retro1.org codex

FSVIEW                                           (MECAFF) CMS User Area command

FSVIEW is a MECAFF-based fullscreen file browser with the possibility to
switch to EE for editing the file.

+----------+------------------------------------------------------------------+
| FSVIEW   | fn fm [ ft ]                                                     |
|          | fn.fm[.ft]                                                       |
| EE       | fn fm [ ft ]  ( FSVIEW                                           |
|          | fn.fm[.ft]    ( FSVIEW                                           |
+----------+------------------------------------------------------------------+

If a file loaded into FSVIEW contains binary characters (codes 0x00 to 0x3F or
0xFF), these characters are replaced with a dot ('.') in the file buffer.

Browsing through the file content and leaving FSVIEW is controlled with the
PF-keys. Additionally, text can be searched in the file using subcommands.
FSVIEW allows to start editing the file with EE by pressing the PF02 key.


PF-Keys
-------

Browsing through the file and leaving FSVIEW is typically controlled with the
PF-keys (see below for the commands):

  PF01  : CENTER
  PF02  : EE
  PF03  : QUIT
  PF04  : /
  PF05  : TOP
  PF06  : PGUP
  PF07  : PGUP SHORT
  PF08  : PGDOWN SHORT
  PF09  : PGDOWN
  PF10  : BOTTOM
  PF11  : LEFT
  PF12  : RIGHT
  PF15  : QUIT
  PF16  : -/
  PF23  : LEFT SHORT
  PF24  : RIGHT SHORT


Commands
--------

The following commands are accepted on the command prompt of FSVIEW:

+----------+------------------------------------------------------------------+
| Help     |                                                                  |
+----------+------------------------------------------------------------------+

Show the help for FSVIEW.


+----------+------------------------------------------------------------------+
| CENTer   |                                                                  |
+----------+------------------------------------------------------------------+

Center the cursors position:
- if the cursor is in the file area, CENTER will attempt to vertically center
  the character under the cursor on the screen;
- if the cursor is on the command line, the cursor will be placed in the file
  area as near as possible to the middle of the screen.


+----------+------------------------------------------------------------------+
| TOp      |                                                                  |
+----------+------------------------------------------------------------------+

Scroll to the top of the file.


+----------+------------------------------------------------------------------+
| PGUP     | [ SHORT ]                                                        |
+----------+------------------------------------------------------------------+

Scroll up the file by one page height. If the option SHORT is given, scrolling
is done only by 2/3 page height.
If the cursor is in the list area, PGUP will attempt to center the cursors
column vertically.


+----------+------------------------------------------------------------------+
| PGDOwn   | [ SHORT ]                                                        |
+----------+------------------------------------------------------------------+

Scroll down the file by one page height. If the option SHORT is given,
scrolling is done only by 2/3 page height.
If the cursor is in the list area, PGDOWN will attempt to center the cursors
column vertically.


+----------+------------------------------------------------------------------+
| BOTtom   |                                                                  |
+----------+------------------------------------------------------------------+

Scroll to the bottom of the file.


+----------+------------------------------------------------------------------+
| LEft     | [ SHORT ]                                                        |
+----------+------------------------------------------------------------------+

Shift the visible horizontal portion of the file to the left, i.e. move the
first displayed column of the file by 20 positions to the left resp. 10
positions if SHORT is specified, up to the first column of the file;
if the cursor is in the file area, LEFT will attempt to center the cursors
column horizontally.


+----------+------------------------------------------------------------------+
| RIght    | [ SHORT ]                                                        |
+----------+------------------------------------------------------------------+

Shift the visible horizontal portion of the file to the right, i.e. move the
first displayed column of the file by 20 positions to the right resp. 10
positions if SHORT is specified, up to the last column of the file being
displayed at the border of the screen;
if the cursor is in the file area, RIGHT  will attempt to center the cursors
column horizontally.


+----------+------------------------------------------------------------------+
| EE       |                                                                  |
+----------+------------------------------------------------------------------+

Open the file displayed in FSVIEW with EE for editing (FSVIEW is fact replaced
with EE, so leaving EE will not return to FSVIEW).


+----------+------------------------------------------------------------------+
| Quit     |                                                                  |
| RETurn   |                                                                  |
+----------+------------------------------------------------------------------+

Leave FSVIEW.


+----------+------------------------------------------------------------------+
|          | /text/                                                           |
+----------+------------------------------------------------------------------+

Search forward for text in the current help page.


+----------+------------------------------------------------------------------+
|          | -/text/                                                          |
+----------+------------------------------------------------------------------+

Search backward for text in the current help page.


+----------+------------------------------------------------------------------+
|          | /                                                                |
+----------+------------------------------------------------------------------+

Repeat the last search in the search direction last used.


+----------+------------------------------------------------------------------+
|          | -/                                                               |
+----------+------------------------------------------------------------------+

Reverse the search direction and repeat the last search in the new search
direction.


Customizing FSVIEW
------------------

FSVIEW can be customized with the following commands in the EE profiles
(PROFILE EE or SYSPROF EE):

+----------+------------------------------------------------------------------+
| PF       | FSVIEW  pfno  command  [ parameters ... ]                        |
|          | FSVIEW  CLEAR pfno                                               |
+----------+------------------------------------------------------------------+

Set or clear the command issued by a PF key. The pfno must be a number from
1 to 24, the maximal command length is 120 characters.


+-----------+-----------------------------------------------------------------+
| INFOLines | FSVIEW  CLEAR                                                   |
|           | FSVIEW  ADD infoline-text                                       |
+-----------+-----------------------------------------------------------------+

Control the information line at the bottom of the screens, usually describing
the PF key settings. FSVIEW supports only one configurable information line.
CLEAR will display an empty line, ADD will display the text passed.