[MPlayer-cygwin] How to build MPlayer documentation on Win32/MSYS

[John Brown]

Hello all,

I originally posted this earlier to MPlayer-users, but I realized that I 
should have posted it here instead.

I carried out the instructions in DOCS/xml/README, but I cannot build the 
documentation because configure is not successful.

./configure and make output follows:

$ ./configure
Searching for XML catalogs...
No SGML catalog found.
Searching for stylesheets...
Searching for html/chunk.xsl...
Found chunk.xsl at 
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl
Searching for html/docbook.xsl...
Found docbook.xsl at 
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl
Searching for DTD...
Found docbookx.dtd at /usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd
Looking for a valid XSLT processor...
Found xsltproc. If it works, it's probably the best choice.
Searching for XML checker...
Found xmllint

$ make all
test -d ../HTML || mkdir ../HTML
make: *** No rule to make target `html-chunked-en', needed by 
`html-chunked'.  Stop.


I had to perform a number of steps other than the documented ones to get 
this far.

1) It could not find chunk.xsl , so I copied DOCS/xml/html-chunk.xsl to 
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl

2) I similarly copied libxslt-1.0.33/tests/docbook/html/docbook.xsl to  
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl

I have no idea whether (1) and (2) were correct, but those files seemed to 
be the most likely candidates.

I could not get the latest libxml2 (2.6) to compile, so I went back to 2.5, 
which forced me to go from libxslt-1.1 to 1.0. I also went back to docbook 
DTD 4.1.2 because the configure script was looking for a 4.1.2 folder.

I do not know what an SGML catalog is, so I cannot copy it.

The documentation page at the MPlayer website says that the documentation is 
generated nightly from CVS. Is this true? If it is, I won't bother with 
this.