From 188e332e9e77f6ea03bfc9e835b198bc09d54b62 Mon Sep 17 00:00:00 2001
From: Sam Varshavchik
Date: Wed, 28 Oct 2020 21:44:03 -0400
Subject: Clean up documentation

---
 rfc2045/makemime.sgml  | 18 +++++++++---------
 rfc2045/reformime.sgml | 16 ++++++++--------
 rfc2045/rfc2045.sgml   | 17 ++++++++---------
 3 files changed, 25 insertions(+), 26 deletions(-)

(limited to 'rfc2045')

diff --git a/rfc2045/makemime.sgml b/rfc2045/makemime.sgml
index e32a9c4..b89b513 100644
--- a/rfc2045/makemime.sgml
+++ b/rfc2045/makemime.sgml
@@ -1,7 +1,7 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <!-- Copyright 2001-2007 Double Precision, Inc.  See COPYING for -->
 <!-- distribution information. -->
-<refentry>
+<refentry id="makemime">
   <info><author><firstname>Sam</firstname><surname>Varshavchik</surname><contrib>Author</contrib></author><productname>Courier Mail Server</productname></info>
 
   <refmeta>
@@ -27,7 +27,7 @@
     </cmdsynopsis>
   </refsynopsisdiv>
 
-  <refsect1>
+  <refsect1 id="makemime_description">
     <title>DESCRIPTION</title>
 
     <para>
@@ -80,7 +80,7 @@ available to be used as an input file (which must be explicitly specified
 by one of the options). Of course, only one input file can come from a single
 pipe.</para>
 
-    <refsect2>
+    <refsect2 id="makemime_mime_overview">
 <title>MIME overview</title>
 
       <para>
@@ -182,7 +182,7 @@ sections also exist, and their usage is defined by their respective
 RFCs.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="makemime_creating_a_single_mime_section">
       <title>Creating a single MIME section</title>
 
       <cmdsynopsis sepchar=" ">
@@ -271,7 +271,7 @@ options must follow the <option>-c</option> option.</para>
       </note>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="makemime_creating_a_multipart_mime_collection">
       <title>Creating a multipart MIME collection</title>
 
       <cmdsynopsis sepchar=" ">
@@ -309,7 +309,7 @@ The collection is written to standard output, or the pipe or
 to <replaceable>outputfile</replaceable>.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="makemime_creating_a_multipart_mime_section">
       <title>Creating a multipart MIME section</title>
 
       <cmdsynopsis sepchar=" ">
@@ -353,7 +353,7 @@ headers may confuse <command moreinfo="none">makemime</command>, and it may not
 handle them.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="makemime_recursive_mime_collections">
 <title>Recursive MIME collections</title>
 
       <para>
@@ -413,7 +413,7 @@ Just add the
 course), and send it on its way.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="makemime_building_complex_mime_encodings">
       <title>Building complex MIME encodings</title>
 
       <para>
@@ -571,7 +571,7 @@ An equivalent argument file would be:</para>
     </refsect2>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="makemime_see_also">
     <title>SEE ALSO</title>
 
     <para>
diff --git a/rfc2045/reformime.sgml b/rfc2045/reformime.sgml
index 84f6ea5..c6becff 100644
--- a/rfc2045/reformime.sgml
+++ b/rfc2045/reformime.sgml
@@ -1,7 +1,7 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <!-- Copyright 1998 - 2010 Double Precision, Inc.  See COPYING for -->
 <!-- distribution information. -->
-<refentry>
+<refentry id="reformime">
   <info><author><firstname>Sam</firstname><surname>Varshavchik</surname><contrib>Author</contrib></author><productname>Courier Mail Server</productname></info>
 
   <refmeta>
@@ -22,7 +22,7 @@
     </cmdsynopsis>
   </refsynopsisdiv>
 
-  <refsect1>
+  <refsect1 id="reformime_description">
     <title>DESCRIPTION</title>
     <para>
 <command>reformime</command> is a utility for reformatting
@@ -92,7 +92,7 @@ Here's the output from
     <para>
 Arbitrarily complex MIME constructs are possible.</para>
   </refsect1>
