home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / jove-4.16-src.tgz / tar.out / bsd / jove / doc / README < prev    next >
Text File  |  1996-09-28  |  4KB  |  89 lines
  1. ########################################################################
  2. # This program is Copyright (C) 1986-1996 by Jonathan Payne.  JOVE is  #
  3. # provided to you without charge, and with no warranty.  You may give  #
  4. # away copies of JOVE, including sources, provided that this notice is #
  5. # included in all the files.                                           #
  6. ########################################################################
  7.  
  8. README        this file
  9.  
  10. cmds.macros.nr    nroff macros used to format cmds.nr to produce cmds.doc
  11. intro.nr    introductory part of JOVE manual; combined with cmds.nr
  12.         to produce complete manual (nroff input)
  13. cmds.nr        descriptions of JOVE commands (and variables) (nroff input)
  14.  
  15. jove.nr        JOVE manpage (nroff input)
  16. teachjove.nr    teachjove manpage (nroff input)
  17. jovetool.nr    jovetool manpage (nroff input)
  18. xjove.nr    xjove manpage (nroff input)
  19.  
  20. jove.qref    JOVE quick reference documentation
  21.  
  22. teach-jove    text used by teachjove program
  23.  
  24. example.rc    sample user .joverc (startup file)
  25.  
  26. jove.rc        standard system startup file
  27. jove-local.rc    (not supplied) local additional startup file.
  28.  
  29. jove.rc.3022    startup files for specific terminals
  30. jove.rc.sun
  31. jove.rc.sun-cmd
  32. jove.rc.vt100
  33. jove.rc.wyse
  34. jove.rc.xterm
  35. jove.rc.z29
  36.  
  37. keychart.        keyboard binding descriptions for specific terminals
  38. keychart.3022
  39. keychart.sun
  40. keychart.sun-cmd
  41. keychart.vt100
  42. keychart.wyse
  43. keychart.xterm
  44. keychart.z29
  45.  
  46. XTermresource    X Window System resource file to improve the codes
  47.         generated by XTerm.  See comments in the file.
  48.  
  49. The Makefile in the parent directory contains recipes for building
  50. and installing documentation and for installing the various startup
  51. files.
  52.  
  53. The file jove.rc is intended to be 'source'd before each run of jove
  54. (except when the -j flag is given).  This file contains various
  55. initializations, some of which are pretty well essential and some of which
  56. are suggestions for sysadmins to experiment with.  See the comments in
  57. this file.  Note that if you hack this file, you must take precautions to
  58. avoid your changes being lost if you upgrade Jove.  See jove-local.rc
  59. below for an alternative for performing local customizations.
  60.  
  61. A files jove.rc.$TERM, where $TERM is the value of the TERM environment
  62. variable, is 'source'd near the end the generic jove.rc, and provides
  63. suggested bindings for the function keys on the various terminals.  The
  64. selection of terminals given is somewhat arcane, and suggestions for
  65. bindings for other terminals would be welcomed.  See the comments in these
  66. files.
  67.  
  68. After jove.rc.$TERM is source'd, a file jove-local.rc is source'd if it
  69. exists.  Local settings can be placed in this file that will add to or
  70. override previous settings from jove.rc and/or jove.rc.TERM files.
  71. jove-local.rc may contain terminal bindings but is not terminal specific;
  72. if a site does a lot of terminal key binding customization for multiple
  73. terminal types, it should likely create a local terminal file and source
  74. it from this file (see jove.rc for an example of how to do this).
  75.  
  76. The user's $HOME/.joverc will be 'source'd after jove.rc.$TERM and
  77. jove-local.rc .  User preferences belong in this file.
  78.  
  79. The files keychart.TERM, where TERM is the value of the $TERM environment
  80. variable, are intended to display a map of the Function Keys on the
  81. particular keyboard showing what they are bound to.  This file will be
  82. displayed when the user gives the 'keychart' macro (which should usually
  83. be bound to the Help key, if there is one).  The file 'keychart.' is a
  84. dummy for unrecognized $TERMs.  Some of these files also contain setup
  85. information for the terminal.
  86.  
  87. We welcome contributions to our collection of terminal support files.
  88. We don't have the resources to create more than a few ourselves.
  89.