Return to versions.doc CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / elvis / doc

Annotation of coherent/d/usr/bin/elvis/doc/versions.doc, revision 1.1

1.1     ! root        1: 
        !             2:      Elvis 1.4                    VERSIONS                     Page 12-1
        !             3: 
        !             4: 
        !             5: E12.  VERSIONSF
        !             6: 
        !             7:         Elvis  currently  works  under BSD UNIX, AT&T System-V UNIX, SCO
        !             8:      XENIX, Minix, Coherent, MS-DOS,  Atari  TOS,  and  OS9/68k.    This
        !             9:      section  of the manual provides special information that applies to
        !            10:      each particular version of Elvis.  
        !            11: 
        !            12:         For all versions except MS-DOS, the file  "Makefile.mix"  should
        !            13:      be  copied to "Makefile", and then edited to select the correct set
        !            14:      of options for your system.  There is more information  about  this
        !            15:      embedded in the file itself.  
        !            16: 
        !            17: 
        !            18:    E12.1  BSD UNIXF
        !            19: 
        !            20:         Temporary files are stored in /tmp.  
        !            21: 
        !            22:         Elvis doesn't  have  an  "expreserve" program yet.  Instead, you
        !            23:      should modify /etc/rc so that the temp files are not  deleted  when
        !            24:      the system is rebooted.  Find a line in /etc/rc which reads 
        !            25: 
        !            26:             rm -rf /tmp/*
        !            27: 
        !            28:         or something like that, and change it to read 
        !            29: 
        !            30:             rm -rf /tmp/[^e]* /tmp/e[^l]* /tmp/el[^v]* /tmp/elv_*
        !            31: 
        !            32:         If  you  do not have permission to modify /etc/rc, then it would
        !            33:      be unsafe for you to have Elvis store any temp files in /tmp.    In
        !            34:      this  case,  I  suggest  you  make  a  "tmp" directory in your home
        !            35:      directory and add "set directory=/your/home/directory/tmp" to  your
        !            36:      .exrc file or $EXINIT variable.  
        !            37: 
        !            38:         Both  Elvis  and the real Vi read initialization commands from a
        !            39:      file called ".exrc", but the commands in that file  might  work  on
        !            40:      one but     not     the     other.          For    example,    "set
        !            41:      keywordprg=/usr/myself/bin/ref" will work for Elvis,  but  Vi  will
        !            42:      complain because  it  doesn't  have  a "keywordprg" option.  If the
        !            43:      warning messages annoy you, then you can edit the config.h file  to
        !            44:      change  the  name  of  the initialization file ".exrc" to something
        !            45:      else, such as ".elvisrc".  
        !            46: 
        !            47:         If you use X windows, you  may  wish  to  add  "-DCS_LATIN1"  to
        !            48:      CFLAGS.   This will cause the digraph table and the flipcase option
        !            49:      to have  default  values  that  are  appropriate  for  the  LATIN-1
        !            50:      character set.  That's the standard character set for X.  
        !            51: 
        !            52: 
        !            53:    E12.2  System-V UNIXF
        !            54: 
        !            55:         If  your  system uses terminfo instead of termcap, then you will
        !            56:      have to edit the LIBS setting in the Makefile.  Currently  it  says
        !            57:      "LIBS=-ltermcap",    but   you   may   have   to   change   it   to
        !            58:      "LIBS=-lterminfo" or "LIBS=-lterm" or something like that.  
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: 
        !            65: 
        !            66: 
        !            67: 
        !            68:      Elvis 1.4                    VERSIONS                     Page 12-2
        !            69: 
        !            70: 
        !            71:         The /etc/rc file  should  be  modified,  as  described  for  BSD
        !            72:      systems above.   The potential trouble with ".exrc" described above
        !            73:      for BSD UNIX applies to System-V UNIX as well.  
        !            74: 
        !            75:         Elvis uses control-C as the interrupt key, not Delete.  
        !            76: 
        !            77: 
        !            78:    E12.3  SCO XenixF
        !            79: 
        !            80:         For Xenix-386, you can use the generic System-V settings.    You
        !            81:      may  wish  to add "-DCS_IBMPC" to CFLAGS, to have the digraph table
        !            82:      and flipcase option start up in a mode that is appropriate for  the
        !            83:      console.  
        !            84:      There is  a  separate group of settings for use with Xenix-286.  It
        !            85:      already has "-DCS_IBMPC" in CFLAGS.  
        !            86: 
        !            87:         Because Xenix is so  similar  to  System-V,  everything  I  said
        !            88:      earlier about System-V applies to the Xenix version too.  
        !            89: 
        !            90: 
        !            91:    E12.4  MinixF
        !            92: 
        !            93:         There  are  separate  settings  in Makefile.mix for Minix-PC and
        !            94:      Minix-ST.  The differences  between  these  two  are  that  the  ST
        !            95:      version  uses  ".o"  for  the  object  file  extension where the PC
        !            96:      version uses ".s", and the PC  version  has  some  extra  flags  in
        !            97:      CFLAGS to  reduce  the  size  of  Elvis.   The PC version also uses
        !            98:      tinytcap (instead of the full termcap) to make it smaller.  
        !            99: 
        !           100:         Minix-PC users should read the CFLAGS  section  of  this  manual
        !           101:      very carefully.  
        !           102: 
        !           103:         The temporary  files  are  stored  in  /usr/tmp.    The /usr/tmp
        !           104:      directory  must  exist  before  you  run  Elvis,  and  it  must  be
        !           105:      readable/writable by  everybody.    We use /usr/tmp instead of /tmp
        !           106:      because after a system crash or power failure, you can recover  the
        !           107:      altered version  of a file from the temporary file in /usr/tmp.  If
        !           108:      it was stored in /tmp, though, then it would be lost  because  /tmp
        !           109:      is probably located on the RAM disk.  
        !           110: 
        !           111:         Elvis uses control-C as the interrupt key, not Delete.  
        !           112: 
        !           113: 
        !           114:    E12.5  CoherentF
        !           115: 
        !           116:         Elvis was ported to Coherent by Esa Ahola.  
        !           117: 
        !           118:         Elvis  is  too  large to run under Coherent unless you eliminate
        !           119:      some features via the CFLAGS setting.  The recommended settings, in 
        !           120:      Makefile.mix, produce a working version of elvis which emulates  Vi
        !           121:      faithfully, but  lacks most of the extensions.  You should read the
        !           122:      CFLAGS section of this manual carefully.  
        !           123: 
        !           124:         You can probably reduce the size of Elvis  by  using  tinytcap.c
        !           125:      instead of  -lterm.   This would allow you to keep most features of
        !           126:      Elvis, at the expense of terminal independence.    (Tinytcap.c  has
        !           127:      ANSI escape sequences hard-coded into it.) 
        !           128: 
        !           129: 
        !           130: 
        !           131: 
        !           132: 
        !           133: 
        !           134:      Elvis 1.4                    VERSIONS                     Page 12-3
        !           135: 
        !           136: 
        !           137:         The temporary  files are stored in /tmp.  You should modify your
        !           138:      /etc/rc file as described for BSD earlier.  
        !           139: 
        !           140: 
        !           141:    E12.6  MS-DOSF
        !           142: 
        !           143:         Elvis was ported to MS-DOS by Guntram Blohm and Martin Patzel.  
        !           144: 
        !           145:         There are  two  different  Makefiles  for  Elvis  under  MS-DOS.
        !           146:      "Elvis.prj"  should be used with Turbo-C, and "Elvis.mak" should be
        !           147:      used with MSC and Microsoft MAKE.  The "Elvis.mak"  file  may  work
        !           148:      with MS Quick-C 
        !           149: 
        !           150:         Elvis stores  its  temporary  files  in  C:\tmp.  If this is not
        !           151:      satisfactory, then you should edit the CFLAGS line of your Makefile 
        !           152:      to change TMPDIR to something else before compiling.  You can  also
        !           153:      control  the name of the temp directory via an environment variable
        !           154:      named TMP or TEMP.  The directory must exist  before  you  can  run
        !           155:      Elvis.  
        !           156: 
        !           157:         Normally,  the  TERM  environment variable should not be set, or
        !           158:      else it should be set to "pcbios".  This way, Elvis will make calls 
        !           159:      to BIOS to update the screen.  (If you don't like the  colors  that
        !           160:      the BIOS interface uses, then edit the attr[] table in pc.c.) 
        !           161: 
        !           162:         You  may  prefer  to  use  a  device  driver such as ANSI.SYS or
        !           163:      NNANSI.SYS, for speed; or you may NEED to use a device  driver  for
        !           164:      compatibility.   If  so, you should install one of these drivers by
        !           165:      adding "driver = ansi.sys" to your CONFIG.SYS file, and then define 
        !           166:      TERM to be either "ansi" or "nansi" by adding a line such  as  "set
        !           167:      TERM=ansi" to  your  AUTOEXEC.BAT  file.   You must then reboot for
        !           168:      these changes to take effect.  After that, Elvis  will  notice  the
        !           169:      "TERM" setting and use the driver.  
        !           170: 
        !           171:         Under  MS-DOS,  Elvis has an extra ":set" option called "pcbios"
        !           172:      which indicates whether the BIOS is being used directly.  This is a 
        !           173:      "read only" option; you can't use it to switch your interface style 
        !           174:      in the middle of an edit session.  
        !           175: 
        !           176:         An extra program, called "wildcard", is needed for MS-DOS.    It
        !           177:      expands wildcard characters in file names.  
        !           178: 
        !           179: 
        !           180:    E12.7  Atari TOSF
        !           181: 
        !           182:         Elvis  was  ported  to  Atari  TOS  by  Guntram Blohm and Martin
        !           183:      Patzel.  It is very similar to the MS-DOS version.  
        !           184: 
        !           185:         It has only been tested with the Mark Williams C compiler.  
        !           186: 
        !           187:         The TERM environment variable is ignored;  the  ST  port  always
        !           188:      assumes that  TERM=vt52.   The SHELL (not COMSPEC!) variable should
        !           189:      be set to the name of a line-oriented shell.  
        !           190: 
        !           191:         A simple shell in  included  with  elvis.    Its  source  is  in
        !           192:      "shell.c", and the name of the executable is "shell.ttp".  This was 
        !           193:      necessary because the standard Atari software doesn't offer any way 
        !           194:      to set environment variables.  The file "profile.sh" should contain 
        !           195: 
        !           196: 
        !           197: 
        !           198: 
        !           199: 
        !           200:      Elvis 1.4                    VERSIONS                     Page 12-4
        !           201: 
        !           202: 
        !           203:      a  set  of  instructions to be executed when the shell first starts
        !           204:      up.  An example of this file  is  included,  but  you  will  almost
        !           205:      certainly want to edit it right away to match your configuration.  
        !           206: 
        !           207:         If  you  already have a command-line shell, then you'll probably
        !           208:      want to continue using it.  The shell that comes with elvis is very 
        !           209:      limited.  
        !           210: 
        !           211:         Currently, character  attributes  cannot  be  displayed  on  the
        !           212:      screen.   In  other  words, the "charattr" option doesn't work very
        !           213:      well.  Its ironic -- the only system that always  has  a  bitmapped
        !           214:      display is the only system that doesn't support multiple fonts!  
        !           215: 
        !           216: 
        !           217:    E12.8  OS9/68kF
        !           218: 
        !           219:         Elvis was ported to OS9/68k by Peter Reinig.  
        !           220: 
        !           221:         The  Makefile  is  currently configured to install elvis and the
        !           222:      related programs in /dd/usr/cmds If this this is unacceptable, then 
        !           223:      you  should  change  the  BIN  setting  to  some  other  directory.
        !           224:      Similarly,    it   expects   the   source   code   to   reside   in
        !           225:      /dd/usr/src/elvis; the ODIR setting is used to control this.  
        !           226: 
        !           227:         Temporary files are stored  in  the  /dd/tmp  directory.    Your
        !           228:      /dd/startup  file  may  need  to  be  modified  to  prevent it from
        !           229:      deleting Elvis' temporary files.  
        !           230: 
        !           231:         The program in alias.c is linked repeatedly to produce the "vi", 
        !           232:      "view", and "input" aliases for elvis.  Sadly, the  "ex"  alias  is
        !           233:      impossible to implement under OS9, because the shell has a built-in 
        !           234:      command by that name.  
        !           235: 
        !           236:         For  some  purposes,  you  must  give  `make'  the  "-b" option.
        !           237:      Specifically, you need this  for  "make  -b  clean"  and  "make  -b
        !           238:      install".  
        !           239: 
        !           240: 
        !           241: 
        !           242: 
        !           243: 
        !           244: 
        !           245: 
        !           246: 
        !           247: 
        !           248: 
        !           249: 
        !           250: 
        !           251: 
        !           252: 
        !           253: 
        !           254: 
        !           255: 
        !           256: 
        !           257: 
        !           258: 
        !           259: 
        !           260: 
        !           261: 
        !           262: 
        !           263: 
        !           264: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.