first last <[EMAIL PROTECTED]> writes:
> La idea no es ser capaz de buscar toda la documentacion desde un
> navegador, sino que toda ella tenga el mismo formato, html que es
> facil de desarrollar, ofrece ventajas sobre man/info como la
> posibilidad de incluir graficos si se ve la pagina en X y, sobretodo,
> incluir toda la documentacion con referencias a otras paginas
> relacionadas (por paquete/tema, etc).
Estaria bien tener todo en un mismo formato. Pero no puedes pedir a todo
el mundo que lo haga as�. Como soluci�n menos mala lo que se puede hacer
es traducior de uno al otro (info2html,..), o escribirlo en xml,sgml y
pasarlo a info, man, html, lo que quieras.
>
> Ademas no creo que molestara el que fuera auto-contenido y no tuviese
> grandes dependencias tipo apache (prueba a poner apache en un
> ordenador con poca memoria... el pobre se arrastra como el solo).
dhelp no necesita ningun servidor web.
>
> Es mas un tema de estructura interna que de
> funcionalidad, ya que no se annade mucha en un
> principio, sino que facilita el desarrollo de la
> documentacion.
Puede que si, pero tambi�n le pones barreras, tienes que escribir html
en vez de lo que siempre has hecho. Si lo que escribes es una p�gina del
man no creo que html2man quede muy bien ({x,sg}ml a man si que queda
bien).
Vamos a ver. Lo que dices es escribirlo todo en html porque te da mas
funcionalidades que man/info,... Supongamos que se hace (caso
hipot�tico). Llega un punto que nos damos cuenta que xml nos da m�s
funcionalidades que html. Tenemos que cambiar toda la documentaci�n a
xml. En unos a�os vemos que hay tal tecnologia que nos da mas
funcionalidades.... No vamos a acabar.
Lo que creo que s� es factible es que haya una forma uniforme de acceder
a esa documentaci�n, est� en el formato que est�. Tienes una aplicaci�n
que le dices: Quiero documentaci�n de la aplicaci�n gqview. Y te salga
la p�gina del manual, la p�gina del info, la documentaci�n de
/usr/share/doc/gqview. La ayuda on-line, los ejemplos,...
Para los que escriben la documentaci�n. Estar�a bien que yo desde la doc
de gqview pudiera poner un enlace a un apartado de la documentaci�n de
ee (electronic eyes). Ya que los dos hablan de cosas parecidas. O si
hago un manual de usuario de debian pudiera *incluir* (no un enlace)
apartados del manual de usuario de linux, ya que hay muchas cosa en
com�n. Pero todas estas relaciones requieren otro tipo de mantenimiento
(tienes que comprobar que lo que incluyes sea coherente en el
tiempo,...). No digo que sea mayor esfuerzo ni menor, solo diferente. Y
a la gente le cuesta cambiar. Pero siempre puedes presentar tus ideas
concretas y que los que escriben decidan si las siguen o no.
He escrito m�s de lo que queria, y tampoco estoy seguro que se me vaya a
entender, pero ah� est�.
Santi
--
Buscando firma...
Buscando firma...hecho
