discuss: man pages
Subject:
Re: man pages
From:
Ismael Olea ####@####.####
Date:
15 Jun 2003 17:04:22 -0000
Message-Id: <1055673186.4547.71.camel@lisergia.olea.org>
El vie, 16 de 05 de 2003 a las 08:43, jdd escribió:
> this discussion makes me think at an other way to improve doc.
>
> do you know of any utility that could detecte automatically _all_ the
> doc available for an application?
>
> some sort of "locate_doc"
The most similar thing is the scrollkeeper register.
It's a distro packager responsability to register documents inside a
Linux package to register them into scrollkeeper.
The registering is from a XML standard OMF file.
> I mean I use mostly man pages or google. but I have no way to know if
> there is an info file, HOWTO's, /usr/share/doc... and I can miss some
> important thing.
It's a horrible mix.
My opinion is there is a concrete «labour of love» here:
* migrating all docs into docbook (at least as source code)
* spread the scrollkeeper use in all distros
* write a CLI yelp-like tool. yelp (from Gnome) can navigate with
all scrollkeeper registered documents
We should to erase of the surface of the earth the use of man and info
and put a bit of order in the system documentation as you suggest.
> an utility can find man or info page, /usr/share/doc README or such
> pretty usual thing but not html courses, but there could be a
> registration form (as fresmeat) at ldp or any html tag, LDP recommended,
> to easy web index.
At TLDP-ES we are working in the server equivalente of the
(scrollkeeper) system. We have an advanced prototype yet.
--
A.Ismael Olea González
####@####.#### http://www.olea.org
http://aduaneros.olea.org, la ONG sin futuro.
El mundo tiene miedo a un planeta BUSH: No a la guerra.