Home
Wyrd v1.2 User Manual
Contents
1. http www gnu org software ncurses ncurses html Shttp www roaringpenguin com penguin open_source_remind php Shttp www gnu org software make 3 Quick Start 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 Section 4 to see how Wyrd can be configured to better fit your needs 3 1 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 Aside from reading the Remind manpage you may get some useful pointers by reading Mike Harris s article on 43 Folders or David Skoll s writeup on Linux Journal You can launch Wyrd using the default reminder file by executing wy rd If desired a different reminder file may be selected by executing wyrd lt filename gt 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 th
2. 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 6 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 12 7 Contact info Wyrd author Paul Pelzl lt pelzlpj eecs umich edu gt Wyrd website http www eecs umich edu pelzlpj wyrd Feel free to contact me if you have bugs feature requests patches etc I would also welcome volunteers interested in packaging Wyrd for various platforms Wyrd is developed with the aid of the excellent GNU Arch RCS Interested developers are advised to track Wyrd development via my public archive pelzlpj eecs umich edu 2005 http www personal engin umich edu pelzlpj tla 2005 Primary development may be found on branch wyrd main Wyrd uses tla s configs support After getting a copy of the source run tla build config dist arch in the project tree root to grab the extra packages that Wyrd de pends on 8 Miscellaneous Wyrd is a concept in ancient Anglo saxon and Nordic cultures roughly corresponding to fate Wikipedia http www gnu org software gnu arch 13
3. different editor see Section 4 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 re minder 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 lt return gt you will begin editing that reminder Wyrd will open up the appropriate reminders file in your editor and move the cursor to the appropriate 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 lt enter gt on a blank timeslot Wyrd will begin creating a new timed or untimed reminder depending on whether the timed
4. a scrollable timetable view suitable for visualizing your calendar at a glance 2 It makes creating and editing reminders fast and easy However Wyrd does not hide Remind s textfile programmability for this is what makes Remind a truly powerful calendaring system Wyrd also requires only a fraction of the resources of most calendar programs available today 2 Installation This section describes how to install Wyrd by compiling from source Volunteers have pre packaged Wyrd for several popular operating systems so you may be able to save yourself some time by installing from those packages Please check the Wyrd website for up to date package information Wyrd is designed to be portable to most Unix like operating systems including GNU Linux BSD and Mac OS X Before installing Wyrd your system must have the following software installed e OCaml gt 3 08 e the ncurses library and development headers e Remind gt gt 3 0 24 e GNU make e standard Unix utilities such as cat sort and less Wyrd may be compiled by executing the following at the root of the source tree configure make After compiling become root and execute make install to complete the installation process The make command here should correspond to GNU make on some systems particularly BSD you may need to use gmake http www roaringpenguin com penguin open_source_remind php http www eecs umich edu pelzlpj wyrd 3http caml inria fr
5. e timed_current the current time in the day schedule window if it is visible e timed_reminderl a nonempty timeslot in the day schedule window indented to level 1 e timed_reminder2 a nonempty timeslot in the day schedule window indented to level 2 e timed_reminder3 a nonempty timeslot in the day schedule window indented to level 3 e timed_reminder4 a nonempty timeslot in the day schedule window indented to level 4 e untimed_reminder an entry in the untimed reminders window e timed_date the vertical date strip at the left side of the screen 11 e selection_info the line providing date time for the current selection e description the reminder description window e status the bottom bar providing current date and time e calendar_labels the month and weekday labels in the calendar window e calendar_levell calendar days with low activity e calendar_level2 calendar days with medium activity e calendar_level3 calendar days with high activity e calendar_today the current day in the calendar window if it is visible e calendar_selection the selected day in the calendar window e left_divider the vertical line to the left of the timed reminders window e right_divider the vertical and horizontal lines to the right of the timed reminders window 5 Licensing Wyrd is Free Software you can redistribute it and or modify it under the terms of the GNU General Public License
6. Wyrd v1 2 User Manual Paul J Pelzl November 19 2005 Because you re tired of waiting for your bloated calendar program to start up Contents 1 Introduction 2 Installation 3 Quick Start SSL COVELVIEW DP A A A EE A A AAA Be ee aa 3 2 Navigation e aha a A lada Bd ll a ia 3 3 Editing Reminders 3 4 Viewing Reminders 3 5 Searching for Reminders 0 00 2 ee 36 Other Commands 0 2k 2 aoe a A a reo Baie Gee ape She Bet ahd 3 0 Alarm Sttatesies tana oe ae eas ek Re a ek BO oe ae a eed 3 82 Miscellaneous i resme Ace aula Gay awe eRe da Pade ly act A a ae Aa 4 Advanced Configuration Aull wy Vore Syntaks sa 4 20 dw eae et Bh a i Ae eee ot See oe oh et 4 1 1 Including Other Refiles 2 2 0 0 000 020 0 0000000000004 4 1 2 Setting Configuration Variables 0 o o e 4 1 3 lt Creating Key Bindings aaie ie a i a a AA A A a 4 1 4 Removing Key Bindings e 4 15 Setting the Color Scheme 000000000000 00 8 4 2 Configuration Variables e 4 3 Calendar Operations pa a ias A a a a jo ae de da 4 4 Colorable Objects hc da ss a A a aa Go ed 5 Licensing 6 Acknowledgments 7 Contact info 8 Miscellaneous 12 12 13 13 1 Introduction Wyrd is a text based front end to Remind a sophisticated calendar and alarm program available from Roar ing Penguin Software Inc Wyrd serves two purposes 1 It displays reminders in
7. _algorithm 1 or maximum hours of reminders in a day with busy_algorithm 2 which will be colored us ing the color scheme for calendar_levell usy_level2 ame as above using the calendar_level2 color scheme no busy_level3 Same as above using the calendar_level2 color scheme rendered in bold busy_level4 Same as above using the calendar_leve13 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 e status_12_hour A boolean value that determines whether the current time is drawn using a 12 or 24 hour clock e 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 e 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
8. around it When set to false the default the cursor will move up and down the schedule during scrolling operations For maximum usefulness busy_levell lt busy_level2 lt busy_level3 lt busy_level4 4 3 Calendar Operations Every Wyrd operation can be made available to the interface using the syntax described in Section 4 1 3 The following is a list of every available operation e scroll up move the cursor up one element e scroll_down move the cursor down one element e next_day jump ahead one day e previous day jump backward one day e next_week jump ahead one week e previous week jump backward one week e next_month jump ahead one month e previous month jump backward one month e home jump to the current date and time e 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 new_timed create a new timed reminder new_timed_dialog ame as previous with a reminder file selection dialog n new_untimed create a new untimed reminder new_untimed_dialog ame as previous with a reminder file selection dialog n new_templateN create a new user defined reminder using templateN where N may
9. e 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 3 2 Navigation Action Keypress scroll up and down the schedule lt up gt lt down gt ork j jump back or forward by a day lt pageup gt lt pagedown gt or 4 6 or lt gt or H L jump back or forward by a week 8 2or orK J jump back or forward by a month jump to current date and time lt home gt jump to the next reminder lt tab gt switch between schedule and untimed reminders window lt left gt lt right gt orh 1 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 Thttp www 43folders com 2005 02 guest_mike_harr html Shttp www linuxjournal com article 3529 3 3 Editing Reminders Note By default Wyrd is configured to use the Vim editor for modifying your reminder files To use a
10. nd in et c wyrdrc or usr local etc wyrdrc within your personalized rcfile wyrdrc The filename string should be enclosed in quotes 4 1 2 Setting Configuration Variables Syntax set variable value_string A number of configuration variables can be set using this syntax check Section 4 2 to see a list The variables are unquoted but the values should be quoted strings 4 1 3 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 Section 4 3 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 AM 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 e lt esc gt e lt tab gt e lt enter gt e lt return gt e lt insert gt e lt home gt e lt end gt e lt pageup gt e lt pagedown gt o lt space gt e lt left gt e lt right gt e lt up gt e lt down gt e Wes Io to Lia al 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 n
11. or the untimed window is selected Finally pressing e will open the reminder file in your editor without attempting to select any partic ular reminder 3 4 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 ina 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 3 5 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 lt return gt 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 lt esc gt 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
12. otation As an example you could use 1024 do not enclose it in quotes to represent Ctrl T Multiple keys may be bound to the same operation if desired 4 1 4 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 4 1 5 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 Section 4 4 Wyrd will recognize the following color keywords black red green yellow blue magenta cyan white 4 2 Configuration Variables The following configuration variables may be set as described in Section 4 1 2 e remind_ command Determines the command used to execute Remind e reminders file Controls which Remind file Wyrd will operate on The default is reminders e edit_old_command Controls the command used to edit a pre existing reminder The special characters Sf and Sn will be substituted with a filename to edit and a line number to navigate to within that file e edit_new_command Controls the command used to edit a new reminder The special character will be substituted with a filename to edit Ideally this command should move the cursor to the last line of the file where the new reminder template i
13. range from 0 to 9 new_templateN_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 times tamp formats are determined by the value of description_12_hour 10 e view_month view Remind s formatted calendar for the month that contains the selected date the in calendar times tamp formats are determined by the value of description_12_hour e refresh refresh the display e quit exit Wyrd e entry_complete signal completion of search string entry e entry backspace delete the last character of the search string e entry cancel cancel entry of a search string 4 4 Colorable Objects Each of Wyrd s on screen elements may be colored by the color scheme of your choice using the syntax defined in Section 4 1 5 The following is a list of all colorable objects e help the help bar at the top of the screen e timed_default an empty timeslot in the day schedule window
14. s created e edit_any_command Controls the command used for editing a reminder file without selecting any particular reminder The special character 3f will be substituted with a filename to edit timed_template Controls the format of the REM line created when editing a new timed reminder The following character substitutions will be made M month name d day of the month Sy year Sh hour Sm minute Sw weekday name 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 partic ular 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_levell An integer value specifying the maximum number of reminders in a day with busy
15. 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 4 Advanced Configuration 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 SHOME wyrdrc and select settings that match your usage patterns The recommended procedure is to include the wyrdrc file provided with Wyrd see Section 4 1 1 and add or remove settings as desired 4 1 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 A 4 1 1 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 fou
16. to jump backward to the previous reminder 3 6 Other Commands A list of all keybindings may be viewed by pressing You can exit Wyrd by pressing O If the screen is corrupted for some reason hit Ctr1 L to refresh the display 3 7 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 s amp reminders amp 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 de scribed in Section 4 3 8 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
Download Pdf Manuals
Related Search
Related Contents
Cement Curing Autoclave PDFファイル - 医薬品医療機器総合機構 ECCO 27 n°3 Sikadur Arena Lexmark X860de, X862de, and X864de Options 7500-432 Copyright © All rights reserved.
Failed to retrieve file