[mjs eazel com: Re: help vs. gnome-help]

[Ali Abdin <aliabdin aucegypt edu>]

Okay - dudes - here is the official on 'help:' vs. 'ghelp:' vs. 'gnome-help:'

You should use 'gnome-help:' for GNOME documents (for cross-linking). This
will always exist in the future.

Regards,
Ali

----- Forwarded message from Maciej Stachowiak <mjs eazel com> -----

Date: Fri, 15 Sep 2000 13:32:54 -0700
From: Maciej Stachowiak <mjs eazel com>
Subject: Re: help vs. gnome-help
To: Darin Adler <darin eazel com>
Cc: Ali Abdin <aliabdin aucegypt edu>
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
X-Authentication-warning: pythagoras.eazel.com: mjs set sender to mjs eazel com
 using -f
Original-recipient: rfc822;aliabdin aucegypt edu

Darin Adler <darin eazel com> writes:

> on 9/15/00 1:04 PM, Ali Abdin at aliabdin aucegypt edu wrote:
> 
> > I have a question about the help-method. mjs told me that perhaps we should be
> > using 'help:' URIs and instead use 'gnome-help:' URI's. He tells me this is to
> > be more RFC compliant (i.e. we can't make up our own arbitrary generic URIs).
> 
> That's true.
> 
> > The GNOME Documentation Project need this information (for cross-linking
> > between documents) because they are updating their docs for GNOME 1.4
> 
> I think we should use "gnome-help" in anything we want to use for the long
> term. It's nicer to support "help:" in the UI (like in the location bar),
> but some day it might collide with some other use of "help:" and it would be
> good if documents used "gnome-help:" internally for cross-documents links so
> we don't have to update them all.
> 
> > Currently we supposed 'ghelp:' (to be backwards compatible), 'help:', and
> > 'gnome-help:' - We should drop either 'help:' or 'gnome-help:'
> 
> I don't agree. I don't think we have to drop one or the other. The reason to
> use "gnome-help:" is for long term compatibility with the RFC. But if
> supporting "help:" in the location bar is useful for the short term, I don't
> see the harm in having the synonym.
> 

I agree with Darin. We should use `gnome-help:' in the documents
themselves, but additionally accept `help:' in the UI for convenience
and `ghelp:' for backwards compatibility. Perhaps someday we can drop
`ghelp:'.

 - Maciej

----- End forwarded message -----