home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3001 / README < prev   
Text File  |  1991-03-06  |  3KB  |  77 lines
  1. -------
  2.  
  3. Program name:  jargon
  4. Source language:  icon
  5. Purpose:  quickly find entries in the hacker's jargon file
  6.  
  7. -------
  8.  
  9. Description:
  10.  
  11. This shell archive contains a jargon database program, aptly enough
  12. named "jargon."  If you have the recently posted (March 1, 1991, alt.
  13. sources) hacker's jargon file around, you can use this package for
  14. quick access to entries within that file, as in "jargon word" (where
  15. "word" is the bit of hacker's jargon you want a definition for).
  16.  
  17. -------
  18.  
  19. Installation:
  20.  
  21. Cp Makefile.dist to Makefile and edit it to reflect local naming con-
  22. ventions.  After editing, type "make all."  If, after seeing a lot of
  23. garbage go by, you get the message "everything seems OK," then su root
  24. and make install.  Be sure to set default ownership and permissions in
  25. the makefile to some value that makes sense for your system.  If you
  26. don't have root priviledges, you must change the DESTDIR and LIBDIR
  27. variables in the makefile so that they reflect directories you have
  28. access to.  Note that I am assuming a Unix installation in the
  29. makefile.  If you are using some other platform, you'll need to edit
  30. the file "jargon.src" so that the variable "database" is set to the
  31. full path of the jargon.wrd file (i.e. $(LIBDIR)/jargon.wrd in the
  32. makefile).  Then type:
  33.  
  34.     icont jarg2get.icn
  35.     icont -o idxtext idxtext.icn adjuncts.icn
  36.     copy jargon.src jargon.icn
  37.     icont -o jargon jargon.icn gettext.icn adjuncts.icn
  38.     thes2get < JARGONFILE > jargon.wrd
  39.     idxtext jargon.wrd
  40.  
  41. where "copy" is your system's file copy or rename command, and
  42. JARGONFILE is the name of the original jargon.ascii file.  To test a
  43. non-UNIX installation, type
  44.  
  45.     (ficonx) jargon zork
  46.  
  47. The ficonx part may not be necessary.  If you get a definition for
  48. "zork," then everything is probably OK.  If you altered jargon.src so
  49. that the database variable points to a jargon.wrd file in the current
  50. directory, then there is no need to do anything more.  If you named a
  51. database file in a different directory than the current one, then you
  52. should copy the jargon.wrd file to that directory, and then type
  53.  
  54.     (ficonx) idxtext DATABASE
  55.  
  56. where DATABASE gives the full path of your jargon.wrd file.  Running
  57. this command may take a minute, so be patient.
  58.  
  59. Note that I have not tried installing jargon on anything but a Unix
  60. system, so I have no idea how it will work.  In particular, there
  61. might be difficulties on systems for which newline translation is
  62. necessary.
  63.  
  64. -------
  65.  
  66. Admission:
  67.  
  68. Jargon is really just a cheap trick I use to get people to test a
  69. small text retrieval package.  This package is fully documented in the
  70. files
  71.  
  72.     gettext.icn
  73.     adjuncts.icn
  74.     idxtext.icn
  75.  
  76. Icon programmers will find gettext a nice, easy way to access
  77.