<HTML
><HEAD
><TITLE
>Command line options</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="GNOME calendar user's manual"
HREF="gnomecal.html"><LINK
REL="PREVIOUS"
TITLE="GNOME calendar user's manual"
HREF="gnomecal.html"><LINK
REL="NEXT"
TITLE="Technical information about the GNOME calendar"
HREF="tech.html.html"></HEAD
><BODY
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME calendar user's manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="gnomecal.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="tech.html.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="CMDLINE"
>Chapter 1. Command line options</A
></H1
><P
>      The following command line options are recognized by the
      <TT
CLASS="FILENAME"
>gnomecal</TT
> 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 useful
      for example to include in scripts.
    </P
><P
>      <P
></P
><UL
><LI
><P
>            <I
CLASS="EMPHASIS"
>--events</I
>.  Displays the events for the
	    date specified (or today, if no date is specified).
	  </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--from DATE</I
>.  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.
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--to DATE</I
>.  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
	    <I
CLASS="EMPHASIS"
>--from</I
> option.
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--file FILE</I
>.  Set the calendar to the
	    <I
CLASS="EMPHASIS"
>FILE</I
> specified on the command line.
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--todo</I
>.  Dumps the to-do values to
	    standard output.
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--userfile</I
>.  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.
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--geometry</I
>.  Used to specity the
            startup geometry of the application (location and size).
          </P
></LI
><LI
><P
>            <I
CLASS="EMPHASIS"
>--view VIEWMODE</I
>.  Use this to specify
            the startup view that should be used.
            <I
CLASS="EMPHASIS"
>VIEWMODE</I
> is one of: dayview,
            weekview, monthview, yearview.
          </P
></LI
></UL
>
    </P
><P
>      <I
CLASS="EMPHASIS"
>DATE</I
> 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".  
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gnomecal.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnomecal.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="tech.html.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>GNOME calendar user's manual</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Technical information about the GNOME calendar</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>