summaryrefslogtreecommitdiffstats
path: root/files/calcurse.1.html
blob: ee6eab92344f7762f847a258947d860b563aab68 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>calcurse(1)</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.77.1" /></head><body><div xml:lang="en" class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="idp26316800"></a>calcurse(1)</h2></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="section"><a href="#_name">1. Name</a></span></dt><dt><span class="section"><a href="#_synopsis">2. Synopsis</a></span></dt><dt><span class="section"><a href="#_description">3. Description</a></span></dt><dt><span class="section"><a href="#_options">4. Options</a></span></dt><dt><span class="section"><a href="#_format_strings">5. Format strings</a></span></dt><dd><dl><dt><span class="section"><a href="#_format_specifiers_for_appointments">5.1. Format specifiers for appointments</a></span></dt><dt><span class="section"><a href="#_format_specifiers_for_events">5.2. Format specifiers for events</a></span></dt><dt><span class="section"><a href="#_format_specifiers_for_todo_items">5.3. Format specifiers for todo items</a></span></dt><dt><span class="section"><a href="#_examples">5.4. Examples</a></span></dt><dt><span class="section"><a href="#_extended_format_specifiers">5.5. Extended format specifiers</a></span></dt></dl></dd><dt><span class="section"><a href="#_notes">6. Notes</a></span></dt><dt><span class="section"><a href="#_configuration">7. Configuration</a></span></dt><dt><span class="section"><a href="#_files">8. Files</a></span></dt><dt><span class="section"><a href="#_environment">9. Environment</a></span></dt><dt><span class="section"><a href="#_bugs">10. Bugs</a></span></dt><dt><span class="section"><a href="#_see_also">11. See also</a></span></dt><dt><span class="section"><a href="#_authors">12. Authors</a></span></dt><dt><span class="section"><a href="#_copyright">13. Copyright</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_name"></a>1. Name</h2></div></div></div><p>calcurse - text-based organizer</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_synopsis"></a>2. Synopsis</h2></div></div></div><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><span class="strong"><strong>calcurse</strong></span> [<span class="strong"><strong>-h</strong></span>|<span class="strong"><strong>-v</strong></span>] [<span class="strong"><strong>-an</strong></span>] [<span class="strong"><strong>-t</strong></span>[num]] [<span class="strong"><strong>-c</strong></span>&lt;file&gt; | <span class="strong"><strong>-D</strong></span>&lt;dir&gt;]<br />
         [<span class="strong"><strong>-i</strong></span>&lt;file&gt;] [<span class="strong"><strong>-x</strong></span>[format]] [<span class="strong"><strong>-d</strong></span> &lt;date&gt;|&lt;num&gt;]<br />
         [<span class="strong"><strong>-s</strong></span>[date]] [<span class="strong"><strong>-r</strong></span>[range]] [<span class="strong"><strong>-S</strong></span> &lt;regex&gt;] [<span class="strong"><strong>--status</strong></span>]</p></div></blockquote></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_description"></a>3. Description</h2></div></div></div><p>Calcurse is a text-based calendar and scheduling application. It helps keeping
track of events, appointments and everyday tasks.  A configurable notification
system reminds user of upcoming deadlines, and the curses based interface can
be customized to suit user needs.  All of the commands are documented within an
online help system.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_options"></a>4. Options</h2></div></div></div><p>The following options are supported:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong>-a</strong></span>, <span class="strong"><strong>--appointment</strong></span>
</span></dt><dd>
  Print the appointments and events for the current day and exit. <span class="emphasis"><em>Note:</em></span> The calendar
  from which to read the  appointments can be specified using the <span class="strong"><strong>-c</strong></span> flag.
