Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / zotnet / tws / phoon / README
1 First distribution of phoon, deltime, and libtws - 15nov86.
2
3
4 This package contains two programs and a library:
5
6     phoon - program to display the PHase of the mOON.  Unlike other
7     such programs, which just tell you how long since first quarter
8     or something like that, phoon *shows* you the phase with a little
9     picture.  I've put an example at the end of this file.
10
11     deltime - program to subtract date/times.  Tells you the difference
12     between two date/times, or between now and a specified date/time.
13     I once used this to help a friend quit smoking - every time she
14     logged in, the computer told her how many days since her last
15     cigarette.  I also use it in my .login, to tell me how old I am.
16
17     libtws - date/time library.  Unlike the standard Unix(R)
18     date/time routines, libtws lets you parse a date/time string
19     into internal form.  Most of this library came from version
20     6.5 of the MH message handling system, courtesy of Marshall Rose.
21
22
23 Files in this distribution:
24
25     README              this
26     Makefile            guess
27     deltime.c           source for time subtraction tool
28     deltime.man         manual for time subtraction tool
29     dtime.c             source for most of the time routines
30     dtimep.lex          source for time-parsing routine
31     lexedit.sed         script to modify output of lex
32     lexstring.c         front end for time-parsing routine
33     libtws.man          manual for time library
34     parsetime.c         source for test program
35     phoon.c             source for phase of moon program
36     phoon.man           manual for phase of moon program
37     tws.h               include file for time library
38
39
40 Unpack the files, edit Makefile and change the options to suit,
41 make, and enjoy!  I've tested this stuff under 4.2 BSD, 4.3 BSD,
42 and System V rel 2.  Nevertheless, I'm sure bugs remain.  Feedback
43 is welcome - send bug reports, enhancements, checks, money orders,
44 etc. to the addresses below.
45
46
47      Jef Poskanzer, UniSoft Systems, Berkeley
48          unisoft!jef@ucbvax.Berkeley.Edu
49               ...ucbvax!unisoft!jef
50                   (415)644-1230
51
52                   ------------.
53              .--'  o     . .   `--.
54           .-'   .    O   .       . `-.
55         -'@   @@@@@@@   .  @@@@@      `-.
56        @@@  @@@@@@@@@@@   @@@@@@@   .    \
57      /    o @@@@@@@@@@@   @@@@@@@       . \.
58     @@  o   @@@@@@@@@@@.   @@@@@@@   O      \
59    @@@@   .   @@@@@@@o    @@@@@@@@@@     @@@ \
60    @@@@@               . @@@@@@@@@@@@@ o @@@@|
61   @@@@@  O  `.-./  .      @@@@@@@@@@@@    @@  \         First Quarter +
62    @@@@    --`-'       o     @@@@@@@@ @@@@    |         5 22:33:24
63   @ @@@        `    o      .  @@   . @@@@@@@  |         Full Moon -    
64          @@            .-.     @@@   @@@@@@@  |         1 10:37:39
65     . o        @@@     `-'   . @@@@   @@@@  o /
66          @@   @@@@@ .           @@   .       |
67         @@@@  @\@@    /  .  O    .     o   . /
68       o  @@     \ \  /         .    .       /
69      \     .    .\.-.___   .      .   .-. /'
70                   `-'                `-' /
71         -.   o   / |     o    O   .   .-'
72           `-.   /     .       .    .-'
73              `--.       .      .--'
74                   ------------'