Commit abfb543c authored by Jonh Wendell's avatar Jonh Wendell Committed by Jonh Wendell S. Santana
Browse files

Initial documentation skeleton, patch from Jaap A. Haitsma, important step

2007-12-19  Jonh Wendell <jwendell@gnome.org>

	* lots of files: Initial documentation skeleton, patch from Jaap A. Haitsma,
	  important step to fix bug #503806.

svn path=/trunk/; revision=122
parent 52ece310
2007-12-19 Jonh Wendell <jwendell@gnome.org>
* lots of files: Initial documentation skeleton, patch from Jaap A. Haitsma,
important step to fix bug #503806.
2007-12-15 Jonh Wendell <jwendell@gnome.org>
* src/vinagre-commands.c:
Make links in about dialog clickable. Closes #503770
......
SUBDIRS = src po data
SUBDIRS = src help po data
vinagredocdir = ${datadir}/doc/vinagre
vinagredoc_DATA = \
......
......@@ -27,6 +27,7 @@ AC_DEFINE_UNQUOTED(GETTEXT_PACKAGE,"$GETTEXT_PACKAGE", [GETTEXT package name])
IT_PROG_INTLTOOL([0.35.0])
AM_GLIB_GNU_GETTEXT
GNOME_DOC_INIT
#*******************************************************************************
# Check required GNOME libraries
......@@ -83,6 +84,7 @@ data/Makefile
data/vinagre.desktop.in
data/vinagre-file.desktop.in
data/icons/Makefile
help/Makefile
po/Makefile.in
src/Makefile
])
......
<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>
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY GFDL SYSTEM "fdl-appendix.xml">
<!ENTITY app "Vinagre">
<!ENTITY application "<application>&app;</application>">
<!ENTITY appversion "0.4">
<!ENTITY manrevision "0.4">
]>
<!--
(Do not remove this comment block.)
Template Maintained by the GNOME Documentation Project:
http://developer.gnome.org/projects/gdp
Template version: 2.0 beta
Template last modified Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo>
<title>&application; Manual</title>
<abstract role="description">
<para>
&application; is a Remote Desktop Viewer
</para>
</abstract>
<copyright>
<year>2007</year>
<holder>Jonh Wendell (wendell@bani.com.br)</holder>
</copyright>
<!-- translators: uncomment this:
<copyright>
<year>2006</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 role="maintainer">
<publishername>Jonh Wendell</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 role="maintainer">
<firstname>Jonh</firstname>
<surname>Wendell</surname>
<email>wendell@bani.com.br</email>
</author>
<!-- This is appropriate place for other contributors: translators,
maintainers, etc. Commented out by default.
<othercredit role="translator">
<firstname>Latin</firstname>
<surname>Translator 1</surname>
<affiliation>
<orgname>Latin Translation Team</orgname>
<address> <email>translator@gnome.org</email> </address>
</affiliation>
<contrib>Latin translation</contrib>
</othercredit>
-->
</authorgroup>
<revhistory>
<revision>
<revnumber>0.1</revnumber>
<date>2007-12-16</date>
<revdescription>
<para role="author">Jaap A. Haitsma
<email>jaap@haitsma.org</email>
</para>
<para role="publisher">Jaap A. Haitsma</para>
</revdescription>
</revision>
</revhistory>
<legalnotice>
<title>Feedback</title>
<para>
To report a bug or make a suggestion regarding the &app; application or
this manual, follow the directions in the
<ulink url="http://www.gnome.org/projects/vinagre/"
type="http">&application; Contact Page</ulink>.
</para>
<!-- Translators may also add here feedback address for translations -->
</legalnotice>
</articleinfo>
<indexterm zone="index">
<primary>&application;</primary>
</indexterm>
<indexterm zone="index">
<primary>vinagre</primary>
</indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<section id="intro">
<title>Introduction</title>
<!-- manrevision 2.0 compatibility -->
<anchor id="aboutex"/>
<anchor id="notice"/>
<indexterm>
<primary>&application;</primary>
<secondary>Manual</secondary>
<tertiary>vinagre</tertiary>
</indexterm>
<para>
&app; is remote desktop viewer for the <systemitem>GNOME desktop</systemitem>
</para>
</section>
<section id="using">
<title>Usage</title>
<para>
Describe usage overhere
</para>
<figure>
<title>&app; screenshot</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/vinagre-screenshot.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</figure>
<para>
Describe usage here
</para>
</section>
<section id="preferences">
<title>Preferences</title>
<para>
Describe preferences overhere
</para>
</section>
<section id="faq">
<title>Frequently Asked Questions</title>
<para>
Describe FAQ overhere
</para>
</section>
<section id="about">
<title>About</title>
<para>
&app; was written by Jonh Wendell <email>wendell@bani.com.br</email>.
To find more information about &app;, please visit the
<ulink url="http://www.gnome.org/projects/vinagre" type="http">
&application; web page</ulink>.
</para>
<para>
To report a bug or make a suggestion regarding this application you can file
a bug in our
<ulink url="http://bugzilla.gnome.org/browse.cgi?product=vinagre" type="http">
bug tracker</ulink>.
</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 the
<ulink url="http://www.gnu.org/licenses/gpl.html" type="http">GNU site</ulink>, or in the file
COPYING included with the source code of this program.
</para>
</section>
</article>
include $(top_srcdir)/gnome-doc-utils.make
dist-hook: doc-dist-hook
DOC_MODULE = vinagre
DOC_ENTITIES = legal.xml
DOC_INCLUDES =
DOC_FIGURES = \
figures/vinagre-screenshot.png
DOC_LINGUAS =
<?xml version="1.0" standalone="no"?>
<omf>
<resource>
<subject category="GNOME|Applications|Internet"/>
<type>
user's guide
</type>
<relation seriesid="bb353636-2d9e-4ca1-87c7-3afd25ff5b0d"/>
<rights type="GNU FDL" license.version="1.1" holder="Jonh Wendell"/>
</resource>
</omf>
......@@ -26,6 +26,7 @@
#include <glib/gi18n.h>
#include <gtk/gtk.h>
#include <libgnomevfs/gnome-vfs.h>
#include <string.h>
#include "vinagre-commands.h"
#include "vinagre-utils.h"
......@@ -306,6 +307,49 @@ vinagre_about_dialog_handle_email (GtkAboutDialog *about, const char *link, gpoi
}
/* Help Menu */
void
vinagre_cmd_help_contents (GtkAction *action,
VinagreWindow *window)
{
GError *error = NULL;
char *command;
const char *lang;
char *uri = NULL;
int i;
const char * const * langs = g_get_language_names ();
for (i = 0; langs[i]; i++)
{
lang = langs[i];
if (strchr (lang, '.'))
continue;
if (uri)
g_free (uri);
uri = g_build_filename (DATADIR, "/gnome/help/vinagre/", lang, "/vinagre.xml", NULL);
if (g_file_test (uri, G_FILE_TEST_EXISTS))
break;
}
command = g_strconcat ("gnome-open ghelp://", uri, NULL);
gdk_spawn_command_line_on_screen (gtk_window_get_screen (GTK_WINDOW (window)),
command,
&error);
if (error != NULL)
{
vinagre_utils_show_error (error->message, GTK_WINDOW (window));
g_error_free (error);
}
g_free (command);
g_free (uri);
}
void
vinagre_cmd_help_about (GtkAction *action,
VinagreWindow *window)
......@@ -364,4 +408,5 @@ vinagre_cmd_help_about (GtkAction *action,
NULL);
g_free (license_trans);
}
/* vim: ts=8 */
......@@ -62,6 +62,8 @@ void vinagre_cmd_bookmarks_edit (GtkAction *action,
void vinagre_cmd_bookmarks_del (GtkAction *action,
VinagreWindow *window);
void vinagre_cmd_help_contents (GtkAction *action,
VinagreWindow *window);
void vinagre_cmd_help_about (GtkAction *action,
VinagreWindow *window);
......
......@@ -54,7 +54,7 @@ static const GtkActionEntry vinagre_always_sensitive_menu_entries[] =
/* Help menu */
{"HelpContents", GTK_STOCK_HELP, N_("_Contents"), "F1",
N_("Open the vinagre manual"), NULL },
N_("Open the vinagre manual"), G_CALLBACK (vinagre_cmd_help_contents)},
{ "HelpAbout", GTK_STOCK_ABOUT, NULL, NULL,
N_("About this application"), G_CALLBACK (vinagre_cmd_help_about) }
};
......
......@@ -630,11 +630,6 @@ init_widgets_visibility (VinagreWindow *window)
"BookmarksEdit");
gtk_action_set_sensitive (action, FALSE);
/* TODO: Implement these commands */
action = gtk_action_group_get_action (window->priv->always_sensitive_action_group,
"HelpContents");
gtk_action_set_sensitive (action, FALSE);
/* fav panel visibility */
action = gtk_action_group_get_action (window->priv->always_sensitive_action_group,
"ViewBookmarks");
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment