home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / pvic_10a.lzh / DOC / vi.txt < prev   
Text File  |  1998-06-11  |  5KB  |  139 lines
  1. PVIC 1.0a
  2. =========
  3.  
  4. PVIC is a Portable VI Clone derived from STEVIE 3.69B. It has been written 
  5. in Kernighan and Ritchie C, so it compiles on both old and modern C compilers.
  6.  
  7. The original STEVIE 3.69B I got was written for MS-DOS systems, and did 
  8. contain many non portable things like BIOS calls. I have removed everything 
  9. from STEVIE 3.69B I considered non-portable, and I did rewrite the I/O. I 
  10. added code to read termcap files. I gave many variables and functions from the 
  11. original STEVIE 3.69B more understandable names.
  12.  
  13. There are some incompatibilities between different operating systems. These 
  14. incompatibilities are resolved in the files LOCDEFS.H and LOCFUNCS.H. To port 
  15. PVIC to another operating system, you only have to modify these files. 
  16.  
  17. The code provided is for OS-9.
  18.  
  19. I hope PVIC will provide for those who have to work on many different 
  20. platforms, and want to use the same editor on every platform. I encourage
  21. everybody to copy and/or port PVIC.
  22.  
  23.                 Frits Wiarda
  24.                 Boul.Heuvelink 1-5
  25.                 6828 KG Arnhem
  26.                 Holland
  27.                 e-mail fwiarda@compuserve.com
  28.  
  29. ENVIRONMENT
  30. ===========
  31. Installing PVIC
  32. ---------------
  33. The 'vi' executable must be installed in the execution directory or in a
  34. directory on the search path. 
  35.  
  36. Running PVIC
  37. ============
  38. Usage: vi [file ...]
  39.        vi -t tag
  40.        vi +[num] file
  41.        vi +/pat  file
  42.  
  43. Environment variables affecting PVIC
  44. ------------------------------------
  45. Variable        Description
  46.  
  47. EXINIT            If defined, this must contain a colon command that will be
  48.                   executed during initialisation, e.g., 'set eb ts=4'
  49. LINES            The number of lines on the terminal
  50. SHELL            If present, identifies the shell used for :sh, :! and !
  51.                 commands. If absent it defaults to the standard shell for
  52.                 your operating system. For OS-9 this is the Microware shell,
  53.                 'shell'.
  54. TERM            Contains the termcap terminal name of the current terminal
  55. TERMCAP            If set, must contain either:
  56.                 - the full pathname of the termcap database.
  57.                 - the termcap entry for the current terminal. This gives
  58.                   the fastest startup.
  59.                   If $TERMCAP is not set the termcap database must be in
  60.                 the usual default place for your operating system
  61.                 (/dd/SYS/termcap for OS-9).
  62.  
  63. The terminal type defaults to ANSI if $TERM is unset; in this case $TERMCAP
  64. will be ignored and key assignments will suit a PC. In other words, PVIC will
  65. work on a PC without and environment variables set provided that the
  66. ANSI.SYS driver is installed. If the terminal is other than an ANSI type
  67. then $TERM must contain the termcap name of your terminal.
  68.  
  69. The other variables are not required.
  70.  
  71. Environment variables may be used anywhere in a colon shell or file i/o
  72. command and will be expanded where they can be found. If they cannot be
  73. matched an error will be signalled.
  74.  
  75. Files
  76. -----
  77. /dd/sys/termcap    - the termcap database
  78.  
  79. $HOME/.exrc        - contains initialisation commands. Settings in this file
  80.                   override termcap settings and are in turn overridden by
  81.                   $EXINIT and $LINES.
  82.  
  83. VI editor options supported by PVIC
  84. -----------------------------------
  85. Option        Abbreviation    Default    Description
  86.  
  87. lines        lines            24        lines on the screen
  88. report        report            5        min report line count (e.g. yanked lines)
  89. scroll        scroll            12        scroll size for half-screen scrolling
  90. tabsize        ts                8        tab size (chars). In OS/9 the tab size
  91.                                     defaults to the value in the terminal
  92.                                     descriptor.
  93.  
  94. autoindent    ai                no        auto-indent mode flag
  95. backup        bk                no        make backups when files are written
  96. errorbell    eb                no        beep when an invalid key is hit
  97. ignorecase    ic                no        ignore case in searches
  98. list        list            no        shows graphic tabs and newlines
  99. modelines    ml                yes        enable mode line processing. Modelines
  100.                                     are lines of the form ex:colon-command
  101.                                     in a file that is being edited
  102. number        nu                no        show line numbers
  103. showmatch    sm                no        show matching []{}()
  104. showmode    mo                yes        show edit mode
  105. vbell        vb                no        visual bell
  106. wrapscan    ws                yes        search wraps round buffer
  107.  
  108. Termcap capabilities used by PVIC
  109. ---------------------------------
  110. Capability            Tag    Rqd    Default        Description
  111.  
  112. clear_screen        cl    Y    \E[2J        Erase display (may optionally home 
  113.                                         cursor).
  114. clear_to_eol           ce    Y    \E[K        Erase the entire current line.
  115. cursor_motion        cm    Y    \E[%i%d;%dH    Cursor motion string.
  116.  
  117. lines                li        24            Lines on screen
  118. columns                co        80            Columns on screen
  119. init_terminal        ti                    Initialise terminal
  120. deinit_terminal        te                    Restore original terminal operation
  121. save_cursor            sc        \E[s        Save the cursor position.
  122. restore_cursor        rc        \E[u        Restore the cursor position.
  123. cursor_invisible    vi                    Invisible cursor (very optional).
  124. cursor_visible        vs                    Visible cursor (very optional).
  125. bell                bl        \007        Audible bell.
  126. key_f1                k0        \EOP        F1 key
  127. key_f2                k1        \EOQ        F2 key
  128. key_ic                kI                    Insert
  129. key_dc                kD                    Delete
  130. key_home            kh                    Go to first non-space char on line
  131. key_eol                kE                    Go to end of line
  132. key_ppage            kP                    Page up
  133. key_npage            kN                    Page down
  134. key_up                ku        \E[A        Cursor up
  135. key_down            kd        \E[B        Cursor down
  136. key_left            kl        \E[D        Cursor left
  137. key_right            kr        \E[C        Cursor right
  138. key_backspace        kb        \010        Backspace
  139.