diff options
| -rw-r--r-- | ChangeLog | 17 | ||||
| -rw-r--r-- | Makefile.am | 2 | ||||
| -rw-r--r-- | configure.in | 2 | ||||
| -rw-r--r-- | help/C/Makefile.am | 7 | ||||
| -rw-r--r-- | help/C/epiphany-C.omf | 31 | ||||
| -rw-r--r-- | help/C/epiphany.xml | 217 | ||||
| -rw-r--r-- | help/C/figures/ephy-screenshot.png | bin | 0 -> 40200 bytes | |||
| -rw-r--r-- | help/C/legal.xml | 76 | ||||
| -rw-r--r-- | help/Makefile.am | 1 | ||||
| -rw-r--r-- | omf-install/Makefile.am | 33 | ||||
| -rw-r--r-- | omf.make | 53 | ||||
| -rw-r--r-- | src/window-commands.c | 28 | ||||
| -rw-r--r-- | xmldocs.make | 95 |
13 files changed, 560 insertions, 2 deletions
@@ -1,3 +1,20 @@ +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) + 2003-03-25 Marco Pesenti Gritti <marco@it.gnome.org> * lib/ephy-dnd.c: diff --git a/Makefile.am b/Makefile.am index 136c4ba21..2277cbae8 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,6 +1,6 @@ ## Process this file with automake to produce Makefile.in -SUBDIRS = lib embed src data po +SUBDIRS = lib embed src data po help EXTRA_DIST = \ intltool-merge.in \ diff --git a/configure.in b/configure.in index dfc6be298..7e252255e 100644 --- a/configure.in +++ b/configure.in @@ -170,5 +170,7 @@ embed/Makefile embed/mozilla/Makefile src/Makefile src/bookmarks/Makefile +help/Makefile +help/C/Makefile po/Makefile.in ]) 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 Binary files differnew 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 diff --git a/omf-install/Makefile.am b/omf-install/Makefile.am new file mode 100644 index 000000000..74086afcd --- /dev/null +++ b/omf-install/Makefile.am @@ -0,0 +1,33 @@ +# +# Modify the definition of $omf_dest_dir, replacing "gdp-example1" with +# the name of your package. +# +# No other modifications should be necessary. +# +# Note that you must configure your package with --localstatedir=/var/lib +# so that the scrollkeeper-update command below will update the database +# in the standard scrollkeeper directory. +# +# If it is impossible to configure with --localstatedir=/var/lib, then +# modify the definition of scrollkeeper_localstate_dir so that +# it points to the correct location. Note that you must still use +# $(localstatedir) in this or when people build RPMs it will update +# the real database on their system instead of the one under RPM_BUILD_ROOT. + +omf_dest_dir=$(datadir)/omf/epiphany +scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper + +install-data-local: + $(mkinstalldirs) $(DESTDIR)$(omf_dest_dir) + -for file in $(srcdir)/*.omf; do \ + $(INSTALL_DATA) $(srcdir)/$$file $(DESTDIR)$(omf_dest_dir); \ + done + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) + +uninstall-local: + -for file in $(srcdir)/*.omf; do \ + basefile=`basename $$file`; \ + rm -f $(omf_dest_dir)/$$basefile; \ + done + -rmdir $(omf_dest_dir) + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) diff --git a/omf.make b/omf.make new file mode 100644 index 000000000..3261e0015 --- /dev/null +++ b/omf.make @@ -0,0 +1,53 @@ +# +# No modifications of this Makefile should be necessary. +# +# This file contains the build instructions for installing OMF files. It is +# generally called from the makefiles for particular formats of documentation. +# +# Note that you must configure your package with --localstatedir=/var/lib +# so that the scrollkeeper-update command below will update the database +# in the standard scrollkeeper directory. +# +# If it is impossible to configure with --localstatedir=/var/lib, then +# modify the definition of scrollkeeper_localstate_dir so that +# it points to the correct location. Note that you must still use +# $(localstatedir) in this or when people build RPMs it will update +# the real database on their system instead of the one under RPM_BUILD_ROOT. +# +# Note: This make file is not incorporated into xmldocs.make because, in +# general, there will be other documents install besides XML documents +# and the makefiles for these formats should also include this file. +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + +omf_dest_dir=$(datadir)/omf/@PACKAGE@ +scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper + +omf: omf_timestamp + +omf_timestamp: $(omffile) + -for file in $(omffile); do \ + scrollkeeper-preinstall $(docdir)/$(docname).xml $(srcdir)/$$file $$file.out; \ + done + touch omf_timestamp + +install-data-hook-omf: + $(mkinstalldirs) $(DESTDIR)$(omf_dest_dir) + for file in $(omffile); do \ + $(INSTALL_DATA) $$file.out $(DESTDIR)$(omf_dest_dir)/$$file; \ + done + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) -o $(DESTDIR)$(omf_dest_dir) + +uninstall-local-omf: + -for file in $(srcdir)/*.omf; do \ + basefile=`basename $$file`; \ + rm -f $(omf_dest_dir)/$$basefile; \ + done + -rmdir $(omf_dest_dir) + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) diff --git a/src/window-commands.c b/src/window-commands.c index 2891160a6..fbb42dfa0 100644 --- a/src/window-commands.c +++ b/src/window-commands.c @@ -16,6 +16,11 @@ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ +/* + * 25 Mar 2003: Added support for help manual : Patanjali Somayaji + * (patanjali@codito.com) + */ + #include <config.h> #include "ephy-shell.h" @@ -666,7 +671,28 @@ void window_cmd_help_contents (EggAction *action, EphyWindow *window) { - /* FIXME: Need to implement */ + GError *err; + + err = NULL; + gnome_help_display ("epiphany", NULL, &err); + + if (err != NULL) + { + GtkWidget *dialog; + dialog = gtk_message_dialog_new (GTK_WINDOW (window), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_MESSAGE_ERROR, + GTK_BUTTONS_CLOSE, + _("Could not display help: %s"), err->message); + + g_signal_connect (G_OBJECT (dialog), "response", + G_CALLBACK (gtk_widget_destroy), + NULL); + + gtk_window_set_resizable (GTK_WINDOW (dialog), FALSE); + gtk_widget_show (dialog); + g_error_free (err); + } } void diff --git a/xmldocs.make b/xmldocs.make new file mode 100644 index 000000000..9f78af7f6 --- /dev/null +++ b/xmldocs.make @@ -0,0 +1,95 @@ +# +# No modifications of this Makefile should be necessary. +# +# To use this template: +# 1) Define: figdir, docname, lang, omffile, and entities in +# your Makefile.am file for each document directory, +# although figdir, omffile, and entities may be empty +# 2) Make sure the Makefile in (1) also includes +# "include $(top_srcdir)/xmldocs.make" and +# "dist-hook: app-dist-hook". +# 3) Optionally define 'entities' to hold xml entities which +# you would also like installed +# 4) Figures must go under $(figdir)/ and be in PNG format +# 5) You should only have one document per directory +# 6) Note that the figure directory, $(figdir)/, should not have its +# own Makefile since this Makefile installs those figures. +# +# example Makefile.am: +# figdir = figures +# docname = scrollkeeper-manual +# lang = C +# omffile=scrollkeeper-manual-C.omf +# entities = fdl.xml +# include $(top_srcdir)/xmldocs.make +# dist-hook: app-dist-hook +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + + +# ************* Begin of section some packagers may need to modify ************** +# This variable (docdir) specifies where the documents should be installed. +# This default value should work for most packages. +# docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang) +docdir = $(datadir)/gnome/help/$(docname)/$(lang) + +# ************** You should not have to edit below this line ******************* +xml_files = $(entities) $(docname).xml + +EXTRA_DIST = $(xml_files) $(omffile) +CLEANFILES = omf_timestamp + +include $(top_srcdir)/omf.make + +all: omf + +$(docname).xml: $(entities) + -ourdir=`pwd`; \ + cd $(srcdir); \ + cp $(entities) $$ourdir + +app-dist-hook: + if test "$(figdir)"; then \ + $(mkinstalldirs) $(distdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-local: omf + $(mkinstalldirs) $(DESTDIR)$(docdir) + for file in $(xml_files); do \ + cp $(srcdir)/$$file $(DESTDIR)$(docdir); \ + done + if test "$(figdir)"; then \ + $(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-hook: install-data-hook-omf + +uninstall-local: uninstall-local-doc uninstall-local-omf + +uninstall-local-doc: + -if test "$(figdir)"; then \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + rm -f $(docdir)/$(figdir)/$$basefile; \ + done; \ + rmdir $(DESTDIR)$(docdir)/$(figdir); \ + fi + -for file in $(xml_files); do \ + rm -f $(DESTDIR)$(docdir)/$$file; \ + done + -rmdir $(DESTDIR)$(docdir) + |
