Red Hat Bugzilla – Bug 38453
Provide formatted version of documentation instead of SGML
Last modified: 2008-05-01 11:38:00 EDT
In the wine package (wine-20010131-3) the directory "documentation" is
included as documentation of the package. Most of this directory consists
of DocBook SGML files. These are not convenient to read, but rather to be
considered documentation source.
I would suggest to rather enclose a formatted version of the
documentation. Please find enclosed a patch to the spec file which creates
the HTML documentation. db2html found a syntax error in one of the SGML
files, and I also include a patch for that. (Used by my modified spec
file.) That may have been fixed in a newer version of Wine, of course.
My changes package the HTML files INSTEAD of the SGML version. I also
explicitly point to a few files in the documentation directory which isn't
part of the SGML sources but rather makes sense to include separately.
My choice of HTML version was simply because I find it most convenient.
You may of course choose to create and package the PDF and/or PS versions
also/instead. I think it makes sense to send formatted version of the
documentation. But exactly which format(s) is a matter of taste of course.
Created attachment 16886 [details]
SPEC file changes to create HTML documentation
Created attachment 16887 [details]
Correction of a syntax error in a documentation file.
Thanks, done in 20010503-1.