-  <refsect1>
+  <refsect1 id="reformime_options">
     <title>OPTIONS</title>
 
     <variablelist>
@@ -237,7 +237,7 @@ Pipe the contents of the indicated MIME section to a program.</para>
       </varlistentry>
     </variablelist>
 
-    <refsect2>
+    <refsect2 id="reformime_extracting_rfc_2045_mime_section_s__to_file_s_">
       <title>Extracting RFC 2045 MIME section(s) to file(s)</title>
 
       <para>
@@ -326,7 +326,7 @@ content that usually precedes a binary attachment.</para>
       </note>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="reformime_adding_rfc_2045_mime_headers">
       <title>Adding RFC 2045 MIME headers</title>
 
       <para>
@@ -364,7 +364,7 @@ mail delivery, as a delivery failure may occur.
       </para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="reformime_creating_multipart_digest_mime_digests">
       <title>Creating <literal>multipart/digest</literal> MIME digests</title>
 
       <para>The <option>-m</option> option creates a MIME digest.
@@ -376,7 +376,7 @@ presumed to contain an RFC 2822-formatted message.
 and writes it to standard output.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="reformime_translating_mime_headers">
       <title>Translating MIME headers</title>
 
       <para>
@@ -470,7 +470,7 @@ is a structured header with RFC 2822 addresses.</para>
     </refsect2>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="reformime_see_also">
     <title>SEE ALSO</title>
 
     <para>
diff --git a/rfc2045/rfc2045.sgml b/rfc2045/rfc2045.sgml
index 788b21c..e65ffeb 100644
--- a/rfc2045/rfc2045.sgml
+++ b/rfc2045/rfc2045.sgml
@@ -1,7 +1,7 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <!-- Copyright 2001-2007 Double Precision, Inc.  See COPYING for -->
 <!-- distribution information. -->
-<refentry>
+<refentry id="rfc2045">
   <info><author><firstname>Sam</firstname><surname>Varshavchik</surname><contrib>Author</contrib></author><productname>Courier Mail Server</productname></info>
 
   <refmeta>
@@ -27,7 +27,7 @@ cc ... -lrfc2045 -lrfc822
     </informalexample>
   </refsynopsisdiv>
 
-  <refsect1>
+  <refsect1 id="rfc2045_description">
     <title>DESCRIPTION</title>
 
     <para>
@@ -43,7 +43,7 @@ The rfc2045 library is used to:</para>
     <para>
 3) Optionally rewrite and reformat the message.</para>
 
-    <refsect2>
+    <refsect2 id="rfc2045_creating_an_rfc2045_structure">
       <title>Creating an rfc2045 structure</title>
       <informalexample>
 	<programlisting format="linespecific">
@@ -123,8 +123,7 @@ function <function moreinfo="none">rfc2045_free</function>() deallocates and des
 structure.</para>
     </refsect2>
 
-    <refsect2>
-
+    <refsect2 id="rfc2045_structure_of_a_mime_message">
       <title>Structure of a MIME message</title>
 
       <informalexample>
@@ -229,7 +228,7 @@ ignored, and skipped over, when traversing the
 <structname>rfc2045</structname> tree.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="rfc2045_basic_mime_information">
       <title>Basic MIME information</title>
 
       <informalexample>
@@ -411,7 +410,7 @@ NULL, or an empty string.</para>
 
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="rfc2045_decoding_a_mime_section">
       <title>Decoding a MIME section</title>
 
       <informalexample>
@@ -473,7 +472,7 @@ immediately stops and
 <function moreinfo="none">rfc2045_cdecode</function>() or <function moreinfo="none">rfc2045_cdecode_end</function>() terminates with <function moreinfo="none">callback_func</function>'s return code.</para>
     </refsect2>
 
-    <refsect2>
+    <refsect2 id="rfc2045_rewriting_mime_messages">
       <title>Rewriting MIME messages</title>
 
       <para>
@@ -567,7 +566,7 @@ by <parameter moreinfo="none">appname</parameter>.</para>
     </refsect2>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="rfc2045_see_also">
     <title>SEE ALSO</title>
 
     <para>
-- 
cgit v1.2.3