</dd><dt><span class="term">
<span class="strong"><strong>-c</strong></span> &lt;file&gt;, <span class="strong"><strong>--calendar</strong></span> &lt;file&gt;
</span></dt><dd>
  Specify the calendar file to use.  The default  calendar is
  <span class="strong"><strong>~/.calcurse/apts</strong></span> (see section <span class="emphasis"><em>FILES</em></span> below). This option is incompatible
  with -<span class="strong"><strong>D</strong></span>.
</dd><dt><span class="term">
<span class="strong"><strong>-d</strong></span> &lt;date|num&gt;, <span class="strong"><strong>--day</strong></span> &lt;date|num&gt;
</span></dt><dd><p class="simpara">
  Print the appointments for the given date  or  for  the given  number  of
  upcoming days, depending on the argument format. Two possible formats are
  supported:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
a date (possible formats described below).
</li><li class="listitem">
a number <span class="strong"><strong>n</strong></span>.
</li></ul></div><p class="simpara">In the first  case,  the  appointment  list  for  the specified  date will be
returned, while in the second case the appointment list for the <span class="strong"><strong>n</strong></span>  upcoming
days will be returned.</p><p class="simpara">As an example, typing <span class="strong"><strong>calcurse -d  3</strong></span>  will  display your  appointments  for
today, tomorrow, and the day after tomorrow.</p><p class="simpara">The  date  format  used  is  the  one  specified in the “General options”
menu.  Four formats are available:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
mm/dd/yyyy
</li><li class="listitem">
dd/mm/yyyy
</li><li class="listitem">
yyyy/mm/dd
</li><li class="listitem">
yyyy-mm-dd
</li></ol></div><p class="simpara"><span class="emphasis"><em>Note:</em></span> as for the <span class="strong"><strong>-a</strong></span> flag, the calendar  from which to  read  the
appointments can be specified using the <span class="strong"><strong>-c</strong></span> flag.</p></dd><dt><span class="term">
<span class="strong"><strong>-D</strong></span> &lt;dir&gt;, <span class="strong"><strong>--directory</strong></span> &lt;dir&gt;
</span></dt><dd>
  Specify  the  data directory to use. This option is incompatible  with  -c.
  If  not  specified,   the default directory is <span class="strong"><strong>~/.calcurse/</strong></span>.
</dd><dt><span class="term">
<span class="strong"><strong>--format-apt</strong></span> &lt;format&gt;
</span></dt><dd>
  Specify a format to control the output of appointments in non-interactive
  mode. See the <span class="emphasis"><em>FORMAT STRINGS</em></span> section for detailed information on format
  strings.
</dd><dt><span class="term">
<span class="strong"><strong>--format-recur-apt</strong></span> &lt;format&gt;
</span></dt><dd>
  Specify a format to control the output of recurrent appointments in
  non-interactive mode. See the <span class="emphasis"><em>FORMAT STRINGS</em></span> section for detailed
  information on format strings.
</dd><dt><span class="term">
<span class="strong"><strong>--format-event</strong></span> &lt;format&gt;
</span></dt><dd>
  Specify a format to control the output of events in non-interactive mode. See
  the <span class="emphasis"><em>FORMAT STRINGS</em></span> section for detailed information on format strings.
</dd><dt><span class="term">
<span class="strong"><strong>--format-recur-event</strong></span> &lt;format&gt;
</span></dt><dd>
  Specify a format to control the output of recurrent events in non-interactive
  mode. See the <span class="emphasis"><em>FORMAT STRINGS</em></span> section for detailed information on format
  strings.
</dd><dt><span class="term">
<span class="strong"><strong>--format-todo</strong></span> &lt;format&gt;
</span></dt><dd>
  Specify a format to control the output of todo items in non-interactive mode.
  See the <span class="emphasis"><em>FORMAT STRINGS</em></span> section for detailed information on format strings.
</dd><dt><span class="term">
<span class="strong"><strong>-g</strong></span>, <span class="strong"><strong>--gc</strong></span>
</span></dt><dd>
  Run the garbage collector for note files and exit.
