kernel-doc

[Roland McGrath]

I reenabled kernel-doc and tweaked it up.

* Make htmldocs too.  Some pithy bits are only in the .tmpl stuff and it is
  nice to be able to point people at "install kernel-doc and point your
  browser at file:///...", etc.

* make in %build, only install in %install.  Pure rpm anality.

* Use %{?_smp_mflags}.  mandocs is slow enough already.

* New macro switch %{doc_build_fail} to suppress barfing on 'make mandocs'
  failure.  We should get real kernel-doc and can eyeball the logs for
  errors, but won't be breaking our builds on every rebase where upstream
  tweaked comments so they broke kerneldoc.  The switch defaults from
  %{released_kernel}, so we should break again if kernel-doc would come out
  bogus in a non-rawhide build.  No extra human intervention required.

* Install in kernel-doc-%{rpmversion} (.27) subdir, not -%{kversion} (.26).
  It was obviously insane to have kernel-doc-2.6.27-0.xyz.fc10 that installs
  /usr/share/doc/kernel-doc-2.6.26/ files.


Gabba gabba,
Roland