mirror of
https://git.openafs.org/openafs.git
synced 2025-01-18 06:50:12 +00:00
ad526abaab
The merge-pod script is our simple custom preprocessor for man-page pod files. The merge-pod script expects one or more arguments to specify the input files and generates the output files in the same directory as the input files. Unfortunately, this precludes us from using merge-pod to do out-of-tree builds (a.k.a. objdir builds) which generate man-pages, since the output files are written to the source directory. Change merge-pod so when no input files are specified, merge-pod will scan the man-page pod<n> directories for *.in files, and put the pod output files in pod<n> directories in the current working directory. With this change, merge-pod remains compatible with the old method, which is still in use by the NT makefile and the regen.sh script, but provides support for a future commit to invoke merge-pod from the man-pages Makefile. Change-Id: I36b5b851cd1a09d050cf21c65ab3ae160a5c15cb Reviewed-on: https://gerrit.openafs.org/15788 Tested-by: BuildBot <buildbot@rampaginggeek.com> Reviewed-by: Mark Vitale <mvitale@sinenomine.net> Reviewed-by: Cheyenne Wills <cwills@sinenomine.net> Reviewed-by: Michael Meffie <mmeffie@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.