Provided by: wyrd_1.4.4-1_i386 bug

NAME

       wyrd  is  a text-based front-end to remind(1), a sophisticated calendar
       and alarm program.

SYNOPSIS

       wyrd [OPTIONS] [FILE]

DESCRIPTION

       Open the calendar and  display  reminders  defined  in  FILE  (and  any
       included reminder files). The default reminder file is ~/.reminders.

OPTIONS

       --version
               Display version information and exit.

       --help
               Display usage information.

       --add EVENT
               Add given event to reminders file and exit.

       --a EVENT
               Add given event to reminders file and exit.

QUICK START

       CAUTION: while this manpage should be suitable as a quick reference, it
       may be  subject  to  miscellaneous  shortcomings  in  typesetting.  The
       definitive  documentation  is the user manual provided with Wyrd in PDF
       or HTML format.

       This section describes how to use Wyrd in  its  default  configuration.
       After  familiarizing  yourself with the basic operations as outlined in
       this section, you may wish to consult the wyrdrc(5) manpage to see  how
       Wyrd can be configured to better fit your needs.

   OVERVIEW
       Before  attemping  to  use Wyrd, learn how to use Remind. Wyrd makes no
       attempt to hide the details of Remind programming from the user.

       At the top of the window is a short (incomplete) list of keybindings.

       The left window displays a scrollable timetable  view,  with  reminders
       highlighted  in various colors. If the DURATION specifier is used for a
       reminder, the highlighted area is rendered with  an  appropriate  size.
       Overlapping   reminders  are  rendered  using  one  of  four  different
       indentation levels  so  that  all  reminders  are  at  least  partially
       visible.  If  the  current  time  is  visible  in  this  window,  it is
       highlighted in red.

       The upper right window displays a month calendar,  with  the  color  of
       each  day  representing the number of reminders it contains. The colors
       range across shades of white to  blue  to  magenta  as  the  number  of
       reminders  increases.  The selected date is highlighted in cyan; if the
       current date is visible, it is highlighted in red.

       The lower right window displays a list of the untimed reminders falling
       on the selected date.

       The bottom window displays the full text of the MSG for the reminder or
       reminders that are currently selected.

   NAVIGATION
       --------------------------------------------------------------------------------------------------------
       Action                                                   Keypress
       --------------------------------------------------------------------------------------------------------
       scroll up and down the schedule                          <up>, <down> or k, j
       jump back or forward by a day                            <pageup>, <pagedown> or 4, 6 or <, > or H, L
       jump back or forward by a week                           8, 2 or [, ] or K, J
       jump back or forward by a month                          {, }
       jump to current date and time                            <home>
       jump to the next reminder                                <tab>
       switch between schedule and untimed reminders window     <left>, <right> or h, l
       zoom in on the schedule                                  z
       scroll the description window up and down                d, D
       --------------------------------------------------------------------------------------------------------

       Notice that if you have a numeric keypad, the {4, 6, 8,  2}  keys  will
       let   you  move  directionally  in  the  month  calendar  view  at  the
       upper-right  of  the  screen.  Similarly,  {H,  J,  K,  L}  will  cause
       directional calendar movement using the standard mapping from vi(1).

       In  addition  to  the  hotkeys  provided  above,  Wyrd  lets  you  jump
       immediately to a desired date by  pressing  'g',  entering  in  a  date
       specifier,  and  then  pressing  <return>.  Any  of  the following date
       specifiers may be used:

       *      8 digits representing year, month, and day: YYYYMMDD

       *      4 digits representing month and day (of current year): MMDD

       *      2 digits representing day (of current month and year): DD

       (The date specifier format may be  changed  to  DDMMYYYY;  consult  the
       section on CONFIGURATION VARIABLES.  )

   EDITING REMINDERS
       Note:  By  default,  Wyrd  is  configured to modify your reminder files
       using the text editor specified by the  $EDITOR  environment  variable.
       (This  configuration  has  been  tested  successfully  with a number of
       common settings for $EDITOR, including 'vim', 'emacs', and 'nano'.)  If
       you wish to use a different editor, see the wyrdrc(5) manpage.

       If  you  select a timeslot in the schedule view, then hit 't', you will
       begin creating a new timed reminder. Wyrd will open  up  your  reminder
       file  in  your  favorite  editor  and move the cursor to the end of the
       file, where a new reminder template has been created. The template  has
       the  selected  date  and time filled in, so in many cases you will only
       need to fill in a MSG value.

       Similarly, hitting 'u' will begin creating an  untimed  reminder.   'w'
       will  create  a  weekly  timed  reminder,  and 'W' will create a weekly
       untimed reminder; 'm' will create a monthly  timed  reminder,  and  'M'
       will create a monthly untimed reminder.

       'T' and 'U' also create timed and untimed reminders (respectively), but
       first will provide a selection dialog for you to choose which  reminder
       file  you  want  to  add this reminder to. The set of reminder files is
       determined by scanning the INCLUDE lines in your default reminder file.

       If you select a reminder (either timed or untimed)  and  hit  <return>,
       you will begin editing that reminder. Wyrd will open up the appropriate
       reminders file in your editor and move the cursor to the  corresponding
       REM line.

       If  you select a timeslot that contains multiple overlapping reminders,
       Wyrd will provide a dialog  that  allows  you  to  select  the  desired
       reminder.

       If  you hit <enter> on a blank timeslot, Wyrd will begin creating a new
       timed or untimed reminder  (depending  on  whether  the  timed  or  the
       untimed window is selected).

       Finally,  pressing  'e'  will  open  the  reminder  file in your editor
       without attempting to select any particular reminder.

   QUICK REMINDERS
       Wyrd offers an additional mode for entering simple  reminders  quickly.
       Press  'q',  and  you will be prompted for an event description. Simply
       enter a description for the event using natural  language,  then  press
       <return>. Examples:

       *      meeting with Bob tomorrow at 11

       *      drop off package at 3pm

       *      wednesday 10am-11:30 go grocery shopping

       *      Board game night 20:15 next Fri

       *      7/4 independence day

       *      7/4/2007 independence day (next year)

       *      independence day (next year) on 2007-07-04

       If  your  event  description  can  be understood, Wyrd will immediately
       create the reminder and scroll the display to its location.

       Currently  the  quick  reminder  mode  tends  to  favor   USA   English
       conventions,  as generalizing the natural language parser would require
       some work.

       Wyrd also allows you to use the "quick reminder" syntax to  create  new
       reminders  from  the  command  line, using the -a or --add options. For
       example,
       wyrd --add "dinner with neighbors tomorrow at 7pm"

       would create a new reminder for tomorrow evening.  When  used  in  this
       mode,  Wyrd  exits  silently  with  error  code  0  if the reminder was
       successfully created.  If the reminder could not be  created  (e.g.  if
       the  reminder syntax could not be parsed), Wyrd prints an error message
       and exits with a nonzero error code.

   CUTTING AND PASTING REMINDERS
       Reminders can be easily duplicated or rescheduled through  the  use  of
       Wyrd's cutting and pasting features.

       Selecting  a  reminder  and  pressing  'X'  will cut that reminder: the
       corrdsponding REM line is deleted from your  reminders  file,  and  the
       reminder  is  copied  to  Wyrd's  clipboard. To copy a reminder without
       deleting it, use 'y' instead.

       To paste a reminder from the clipboard back into  your  schedule,  just
       move  the  cursor  to  the  desired  date/time and press 'p'. Wyrd will
       append a new REM line to the end of your reminders file, and  open  the
       file  with  your  editor. The REM line will be configured to trigger on
       the selected date. If the copied reminder was timed,  then  the  pasted
       reminder will be set to trigger at the selected time using the original
       DURATION setting. (Additional Remind settings such as delta and  tdelta
       are not preserved by copy-and-paste.)

       If  you wish to paste a reminder into a non-default reminders file, use
       'P'. This will spawn a selection dialog where you can choose  the  file
       that will hold the new reminder.

       WARNING:  Cutting  a  reminder  will delete only the single REM command
       responsible for triggering it. If you are using more complicated Remind
       scripting  techniques  to  generate a particular reminder, then the cut
       operation may not do what you want.

   VIEWING REMINDERS
       Aside from viewing reminders as they fall  in  the  schedule,  you  can
       press  'r'  to  view  all reminders triggered on the selected date in a
       less(1) window. Similarly, 'R' will view all reminders triggered on  or
       after the selected date (all non-expired reminders are triggered).

       If  you want to get a more global view of your schedule, Wyrd will also
       let you view Remind's formatted calendar output in  a  less(1)  window.
       Pressing  'c'  will view a one-week calendar that contains the selected
       date, while pressing 'C' will view a one-month calendar containing  the
       selected date.

   SEARCHING FOR REMINDERS
       Wyrd  allows  you  to search for reminders with MSG values that match a
       search string. Press '/' to start entering a (case insensitive) regular
       expression.  After  the expression has been entered, press <return> and
       Wyrd will locate the next reminder that matches the regexp.  Press  'n'
       to  repeat  the  same search. Entry of a search string may be cancelled
       with <esc>.

       The regular expression syntax is Emacs-compatible.

       Note: Sorry,  there  is  no  "search  backward"  function.  The  search
       function  requires  the use of "remind -n", which operates only forward
       in time.  For the same reason, there is a command to  jump  forward  to
       the  next  reminder,  but  no  command to jump backward to the previous
       reminder.

   OTHER COMMANDS
       A list of all keybindings may be viewed by pressing '?'. You  can  exit
       Wyrd  by  pressing 'Q'. If the screen is corrupted for some reason, hit
       'Ctrl-L' to refresh the display.

   ALARM STRATEGIES
       You may wish to  generate  some  sort  of  alarm  when  a  reminder  is
       triggered.   Wyrd  does  not  offer  any  special  alarm functionality,
       because Remind can handle the job already. Check the Remind manpage and
       consider  how  the  -k option could be used to generate alarms with the
       aid of external programs.  For  example,  the  following  command  will
       generate a popup window using gxmessage(1) whenever a timed reminder is
       triggered:
       remind -z -k'gxmessage -title "reminder"  &' ~/.reminders &

       (A sensible way to start this alarm command is to place it in
        {.xinitrc} so that it launches when the X server is started.)  If  you
       want  some  advance  warning (say, 15 minutes), you can cause Remind to
       trigger early by setting a tdelta in the AT clause:
          REM Nov 27 2005 AT 14:30 +15 MSG Do something

       Alternatively, if  you  want  to  generate  alarms  only  for  specific
       reminders,  consider  using Remind's RUN command. This process could be
       easily  automated  by  using  the  templateN  configuration   variables
       described in the wyrdrc(5) manpage.

   MISCELLANEOUS
       Remind's  TAG  specifier  may  be  used  to  cause Wyrd to give special
       treatment to certain reminders. If a reminder line includes the  clause
       "TAG  noweight",  then Wyrd will not give that reminder any weight when
       determining  the  ``busy  level''  colorations  applied  to  the  month
       calendar.  If a reminder line includes the clause "TAG nodisplay", then
       Wyrd will neither display that reminder nor give  it  any  weight  when
       determining the month calendar colorations. The tag parameters are case
       insensitive.

       WARNING: These tag parameters are not guaranteed to interact well  with
       other Remind front-ends such as tkremind.

