Man Linux: Main Page and Category List

NAME

       wyrdrc  is  the configuration textfile for the wyrd(1) console calendar
       application.

INTRODUCTION

       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
       format.

       Wyrd  reads  a  run-configuration  textfile  (generally  /etc/wyrdrc or
       /usr/local/etc/wyrdrc) to determine key bindings,  color  schemes,  and
       many  other  settings. You can create a personalized configuration file
       in $HOME/.wyrdrc, and select settings that match your  usage  patterns.
       The  recommended  procedure  is to ‘‘include’’ the wyrdrc file provided
       with Wyrd (see INCLUDING OTHER RCFILES), and add or remove settings  as
       desired.

WYRDRC SYNTAX

       You  may notice that the wyrdrc syntax is similar to the syntax used in
       the configuration file for the Mutt email client (muttrc).

       Within the wyrdrc file, strings should be  enclosed  in  double  quotes
       (").  A double quote character inside a string may be represented by \"
       .  The backslash character must be represented by doubling it (\\).

   INCLUDING OTHER RCFILES
       Syntax: include filename_string
       This syntax can be used to include one  run-configuration  file  within
       another.   This  command  could be used to load the default wyrdrc file
       (probably found in /etc/wyrdrc or  /usr/local/etc/wyrdrc)  within  your
       personalized  rcfile,  ~/.wyrdrc  .   The  filename  string  should  be
       enclosed in quotes.

   SETTING CONFIGURATION VARIABLES
       Syntax: set variable=value_string
       A number of configuration variables can be set using this syntax; check
       the  CONFIGURATION  VARIABLES  description to see a list. The variables
       are unquoted, but the values should be quoted strings.

   CREATING KEY BINDINGS
       Syntax: bind key_identifier operation
       This command will bind a keypress to execute a calendar operation.  The
       various  operations,  which  should  not  be enclosed in quotes, may be
       found in the section on CALENDAR OPERATIONS.  Key  identifiers  may  be
       specified  by strings that represent a single keypress, for example "m"
       (quotes included). The key may be  prefixed  with  "\\C"  or  "\\M"  to
       represent  Control or Meta (Alt) modifiers, respectively; note that the
       backslash  must  be  doubled.   A   number   of   special   keys   lack
       single-character  representations, so the following strings may be used
       to represent them:

       *      "<esc>"

       *      "<tab>"

       *      "<enter>"

       *      "<return>"

       *      "<insert>"

       *      "<home>"

       *      "<end>"

       *      "<pageup>"

       *      "<pagedown>"

       *      "<space>"

       *      "<left>"

       *      "<right>"

       *      "<up>"

       *      "<down>"

       *      "<f1>" to "<f12>"

       Due  to  differences  between  various  terminal  emulators,  this  key
       identifier  syntax may not be adequate to describe every keypress. As a
       workaround, Wyrd will also accept key identifiers in octal notation. As
       an  example,  you  could  use  \024  (do  not  enclose it in quotes) to
       represent Ctrl-T.

       Multiple keys may be bound to the same operation, if desired.

   REMOVING KEY BINDINGS
       Syntax: unbind key_identifier
       This  command  will  remove  all  bindings  associated  with  the   key
       identifier.  The  key  identifiers  should  be defined using the syntax
       described in the previous section.

   SETTING THE COLOR SCHEME
       Syntax: color object foreground background
       This command will apply the specified foreground and background  colors
       to  the  appropriate object. A list of colorable objects is provided in
       the section on COLORABLE OBJECTS.  Wyrd will  recognize  the  following
       color  keywords: black, red, green, yellow, blue, magenta, cyan, white,
       default.  The  default  keyword  allows  you  to  choose  the   default
       foreground or background colors. If you use default for your background
       color,  this  will  access  the  transparent  background  on   terminal
       emulators which support it.

CONFIGURATION VARIABLES

       The  following  configuration  variables may be set as described in the
       SETTING CONFIGURATION VARIABLES section.

       *      remind_command
              Determines the command used to execute Remind.

       *      reminders_file
              Controls which Remind file Wyrd will operate on. The default  is
              ~/.reminders .

       *      edit_old_command
              Controls  the  command used to edit a pre-existing reminder. The
              special strings ’%file%’ and ’%line%’ will be  replaced  with  a
              filename  to  edit  and a line number to navigate to within that
              file.

       *      edit_new_command
              Controls the command used to edit a new  reminder.  The  special
              character  ’%file%’  will  be  replaced with a filename to edit.
              Ideally, this command should move the cursor to the last line of
              the file, where the new reminder template is created.

       *      edit_any_command
              Controls  the  command  used for editing a reminder file without
              selecting  any  particular  reminder.  The   special   character
              ’%file%’ will be replaced with a filename to edit.

       *      timed_template
              Controls  the  format of the REM line created when editing a new
              timed reminder. The following string substitutions will be made:
              ’%monname%’ - month name, ’%mon%’ - month number, ’%mday%’ - day
              of the month, ’%year%’  -  year,  ’%hour%’  -  hour,  ’%min%’  -
              minute,  ’%wdayname%’ - weekday name, ’%wday%’ - weekday number.

       *      untimed_template
              Controls the format of the REM line created when editing  a  new
              untimed  reminder.  The  substitution  syntax is the same as for
              timed_template.

       *      templateN
              Controls the format of a generic user-defined REM line template;
              N  may range from 0 to 9. The substitution syntax is the same as
              for timed_template.

       *      busy_algorithm
              An integer value specifying which algorithm to use for measuring
              how busy the user is on a particular day. If busy_algorithm="1",
              then Wyrd will  simply  count  the  total  number  of  reminders
              triggered  on  that  day.  If busy_algorithm="2", then Wyrd will
              count the number of hours of reminders that fall  on  that  day.
              (Untimed   reminders  are  assumed  to  occupy  untimed_duration
              minutes.)

       *      untimed_duration
              An integer value that  specifies  the  assumed  duration  of  an
              untimed  reminder,  in minutes. This is used only when computing
              the busy level with busy_algorithm="2".

       *      busy_level1
              An integer value specifying the maximum number of reminders in a
              day (with busy_algorithm="1") or maximum hours of reminders in a
              day (with busy_algorithm="2") which will be  colored  using  the
              color scheme for calendar_level1.

       *      busy_level2
              Same as above, using the calendar_level2 color scheme.

       *      busy_level3
              Same  as  above, using the calendar_level2 color scheme rendered
              in bold.

       *      busy_level4
              Same as above, using the calendar_level3 color scheme.  Any  day
              with  more  reminders  than  this  will  be  rendered  using the
              calendar_level3 color scheme rendered in bold.

       *      week_starts_monday
              A boolean value ("true" or "false") that  determines  the  first
              day of the week.

       *      schedule_12_hour
              A  boolean  value  that  determines  whether the timed reminders
              window is drawn using 12- or 24-hour time.

       *      selection_12_hour
              A  boolean  value  that   determines   whether   the   selection
              information is drawn with 12- or 24-hour time.

       *      status_12_hour
              A  boolean  value  that  determines  whether the current time is
              drawn using a 12- or 24-hour clock.

       *      description_12_hour
              A boolean value that determines whether reminder start  and  end
              times  are  drawn  using  12- or 24-hour time in the description
              window. This value also controls the format of timestamps in the
              formatted calendars produced by view_week and view_month.

       *      center_cursor
              A  boolean  value that determines how the screen and cursor move
              during scrolling operations. When set to "true", the  cursor  is
              fixed  in  the  center  of  the  timed reminders window, and the
              schedule scrolls around it. When set to "false"  (the  default),
              the  cursor  will move up and down the schedule during scrolling
              operations.

       *      goto_big_endian
              A boolean value that determines how the the goto operation  will
              parse  dates.  When  set to "true", date specifiers should be in
              ISO 8601 (YYYYMMDD) format. When set to "false", date specifiers
              should be in European style DDMMYYYY format.

       *      quick_date_US
              A boolean value that determines how the quick_add operation will
              parse numeric dates with slashes, e.g. 6/1 (or  6/1/2006).  When
              set to "true", the first number is a month and the second is the
              day of the month (June 1). When set to "false",  these  meanings
              of these two fields are switched (January 6).

       *      number_weeks
              A  boolean  value that determines whether or not weeks should be
              numbered within the month calendar window.  Weeks  are  numbered
              according to the ISO 8601 standard. The ISO standard week begins
              on  Monday,  so  to  avoid  confusion  it  is  recommended  that
              week_starts_monday  be  set  to  "true"  when  week numbering is
              enabled.

       *      home_sticky
              A boolean value that determines whether or not the cursor should
              "stick"  to  the  "home"  position.  When  this option is set to
              "true", then after pressing  the  <home>  key  the  cursor  will
              automatically  follow  the  current date and time. The effect is
              cancelled by pressing any of the navigation keys.

       *      untimed_window_width
              An integer  value  that  determines  the  target  width  of  the
              month-calendar  window  and  the  untimed  reminders window. The
              allowable range is 34 to ($COLUMNS - 40)  characters,  and  Wyrd
              will silently disregard any setting outside this range.

       *      advance_warning
              A  boolean  value  that  determines  whether  or not Wyrd should
              display advance warning of reminders. When set to  "true",  Wyrd
              will  invoke  Remind in a mode that generates advance warning of
              reminders as specified in the reminder file.

       *      untimed_bold
              A boolean value that  determines  whether  or  not  Wyrd  should
              render untimed reminders using a bold font.

       For  maximum  usefulness,  busy_level1  <  busy_level2  < busy_level3 <
       busy_level4.

CALENDAR OPERATIONS

       Every Wyrd operation can be made available to the interface  using  the
       syntax  described  in  the  section  on  CREATING  KEY  BINDINGS.   The
       following is a list of every available operation.

       *      scroll_up
              move the cursor up one element

       *      scroll_down
              move the cursor down one element

       *      next_day
              jump ahead one day

       *      previous_day
              jump backward one day

       *      next_week
              jump ahead one week

       *      previous_week
              jump backward one week

       *      next_month
              jump ahead one month

       *      previous_month
              jump backward one month

       *      home
              jump to the current date and time

       *      goto
              begin entering a date specifier to jump to

       *      zoom
              zoom in on the day schedule view (this operation is cyclic)

       *      edit
              edit the selected reminder

       *      edit_any
              edit a reminder file, without selecting any particular reminder

       *      scroll_description_up
              scroll the description window contents up (when possible)

       *      scroll_description_down
              scroll the description window contents down (when possible)

       *      quick_add
              add a ‘‘quick reminder’’

       *      new_timed
              create a new timed reminder

       *      new_timed_dialog
              same as previous, with a reminder file selection dialog

       *      new_untimed
              create a new untimed reminder

       *      new_untimed_dialog
              same as previous, with a reminder file selection dialog

       *      new_templateN
              create a new user-defined reminder using templateN, where N  may
              range from 0 to 9

       *      new_templateN_dialog
              same as previous, with a reminder file selection dialog

       *      copy
              copy a reminder to Wyrd’s clipboard

       *      cut
              delete a reminder and copy it to Wyrd’s clipboard

       *      paste
              paste a reminder from Wyrd’s clipboard into the schedule

       *      paste_dialog
              same as previous, with a reminder file selection dialog

       *      switch_window
              switch  between  the  day  schedule  window on the left, and the
              untimed reminder window on the right

       *      begin_search
              begin entering a search string

       *      search_next
              search for the next occurrence of the search string

       *      next_reminder
              jump to the next reminder

       *      view_remind
              view the output of remind for the selected date

       *      view_remind_all
              view the output of remind for the selected date, triggering  all
              non-expired reminders

       *      view_week
              view  Remind’s formatted calendar for the week that contains the
              selected date (the in-calendar timestamp formats are  determined
              by the value of description_12_hour)

       *      view_month
              view Remind’s formatted calendar for the month that contains the
              selected date (the in-calendar timestamp formats are  determined
              by the value of description_12_hour)

       *      refresh
              refresh the display

       *      quit
              exit Wyrd

       *      entry_complete
              signal completion of search string entry or date specifier

       *      entry_backspace
              delete the last character of the search string or date specifier

       *      entry_cancel
              cancel entry of a search string or date specifier

COLORABLE OBJECTS

       Each of Wyrd’s on-screen elements may be colored by the color scheme of
       your  choice,  using  the  syntax defined in the section on SETTING THE
       COLOR SCHEME.  The following is a list of all colorable objects.

       *      help
              the help bar at the top of the screen

       *      timed_default
              an empty timeslot in the day-schedule window

       *      timed_current
              the current time in the day-schedule window (if it is visible)

       *      timed_reminder1
              a nonempty timeslot in  the  day-schedule  window,  indented  to
              level 1

       *      timed_reminder2
              a  nonempty  timeslot  in  the  day-schedule window, indented to
              level 2

       *      timed_reminder3
              a nonempty timeslot in  the  day-schedule  window,  indented  to
              level 3

       *      timed_reminder4
              a  nonempty  timeslot  in  the  day-schedule window, indented to
              level 4

       *      untimed_reminder
              an entry in the untimed reminders window

       *      timed_date
              the vertical date strip at the left side of the screen

       *      selection_info
              the line providing date/time for the current selection

       *      description
              the reminder description window

       *      status
              the bottom bar providing current date and time

       *      calendar_labels
              the month and weekday labels in the calendar window

       *      calendar_level1
              calendar days with low activity

       *      calendar_level2
              calendar days with medium activity

       *      calendar_level3
              calendar days with high activity

       *      calendar_today
              the current day in the calendar window (if it is visible)

       *      left_divider
              the vertical line to the left of the timed reminders window

       *      right_divider
              the vertical and horizontal lines to  the  right  of  the  timed
              reminders window

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

       wyrd(1), remind(1)

AUTHOR

       This manpage is written by Paul J. Pelzl <pelzlpj@eecs.umich.edu>.

configuration file for the Wyrd21aFebruaryp2008ation