home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume23 / smiley / part01 / README < prev    next >
Text File  |  1991-10-22  |  4KB  |  111 lines
  1. smiley server, version 4
  2.  
  3. This version has about fifty more smileys than version 3.
  4. The file "other" is now shipped in uuencoded form since it
  5. contains control characters for a few animated smileys.
  6.  
  7. DESCRIPTION
  8.  
  9. smiley(1) is a "smiley server" I wrote for my own pleasure.  It can
  10. explain any smiley it knows, or print one it knows at random.  I use
  11. it to generate a random prompt when there is a status line available
  12. to hold the information I would otherwise put into my prompt.  Hence
  13. smiley(1) does not contain the invisible smiley or any multi-line
  14. smileys.
  15.  
  16. The list of smileys in faces.in is more comprehensive than I have seen
  17. anywhere else, largely because it is a superset of all the smiley lists
  18. I have ever seen posted on the net.  I have lost some of the original
  19. attributions; the articles whose headers I have retained are these:
  20.  
  21.     Message-ID: <76@icus.UUCP>
  22.     Message-ID: <1990Sep11.102411.8537@diku.dk>
  23.     Message-ID: <39917@cci632.UUCP>
  24.     Message-ID: <1990Sep14.122955.558@diku.dk>
  25.     Message-ID: <9366@uhccux.uhcc.Hawaii.Edu>
  26.     Message-ID: <2005@unsvax.NEVADA.EDU>
  27.     Message-ID: <1991Mar18.212208.27911@odin.corp.sgi.com>
  28.  
  29.     From: csh068@uk.ac.cov.cck (Smiley)
  30.     Message-ID: <$V5&&|$@cck.cov.ac.uk>
  31.     Date: 17 Apr 91 08:45:26 GMT
  32.  
  33.     From: raymond@cosc.canterbury.ac.nz (cantva)
  34.     Message-ID: <1991May18.150401.771@csc.canterbury.ac.nz>
  35.     Date: 18 May 91 03:03:59 GMT
  36.  
  37. In the interest of completeness and to the best of my knowledge (I
  38. started this collection several years ago) I have not "censored" the
  39. smileys, so there may be smileys you find offensive.  I certainly find
  40. some of them offensive!
  41.  
  42. The smileys are processed by mkfaces and deliberately embedded in the
  43. executable - it does not have to locate and parse an external data
  44. file.  In order to minimize the size of the executable, smiley.c does
  45. not use standard I/O.  I will ignore complaints about this; I do not
  46. anticipate ever using this program on a non-UNIX system.
  47.  
  48. I happened to take the included getopt.c from the rkive sources; it was
  49. originally posted to comp.sources.unix in volume3.  It is preferable to
  50. the getopt() provided on some systems as it does not use standard I/O.
  51.  
  52. The bsearch.c is from emx.utexas.edu:pub/mnt/src/lib/libposix, obtained
  53. Tue Mar 19 14:18:28 CST 1991
  54.  
  55. TERMS
  56.  
  57. This package (excluding getopt.c and bsearch.c) is
  58.  
  59. (C) Copyright 1991 by DaviD W. Sanderson.
  60.  
  61. You may copy it and use it for your own enjoyment.
  62. You may not represent it as your own work or sell it.
  63.  
  64. AUTHOR
  65.  
  66. DaviD W. Sanderson (dws@cs.wisc.edu)
  67.  
  68. DOCUMENTATION
  69.  
  70. This section is mainly intended for novices (more experienced people
  71. will already know all this).
  72.  
  73. Besides this file, there are two sources of information about what
  74. options smiley(1) takes.
  75.  
  76. 1) The file smiley.1 is the nroff/troff source for the man page for
  77. smiley(1).  The exact command to format it on your system may vary,
  78. but will typically be something like this:
  79.  
  80.     # format for viewing at the terminal
  81.     $ nroff -man smiley.1 | more
  82. or
  83.     # typeset and send to the printer named "lps1"
  84.     $ ditroff -Plps1 -man smiley.1
  85.  
  86. 2) The program itself prints a help message when you give it an illegal
  87. option.  Since it uses getopt(3) to process its options, the "-?" option
  88. is always illegal.  (All programs using getopt(3) to process their
  89. options really *ought* to print some sort of help message when given -?,
  90. though not all of them do.)  For example:
  91.  
  92.     $ smiley -?    # sh-like shells
  93.     % smiley -\?    # csh-like shells force you to quote the ?
  94.  
  95. As it happens, the -h flag is not a legal argument to smiley(1), and
  96. requires no quoting even in poor csh, so you can use that instead:
  97.  
  98.     % smiley -h
  99.  
  100. Now, since smiley(1) uses getopt(3), you can end the options with
  101. the special option "--".  This allows you to give smileys on the
  102. command line that would otherwise be interpreted as options.  For
  103. example, to get smiley(1) to explain the smiley "-=": 
  104.  
  105.     $ smiley -=    # here "-=" is interpreted as an illegal option
  106.     smiley: illegal option -- =
  107.     [rest of help message deleted]
  108.     $ smiley -- -=    # this works fine.
  109.     -=    a doused candle (to end a flame)
  110.     $
  111.