home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / vil63os2.zip / vile.man < prev   
Text File  |  1996-10-14  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. VILE(1)                              VILE(1)
  5.  
  6.  
  7. NAME
  8.        vile, xvile - VI Like Emacs
  9.  
  10. SYNOPSIS
  11.        vile [-hVv] [-spattern] [+/pattern] [-ttag] [-gNNN] [+NNN]
  12.        [@cmdfile] [filename]...
  13.  
  14. DESCRIPTION
  15.        vile is a text editor.  This man     page  is  fairly  terse.
  16.        More  information  can be obtained from the internal help,
  17.        available with the -h option or by using the ":help"  com-
  18.        mand from within vile.
  19.  
  20.        xvile  is  the  same  text  editor,  built as an X-windows
  21.        application, with fully integrated mouse support,  scroll-
  22.        bars, etc.
  23.  
  24. SPIRIT
  25.        vile  retains the "finger-feel", if you will, of vi, while
  26.        adding the multiple buffer and multiple window features of
  27.        emacs and other editors.     It is definitely not a vi clone,
  28.        in that some substantial stuff is missing, and the  screen
  29.        doesn't    look quite the same.  The things that you tend to
  30.        type over and over probably work.  Things done  less  fre-
  31.        quently, like configuring a startup file, are somewhat (or
  32.        very, depending on how ambitious you are) different.   But
  33.        what  matters  most is that one's "muscle memory" does the
  34.        right thing to the text in front of you, and that is  what
  35.        vile tries to do for vi users.
  36.  
  37. OPTIONS
  38.        +NNN and -gNNN
  39.           vile  will  begin     the session on the first file at
  40.           the specified line number.
  41.  
  42.        +/pattern or -s pattern
  43.           In the first file, vile  will  execute  an  initial
  44.           search for the given pattern.
  45.  
  46.        -t tag
  47.           vile will edit the correct file and move the cursor
  48.           to the location of the tag.  This requires a  tags-
  49.           file created with the ctags(1) command.
  50.  
  51.        -h     Invokes vile on the helpfile.
  52.  
  53.        -R     Invokes  vile  in     "readonly"  mode - no writes are
  54.           permitted while in this mode.  (This will     also  be
  55.           true  if    vile is invoked as view, or if "readonly"
  56.           mode is set in the startup file.)
  57.  
  58.        -v     Invokes vile in "view" mode - no changes    are  per-
  59.           mitted to any buffer while in this mode.
  60.  
  61.  
  62.  
  63.  
  64.                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VILE(1)                              VILE(1)
  71.  
  72.  
  73.        -V     vile will report its version number.
  74.  
  75.        @cmdfile
  76.           vile  will  run  the  specified file as its startup
  77.           file, and will bypass any normal startup file (i.e.
  78.           .vilerc) or environment variable (i.e.  $VILEINIT).
  79.  
  80.        -25 -43 -50
  81.           On PC systems you may be able to    set  the  initial
  82.           screen  resolution  from    the  command  line.   See
  83.           vile.hlp for details.
  84.  
  85.        xvile-specific command-line options are    detailed  in  the
  86.        help  file (see "Standard X command line arguments").  The
  87.        standard ones (e.g. -display, -fn, -geometry, -name, etc.)
  88.        are all supported.
  89.  
  90. INVOCATION
  91.        vile  will  edit     the files specified on the command line.
  92.        If no files are specified, and standard input is not  con-
  93.        nected  to  a  terminal,     then vile will bring up a buffer
  94.        containing the output of the pipe it is connected to,  and
  95.        will re-open /dev/tty for commands.  Files (except for the
  96.        first) are not actually read into buffers until "visited".
  97.        All  buffers  are  kept    in memory: machines with not much
  98.        memory or swap space may have trouble with this.
  99.  
  100. STARTUP
  101.        If the @cmdfile option is given, then the  file    given  as
  102.        "cmdfile"  will be run before any files are loaded.  If no
  103.        @ option appears, startup commands will be taken from  the
  104.        user's  VILEINIT     variable,  if    it  is set, from the file
  105.        .vilerc in the current directory, if it    exists,     or  from
  106.        $HOME/.vilerc,  as  a  last resort.  See the help file for
  107.        examples of what sorts of things might go into these  com-
  108.        mand files.
  109.  
  110. COMMANDS
  111.        Please  refer  to the help available within vile for vile-
  112.        specific     commands.   (That  document,  however,      assumes
  113.        familiarity  with  vi.)     Short    descriptions of each vile
  114.        command may be obtained with the ": describe-function" and
  115.        ":  describe-key"  commands.   All  commands may be listed
  116.        with ": show-commands".
  117.  
  118.        Additional  documentation  on  writing  macros  using  the
  119.        internal     scripting  language  can  be  found  in the file
  120.        "macros.doc", distributed with the vile source.
  121.  
  122. RELATED PROGRAMS
  123.        vile may also be built and installed as    xvile,    in  which
  124.        case  it     behaves  as a native X Windows application, with
  125.        scrollbars, better mouse support, etc.  The help file  has
  126.        more information on this.
  127.  
  128.  
  129.  
  130.                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VILE(1)                              VILE(1)
  137.  
  138.  
  139.        There  is a program distributed with the vile source which
  140.        is usually installed as vile-manfilt.   (Two  versions  of
  141.        the  source  for     vile-manfilt  are  available, in C (man-
  142.        filt.c) and in Perl (manfilt.pl).)  It may be used in con-
  143.        junction with vile or xvile (with the help of the macro in
  144.        the file manpage.rc) to    filter    and  view  system  manual
  145.        pages.  xvile will even (with your font set properly) dis-
  146.        play certain portions of the manual page text in     bold  or
  147.        italics as appropriate.    See the help file for details.
  148.  
  149.        Likewise,   there  is  a     vile-c-filt  program  which  can
  150.        embolden, underline, or    perform     coloring  on  C  program
  151.        source  code.   (And again, two versions of the source, in
  152.        C and in "flex", are available.)     Again, see the help file
  153.        for more information.
  154.  
  155. SEE ALSO
  156.        Your  favorite  vi  document, the file macros.doc, and the
  157.        vile help page, available with the -h  option  or  as  the
  158.        text file vile.hlp.
  159.  
  160. DEBTS and CREDITS
  161.        vile  was originally built from a copy of microEmacs, so a
  162.        large debt of gratitude is due to the developers     of  that
  163.        program.      A  lot  of people have helped with code and bug
  164.        reports on vile.     Names are named at  the  bottom  of  the
  165.        help file.
  166.  
  167. AUTHORS
  168.        vile  was created by Paul Fox, Tom Dickey, and Kevin Buet-
  169.        tner.
  170.  
  171. BUGS
  172.        The "VI Like Emacs" joke     isn't    really    funny.     It  only
  173.        sounds  that  way.  :-)     Other suspicious behavior should
  174.        be reported to vile-bugs@foxharp.boston.ma.us.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                 3
  197.  
  198.  
  199.