</dd><dt><span class="term">
<span class="strong"><strong>-h</strong></span>, <span class="strong"><strong>--help</strong></span>
</span></dt><dd>
  Print  a  short  help  text  describing  the  supported command-line options,
  and exit.
</dd><dt><span class="term">
<span class="strong"><strong>-i</strong></span> &lt;file&gt;, <span class="strong"><strong>--import</strong></span> &lt;file&gt;
</span></dt><dd>
  Import the icalendar data contained in <span class="emphasis"><em>file</em></span>.
</dd><dt><span class="term">
<span class="strong"><strong>-n</strong></span>, <span class="strong"><strong>--next</strong></span>
</span></dt><dd><p class="simpara">
  Print the next appointment within upcoming 24 hours and exit.  The indicated
  time is the number of hours and minutes left before this appointment.
</p><p class="simpara"><span class="emphasis"><em>Note:</em></span> the calendar from which to read the appointments can be specified using
the <span class="strong"><strong>-c</strong></span> flag.</p></dd><dt><span class="term">
<span class="strong"><strong>-r</strong></span>[num], <span class="strong"><strong>--range</strong></span>[=num]
</span></dt><dd>
  Print events and appointments for the <span class="emphasis"><em>num</em></span> number of days and exit. If no
  <span class="emphasis"><em>num</em></span> is given, a range of 1 day is considered.
</dd><dt><span class="term">
<span class="strong"><strong>--read-only</strong></span>
</span></dt><dd><p class="simpara">
  Don’t save configuration nor appointments/todos.
</p><p class="simpara"><span class="emphasis"><em>Warning:</em></span> Use this this with care! If you run an interactive calcurse instance
in read-only mode, all changes from this session will be lost without warning!</p></dd><dt><span class="term">
<span class="strong"><strong>-s</strong></span>[date], <span class="strong"><strong>--startday</strong></span>[=date]
</span></dt><dd>
  Print  events  and appointments from <span class="emphasis"><em>date</em></span> and exit.  If no <span class="emphasis"><em>date</em></span> is given,
  the current day is considered.
</dd><dt><span class="term">
<span class="strong"><strong>-S</strong></span>&lt;regex&gt;, <span class="strong"><strong>--search</strong></span>=&lt;regex&gt;
</span></dt><dd>
  When used with the <span class="strong"><strong>-a</strong></span>, <span class="strong"><strong>-d</strong></span>, <span class="strong"><strong>-r</strong></span>, <span class="strong"><strong>-s</strong></span>, or <span class="strong"><strong>-t</strong></span> flag, print only the items
  having a description that matches the given regular expression.
</dd><dt><span class="term">
<span class="strong"><strong>--status</strong></span>
</span></dt><dd>
  Display  the  status of running instances of calcurse. If calcurse is
  running, this will tell  if  the  interactive mode  was  launched  or  if
  calcurse is running in background.  The process pid will also be indicated.
</dd><dt><span class="term">
<span class="strong"><strong>-t</strong></span>[num], <span class="strong"><strong>--todo</strong></span>[=num]
</span></dt><dd>
  Print the <span class="strong"><strong>todo</strong></span> list and exit. If the optional number <span class="emphasis"><em>num</em></span> is given, then
  only todos having a priority equal to <span class="emphasis"><em>num</em></span> will be returned. The priority
  number must be between 1 (highest) and 9 (lowest). It is also possible to
  specify <span class="strong"><strong>0</strong></span> for the priority, in which case only completed tasks will be
  shown.
</dd><dt><span class="term">
<span class="strong"><strong>-v</strong></span>, <span class="strong"><strong>--version</strong></span>
</span></dt><dd>
  Display <span class="strong"><strong>calcurse</strong></span> version and exit.
