Added help support, help manual and scrollkeeper updates

2003-03-26  Patanjali Somayaji <patanjali@codito.com>

	Added help support, help manual and scrollkeeper updates

	* configure.in (help/Makefile and help/C/Makefile for AC_OUTPUT())
	* makefile.am (added "help" to SUBDIRS in Makefile.am)
	* omf.make (added)
 	* xmldocs.make (added)
	* omf-install/Makefile.am (added)
	* help/Makefile.am (added)
	* help/C/epiphany.xml (manual xml added)
	* help/C/legal.xml (added)
	* help/C/epiphany-C.omf (omf file added)
	* help/C/Makefile.am (added)
	* help/C/figures/ephy-screenshot.png (added)
	* src/window-commands.c (added handler code to show manual)

6 files changed, 332 insertions, 0 deletions

diff --git a/help/C/Makefile.am b/help/C/Makefile.am
new file mode 100644
index 000000000..f4f50f3b8
--- /dev/null
+++ b/help/C/Makefile.am
@@ -0,0 +1,7 @@
+figdir = figures
+docname = epiphany
+lang = C
+omffile = epiphany-C.omf
+entities = legal.xml
+include $(top_srcdir)/xmldocs.make
+dist-hook: app-dist-hook
diff --git a/help/C/epiphany-C.omf b/help/C/epiphany-C.omf
new file mode 100644
index 000000000..2e648f16a
--- /dev/null
+++ b/help/C/epiphany-C.omf
@@ -0,0 +1,31 @@
+<?xml version="1.0" standalone="no"?>
+<omf>
+  <resource>
+    <creator>
+      Patanjali Somayaji 
+    </creator>
+    <maintainer>
+      Patanjali Somayaji
+    </maintainer>
+    <title>
+      Epiphany Manual Vx.x
+    </title>
+    <date>
+      2003-25-03
+    </date>
+    <version identifier="2.0" date="2003-25-03" 
+    description="Epiphany Manual, first version, program version 1.107"/>
+    <subject category="GNOME|Applications"/>
+    <description>
+      User manual for Epiphany - GNOME2 web browser. 
+    </description>
+    <type>
+      user's guide
+    </type>
+    <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"/>
+    <identifier url="epiphany.xml"/>
+    <language code="C"/>
+    <relation seriesid="48206048-5ef3-11d7-85db-fe5f992e5b79"/>
+    <rights type="GNU FDL" license.version="1.1" holder="Patanjali Somayaji"/>
+  </resource>
+</omf>
diff --git a/help/C/epiphany.xml b/help/C/epiphany.xml
new file mode 100644
index 000000000..9b318b8ae
--- /dev/null
+++ b/help/C/epiphany.xml
@@ -0,0 +1,217 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+  <!ENTITY legal SYSTEM "legal.xml">
+  <!ENTITY appversion "0.5.0">
+  <!ENTITY manrevision "2.0">
+  <!ENTITY date "Mar 2003">
+  <!ENTITY fr "<application>Epiphany</application>">
+  <!-- Information about the entities
+       The legal.xml file contains legal information, there is no need to edit the file. 
+       Use the appversion entity to specify the version of the application.
+       Use the manrevision entity to specify the revision number of this manual.
+       Use the date entity to specify the release date of this manual.
+       Use the fr entity to specify the name of the application. -->
+]>
+<!-- 
+      (Do not remove this comment block.)
+  Maintained by the GNOME Documentation Project
+  http://developer.GNOME.org/projects/gdp
+  Template version: 2.0 beta
+  Template last modified Jan 30, 2002
+-->
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+  <articleinfo> 
+    <title>Epiphany Manual &manrevision;</title>       
+
+    <copyright> 
+      <year>2003</year> 
+      <holder>Patanjali Somayaji</holder> 
+    </copyright> 
+
+<!-- translators: uncomment this:
+
+  <copyright>
+   <year>2002</year>
+   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+  </copyright>
+
+   -->
+<!-- An address can be added to the publisher information.  If a role is 
+     not specified, the publisher/author is the same for all versions of the 
+     document.  -->
+    <publisher> 
+      <publishername> GNOME Documentation Project </publishername> 
+    </publisher> 
+
+   &legal; <!-- This file contains link to license for the
+   documentation (GNU FDL), and other legal stuff such as "NO
+   WARRANTY" statement. Please do not change any of this. -->
+
+    <authorgroup> 
+      <author> 
+	<firstname>Patanjali</firstname> 
+	<surname>Somayaji</surname> 
+	<affiliation> 
+	  <orgname>GNOME Documentation Project</orgname> 
+	  <address> <email>patanjali@codito.com</email> </address> 
+	</affiliation> 
+      </author> 
+    </authorgroup>
+
+
+    <releaseinfo> This manual describes version &appversion; of &fr;.
+    </releaseinfo> 
+  </articleinfo> 
+
+  <indexterm zone="index"> 
+    <primary>Epiphany</primary> 
+  </indexterm> 
+  <indexterm zone="index"> 
+    <primary>epiphany</primary> 
+  </indexterm>
+  <indexterm zone="index"> 
+    <primary>Browser</primary> 
+  </indexterm>
+
+<!-- ============= Document Body ============================= -->
+<!-- ============= Introduction ============================== -->
+<!-- Use the Introduction section to give a brief overview of what
+     the application is and what it does. -->
+  <sect1 id="fr-introduction"> 
+    <title>Introduction</title> 
+    <para>&fr; is a GNOME web browser based on the mozilla rendering 
+	engine. A web browser is more than an application, it is a way 
+	of thinking, it is a way of seeing the world. Epiphany's 
+	principles are simplicity and standards compliance.
+
+   </para>
+    <figure id="fr-add-dialog-fig">
+	<title>Epiphany Screenshot</title>
+	<screenshot> 
+	  <mediaobject> 
+	    <imageobject><imagedata
+		fileref="figures/ephy-screenshot.png" format="PNG"/> 
+	    </imageobject>
+	  </mediaobject>
+	</screenshot>
+      </figure>
+   
+
+   <para>	
+   <itemizedlist>
+    <listitem>
+      <para>Simplicity:</para>
+      <para>
+Epiphany aims to utilize the simplest interface possible for a browser.  Keep
+in mind that simple does not necessarily mean less powerful.  We believe
+the commonly used browsers of today are too big, buggy, and bloated. Epiphany
+addresses simplicity with a small browser designed for the web -- not mail,
+newsgroups, file management, instant messenging or coffee making.  The UNIX
+philosophy is to design small tools that do one thing, and do it well.
+
+Epiphany also address simplicity with modularity to make a light and powerful
+application.  If something can be implemented using external applications
+or components, we use it rather than wasting resources in the web browser.
+Integration will be achived with CORBA, Bonobo, and the ever popular
+command line.  
+
+Mail will be handled with your favorite e-mail application (Evolution, pine,
+mutt, balsa, pronto, whatever).
+      </para>
+    </listitem>
+    <listitem>
+      <para>Standards compliance:</para>
+      <para>
+The introduction of non-standard features in browsers could make it difficult
+or impossible to use alternative products like Epiphany if developers embrace
+them.  Alternative (standards complying) browsers could not be able to
+fully access web sites making use of these features.  The success of
+non-standard features can ultimately lead to forcing one browser, on
+one platform to dominate the market. Standards compliance ensures the 
+freedom of choice.  Epiphany aims to achieve this.
+      </para>
+    </listitem>
+    <listitem>
+      <para>USER INTERFACE LINES</para>
+        <itemizedlist>
+          <listitem>
+            <para>HIG compliance</para>
+              <para>
+Epiphany is going to follow version 1.0 of the gnome 
+user guidelines. Unless there are very seriuos reasons to make an 
+exception not following it will be considered a bug. 
+"I follow the HIG only when I like it" is not a legitimate approach. 
+Any areas where we diverge from the HIG will communicated 
+to the HIG team for future consideration.
+            </para>
+          </listitem>
+          <listitem>
+            <para>Gnome integration</para>
+            <para>
+Epiphany's main goal is to be integrated with the gnome desktop. 
+We dont aim to make epiphany usable outside Gnome. If someone will like 
+to use it anyway, it's just a plus. Ex: Making people happy that 
+don't have control center installed is not a good reason 
+to have mime configuration in epiphany itself.
+            </para>
+          </listitem>
+          <listitem>
+            <para>Simple design</para>
+            <para>
+Feature bloat and user interface clutter is evil :)
+            </para>
+          </listitem>
+          <listitem>
+            <para>Preferences</para>
+            <para>
+We will follow the new gnome policy about preferences. 
+I think Havoc Pennington already explained it a lot 
+better than I could ever do.
+http://www106.pair.com/rhp/free-software-ui.html
+            </para>
+          </listitem>
+          <listitem>
+            <para>User target</para>
+            <para>
+We target non-technical users by design. 
+This happens to be 90% of the user population.
+(Technical details should not exposed in the interface)
+We target web users, we dont directly target web developers.
+A few geek-oriented feautures can be kept as 
+long as they are non-obtrusive.
+            </para>
+          </listitem>
+        </itemizedlist>
+    </listitem>
+  </itemizedlist>
+  </para>
+  </sect1>
+
+<!-- ============= About ================================== -->
+  <sect1 id="fr-about"> 
+    <title>About &fr;</title> 
+
+    <para> &fr; was written by Marco Presenti Gritti 
+      (<email>marco@it.gnome.org</email>). To find more information
+      about &fr;, please visit the <ulink
+      url="http://epiphany.mozdev.org" type="http">Epiphany 
+      Web page</ulink>. 
+    </para>
+    <para>
+      This manual was written by Patanjali Somayaji 
+      (<email>patanjali@codito.com</email>). 
+    </para>
+
+    <para> This program is distributed 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. A copy of this license can be found at this
+      <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
+      COPYING included with the source code of this program. </para>
+
+  </sect1> 
+</article>
diff --git a/help/C/figures/ephy-screenshot.png b/help/C/figures/ephy-screenshot.png
new file mode 100644
index 000000000..85bc13983
--- /dev/null
+++ b/help/C/figures/ephy-screenshot.png
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 000000000..d6906f9b9
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,76 @@
+   <legalnotice id="legalnotice">
+         <para>
+           Permission is granted to copy, distribute and/or modify this
+           document under the terms of the GNU Free Documentation
+           License (GFDL), Version 1.1 or any later version published
+           by the Free Software Foundation with no Invariant Sections,
+           no Front-Cover Texts, and no Back-Cover Texts.  You can find
+           a copy of the GFDL at this <ulink type="help"
+           url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+           distributed with this manual.
+          </para>
+          <para> This manual is part of a collection of GNOME manuals
+           distributed under the GFDL.  If you want to distribute this
+           manual separately from the collection, you can do so by
+           adding a copy of the license to the manual, as described in
+           section 6 of the license.
+         </para>
+ 
+         <para>
+           Many of the names used by companies to distinguish their
+           products and services are claimed as trademarks. Where those
+           names appear in any GNOME documentation, and the members of
+           the GNOME Documentation Project are made aware of those
+           trademarks, then the names are in capital letters or initial
+           capital letters.
+         </para>
+ 
+         <para>
+           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+           WITH THE FURTHER UNDERSTANDING THAT:
+ 
+           <orderedlist>
+                 <listitem>
+                   <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
+                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+                     EXCEPT UNDER THIS DISCLAIMER; AND
+                   </para>
+                 </listitem>
+                 <listitem>
+                   <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+                        THE POSSIBILITY OF SUCH DAMAGES.
+                   </para>
+                 </listitem>
+           </orderedlist>
+         </para>
+   </legalnotice>
+ 
\ No newline at end of file
diff --git a/help/Makefile.am b/help/Makefile.am
new file mode 100644
index 000000000..42ffacc26
--- /dev/null
+++ b/help/Makefile.am
@@ -0,0 +1 @@
+SUBDIRS = C