home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / business / calend2.lzh / CALENDAR / MONTH.MAN < prev    next >
Text File  |  1991-11-01  |  10KB  |  225 lines
  1. month(1)
  2.  
  3. NAME
  4.         month - a visual monthly calendar and time/event browser
  5.  
  6. SYNOPSIS
  7.         month [-d]
  8.  
  9. DESCRIPTION
  10.  
  11.     Overview
  12.  
  13.         Month displays a calendar of the current month of the current year,
  14.         with the current day highlighted.  It then allows the user to browse
  15.         to any month/day/year he chooses, and to schedule and recall events
  16.         for a day or for some regular repeating series of days.
  17.  
  18.     Screen Areas
  19.  
  20.         There are four distinct areas of the screen.  The days area where
  21.         the days of the month are listed in calendar format, the months area
  22.         where the months of the year are listed, the years area where a
  23.         sequence of years are listed, and the schedule area, which may be
  24.         blank and occupies lines 19-24 on the terminal. (lines below 24 are
  25.         not used)
  26.  
  27.     Commands
  28.         
  29.         Quitting
  30.                 You may type 'Q' almost any time to quit.  This will update
  31.                 your event database if you have made any changes.
  32.                 Your event database is a file called ".month" in your
  33.                 home directory.
  34.                 Control-c or Control-\ can be used any time for immediate
  35.                 abort and no event database update.
  36.                 Any time you quit in any of these ways, you will be informed
  37.                 of whether your event database has been updated.
  38.  
  39.         Cursor motion
  40.  
  41.             'h', 'l', 'k', and 'j' are used to move the cursor left, right,
  42.             up and down respectively within a screen area.  In some cases,
  43.             explained later, 'j' and 'k' will not work, and a <TAB> or <CR>
  44.             is used to move between fields in a wrap-around fashion.
  45.  
  46.         Selection
  47.  
  48.             <CR> and <LF> are used to select items/commands at the cursor
  49.             position.
  50.         
  51.         Direct entry of numbers
  52.  
  53.             The user may type the number of a desired month, day, or year
  54.             whenever the cursor is appropriately positioned.  This is
  55.             true in all screen areas.  <ESC> is used to abort the function.
  56.         
  57.         Scrolling numbers
  58.  
  59.             In the schedule area, numbers may be scrolled forwards and
  60.             backwards with the <SPACE> and <BACKSPACE> keys respectively.
  61.             This is the only way to change hours and minutes.
  62.         
  63.         Time browsing
  64.  
  65.             'm', 'd' and 'y' are used to move into the months area, the
  66.             days area or the years area respectively.  This is only when
  67.             time browsing in these three panes.  To get to a particular
  68.             month or year, move to the appropriate area and onto the
  69.             desired month or year, and select it. (<CR>)  Years may be
  70.             scrolled a year at a time by using the scroll areas marked
  71.             by '<<' and '>>'.  Attempting to move passed these areas will
  72.             scroll by one year, selecting them scrolls by ten years.
  73.             The last month of the previous year, or the first month of
  74.             next year, may be obtained by selecting the area above
  75.             January or below December respectively.  The cursor is the
  76.             positioned for immediate return via a subsequent selection.
  77.  
  78.             'n' and 'p' can be used to go to the next or previous month,
  79.             day, or year, depending on which screen area you are in.
  80.  
  81.             'M' is used to mark a specific date.  You will be prompted for
  82.             an identifier which is a single digit between '0' and '9'.
  83.             Once a mark has been set at a certain date, you may jump to
  84.             that date from any other date with the command below.
  85.  
  86.             'G' is used to go to a previously set mark.  You will be
  87.             prompted for the mark's identifying digit.
  88.  
  89.             ';' is used to go directly to the last date you viewed which
  90.             was in a different month than currently displayed.  Use the
  91.             same command again to return to where you were originally.
  92.  
  93.             'T' is used to go directly the actual, real current date, which
  94.                 is the date initially displayed upon startup.
  95.         
  96.         Overviewing a day
  97.  
  98.             'O' will fill the schedule area with a read only view
  99.             of your day according to your event database.  Four
  100.             six-hour grids appear showing which hours of the
  101.             day have been pre-scheduled.  The cursor must be placed
  102.             on the day to be viewed with this function.
  103.  
  104.         Overviewing a month
  105.  
  106.             'A' will mark all the days on the calendar that have
  107.             at least one event posted.  This feature is especially
  108.             useful before scanning; described next.
  109.  
  110.         Scanning events
  111.  
  112.                 'S' will cause a sequential list of events for the current day
  113.                 to be displayed in the schedule area.  The events for any given
  114.                 day may be scanned, deleted, or modified.
  115.             After displaying each one, the prompt "[n,p,d,e,q]" is put
  116.             up and will respond to these character commands:
  117.  
  118.                 'n': go to next event
  119.                 'p': go to previous event
  120.                 'd': delete this event
  121.                 'e': edit this event as during a posting described below
  122.                 'q': quit the scan and return to calendar
  123.                 <ESC>: same as 'q'
  124.  
  125.         Every event scan
  126.  
  127.             'E' will display, one at a time, absolutely every event
  128.             in your event database.  The prompt "['n','q']" is displayed
  129.             and will respond to these character commands:
  130.  
  131.                 'n': go to next event
  132.                 'q': quit the scan and return to calendar
  133.                 <ESC>: same as 'q'
  134.         
  135.         Posting an event
  136.  
  137.             'P' is the command used to post an event.  The
  138.             cursor is placed into the schedule area with a host of
  139.             information displayed.  To discontinue, use <ESC> or
  140.             select CANCEL.  The cursor first appears on the first
  141.             line of the schedule area.  This line gives the starting
  142.             date for the event, and when it shall occur.  The user
  143.             may move into the starting date and change the month,
  144.             day and year by scrolling with <SPACE> and <BACKSPACE>,
  145.             or by directly typing it.  The other fields in this
  146.             first line may be moved onto and selected.  <TAB> will
  147.             move the cursor to the next line which contains the
  148.             time at which the event occurs.  'h' and 'l' move between
  149.             the hours and minutes fields which may be scrolled.  The
  150.             AM/PM indicator changes as the hours scroll across
  151.             12:00 boundaries.  <TAB> will move the cursor to the
  152.             next line which gives the duration of the event, and
  153.             it is edited in the same fashion.  <TAB> moves the cursor
  154.             to the next line which is a one line description of the
  155.             event, to be typed whenever the cursor is placed here.
  156.             <TAB> moves to the last line in the schedule area which
  157.             allows the user to select ACCEPT or CANCEL.  Selecting
  158.             ACCEPT will put the event into the user's event database,
  159.             after being asked if he really wants it to be.  Selecting
  160.             CANCEL aborts the process.  <TAB> returns to the first
  161.             line.
  162.  
  163.             Event scheduling
  164.  
  165.                 When and how often will an event occur?  This information
  166.                 is contained in the first line of the schedule area.  The
  167.                 date entered there is the starting date for the event,
  168.                 that is, the event will not be recalled until that date.
  169.                 This date is best entered by browsing to it, placing the
  170.                 cursor in the days area on the desired day, and then
  171.                 type 'P' to post the event, in which case the desired date
  172.                 automatically appears as the default, but may be edited.
  173.                 In the following examples, only the fields that need to be
  174.                 selected are mentioned, all others should be turned off.
  175.                 (not highlighted)  Examples:
  176.  
  177.                 March 5, 1990 (once only)
  178.                     3/5/1990
  179.                 
  180.                 Every Tuesday and Wednesday
  181.                     m/d/y every TueWed
  182.                 
  183.                 The 7th of each month
  184.                     m/7/y monthly
  185.                 
  186.                 Each July 4th
  187.  
  188.                     7/4/y yearly
  189.  
  190.                 The 2nd and last sunday of each month
  191.                     m/d/y monthly every 2nd last Sun
  192.  
  193.                 The 1st and last friday of each year
  194.                     m/d/y yearly every 1st last Fri
  195.  
  196.                 Every other thursday
  197.                     m/d/y every 2nd Thu
  198.                     Note, this will include the 1st, 3rd, 5th, 7th, etc.
  199.                     thursday, starting from the specified m/d/y
  200.  
  201.         Miscellaneous
  202.  
  203.             'L' stands for lunar, and causes a picture of what the moon will
  204.             look like at 11:00PM on the day on which the cursor is placed.
  205.                 '^L' or '^R' will redraw the screen.
  206.  
  207. OPTIONS
  208.         Specifying the -d flag causes a background daemon to be born that
  209.         will wake up at 15 minute intervals during the current login
  210.         session, check your event database, and print a message to your
  211.         terminal with a bell if it finds an event that is 15 minutes, or
  212.         less, away.  It will do this check upon invocation, then wake up
  213.         on every 15-minute clock division until killed or you log out.
  214.  
  215. CAVEATS/BUGS
  216.         Very few attempts have been made to prevent the user from browsing
  217.         through negatively numbered years or years with more than four
  218.         digits in them, the latter causing the years area to get messed up,
  219.         but remains functional.
  220.         In rare cases, events with a starting date before the year 1753,
  221.         will not be recalled correctly.
  222.  
  223. FILES
  224.         $HOME/.month
  225.