</dd><dt><span class="term">
<span class="strong"><strong>-x</strong></span>[format], <span class="strong"><strong>--export</strong></span>[=format]
</span></dt><dd><p class="simpara">
  Export user data to specified format. Events, appointments and todos are
  converted and echoed to stdout.  Two possible formats are available: <span class="emphasis"><em>ical</em></span>
  and <span class="emphasis"><em>pcal</em></span>.  If the optional argument <span class="emphasis"><em>format</em></span> is not given, ical format is
  selected by default.
</p><p class="simpara"><span class="emphasis"><em>Note:</em></span> redirect standard output to export data to a file, by issuing a command
such as:</p><pre class="screen">$ calcurse --export &gt; my_data.dat</pre></dd></dl></div><p><span class="emphasis"><em>Note:</em></span> The <span class="strong"><strong>-N</strong></span> option has been removed in calcurse 3.0.0. See the <span class="emphasis"><em>FORMAT
STRINGS</em></span> section on how to print note along with appointments and events.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_format_strings"></a>5. Format strings</h2></div></div></div><p>Format strings are composed of printf()-style format specifiers — ordinary
characters are copied to stdout without modification. Each specifier is
introduced by a <span class="strong"><strong>%</strong></span> and is followed by a character which specifies the field to
print. The set of available fields depends on the item type.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_format_specifiers_for_appointments"></a>5.1. Format specifiers for appointments</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong>s</strong></span>
</span></dt><dd>
  Print the start time of the appointment as UNIX time stamp
</dd><dt><span class="term">
<span class="strong"><strong>S</strong></span>
</span></dt><dd>
  Print the start time of the appointment using the <span class="strong"><strong>hh:mm</strong></span> format
</dd><dt><span class="term">
<span class="strong"><strong>d</strong></span>
</span></dt><dd>
  Print the duration of the appointment in seconds
</dd><dt><span class="term">
<span class="strong"><strong>e</strong></span>
</span></dt><dd>
  Print the end time of the appointment as UNIX time stamp
</dd><dt><span class="term">
<span class="strong"><strong>E</strong></span>
</span></dt><dd>
  Print the end time of the appointment using the <span class="strong"><strong>hh:mm</strong></span> format
</dd><dt><span class="term">
<span class="strong"><strong>m</strong></span>
</span></dt><dd>
  Print the description of the item
</dd><dt><span class="term">
<span class="strong"><strong>n</strong></span>
</span></dt><dd>
  Print the name of the note file belonging to the item
</dd><dt><span class="term">
<span class="strong"><strong>N</strong></span>
</span></dt><dd>
  Print the note belonging to the item
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_format_specifiers_for_events"></a>5.2. Format specifiers for events</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong>m</strong></span>
</span></dt><dd>
  Print the description of the item
</dd><dt><span class="term">
<span class="strong"><strong>n</strong></span>
</span></dt><dd>
  Print the name of the note file belonging to the item
</dd><dt><span class="term">
<span class="strong"><strong>N</strong></span>
</span></dt><dd>
  Print the note belonging to the item
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_format_specifiers_for_todo_items"></a>5.3. Format specifiers for todo items</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong>p</strong></span>
</span></dt><dd>
  Print the priority of the item
</dd><dt><span class="term">
<span class="strong"><strong>m</strong></span>
</span></dt><dd>
  Print the description of the item
</dd><dt><span class="term">
<span class="strong"><strong>n</strong></span>
</span></dt><dd>
  Print the name of the note file belonging to the item
</dd><dt><span class="term">
<span class="strong"><strong>N</strong></span>
</span></dt><dd>
  Print the note belonging to the item
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_examples"></a>5.4. Examples</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong><code class="literal">calcurse -r7 --format-apt='- %S -&gt; %E\n\t%m\n%N'</code></strong></span>
</span></dt><dd>
  Print appointments and events for the next seven days. Also, print the notes
  attached to each regular appointment (simulates <span class="strong"><strong>-N</strong></span> for appointments).
