Add Docbook framework for documenting Gnomecal -miguel

svn path=/trunk/; revision=928

8 files changed, 209 insertions, 6 deletions

diff --git a/calendar/Makefile.am b/calendar/Makefile.am
index 5bbf788c8e..bba013da7c 100644
--- a/calendar/Makefile.am
+++ b/calendar/Makefile.am
@@ -1,3 +1,5 @@
+SUBDIRS = doc
+
 help_base = $(datadir)/gnome/help/cal
 
 CFLAGS += -Wall
@@ -67,8 +69,6 @@ gnomecal_LDADD = $(LINK_FLAGS)
 
 EXTRA_DIST = \
 	gncal.desktop	\
-	topic.dat	\
-	gnome-cal.html	\
 	bell.xpm	\
 	recur.xpm
 
diff --git a/calendar/doc/C/Makefile.am b/calendar/doc/C/Makefile.am
new file mode 100644
index 0000000000..be6533d715
--- /dev/null
+++ b/calendar/doc/C/Makefile.am
@@ -0,0 +1,44 @@
+gnomecal_helpdir = $(datadir)/gnome/help/gnomecal/C
+
+gnomecal_help_DATA = 	\
+	gnomecal.html	\
+	topic.dat
+
+SGML_FILES =			\
+	gnomecal.sgml
+
+EXTRA_DIST = \
+	topic.dat		\
+	$(SGML_FILES)
+
+all: 
+
+gnomecal.html: gnomecal/gnomecal.html
+	-cp gnomecal/gnomecal.html .
+
+gnomecal/gnomecal.html: $(SGML_FILES)
+	-db2html gnomecal.sgml
+
+dist-hook:
+	mkdir $(distdir)/gnomecal
+	-cp gnomecal/*.html gnomecal/*.css $(distdir)/gnomecal
+	-cp gnomecal.html $(distdir)
+	mkdir $(distdir)/images
+	-cp images/*.gif images/*.jpg $(distdir)/images
+
+install-data-local: gnomecal.html
+	$(mkinstalldirs) $(gnomecal_helpdir)/images
+	-for file in $(srcdir)/gnomecal/*.html $(srcdir)/gnomecal/*.css; do \
+	basefile=`basename $$file`; \
+	$(INSTALL_DATA) $(srcdir)/$$file $(gnomecal_helpdir)/$$basefile; \
+	done
+	-for file in $(srcdir)/images/*.jpg $(srcdir)/images/*.gif; do \
+	$(INSTALL_DATA) $(srcdir)/$$file $(gnomecal_helpdir)/images;\
+	done
+
+gnomecal.ps: gnomecal.sgml
+	-db2ps $<
+
+gnomecal.rtf: gnomecal.sgml	
+	-db2rtf $<
+
diff --git a/calendar/doc/C/gnomecal.sgml b/calendar/doc/C/gnomecal.sgml
new file mode 100644
index 0000000000..92783cc06a
--- /dev/null
+++ b/calendar/doc/C/gnomecal.sgml
@@ -0,0 +1,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>
\ No newline at end of file
diff --git a/calendar/doc/C/topic.dat b/calendar/doc/C/topic.dat
new file mode 100644
index 0000000000..23af169d62
--- /dev/null
+++ b/calendar/doc/C/topic.dat
@@ -0,0 +1,2 @@
+gnomecal.html	Manual
+cmdline.html	Command line options 
diff --git a/calendar/doc/Makefile.am b/calendar/doc/Makefile.am
new file mode 100644
index 0000000000..42ffacc264
--- /dev/null
+++ b/calendar/doc/Makefile.am
@@ -0,0 +1 @@
+SUBDIRS = C
diff --git a/calendar/gui/Makefile.am b/calendar/gui/Makefile.am
index 5bbf788c8e..bba013da7c 100644
--- a/calendar/gui/Makefile.am
+++ b/calendar/gui/Makefile.am
@@ -1,3 +1,5 @@
+SUBDIRS = doc
+
 help_base = $(datadir)/gnome/help/cal
 
 CFLAGS += -Wall
@@ -67,8 +69,6 @@ gnomecal_LDADD = $(LINK_FLAGS)
 
 EXTRA_DIST = \
 	gncal.desktop	\
-	topic.dat	\
-	gnome-cal.html	\
 	bell.xpm	\
 	recur.xpm
 
diff --git a/calendar/gui/main.c b/calendar/gui/main.c
index 29e0049ae2..9462a3a531 100644
--- a/calendar/gui/main.c
+++ b/calendar/gui/main.c
@@ -489,7 +489,7 @@ static GnomeUIInfo gnome_cal_edit_menu [] = {
 };
 
 static GnomeUIInfo gnome_cal_help_menu [] = {
-	GNOMEUIINFO_HELP ("cal"),
+	GNOMEUIINFO_HELP ("gnomecal"),
 
 	GNOMEUIINFO_MENU_ABOUT_ITEM(about_calendar_cmd, NULL),
 
diff --git a/calendar/main.c b/calendar/main.c
index 29e0049ae2..9462a3a531 100644
--- a/calendar/main.c
+++ b/calendar/main.c
@@ -489,7 +489,7 @@ static GnomeUIInfo gnome_cal_edit_menu [] = {
 };
 
 static GnomeUIInfo gnome_cal_help_menu [] = {
-	GNOMEUIINFO_HELP ("cal"),
+	GNOMEUIINFO_HELP ("gnomecal"),
 
 	GNOMEUIINFO_MENU_ABOUT_ITEM(about_calendar_cmd, NULL),