<HTML
><HEAD
><TITLE
>gnome-url</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK
REL="HOME"
TITLE="Gnome Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome Library"
HREF="libgnome.html"><LINK
REL="PREVIOUS"
TITLE="gnome-triggers"
HREF="gnome-gnome-triggers.html"><LINK
REL="NEXT"
TITLE="gnome-util"
HREF="gnome-gnome-util.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-gnome-triggers.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOME-GNOME-URL"
>gnome-url</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4319"
></A
><H2
>Name</H2
>gnome-url -- Launch viewers for documents based on their URL</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4322"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
void <A
HREF="gnome-gnome-url.html#GNOME-URL-SHOW"
>gnome_url_show</A
> (const char *url);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4326"
></A
><H2
>Description</H2
><P
><A
HREF="gnome-gnome-url.html#GNOME-URL-SHOW"
>gnome_url_show</A
>() provides a simple way to display information to the
user. <A
HREF="gnome-gnome-url.html#GNOME-URL-SHOW"
>gnome_url_show</A
>() knows about the <SPAN
CLASS="TYPE"
>man:</SPAN
>,
<SPAN
CLASS="TYPE"
>info:</SPAN
> and <SPAN
CLASS="TYPE"
>ghelp:</SPAN
> special URL prefixes and
will invoke the proper display program for those. </P
><P
>Any other URL is passed to the default information display handler
(usually this defaults to the <TT
CLASS="FILENAME"
>gnome-moz-remote</TT
>
program (which uses Mozilla to display the URL). </P
><P
><A
HREF="gnome-gnome-url.html#GNOME-URL-SHOW"
>gnome_url_show</A
>() uses the user configured programs for the
different URL types. The settings for each one of these handlers is
stored in the configuration file <TT
CLASS="FILENAME"
>~/.gnome/Gnome</TT
>
in the section "URL Handlers". The possible keys are:</P
><P
></P
><UL
><LI
><P
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>info-show:</I
></SPAN
> The command to display an
<SPAN
CLASS="TYPE"
>info:</SPAN
> URL.</P
></LI
><LI
><P
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>man-show:</I
></SPAN
> The command to display an
<SPAN
CLASS="TYPE"
>man:</SPAN
> URL.</P
></LI
><LI
><P
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>ghelp-show:</I
></SPAN
> The command to display an
<SPAN
CLASS="TYPE"
>ghelp:</SPAN
> URL (this is a GNOME-relative help
document).</P
></LI
><LI
><P
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>default-show:</I
></SPAN
> The command to display
any URL type which is not covered by the other cases.</P
></LI
></UL
><P
>The command specification should include a
<TT
CLASS="FILENAME"
><TT
CLASS="LITERAL"
>s</TT
></TT
> specification. The <TT
CLASS="FILENAME"
><TT
CLASS="LITERAL"
>s</TT
></TT
>
will be substituted with the URL thas was passed to the gnome_url_show
function.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4360"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4362"
></A
><H3
><A
NAME="GNOME-URL-SHOW"
></A
>gnome_url_show ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_url_show (const char *url);</PRE
></TD
></TR
></TABLE
><P
>Loads the given URL in an appropriate viewer. The viewer is deduced from
the protocol part of the URL. That is all that the caller should know
about the function.</P
><P
>Internally, the handler for a given URL is deduced by looking in the
/Gnome/URL Handlers/<protocol>-show key in the user's configuration
files. The key is a string that will be passed to <A
HREF="gnome-gnome-exec.html#GNOME-EXECUTE-SHELL"
>gnome_execute_shell</A
>(),
after the <TT
CLASS="LITERAL"
>s</TT
> is replaced with with the URL. If that key can't be found,
it falls back to /Gnome/URL Handlers/default-show, and if that isn't
found, uses the contents of the DEFAULT_HANDLER macro in this file.</P
><P
>If no /Gnome/URL Handlers keys are set, some sensible defaults are added
to the user's configuration files.</P
><P
>We really need a capplet so a user can configure the behaviour of this
function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4373"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>url</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> URL to show</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-gnome-triggers.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-triggers</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-util</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
364
