From 906c2fa02731af0a02338b57096947f5b993759d Mon Sep 17 00:00:00 2001 From: Lukas Fleischer Date: Tue, 9 Jul 2013 00:31:30 +0200 Subject: 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 --- doc/add.txt | 37 +++++++++++++++++++++++++++++++++++++ doc/config.txt | 17 +++++++++++++++++ doc/copy_paste.txt | 11 +++++++++++ doc/credits.txt | 22 ++++++++++++++++++++++ doc/delete.txt | 17 +++++++++++++++++ doc/displacement.txt | 25 +++++++++++++++++++++++++ doc/edit.txt | 18 ++++++++++++++++++ doc/enote.txt | 21 +++++++++++++++++++++ doc/export.txt | 22 ++++++++++++++++++++++ doc/flag.txt | 15 +++++++++++++++ doc/general.txt | 27 +++++++++++++++++++++++++++ doc/goto.txt | 12 ++++++++++++ doc/import.txt | 19 +++++++++++++++++++ doc/main.txt | 20 ++++++++++++++++++++ doc/other.txt | 9 +++++++++ doc/pipe.txt | 9 +++++++++ doc/priority.txt | 17 +++++++++++++++++ doc/repeat.txt | 31 +++++++++++++++++++++++++++++++ doc/save.txt | 14 ++++++++++++++ doc/tab.txt | 14 ++++++++++++++ doc/view.txt | 13 +++++++++++++ doc/vnote.txt | 16 ++++++++++++++++ 22 files changed, 406 insertions(+) create mode 100644 doc/add.txt create mode 100644 doc/config.txt create mode 100644 doc/copy_paste.txt create mode 100644 doc/credits.txt create mode 100644 doc/delete.txt create mode 100644 doc/displacement.txt create mode 100644 doc/edit.txt create mode 100644 doc/enote.txt create mode 100644 doc/export.txt create mode 100644 doc/flag.txt create mode 100644 doc/general.txt create mode 100644 doc/goto.txt create mode 100644 doc/import.txt create mode 100644 doc/main.txt create mode 100644 doc/other.txt create mode 100644 doc/pipe.txt create mode 100644 doc/priority.txt create mode 100644 doc/repeat.txt create mode 100644 doc/save.txt create mode 100644 doc/tab.txt create mode 100644 doc/view.txt create mode 100644 doc/vnote.txt 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 -- cgit v1.2.3-54-g00ecf