</dd><dt><span class="term">
<span class="strong"><strong><code class="literal">calcurse -r7 --format-apt=' - %m (%S to %E)\n' --format-recur-apt=' - %m (%S to %E)\n'</code></strong></span>
</span></dt><dd>
  Print appointments and events for the next seven days and use a custom format
  for (recurrent) appointments: * - Some appointment (18:30 to 21:30)*.
</dd><dt><span class="term">
<span class="strong"><strong><code class="literal">calcurse -t --format-todo '(%p) %m\n'</code></strong></span>
</span></dt><dd>
  List all todo items and put parentheses around the priority specifiers.
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_extended_format_specifiers"></a>5.5. Extended format specifiers</h3></div></div></div><p>Extended format specifiers can be used if you want to specify advanced
formatting options. Extended specifiers are introduced by <span class="strong"><strong>%(</strong></span> and are
terminated by a closing parenthesis (<span class="strong"><strong>)</strong></span>). The following list includes all
short specifiers and corresponding long options:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
<span class="strong"><strong>s</strong></span>: <span class="strong"><strong>(start)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>S</strong></span>: <span class="strong"><strong>(start:epoch)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>d</strong></span>: <span class="strong"><strong>(duration)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>e</strong></span>: <span class="strong"><strong>(end)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>E</strong></span>: <span class="strong"><strong>(end:epoch)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>m</strong></span>: <span class="strong"><strong>(message)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>n</strong></span>: <span class="strong"><strong>(noteid)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>N</strong></span>: <span class="strong"><strong>(note)</strong></span>
</li><li class="listitem">
<span class="strong"><strong>p</strong></span>: <span class="strong"><strong>(priority)</strong></span>
</li></ul></div><p>The <span class="strong"><strong>(start)</strong></span> and <span class="strong"><strong>(end)</strong></span> specifiers support strftime()-style extended
formatting options that can be used for fine-grained formatting. Additionally,
the special formats <span class="strong"><strong>epoch</strong></span> (which is equivalent to <span class="strong"><strong>(start:%s)</strong></span> or <span class="strong"><strong>(end:%s)</strong></span>)
and <span class="strong"><strong>default</strong></span> (which is mostly equivalent to <span class="strong"><strong>(start:%H:%M)</strong></span> or <span class="strong"><strong>(end:%H:%M)</strong></span>
but displays <span class="strong"><strong>..:..</strong></span> if the item doesn’t start/end at the current day) are
supported.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_notes"></a>6. Notes</h2></div></div></div><p>Calcurse interface contains three different panels (calendar, appointment list,
and todo list) on which you can perform different actions. All the possible
actions, together with their associated keystrokes, are listed on the status
bar. This status bar takes place at the bottom of the screen.</p><p>At any time, the built-in help system can be invoked by pressing the <span class="emphasis"><em>?</em></span> key.
Once viewing the help screens, informations on a specific command can be
accessed by pressing the keystroke corresponding to that command.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_configuration"></a>7. Configuration</h2></div></div></div><p>The calcurse options can be changed from the configuration menu (shown when <span class="emphasis"><em>C</em></span>
is hit). Five possible categories are to be chosen from : the color scheme, the
layout (the location of the three panels on the screen), notification options,
key bindings configuration menu, and more general options (such as automatic
save before quitting).  All of these options are detailed in the configuration
menu.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_files"></a>8. Files</h2></div></div></div><p>The following structure is created in your $HOME directory (or in the directory
you specified with the <span class="strong"><strong>-D</strong></span> option), the first time calcurse is run:</p><pre class="screen">$HOME/.calcurse/
          |___notes/
          |___conf
          |___keys
          |___apts
          |___todo</pre><p>The <span class="emphasis"><em>notes</em></span> subdirectory contains descriptions of the notes which are attached
