aboutsummaryrefslogtreecommitdiffstats
path: root/calendar/doc/C/gnomecal.sgml
blob: 92783cc06ac74a41d705f91b8645e0ce9af925ab (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
<!DOCTYPE book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
]>

<book id="gnomecal">
  <bookinfo>
    <title>GNOME calendar user's manual</title>
    <authorgroup>
      <author>
    <firstname>Miguel</firstname> <surname>de Icaza
      Amozurrutia</surname>
    <affiliation>
      <address>
        <email>miguel@gnu.org</email>
      </address>
    </affiliation>
      </author>
    </authorgroup>
    <copyright>
      <year>1998, 1999</year> <holder>Miguel de Icaza</holder>
    </copyright>
    <legalnotice>
      <para>This documentation is free software; you can redistribute
    it and/or modify it under the terms of the GNU General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later
    version.</para>
      
      <para>This program is distributed in the hope that it will be
    useful, but WITHOUT ANY WARRANTY; without even the implied
    warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    See the GNU General Public License for more details.</para>
      
      <para>You should have received a copy of the GNU General Public
    License along with this program; if not, write to the Free
    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
    MA 02111-1307 USA</para>
      
      <para>For more details see the file COPYING in the source
    distribution of GNOME.</para>
    </legalnotice>
  </bookinfo>

  <toc></toc>

  <chapter id="cmdline">
    <title>Command line options</title>

    <para>
      The following command line options are recognized by the
      <filename>gnomecal</filename> program.  You can use these
      options to alter the behaviour of the program or to quickly
      query the program for appointments, and to do items from the
      command line without requiring an X display.  These are usefu
      for example to include in scripts.
    </para>

    <para>
      <itemizedlist>

        <listitem>
          <para>
            <emphasis>--events</emphasis>.  Displays the events for the
        date specified (or today, if no date is specified).
      </para>
        </listitem>

        <listitem>
          <para>
            <emphasis>--from DATE</emphasis>.  Define the beginning of
        the range for the event display, or the startup day on the
        calenday views.  By default, the event will span the whole
        day specified in DATE.
          </para>
        </listitem>

    <listitem>
          <para>
            <emphasis>--to DATE</emphasis>.  Define the range end for
        the event display.  If this is not specified, it will
        default to the end of the day specified by the
        <emphasis>--from</emphasis> option.
          </para>
        </listitem>

    <listitem>
          <para>
            <emphasis>--file FILE</emphasis>.  Set the calendar to the
        <emphasis>FILE</emphasis> specified on the command line.
          </para>
        </listitem>

    <listitem>
          <para>
            <emphasis>--todo</emphasis>.  Dumps the to-do values to
        standard output.
          </para>
        </listitem>

        <listitem>
          <para>
            <emphasis>--userfile</emphasis>.  Use this if you want to
            force the file to be loaded to be the default user's
            calendar (this is the default, only used to override the
            --file if you have some sort of macro.
          </para>
        </listitem>

        <listitem>
          <para>
            <emphasis>--geometry</emphasis>.  Used to specity the
            startup geometry of the application (location and size).
          </para>
        </listitem>
        
        <listitem>
          <para>
            <emphasis>--view VIEWMODE</emphasis>.  Use this to specify
            the startup view that should be used.
            <emphasis>VIEWMODE</emphasis> is one of: dayview,
            weekview, monthview, yearview.
          </para>
        </listitem>
     
      </itemizedlist>
    </para>

    <para>
      <emphasis>DATE</emphasis> is interpreted as being in the local
      time-zone, unless a specific timezone is specified.  Examples
      of valid date specifications include: "1 month ago", "2 hours
      ago", "400000 seconds ago", "last year", "last Monday",
      "yesterday", "a fortnight ago", "3/31/92 10:00:07 PST", "January
      23, 1987 10:05pm", "22:00 GMT".  
    </para>
  </chapter>

  <chapter id="tech.html">
    <title>Technical information about the GNOME calendar</title>

    <para>
      Currently, the GNOME calendar uses the vCal file format standard 
      for storing and loading its appointment and todo database.  This
      standard is widely used in various other calendar applications,
      so it provides a good mechanism for exchanging appointments.
    </para>
    <para>
      In the future the GNOME calendar will support the upcoming
      iCalendar specification as well.
    </para>
    <para>
      If you want to know more about the vCal specification, you can
      check the <ulink url="http://www.imc.org" type=http>Internet
      Mail Consortium (http://www.imc.org)</ulink> for the details.
    </para>
  </chapter>
</book>