## ReminderFox - Info

### Reminder List

> The List dialog is one of the main places to allow you to view and manage the reminders. To bring up the list dialog, you can double-click on the ribbon icon, or right-click on it and select `[View Reminders ..`] from the context menu. The list dialog has tabs for your Reminders, ToDo's, as well as any custom lists that you set up. The main dialog displays all of your reminders along with any attributes in the various list columns.
> Below the ReminderFox list is a button to add reminders/todos. To get a better overview about the reminders in the list, there are three controls to get a reduced, focused part of the reminder list. These are (left to right): 'Views', the 'Spyglass' and a 'Time Selector' - see following details.

#### Columns

> Most columns are hidden by default. You can view and add additional columns by clicking the column chooser in the top-right of your column header.

> 1. Time - shows you what time an event occurs, or `all day` if it's an all day event
> 2. Date Completed - shows the date that a reminder was completed on
> 3. Repeat - shows a brief text explaining what kind of repeat option is set for the reminder (weekly, monthly, yearly, etc)
> 4. Complete - shows a checkbox icon if a reminder has been completed. You can directly interact with this column to toggle the completed status of a reminder.
> 5. Notes - shows a note icon if the reminder has an associated note containing more information
> 6. Remind Daily Until Completed - shows a ribbon icon if the reminder has been set to `Remind Daily Until Completed`. The ribbon will be blue if this option has been set but the reminder date is still in the future. The ribbon will be red if the reminder date has passed and the reminder is now overdue.
> 7. Alarm - shows an alarm icon if the reminder has an alarm set. Hovering over the alarm icon will show you the alarm details.
> 8. Mail - shows a mail icon if this reminder is associated with an email (Thunderbird only).
> You can show and hide any columns that you want. You can also move the columns to any position you like by dragging the column header to where you want.
> Several columns allow you to manipulate the reminder by clicking in the column. Clicking the `Complete` columns toggles a reminder's Complete status; clicking in the `Remind Daily Until Complete` column toggles that option on or off, and clicking on the mail icon will open up the email associated with that reminder in Thunderbird.

#### Using the calendar

> You can show or hide the calendar by pressing the calendar icon on the Edit Reminders dialog.
> 1. The calendar is fully synchronized with your list of reminders. It displays all of the reminders for each month (highlighted in yellow) and any important reminders will have the date highlighted in red.
> 2. You can hover over any date with a reminder to get a tooltip of the description.
> 3. Clicking on a date with a reminder in the calendar jumps to that date in the reminder list, and vice-versa.
> 4. Double-clicking on a date will bring up the Add Reminder dialog with the date set to the one you clicked on.
> 5. Right-clicking on a date with an existing reminder will bring up the reminder context menu to allow you to manipulate the reminder.
> 6. You can advance the year of the calendar by clicking the arrows to the right and left of the year. You can add reminders for different years by first changing the year on the calendar

#### Editing Reminders

> You can double click on any reminder in the list to edit it. This will bring up the reminder window and allow you to change any of the options that you initially set. Also, you can right-click on a reminder to bring up a context menu to select a number of options:

> Select a reminder in the list, and right-click to bring up the context menu. Select the action that you want. Additionally, you can double-click a reminder to bring up the Edit Reminder dialog.
> 1. Edit Reminder - Allows you to edit all of the properties of the reminder.
> 2. Delete Reminder - Deletes the reminder from your list. If it is a repeating reminder, you will be prompted whether you want to delete all instances or just the current selected (and previous) instance.
> 3. Move to List - Moves the selected reminder to any other list, such as the ToDo list or any custom list.
> 4. Important Toggles the reminder's important status. This is for those extra-special events that you can't miss, like your wife's birthday. These reminders will show up highlighted in red in the Reminders list, as well as in the tooltip and status bar.
> 5. Complete - Reminders can be marked as Completed. This is useful for reminders that you finish with and no longer wish to be reminded about in the tooltip or in the status bar. example: if you have a reminder to "Pay phone bill" and you pay it early, then you can mark it as Complete and it will not show up in the upcoming reminders. The completed status resets after the date has passed so the reminder will show up again the following year.
> 6. Remind Daily Until Completed - This option causes the reminder to continue to remind you until it has been completed. This means that once a reminder occurs, it will continue to show up each following day until such time as you mark the reminder as 'Completed' (via the context menu). This is useful for things where you want to keep reminding yourself until you actually do it, like "remember to call Mom". Once a reminder has been completed, you can mark it as Complete from the context menu (or untoggle the Remind Daily Until Completed).
> 7. Find - allows you to search for a reminder containing specific text
> 8. Hide All Repeat Reminders - Hides all repeating instances of repeating reminders, and only shows one instance (the next upcoming instance). This option overrides your global preferences and only takes affect while viewing the current window.
> 9. Show All Reminders - This will show all reminders in your list. This option overrides your global preferences and only takes affect while viewing the current window.
> 10. Hide Completed Items - This hides all reminders that have been marked complete. This option overrides your global preferences and only takes affect while viewing the current window.
> 11. View as HTML - this displays your current list of reminders in a browser window. This can be used to print your reminders.

