On Tue, 15 Feb 2011 16:11:23 +0100, Ralf Corsepius wrote:
On 02/15/2011 03:59 PM, Jan Kratochvil wrote:
Wrote the draft proposal for it: https://fedoraproject.org/wiki/PackagingDrafts/HtmlDocs
Comments from my part:
- texinfos need special preparation to be able to convert them to html.
This applies to many cases, but does not apply in general.
OK, I believe a machine-generated HTML is good enough as the first step. Possible specific problems can be fixed up as normal Bugs later.
- html is just one amongst many formats texinfos can be (if the
texinfos have been prepared for) converted to.
Some list of formats is given on the Wiki page.
I don't see any reason to give html preference over one of the other formats. It's some people's preference, but definitely not all (e.g. I prefer pdf).
I prefer INFO over all the other ones. But I remember I was using HTML before I got used to the only provided INFO. When a separate -doc subpackage is provided I believe providing all the tree of INFO, HTML and PDF is not a problem (HTML as I dislike PDF over the other paging-free formats).
- Many of these html docs are available on-line - Adding local copies
to Fedora only adds bloat to the distro
As we face it on freenode#gdb channel the online versions do not match the local copies. And I do not want to be dependent on network with notebook.
- The GNU standards's officical documentation format is info.
Yes, just Fedora is not GNU.
Thanks, Jan