Re: make htmldocs
From: Karel Kulhavý
Date: Tue Oct 14 2003 - 09:11:03 EST
> Let's take the Debian example. The Makefiles state that I need db2html to
> convert to your chosen HTML format. db2html is provided by docbook-utils,
> which it would seems installs the files listed publically at:
Sorry I downloaded source and installed. No db2html emerged, just docbook2html.
Tried debian's patch for the source. The same.
Tried symlinking docbook2html to db2html:
make: Entering directory `/home/clock/linux-2.4.22/Documentation/DocBook'
rm -rf wanbook
jw: Please specify at least one catalog
Sorry but your guide seems not to work.
Again, please tell me, how to compile Linux Kernel HTML Documentation.
> Now, it turns out that docbook-utils is the name of the open source
> package, as well as the Debian package:
> So, I guess that tells you what to install.
> > > > 3) Bugreport: there should be written
> > > > "Linux kernel depends on DocBook stylesheets. You may download DocBook
> > > > stylesheets here-and-there." in README
> > >
> > > Depends on distribution. We also don't tell for every distribution
> > > where to get gcc and how to install it.
> > Do you say that the place where DocBook stylesheet sources can be downloaded
> > depends on distribution I have? I have been looking at their sourceforge
> > project page but there is nothing like "download DocBook stylesheets".
> > There are DocBook-dsssl and a ton of other cryptic packages but none of them
> > is stylesheets.
> Dude, he was just trying to ask what distro you use, in order to help you
> out. Of course how you install it changes based on the distro you're
> > If there doesn't exist any distribution-idependent installation process
> > for "DocBook stylesheets", then "DocBook stylesheets" is not portable,
> > and transitively, "Linux Kernel" is not portable.
> Given than most Linux distros are open source themselves, and that the
> documentation for many of them is open, perhaps we should all now take an
> opportunity to reflect on how non-sensical this statement is. Did you also
> consider that a bunch of this documentation is available pre-built on the
> web? For example, a bunch of the kernel API man pages can be found at:
> > Could you please
> > recommend me some other open-source free operating system where I don't
> > need to have a "distribution" to be even able to read it's enclosed
> > documentation? I have been using Linux Kernel for 7 years but can't anymore
> > because I am unable to read it's manual.
> FreeBSD? OpenBSD? NetBSD? Minix? I recommend you look through the list at
> http://mirror.aarnet.edu.au if you really feel the urge to move on.
> Michael Still (mikal@xxxxxxxxxxx) | "All my life I've had one dream,
> http://www.stillhq.com | to achieve my many goals"
> UTC + 10 | -- Homer Simpson
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/