Help file names

[Malcolm Tredinnick <malcolm commsecure com au>]

'Evening all!

I'm currently going through the help handling in libgnome, trying to
make sure it matches jrb's earlier api description and generally
cleaning it up. Something has come up that I need to confirm/resolve.

The main help processing code has just been lifted out of Nautilus and
put into libgnome. There is some logic in there that does "promotion" of
filenames from *.html to *.sgml, if necessary. This brings up three
questions:

(1) Do we want to do this (I think we do)?

(2) The current promotion rules are
   ghelp:/.../gfoo/C/index.html     -> ghelp:/.../gfoo/C/gfoo.sgml#index
   ghelp:/.../gfoo/C/index.html#abc -> ghelp:/.../gfoo/C/gfoo.sgml#abc
   ghelp:/.../gfoo/C/stuff.html     -> ghelp:/.../gfoo/C/gfoo.sgml#stuff
   ghelp:/.../gfoo/C/stuff.html#def -> ghelp:/.../gfoo/C/gfoo.sgml#def

These rules seems sensible, providing we commit to saying the main help
file for application Foo should be called foo.sgml.

(3) I assume we really want the promotion rules to be to first promote
to foo.xml and then foo.sgml, right (assuming the *.html file requested
doesn't exist)?

Any enlightenment that people can provide here would be helpful. And
apologies in advance if this is all well-established practice and I just
missed school on the day it was decided.

Cheers,
Malcolm

-- 
You have the right to remain silent. Anything you say will be misquoted,
then used against you.