Index: archive.c
===================================================================
RCS file: /cvs/src/src/bfd/archive.c,v
retrieving revision 1.42
diff -u -r1.42 archive.c
--- archive.c	5 Jul 2005 09:45:54 -0000	1.42
+++ archive.c	5 Oct 2005 21:03:40 -0000
@@ -74,6 +74,8 @@
 
 	Archives are supported in BFD in <<archive.c>>.
 
+SUBSECTION
+	Archive functions
 */
 
 /* Assumes:
Index: bfd.c
===================================================================
RCS file: /cvs/src/src/bfd/bfd.c,v
retrieving revision 1.77
diff -u -r1.77 bfd.c
--- bfd.c	5 Aug 2005 13:52:11 -0000	1.77
+++ bfd.c	5 Oct 2005 21:03:40 -0000
@@ -626,7 +626,10 @@
 
 /*
 SECTION
-	Symbols
+	Miscellaneous
+
+SUBSECTION
+	Miscellaneous functions
 */
 
 /*
Index: cache.c
===================================================================
RCS file: /cvs/src/src/bfd/cache.c,v
retrieving revision 1.20
diff -u -r1.20 cache.c
--- cache.c	14 Jul 2005 07:22:02 -0000	1.20
+++ cache.c	5 Oct 2005 21:03:40 -0000
@@ -36,6 +36,8 @@
 	close, closes it and opens the one wanted, returning its file
 	handle.
 
+SUBSECTION
+	Caching functions
 */
 
 #include "bfd.h"
Index: corefile.c
===================================================================
RCS file: /cvs/src/src/bfd/corefile.c,v
retrieving revision 1.9
diff -u -r1.9 corefile.c
--- corefile.c	4 May 2005 15:53:05 -0000	1.9
+++ corefile.c	5 Oct 2005 21:03:40 -0000
@@ -23,6 +23,9 @@
 SECTION
 	Core files
 
+SUBSECTION
+	Core file functions
+
 DESCRIPTION
 	These are functions pertaining to core files.
 */
Index: elf.c
===================================================================
RCS file: /cvs/src/src/bfd/elf.c,v
retrieving revision 1.313
diff -u -r1.313 elf.c
--- elf.c	3 Oct 2005 03:41:56 -0000	1.313
+++ elf.c	5 Oct 2005 21:03:40 -0000
@@ -19,8 +19,8 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
 
-/*  SECTION
-
+/*
+SECTION
 	ELF backends
 
 	BFD support for ELF formats is being worked on.
Index: format.c
===================================================================
RCS file: /cvs/src/src/bfd/format.c,v
retrieving revision 1.21
diff -u -r1.21 format.c
--- format.c	17 May 2005 19:44:55 -0000	1.21
+++ format.c	5 Oct 2005 21:03:40 -0000
@@ -38,6 +38,8 @@
 
 	The BFD contains the result of an executable core dump.
 
+SUBSECTION
+	File format functions
 */
 
 #include "bfd.h"
Index: init.c
===================================================================
RCS file: /cvs/src/src/bfd/init.c,v
retrieving revision 1.6
diff -u -r1.6 init.c
--- init.c	4 May 2005 15:53:33 -0000	1.6
+++ init.c	5 Oct 2005 21:03:40 -0000
@@ -27,6 +27,9 @@
 SECTION
 	Initialization
 
+SUBSECTION
+	Initialization functions
+
 	These are the functions that handle initializing a BFD.
 */
 
Index: libbfd.c
===================================================================
RCS file: /cvs/src/src/bfd/libbfd.c,v
retrieving revision 1.40
diff -u -r1.40 libbfd.c
--- libbfd.c	5 Jul 2005 09:44:20 -0000	1.40
+++ libbfd.c	5 Oct 2005 21:03:40 -0000
@@ -30,6 +30,9 @@
 
 /*
 SECTION
+	Implementation details
+
+SUBSECTION
 	Internal functions
 
 DESCRIPTION
Index: opncls.c
===================================================================
RCS file: /cvs/src/src/bfd/opncls.c,v
retrieving revision 1.39
diff -u -r1.39 opncls.c
--- opncls.c	5 Jul 2005 09:44:19 -0000	1.39
+++ opncls.c	5 Oct 2005 21:03:40 -0000
@@ -124,6 +124,8 @@
 SECTION
 	Opening and closing BFDs
 
+SUBSECTION
+	Functions for opening and closing
 */
 
 /*
Index: reloc.c
===================================================================
RCS file: /cvs/src/src/bfd/reloc.c,v
retrieving revision 1.139
diff -u -r1.139 reloc.c
--- reloc.c	30 Sep 2005 15:36:40 -0000	1.139
+++ reloc.c	5 Oct 2005 21:03:40 -0000
@@ -1581,7 +1581,7 @@
 INODE
 	howto manager,  , typedef arelent, Relocations
 
-SECTION
+SUBSECTION
 	The howto manager
 
 	When an application wants to create a relocation, but doesn't