* archive.c: Add missing SUBSECTION for documentation.

[binutils.git] / bfd / init.c

diff --git a/bfd/init.c b/bfd/init.c
index f73c42600cc5e023dc68d7b6705d66945f7d15e9..a34acbf9faf52076b79eb5a6f51a25dba9603714 100644 (file)
--- a/bfd/init.c
+++ b/bfd/init.c
@@ -1,5 +1,6 @@
 /* bfd initialization stuff
-   Copyright (C) 1990-1991 Free Software Foundation, Inc.
+   Copyright 1990, 1991, 1992, 1993, 1994, 1995, 2003
+   Free Software Foundation, Inc.
    Written by Steve Chamberlain of Cygnus Support.
 
 This file is part of BFD, the Binary File Descriptor library.
@@ -16,47 +17,38 @@ GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
-Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
-#include <sysdep.h>
+Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
+
 #include "bfd.h"
+#include "sysdep.h"
 #include "libbfd.h"
 
-static boolean initialized = false;
-
-/*proto* bfd_init
+/*
+SECTION
+       Initialization
 
-This routine must be called before any other bfd function to initialize
-magical internal data structures.
+SUBSECTION
+       Initialization functions
 
-*; void EXFUN(bfd_init,(void));
+       These are the functions that handle initializing a BFD.
 */
 
-void DEFUN_VOID(bfd_init)
-{
-  if (initialized == false) {
-    initialized = true;
-
-    bfd_arch_init();
-  }
-}
-
+/*
+FUNCTION
+       bfd_init
 
-/*proto-internal* bfd_check_init
+SYNOPSIS
+       void bfd_init (void);
 
-This routine is called before any other bfd function using initialized
-data is used to ensure that the structures have been initialized.
-Soon this function will go away, and the bfd library will assume that
-bfd_init has been called.
-
-*; void EXFUN(bfd_check_init,(void));
+DESCRIPTION
+       This routine must be called before any other BFD function to
+       initialize magical internal data structures.
 */
 
-void DEFUN_VOID(bfd_check_init)
+/* Actually, there is currently nothing for this function to do.
+   However, someday it may be needed, so keep it around.  */
+
+void
+bfd_init (void)
 {
-  if (initialized == false) {
-    fprintf(stderr,"The bfd library now requires you to call bfd_init()\n");
-    fprintf(stderr,"before any other calls to bfd routines. Please\n");
-    fprintf(stderr,"change your source\n");
-    bfd_init();
-  }
 }