========= vvvvvvvvv NEED en-US REVIEW vvvvvvvvvvvv =================

#### Reminder Filtering (since vers.1.9.9)

> The lists of reminders (events, todo's and user lists) can be reduced using certain criteria. For that at the bottom of the ReminderFox list are two menus.

> > - Spyglass with search items (marked green)
> > - Views (marked red)
> > Both methods can be combined.

> ##### Spyglass with search items

> > Using the spyglass a criteria is selected, a search value can be entered into the textbox. Doing that, the ReminderFox List will only show matching reminders.

> ##### Views

> > Views selector
> > This method lets the user define and use more detailed selections for displaying reminders (events, todo's and user lists) in the ReminderFox List.
> > There are pre-defined time spans, but the user can also define his own selection criteria.
> > Time span selectors
> > Using the menu [1] the pre-defined time spans will be shown. The first point `[Selected Year]` will always switch back to all reminders for the year selected in the calendar.
> > With the menu item `[All Upcoming Reminders]` only reminders starting from 'today' will be displayed.
> > After the menu separator a sub-menu `[More Views ..]` will be shown. This is the place where the user can select or define those complex selections.
> > Note:
> > Definition of user defined 'Views' and 'Criteria' (see below).
> > More Views (sub-menu)

> > > This part [2] offers the possibility for complex selections of the ReminderFox List (Events, Todo's, user defined lists).
> > > As long as the user didn't defined his own selection, he will find some default definitions, f.e.:
> > > - new: Date="-1M"
> > > - Next Birthdays Categories="Birthday";Date="2W"
> > > - Mail/Send backup Description="Mail,Send;Date="-6M,2W"
> > > Note:
> > > This list can be edited using the 'Views' editor, it can be deleted or expanded. (see below).
> > > Selecting a View
> > > If the user selects a specific view from the sub-menu, the View will be shown in the menubox [2a] and be added to the list of the predefined time spans [2b]. This helps to have a fast access to the last selected view. This 'default' will be kept also with closing and re-open the ReminderFox List.
> > > Also the name of the selected view will be added to the ReminderFox List title, like so: `ReminderFox View [Mail/Send backup]`
> > > 'Export/Send [xxxx]'
> > > This menu item can only be seen if a user-defined view is active. The function allows to export or send all reminders shown in the list.
> > > The value in the brackets [xxxx] is the name of the active view.
> > > Notes:
> > > - All reminders will be exported/send, also hidden (because they are completed but hidden), also a selection in the list isn't relevant here.
> > > - A 'selective' Export/Send of reminders is possible using the context menu on the ReminderFox List.

> ##### User defined 'Views' -- Definitions

> > 'Views' are used to select reminders on the 'ReminderFox List', that is only part of the reminders will be shown. A 'View' is defined by one or more 'Criteria'.
> > A 'Criteria' determines if a specific reminders is shown with the 'View' on the ReminderFox List.
> > A criteria is met if it's value matches with the appropriated attribute (DESCRIPTION, NOTE, CATEGORIES, LOCATION or DATE) of the reminder.
> > If the 'view' has multiple criteria, those will be handles as an AND condition, that is all criteria has to be matched.
> > A 'criteria' can have multiple values, those are handled as OR condition, that is only one of them has to match to fullfil the criteria.
> > Views

> > > 'Views' can have any name. Double names are not allowed. The following characters are not allowed: ( = : ; > < )

> > Criteria of a View

> > > The definition of a 'criteria' is done with the attributes DESCRIPTION, NOTE, CATEGORIES, LOCATION or DATE as they are used with building reminders, those attributes will get values.
> > > Multiple values for a OR condition are separated by comma.
> > > If the criteria value starts with a hash (#) the meaning is invers, that is that value isn't allowed in the event/todo's defintion for the criteria (this is not valid for DATE).
> > > Example: `'Categories:#Project1'` -- for this view no event / todo with that categorie value will be shown.
> > > DATE - this is actually a time span, defined with begin and end values which can be in the 'past' or in the 'future'.
> > > The values are defined as day(D), week(W), month(M) or year(Y).
> > > If only one value is given, it's related to 'today', a value of `'2W'` means: from 'Today' the next 2 weeks, `'-2W'` : up to 'Today' started 2 weeks ago.
> > > DESCRIPTION, NOTE and LOCATION - are defined with free text.
> > > CATEGORIES - here the same menu as with defining an event or todo is available.

> ##### 'Views' Editor

> > Open the Editor

> > The 'Views' editor is called with the sub-menu of the views.

> > 'Views' editing

> > The left dialog box is used to select, add or delete a view. Pointing the cursor to a view line will show the criteria and their attributes with a tooltiptext.

> > 'Criteria' editing
> > With the selection of a view in the left dialog box it's criteria are shown in the right dialog box.
> > Also here, criteria can be selected, added and deleted.

> > Each 'criteria' has it's own line. Selecting a criteria line will switch the appropriated editing field below the dialog boxes. The above picture shows the editing of a CATEGORIES.

> > Criteria for DATE (Date span)
> > As said the Date definition can have one or two values. The first value defines the 'date span beginning', the second value the 'date span end'. Both date span values can be in the 'past' or the 'future'. For a zero '0' value the span value will be ignored -- the DATE will be related to 'Today', that is it's past: up to today or future: today to ..

> > > Example
> > > A view "Mail/Send backup" is defined with `Description:Mail,Send;Date:-6M,4W` with idea to select reminders for a backup (export) process.
> > > Using that definition all those reminders are selected with a description of 'Mail' OR 'Send' AND fall in the time span "6 month from today back (past)" [1] and "4 weeks from today into the future" [2] and [2a]. That means both values are related to 'Today'.
> > > Both date fields have a tooltiptext with the resulting date (`1.Juni 2010` and `29.Dezember 2010`).

> > Sorting - both dialog boxes (left 'Views' and right 'Criteria') can be sorted. The buttons [Az] and [Za] work for the active dialog box, this will also be shown with a blue blue line beside the dialog boxes.

========= ^^^^^^^^^ NEED en-US REVIEW ^^^^^^^^^^^ =================

#### Reminder Filtering (pre 1.9.9)

> To get a better overview about the Events and Todo's the list display can be narrowed using some different methods. For this the reminder list dialog offers these methods:

> ##### Spyglass and Time Selector

> The display of events, todos or the custom lists can be reduced using some different criterias. See the red marked fields below:

> 1. Spyglass: - The spyglass give a choice for description, category, notes, location; the entered string is handled as a search item. Using this the list will only show reminders matching that serch item.
> 2. Time Selector: - This is used the choose for different time spans. Also with this option the list will be reduced to meet that critereia.
>    Both filters can be combined to display a reduced list.

> ##### Views

> For more complex filtering/searching of the event list individual 'Views' can be composed and selected from a pull-down menu:
> Using the pull-down will offer some sections with the menu:

> 1. No 'View' - this is to switch off a previous selected 'View'
> 2. a list of all defined 'Views', a selected view has a tic mark, the tooltip text shows the definition for that 'View'
> 3. 'View' Editor - the selection to open the editor for defining new 'Views'
> 4. 'Export/Send' [xxxx] - this is only available with a selected 'View' and is used to export or send the displayed list of events.
>    the [xxxx] names the selected 'View'.
>    Notes:
>    1. All reminders matching the selected 'View' critera will be Exported/Send - regardless if marked/selected in the list or not, also all 'hidden' reminders matching the 'View' will be send/exported!
>    2. A 'selective' Export/Send of reminders can be achive with the Export/Send feature used with the context menu on the list.

> ##### 'View' - Defaults

> As long as the user hasn't defined his own definitions some default settings are available:

> > 1. Mail: Description="Mail,Send"
> > 2. Next Birthdays: Category="Birthday" Date="3M"
> > 3. Next 3Month: Date="3M"
> > 4. Last Quarter: Date="-3M"

> This default set can be changed, deleted or expanded using the 'View' Editor.

> ##### 'View' Editor

> The 'View' Editor let the user define any set of combined attributes of the reminder definition with conneting of 'OR' and 'AND' relations. Each one of those definitions ('Views') is stored with an individual name and added to the pull-down menu for selection. See the icons for online help.
> These pictures give an overview about the 'View' features. (Reminderfox vers. >1.9.7)
> Left top setup - shows a 'View' named "Next Privat". It filters the Reminder List for all entries matching a Category item = "Personal" and the start date of the event is "1M" - as can be seen with the popup pane "1 Month from now" (the second, the end date is obmitted, so the first date span begin at 'today').
> Right top setup - shows the configuring of a Category item using the pull down menu as already know with "Add Reminder" etc.

> > Left bottum setup - shows a definition of "Description:Mail,Send;Date:-1Y,3M". Here all event with 'Mail' or 'Send' in the description/subject and fall in the time span one year back of today andd 3 moth into the future will be selected.
> > Right bottum / Sorting - both lists (left for 'View's and right for 'Criteria') can be sorted. The two buttons [Az] and [Za] are active for the selected box which is also indicated by the blue bar right or left to the buttons.

##### ---