Messages in this thread | | | Date | Tue, 14 Oct 2003 16:09:47 +0200 | From | Karel Kulhavý <> | Subject | Re: make htmldocs |
| |
> 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[1]: Entering directory `/home/clock/linux-2.4.22/Documentation/DocBook' rm -rf wanbook db2html wanbook.sgml 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.
Cl<
> > http://packages.debian.org/cgi-bin/search_contents.pl?word=docbook-utils&searchmode=filelist&case=insensitive&version=unstable&arch=i386 > > Now, it turns out that docbook-utils is the name of the open source > package, as well as the Debian package: > > http://freshmeat.net/projects/docbook-utils/ > > 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 > using. > > > 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: > > http://www.stillhq.com/linux/mandocs/ > > > 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. > > Cheers, > Mikal > > -- > > Michael Still (mikal@stillhq.com) | "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@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| |