Export online help as text files

Move the texts of each online help screen to a separate text file. The
set of files is supposed to replace the online help screens later.

Signed-off-by: Lukas Fleischer <calcurse@cryptocrack.de>

22 files changed, 406 insertions, 0 deletions

diff --git a/doc/add.txt b/doc/add.txt
new file mode 100644
index 0000000..fa038d2
--- /dev/null
+++ b/doc/add.txt
@@ -0,0 +1,37 @@
+Add
+===
+
+Add an item in either the TODO or Appointment list, depending on which
+panel is selected when you press 'a'.
+
+To enter a new item in the TODO list, you will need first to enter the
+description of this new item. Then you will be asked to specify the todo
+priority. This priority is represented by a number going from 9 for the
+lowest priority, to 1 for the highest one. It is still possible to
+change the item priority afterwards, by using the '+' and '-' keys
+inside the todo panel.
+
+If the APPOINTMENT panel is selected while pressing 'a', you will be
+able to enter either a new appointment or a new all-day long event.
+To enter a new event, press [ENTER] instead of the item start time, and
+just fill in the event description.
+To enter a new appointment to be added in the APPOINTMENT list, you
+will need to enter successively the time at which the appointment
+begins, the appointment length (either by specifying the end time in
+[hh:mm] or the duration in [+hh:mm], [+xxdxxhxxm] or [+mm] format), 
+and the description of the event.
+
+The day at which occurs the event or appointment is the day currently
+selected in the calendar, so you need to move to the desired day before
+pressing 'a'.
+
+Notes:
+     o if an appointment lasts for such a long time that it continues
+       on the next days, this event will be indicated on all the
+       corresponding days, and the beginning or ending hour will be
+       replaced by '..' if the event does not begin or end on the day.
+     o if you only press [ENTER] at the APPOINTMENT or TODO event
+       description prompt, without any description, no item will be
+       added.
+     o do not forget to save the calendar data to retrieve the new
+       event next time you launch Calcurse.
diff --git a/doc/config.txt b/doc/config.txt
new file mode 100644
index 0000000..f69d158
--- /dev/null
+++ b/doc/config.txt
@@ -0,0 +1,17 @@
+Config
+======
+
+Open the configuration submenu.
+From this submenu, you can select between color, layout, notification
+and general options, and you can also configure your keybindings.
+
+The color submenu lets you choose the color theme.
+The layout submenu lets you choose the Calcurse screen layout, in other
+words where to place the three different panels on the screen.
+The general options submenu brings a screen with the different options
+which modifies the way Calcurse interacts with the user.
+The notify submenu allows you to change the notify-bar settings.
+The keys submenu lets you define your own key bindings.
+
+Do not forget to save the calendar data to retrieve your configuration
+next time you launch Calcurse.
\ No newline at end of file
diff --git a/doc/copy_paste.txt b/doc/copy_paste.txt
new file mode 100644
index 0000000..0cff341
--- /dev/null
+++ b/doc/copy_paste.txt
@@ -0,0 +1,11 @@
+Copy and Paste
+==============
+
+Copy and paste the currently selected item. This is useful to quickly
+copy an item from one date to another. To do so, one must first
+highlight the item that needs to be copied, then press 'c' to copy.
+Once the new date is chosen in the calendar, the appointment panel must
+be selected and the 'p' key must be pressed to paste the item. The item
+will appear in the appointment panel, assigned to the newly selected
+date.
+
diff --git a/doc/credits.txt b/doc/credits.txt
new file mode 100644
index 0000000..5c6bb90
--- /dev/null
+++ b/doc/credits.txt
@@ -0,0 +1,22 @@
+Calcurse - text-based organizer
+===============================
+
+Copyright (c) 2004-2013 calcurse Development Team
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+	- Redistributions of source code must retain the above
+	  copyright notice, this list of conditions and the
+	  following disclaimer.
+
+	- Redistributions in binary form must reproduce the above
+	  copyright notice, this list of conditions and the
+	  following disclaimer in the documentation and/or other
+	  materials provided with the distribution.
+
+
+Send your feedback or comments to : misc@calcurse.org
+Calcurse home page : http://calcurse.org
diff --git a/doc/delete.txt b/doc/delete.txt
new file mode 100644
index 0000000..937b9a6
--- /dev/null
+++ b/doc/delete.txt
@@ -0,0 +1,17 @@
+Delete
+======
+
+Delete an element in the TODO or Appointment list.
+
+Depending on which panel is selected when you press the delete key,
+the hilighted item of either the TODO or Appointment list will be 
+removed from this list.
+
+If the item to be deleted is recurrent, you will be asked if you
+wish to suppress all of the item occurences or just the one you
+selected.
+
+If the general option 'confirm_delete' is set to 'YES', then you will
+be asked for confirmation before deleting the selected event.
+Do not forget to save the calendar data to retrieve the modifications
+next time you launch Calcurse.
\ No newline at end of file
diff --git a/doc/displacement.txt b/doc/displacement.txt
new file mode 100644
index 0000000..18a3a34
--- /dev/null
+++ b/doc/displacement.txt
@@ -0,0 +1,25 @@
+Displacement keys
+=================
+
+Move around inside calcurse screens.
+The following scheme summarizes how to get around:
+
+                               move up
+                        move to previous week
+
+                                 k K UP 
+       move left                  ^  
+ move to previous day             |
+                      h H LFT 
+                            <--   +  -->
+                                           l L RGT 
+                                  |            move right
+                                  v         move to next day
+                                 j J DWN 
+
+                          move to next week
+                              move down
+
+Moreover, while inside the calendar panel, the '0' key moves
+to the first day of the week, and the '$' key selects the last day of
+the week.
diff --git a/doc/edit.txt b/doc/edit.txt
new file mode 100644
index 0000000..56554fa
--- /dev/null
+++ b/doc/edit.txt
@@ -0,0 +1,18 @@
+Edit Item
+=========
+
+Edit the item which is currently selected.
+Depending on the item type (appointment, event, or todo), and if it is
+repeated or not, you will be asked to choose one of the item properties
+to modify. An item property is one of the following: the start time, the
+end time, the description, or the item repetition.
+Once you have chosen the property you want to modify, you will be shown
+its actual value, and you will be able to change it as you like.
+
+Notes:
+     o if you choose to edit the item repetition properties, you will
+       be asked to re-enter all of the repetition characteristics
+       (repetition type, frequence, and ending date). Moreover, the
+       previous data concerning the deleted occurences will be lost.
+     o do not forget to save the calendar data to retrieve the
+       modified properties next time you launch Calcurse.
\ No newline at end of file
diff --git a/doc/enote.txt b/doc/enote.txt
new file mode 100644
index 0000000..e928960
--- /dev/null
+++ b/doc/enote.txt
@@ -0,0 +1,21 @@
+EditNote
+========
+
+Attach a note to any type of item, or edit an already existing note.
+This feature is useful if you do not have enough space to store all
+of your item description, or if you would like to add sub-tasks to an
+already existing todo item for example.
+Before pressing the 'n' key, you first need to highlight the item you
+want the note to be attached to. Then you will be driven to an
+external editor to edit your note. This editor is chosen the following
+way:
+     o if the 'VISUAL' environment variable is set, then this will be
+       the default editor to be called.
+     o if 'VISUAL' is not set, then the 'EDITOR' environment variable
+       will be used as the default editor.
+     o if none of the above environment variables is set, then
+       '/usr/bin/vi' will be used.
+
+Once the item note is edited and saved, quit your favorite editor.
+You will then go back to Calcurse, and the '>' sign will appear in front
+of the highlighted item, meaning there is a note attached to it.
\ No newline at end of file
diff --git a/doc/export.txt b/doc/export.txt
new file mode 100644
index 0000000..570257d
--- /dev/null
+++ b/doc/export.txt
@@ -0,0 +1,22 @@
+Export
+======
+
+Export calcurse data (appointments, events and todos).
+This leads to the export submenu, from which you can choose between
+two different export formats: 'ical' and 'pcal'. Choosing one of
+those formats lets you export calcurse data to icalendar or pcal
+format.
+
+You first need to specify the file to which the data will be exported.
+By default, this file is:
+
+     ~/calcurse.ics
+
+for an ical export, and:
+
+     ~/calcurse.txt
+
+for a pcal export.
+
+Calcurse data are exported in the following order:
+     events, appointments, todos.
diff --git a/doc/flag.txt b/doc/flag.txt
new file mode 100644
index 0000000..7941167
--- /dev/null
+++ b/doc/flag.txt
@@ -0,0 +1,15 @@
+Flag Item
+=========
+
+Toggle an appointment's 'important' flag or a todo's 'completed' flag.
+If a todo is flagged as completed, its priority number will be replaced
+by an 'X' sign. Completed tasks will no longer appear in exported data
+or when using the '-t' command line flag (unless specifying '0' as the
+priority number, in which case only completed tasks will be shown).
+
+If an appointment is flagged as important, an exclamation mark appears
+in front of it, and you will be warned if time gets closed to the
+appointment start time.
+To customize the way one gets notified, the configuration submenu lets
+you choose the command launched to warn user of an upcoming appointment,
+and how long before it he gets notified.
\ No newline at end of file
diff --git a/doc/general.txt b/doc/general.txt
new file mode 100644
index 0000000..53c71e8
--- /dev/null
+++ b/doc/general.txt
@@ -0,0 +1,27 @@
+Generic keybindings
+===================
+
+Some of the keybindings apply whatever panel is selected. They are
+called generic keybinding.
+Here is the list of all the generic key bindings, together with their
+corresponding action:
+
+ '^R' : Redraw function -> redraws calcurse panels, this is useful if
+                           you resize your terminal screen or when
+                           garbage appears inside the display
+ '^A' : Add Appointment -> add an appointment or an event
+ '^T' : Add TODO        -> add a todo
+ 'T' : -1 Day          -> move to previous day
+ 't' : +1 Day          -> move to next day
+ 'W' : -1 Week         -> move to previous week
+ 'w' : +1 Week         -> move to next week
+ 'M' : -1 Month        -> move to previous month
+ 'm' : +1 Month        -> move to next month
+ 'Y' : -1 Year         -> move to previous year
+ 'y' : +1 Year         -> move to next year
+ '^G' : Goto today      -> move to current day
+
+The '^P' and '^N' keys are used to scroll text upward or downward
+when inside specific screens such the help screens for example.
+They are also used when the calendar screen is selected to switch
+between the available views (monthly and weekly calendar views).
\ No newline at end of file
diff --git a/doc/goto.txt b/doc/goto.txt
new file mode 100644
index 0000000..c6b6482
--- /dev/null
+++ b/doc/goto.txt
@@ -0,0 +1,12 @@
+Goto
+====
+
+Jump to a specific day in the calendar.
+
+Using this command, you do not need to travel to that day using
+the displacement keys inside the calendar panel.
+If you hit [ENTER] without specifying any date, Calcurse checks the
+system current date and you will be taken to that date.
+
+Notice that pressing '^G', whatever panel is
+selected, will select current day in the calendar.
\ No newline at end of file
diff --git a/doc/import.txt b/doc/import.txt
new file mode 100644
index 0000000..65d963e
--- /dev/null
+++ b/doc/import.txt
@@ -0,0 +1,19 @@
+Import
+======
+
+Import data from an icalendar file.
+You will be asked to enter the file name from which to load ical
+items. At the end of the import process, and if the general option
+'system_dialogs' is set to 'yes', a report indicating how many items
+were imported is shown.
+This report contains the total number of lines read, the number of
+appointments, events and todo items which were successfully imported,
+together with the number of items for which problems occured and that
+were skipped, if any.
+
+If one or more items could not be imported, one has the possibility to
+read the import process report in order to identify which problems
+occured.
+In this report is shown one item per line, with the line in the input
+stream at which this item begins, together with the description of why
+the item could not be imported.
diff --git a/doc/main.txt b/doc/main.txt
new file mode 100644
index 0000000..d02fdc0
--- /dev/null
+++ b/doc/main.txt
@@ -0,0 +1,20 @@
+       Welcome to Calcurse. This is the main help screen.
+=========================================================
+
+Moving around:  Press '^P' or '^N' to scroll text upward or downward
+                inside help screens, if necessary.
+
+    Exit help:  When finished, press 'q' to exit help and go back to
+                the main Calcurse screen.
+
+   Help topic:  At the bottom of this screen you can see a panel with
+                different fields, represented by a letter and a short
+                title. This panel contains all the available actions
+                you can perform when using Calcurse.
+                By pressing one of the letters appearing in this
+                panel, you will be shown a short description of the
+                corresponding action. At the top right side of the
+                description screen are indicated the user-defined key
+                bindings that lead to the action.
+
+      Credits:  Press '@' for credits.
\ No newline at end of file
diff --git a/doc/other.txt b/doc/other.txt
new file mode 100644
index 0000000..4e17df7
--- /dev/null
+++ b/doc/other.txt
@@ -0,0 +1,9 @@
+OtherCmd
+========
+
+Switch between status bar help pages.
+Because the terminal screen is too narrow to display all of the
+available commands, you need to press 'o' to see the next set of
+commands together with their keybindings.
+Once the last status bar page is reached, pressing 'o' another time
+leads you back to the first page.
\ No newline at end of file
diff --git a/doc/pipe.txt b/doc/pipe.txt
new file mode 100644
index 0000000..507147e
--- /dev/null
+++ b/doc/pipe.txt
@@ -0,0 +1,9 @@
+Pipe
+====
+
+Pipe the selected item to an external program.
+
+Press the '|' key to pipe the currently selected appointment or
+todo entry to an external program.
+
+You will be driven back to calcurse as soon as the program exits.
diff --git a/doc/priority.txt b/doc/priority.txt
new file mode 100644
index 0000000..678d7dc
--- /dev/null
+++ b/doc/priority.txt
@@ -0,0 +1,17 @@
+Priority
+========
+
+Change the priority of the currently selected item in the TODO list.
+Priorities are represented by the number appearing in front of the
+todo description. This number goes from 9 for the lowest priority to
+1 for the highest priority.
+Todo having higher priorities are placed first (at the top) inside the
+todo panel.
+
+If you want to raise the priority of a todo item, you need to press '+'.
+In doing so, the number in front of this item will decrease, meaning its
+priority increases. The item position inside the todo panel may change,
+depending on the priority of the items above it.
+
+At the opposite, to lower a todo priority, press '-'. The todo position
+may also change depending on the priority of the items below.
\ No newline at end of file
diff --git a/doc/repeat.txt b/doc/repeat.txt
new file mode 100644
index 0000000..f79f2e9
--- /dev/null
+++ b/doc/repeat.txt
@@ -0,0 +1,31 @@
+Repeat
+======
+
+Repeat an event or an appointment.
+You must first select the item to be repeated by moving inside the
+appointment panel. Then pressing 'r' will lead you to a set of three
+questions, with which you will be able to specify the repetition
+characteristics:
+
+  o        type: you can choose between a daily, weekly, monthly or
+                 yearly repetition by pressing 'D', 'W', 'M' or 'Y'
+                 respectively.
+
+  o   frequence: this indicates how often the item shall be repeated.
+                 For example, if you want to remember an anniversary,
+                 choose a 'yearly' repetition with a frequence of '1',
+                 which means it must be repeated every year. Another
+                 example: if you go to the restaurant every two days,
+                 choose a 'daily' repetition with a frequence of '2'.
+
+  o ending date: this specifies when to stop repeating the selected
+                 event or appointment. To indicate an endless 
+                 repetition, enter '0' and the item will be repeated
+                 forever.
+
+Notes:
+       o repeated items are marked with an '*' inside the appointment
+         panel, to be easily recognizable from non-repeated ones.
+       o the 'Repeat' and 'Delete' command can be mixed to create
+         complicated configurations, as it is possible to delete only
+         one occurence of a repeated item.
\ No newline at end of file
diff --git a/doc/save.txt b/doc/save.txt
new file mode 100644
index 0000000..d9d98a6
--- /dev/null
+++ b/doc/save.txt
@@ -0,0 +1,14 @@
+Save
+====
+
+Save calcurse data.
+Data are splitted into four different files which contain :
+
+         / ~/.calcurse/conf -> user configuration
+        |                      (layout, color, general options)
+        |  ~/.calcurse/apts -> data related to the appointments
+        |  ~/.calcurse/todo -> data related to the todo list
+         \ ~/.calcurse/keys -> user-defined key bindings
+
+In the config menu, you can choose to save the Calcurse data
+automatically before quitting.
\ No newline at end of file
diff --git a/doc/tab.txt b/doc/tab.txt
new file mode 100644
index 0000000..58d1b21
--- /dev/null
+++ b/doc/tab.txt
@@ -0,0 +1,14 @@
+Tab
+===
+
+Switch between panels.
+The panel currently in use has its border colorized.
+
+Some actions are possible only if the right panel is selected.
+For example, if you want to add a task in the TODO list, you need first
+to press the 'TAB' key to get the TODO panel selected. Then you can
+press 'a' to add your item.
+
+Notice that at the bottom of the screen the list of possible actions
+change while pressing 'TAB', so you always know what action can be
+performed on the selected panel.
\ No newline at end of file
diff --git a/doc/view.txt b/doc/view.txt
new file mode 100644
index 0000000..8122130
--- /dev/null
+++ b/doc/view.txt
@@ -0,0 +1,13 @@
+View
+====
+
+View the item you select in either the Todo or Appointment panel.
+
+This is usefull when an event description is longer than the available
+space to display it. If that is the case, the description will be
+shortened and its end replaced by '...'. To be able to read the entire
+description, just press 'v' and a popup window will appear, containing
+the whole event.
+
+Press any key to close the popup window and go back to the main
+Calcurse screen.
\ No newline at end of file
diff --git a/doc/vnote.txt b/doc/vnote.txt
new file mode 100644
index 0000000..b55eb7e
--- /dev/null
+++ b/doc/vnote.txt
@@ -0,0 +1,16 @@
+ViewNote
+========
+
+View a note which was previously attached to an item (an item which
+owns a note has a '>' sign in front of it).
+This command only permits to view the note, not to edit it (to do so,
+use the 'EditNote' command, by pressing the 'n' key).
+Once you highlighted an item with a note attached to it, and the '>' key
+was pressed, you will be driven to an external pager to view that note.
+The default pager is chosen the following way:
+     o if the 'PAGER' environment variable is set, then this will be
+       the default viewer to be called.
+     o if the above environment variable is not set, then
+       '/usr/bin/less' will be used.
+As for editing a note, quit the pager and you will be driven back to
+Calcurse.
\ No newline at end of file