From: Steve Chamberlain Date: Wed, 24 Jul 1991 23:22:21 +0000 (+0000) Subject: Added some hints about documentation X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=ad248080bd6659817cc25d003504944d27acedb6;p=binutils-gdb.git Added some hints about documentation Fixed prototype for bfd_get_elt_at_index --- diff --git a/include/bfd.h b/include/bfd.h index 290a0df3ac1..9e53b3770af 100644 --- a/include/bfd.h +++ b/include/bfd.h @@ -1,11 +1,21 @@ - /* A -*- C -*- header file for the bfd library */ +/* bfd.h -- The only header file required by users of the bfd library -/* bfd.h -- The only header file required by users of the bfd library - */ - -/* WARNING: This file is generated from various .c files, if you change it, your -bits may be lost +bits may be lost. + +All the prototypes and definitions following the comment " THE +FOLLOWING IS EXTRACTED FROM THE SOURCE" is extracted from the source. +If you change it someone oneday will extract from the source again, +and your changes will be lost. To save yourself from this bind, change +the definitions in the source in the bfd directory. Type make docs and +then make headers in that directory, and magically this file will +change to reflect your changes. + +If you don't have the tools to perform the extraction then you are +safe from someone on your system trampling over your header files. +You should still maintain the equivalence between the source and this +file though; every change you make to the .c file should be reflected +here. */ /* Copyright (C) 1990, 1991 Free Software Foundation, Inc. @@ -1068,7 +1078,9 @@ PROTO(symindex, bfd_get_next_mapent, (bfd *, symindex, carsym **)); contained in an archive to @var{new_head}. (see chapter on archives) */ PROTO(boolean, bfd_set_archive_head, (bfd *output, bfd *new_head)); -/* *;PROTO(bfd *, bfd_get_elt_at_index, (bfd *, int));*/ + +PROTO(bfd *, bfd_get_elt_at_index, (bfd *, int)); + /* Initially provided a bfd containing an archive and NULL, opens a bfd on the first contained element and returns that. Subsequent calls to