From 7dc8a7ddc204766f1c083919c8732920b0552a68 Mon Sep 17 00:00:00 2001
From: Michael Meffie <mmeffie@sinenomine.net>
Date: Thu, 8 Aug 2024 13:57:05 -0400
Subject: [PATCH] doc: Add section 3 man pages to AdminRef

The section 3 man pages are missing in the AdminRef document, so add
section 3 to the Makefile and perl script which generates the AdminRef
doc.

Currently, the only man page in section 3 is the AFS::ukernel, so only
one page is missing.

Change-Id: I3c7401f2eeafa505b9de4545b9d9c4b5cfd617e2
Reviewed-on: https://gerrit.openafs.org/15828
Reviewed-by: Cheyenne Wills <cwills@sinenomine.net>
Reviewed-by: Michael Meffie <mmeffie@sinenomine.net>
Tested-by: BuildBot <buildbot@rampaginggeek.com>
---
 doc/xml/AdminRef/Makefile.in     | 8 ++++----
 doc/xml/AdminRef/auarf000.xml    | 6 ++++++
 doc/xml/AdminRef/generate-xml.pl | 2 +-
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/doc/xml/AdminRef/Makefile.in b/doc/xml/AdminRef/Makefile.in
index a9d78d6a55..8b29714c9c 100644
--- a/doc/xml/AdminRef/Makefile.in
+++ b/doc/xml/AdminRef/Makefile.in
@@ -9,14 +9,14 @@ VERSION=version
 include @TOP_OBJDIR@/src/config/Makefile.version
 
 SRCS     = $(BOOK).xml preface.xml $(VERSION).xml \
-	   entities.dtd sect1.xml sect5.xml sect8.xml
+	   entities.dtd sect1.xml sect3.xml sect5.xml sect8.xml
 DOCBOOK_STYLESHEETS = @DOCBOOK_STYLESHEETS@
 XSLTPROC = @XSLTPROC@ --stringparam variablelist.as.blocks 1 --param use.id.as.filename 1
 DOCBOOK2PDF = @DOCBOOK2PDF@
 DBTOEPUB = $(DOCBOOK_STYLESHEETS)/epub/bin/dbtoepub
 KINDLEGEN = @KINDLEGEN@
 
-entities.dtd sect1.xml sect5.xml sect8.xml:
+entities.dtd sect1.xml sect3.xml sect5.xml sect8.xml:
 	./generate-xml.pl $(TOP_SRCDIR)
 
 $(BOOK).pdf: $(SRCS)
@@ -42,5 +42,5 @@ check:
 
 clean:
 	rm -f $(BOOK).pdf $(BOOK).mobi $(BOOK).epub $(BOOK).fo \
-		entities.dtd sect1.xml sect5.xml sect8.xml $(VERSION).xml
-	rm -rf sect1 sect5 sect8
+		entities.dtd sect1.xml sect3.xml sect5.xml sect8.xml $(VERSION).xml
+	rm -rf sect1 sect3 sect5 sect8
diff --git a/doc/xml/AdminRef/auarf000.xml b/doc/xml/AdminRef/auarf000.xml
index 6cbe7dce9f..6422759722 100644
--- a/doc/xml/AdminRef/auarf000.xml
+++ b/doc/xml/AdminRef/auarf000.xml
@@ -4,6 +4,7 @@
 <!ENTITY version SYSTEM "version.xml">
 <!ENTITY preface SYSTEM "preface.xml">
 <!ENTITY sect1 SYSTEM "sect1.xml">
+<!ENTITY sect3 SYSTEM "sect3.xml">
 <!ENTITY sect5 SYSTEM "sect5.xml">
 <!ENTITY sect8 SYSTEM "sect8.xml">
 <!ENTITY % entities SYSTEM "entities.dtd">
@@ -61,6 +62,11 @@
     &sect1;
   </reference>
 
+  <reference>
+    <title>AFS Library Reference</title>
+    &sect3;
+  </reference>
+
   <reference>
     <title>AFS System Files</title>
     &sect5;
diff --git a/doc/xml/AdminRef/generate-xml.pl b/doc/xml/AdminRef/generate-xml.pl
index 008f80fb08..bdf4f7c639 100755
--- a/doc/xml/AdminRef/generate-xml.pl
+++ b/doc/xml/AdminRef/generate-xml.pl
@@ -2,7 +2,7 @@
     eval 'exec /usr/bin/perl -S $0 ${1+"$@"}'
 	if $running_under_some_shell;
 
-@sections = ('1', '5', '8');
+@sections = ('1', '3', '5', '8');
 
 $TOP_SRCDIR = shift @ARGV;
 $doc_man_pages = sprintf "%s/../doc/man-pages", $TOP_SRCDIR;