to appointments, events or todos. One text file is created per note, whose name
is built using mkstemp(3) and should be unique, but with no relation with the
corresponding item’s description.</p><p>The <span class="emphasis"><em>conf</em></span> file contains the user configuration. The <span class="emphasis"><em>keys</em></span> file contains the
user-defined key bindings. The <span class="emphasis"><em>apts</em></span> file contains all of the user’s
appointments and events, and the <span class="emphasis"><em>todo</em></span> file contains the todo list.</p><p><span class="emphasis"><em>Note:</em></span> if the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <span class="emphasis"><em>daemon.log</em></span> will appear in calcurse data
directory. This file contains logs about calcurse activity when running in
background.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_environment"></a>9. Environment</h2></div></div></div><p>This section describes the environment variables that affect how calcurse
operates.</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<span class="strong"><strong>VISUAL</strong></span>
</span></dt><dd>
  Specifies the external editor to use for writing notes.
</dd><dt><span class="term">
<span class="strong"><strong>EDITOR</strong></span>
</span></dt><dd>
  If the <span class="emphasis"><em>VISUAL</em></span> environment variable is not set, then <span class="emphasis"><em>EDITOR</em></span> will be used
  as the default external editor. If none of those variables are set, then
  <span class="emphasis"><em>/usr/bin/vi</em></span> is used instead.
</dd><dt><span class="term">
<span class="strong"><strong>PAGER</strong></span>
</span></dt><dd>
  Specifies the default viewer to be used for reading notes. If this variable
  is not set, then <span class="emphasis"><em>/usr/bin/less</em></span> is used.
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_bugs"></a>10. Bugs</h2></div></div></div><p>Incorrect highlighting of items appear when using calcurse black and white
theme together with a <span class="strong"><strong>$TERM</strong></span> variable set to <span class="emphasis"><em>xterm-color</em></span>.  To fix this bug,
and as advised by Thomas E. Dickey (xterm maintainer), <span class="emphasis"><em>xterm-xfree86</em></span> should
be used instead of <span class="emphasis"><em>xterm-color</em></span> to set the <span class="strong"><strong>$TERM</strong></span> variable:</p><pre class="literallayout">"The xterm-color value for $TERM is a bad choice for
 XFree86 xterm because it is commonly used for a
 terminfo entry which happens to not support bce.
 Use the xterm-xfree86 entry which is distributed
 with XFree86 xterm (or the similar one distributed
 with ncurses)."</pre><p>If you find other bugs, please send a report to <a class="ulink" href="mailto:bugs@calcurse.org" target="_top">bugs@calcurse.org</a> or to one of
the authors, below.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_see_also"></a>11. See also</h2></div></div></div><p>vi(1), less(1), ncurses(3), mkstemp(3)</p><p>The ical specification (rfc2445) can be found at:
<a class="ulink" href="http://tools.ietf.org/html/rfc2445" target="_top">http://tools.ietf.org/html/rfc2445</a></p><p>The pcal project page: <a class="ulink" href="http://pcal.sourceforge.net/" target="_top">http://pcal.sourceforge.net/</a></p><p>Calcurse home page: <a class="ulink" href="http://calcurse.org/" target="_top">http://calcurse.org/</a></p><p>Calcurse complete manual, translated in many languages and maintained in
html format, can be found in the doc/ directory of the source package,
or at: <a class="ulink" href="http://calcurse.org/files/manual.html" target="_top">http://calcurse.org/files/manual.html</a></p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_authors"></a>12. Authors</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
<span class="strong"><strong>Frederic Culot</strong></span> &lt;<a class="ulink" href="mailto:frederic@culot.org" target="_top">frederic@culot.org</a>&gt;
</li><li class="listitem">
<span class="strong"><strong>Lukas Fleischer</strong></span> &lt;<a class="ulink" href="mailto:calcurse@cryptocrack.de" target="_top">calcurse@cryptocrack.de</a>&gt;
</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_copyright"></a>13. Copyright</h2></div></div></div><p>Copyright (c) 2004-2012 calcurse Development Team.
This software is released under the BSD License.</p></div></div></body></html>