USAGE TIPS

       *      Wyrd  fills  in  sensible  defaults  for  the  fields  of  a REM
              statement, but you will inevitably need to make some small edits
              to  achieve  the behavior you want. If you use Vim, you can make
              your life easier by installing  the  Vim-Latex  Suite  and  then
              modifying your ~/.wyrdrc to use REM templates like this:

       set timed_template="REM %monname% %mday% %year% <++>AT %hour%:%min%<++>
       DURATION 1:00<++> MSG %\"<++>%\" %b"
       set untimed_template="REM %monname% %mday%  %year%  <++>MSG  %\"<++>%\"
       %b"

       With this change, hitting Ctrl-J inside Vim (in insert mode) will cause
       your cursor to jump directly to  the  <++>  markers,  enabling  you  to
       quickly add any desired Remind delta and message parameters.

LICENSING

       Wyrd  is  Free Software; you can redistribute it and/or modify it under
       the terms of the GNU  General  Public  License  (GPL),  Version  2,  as
       published  by  the Free Software Foundation. You should have received a
       copy of the GPL along with this program, in the file 'COPYING'.

ACKNOWLEDGMENTS

       Thanks, of course, to David Skoll for writing such a powerful  reminder
       system.   Thanks  also  to  Nicolas  George, who wrote the OCaml curses
       bindings used within Wyrd.

CONTACT INFO

       Wyrd author: Paul Pelzl <pelzlpj@eecs.umich.edu>
       Wyrd website: http://www.eecs.umich.edu/~pelzlpj/wyrd

MISCELLANEOUS

       ``Wyrd is a concept in ancient Anglo-saxon and Nordic cultures  roughly
       corresponding to fate.'' -- Wikipedia

SEE ALSO

       wyrdrc(5), remind(1)