mirror of
https://git.openafs.org/openafs.git
synced 2025-01-18 15:00:12 +00:00
d86c4d632e
Fix various issues so that building the documentation in doc/xml works for objdir builds: - set srcdir=@srcdir@ like all other Makefile's, so VPATH is set correctly via Makefile.config - Pass "--path '@abs_builddir@'" to all xml/xsl processors, so they can find the generated version.xml (otherwise they only look in srcdir) - Pass --output when building PDFs, so the generated PDF doesn't go in srcdir - Specify $(srcdir) for $(BOOK).xml and generate-xml.pl - Change generate-xml.pl to find pod2refentry in srcdir instead of '.' Change-Id: Id09595dba6e70e3d367a26e279446844750d1fd4 Reviewed-on: https://gerrit.openafs.org/15856 Tested-by: BuildBot <buildbot@rampaginggeek.com> Reviewed-by: Michael Meffie <mmeffie@sinenomine.net> Tested-by: Michael Meffie <mmeffie@sinenomine.net> Reviewed-by: Cheyenne Wills <cwills@sinenomine.net> |
||
---|---|---|
.. | ||
doxygen | ||
man-pages | ||
protocol | ||
txt | ||
xml | ||
LICENSE | ||
README |
What's in the "doc" subdirectory ** doc/man-pages pod sources for man pages (converted from original IBM html source). ** doc/xml xml sources for manuals (converted from original IBM html source). Note: The doc/xml/AdminRef uses doc/xml/AdminRef/pod2refentry to convert the pod man pages to xml for printing. pod goes directly to html just fine. ** doc/pdf Old Transarc (and possibly pre-Transarc) protocol and API documentation for which we have no other source. ** doc/txt Technical notes, Windows notes, and examples. ** doc/doxygen Configuration files for the doxygen tool to generate documentation from the annotated sources. See the 'dox' Makefile target in the top level Makefile.