mirror of
https://git.openafs.org/openafs.git
synced 2025-01-18 15:00:12 +00:00
6ff968264f
The AdminRef is a collection of OpenAFS man pages in a single document. Unfortunately, the man pages are not listed in any particular order, but rather just the order found by reading the unsorted directory entries. Change the generate-xml script so the man pages are in sorted order in the generated AdminRef document. Instead of writing the man page references after processing each page, save each entry in a list, and then sort the list after all the pages have been processed. Also, check the exit code of the pod2refentry script so errors are not ignored while generating the AdminRef document. Change-Id: I624485e4efd1fb0c08642b379a12c946f5793336 Reviewed-on: https://gerrit.openafs.org/15827 Tested-by: BuildBot <buildbot@rampaginggeek.com> 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.