Fixed minor typos.
authorRoland Pesch <pesch@cygnus>
Mon, 19 Aug 1991 23:03:12 +0000 (23:03 +0000)
committerRoland Pesch <pesch@cygnus>
Mon, 19 Aug 1991 23:03:12 +0000 (23:03 +0000)
bfd/ChangeLog
bfd/archures.c
bfd/bfd.c
bfd/bfd.texinfo
bfd/core.c
bfd/libbfd.h
bfd/opncls.c
bfd/reloc.c
bfd/syms.c

index 9b22c7b7e6c1a0db0c7e66d7e2ab1507839dcfc8..64d7dd80d79d4a0b571d1f8b838a32166bab3220 100644 (file)
@@ -1,8 +1,11 @@
 Mon Aug 19 13:48:22 1991  Roland H. Pesch  (pesch at cygint.cygnus.com)
 
+       * bfd.texinfo: use @setchapternewpage on instead of lots of
+       @page's; minor rephrasing in Introduction.
+
        * aoutx.h, archive.c, archures.c, bfd.c, bfd.texinfo, cache.c,
-       coffcode.h, core.c, format.c, libbfd.c, libbfd.h, libcoff.h,
-       opncls.c, reloc.c, section.c, syms.c, targets.c (documentation
+       coffcode.h, core.c, format.c, ieee.c, libbfd.c, libbfd.h, libcoff.h,
+       oasys.c, opncls.c, reloc.c, section.c, syms.c, targets.c (documentation
        segments): used BFD (caps) more consistently as a name in
        discourse, fixed a few other minor typos and uses of fonts
        
index 94af442d0db046936866a3f7a602a8bae7380797..55295a9926042b12954d611b28906582e67ce67b 100644 (file)
@@ -22,7 +22,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 @section Architectures
 BFD's idea of an architecture is implimented in @code{archures.c}. BFD
 keeps two atoms in a BFD describing the architecture of the data
-attatched to the BFD, the @code{enum bfd_architecture arch} field and
+attached to the BFD, the @code{enum bfd_architecture arch} field and
 the @code{unsigned long machine} field.
 */
 
index ad30a1b6cbc9ddf05d26d2a5e1835e2d3429beda..0bf4a651ffcd0e4493f46fb80fb5fc4a65d86bb5 100644 (file)
--- a/bfd/bfd.c
+++ b/bfd/bfd.c
@@ -24,10 +24,10 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 @section typedef bfd
 
 Pointers to bfd structs are the cornerstone of any application using
-libbfd. References though the BFD and to data in the BFD give the
+@code{libbfd}. References though the BFD and to data in the BFD give the
 entire BFD functionality.
 
-Finally!  The BFD struct itself.  This contains the major data about
+Here is the BFD struct itself.  This contains the major data about
 the file, and contains pointers to the rest of the data.
 
 *+++
@@ -62,12 +62,13 @@ the back end.
 
 $  boolean target_defaulted;
 
-The caching routines use these to maintain an LRU list of BFDs.
+The caching routines use these to maintain a least-recently-used list of
+BFDs (@pxref{File Caching}).
 
 $  struct _bfd *lru_prev, *lru_next;
 
-When a file is closed by the caching routines, it retains the state
-here:
+When a file is closed by the caching routines, BFD retains state
+information on the file here:
 
 $  file_ptr where;              
 
@@ -117,14 +118,14 @@ The number of sections
 
 $  unsigned int section_count;
 
-Stuff only usefull for object files:
+Stuff only useful for object files:
 The start address.
 
 $  bfd_vma start_address;
 Used for input and output
 
 $  unsigned int symcount;
-Symtab for output BFD
+Symbol table for output BFD
 
 $  struct symbol_cache_entry  **outsymbols;             
 
@@ -136,7 +137,7 @@ Particular machine within arch, e.g. 68010
 
 $  unsigned long obj_machine;
 
-Stuff only usefull for archives:
+Stuff only useful for archives:
 
 $  PTR arelt_data;              
 $  struct _bfd *my_archive;     
@@ -152,7 +153,7 @@ Used by the application to hold private data
 
 $  PTR usrdata;
 
-Where all the allocated stuff under this BFD goes 
+Where all the allocated stuff under this BFD goes (@pxref{Memory Usage}).
 
 $  struct obstack memory;
 $};
index a1431199a1bc82e190b6179f9c8ed683ecc97c4b..23cf28b2b7a37023a37b2c85b79ff539c1877807 100755 (executable)
@@ -29,6 +29,7 @@ into another language, under the above conditions for modified versions.
 @end ifinfo
 @iftex
 @c@finalout
+@setchapternewpage on
 @c@setchapternewpage odd
 @settitle LIB BFD, the Binary File Descriptor Library
 @titlepage
@@ -324,13 +325,13 @@ which can simply derive this information can pass it successfully
 between formats (COFF, IEEE and Oasys).
 @end table
 
-
-What is a backend
+@c FIXME: what is this line about?  Do we want introductory remarks 
+@c FIXME... on back ends?  commented out for now.
+@c What is a backend
 @node BFD front end, BFD back end, Mechanism, Top
-@page
 @chapter BFD front end
 @include  bfd.texi
-@page
+
 @node Memory Usage, Sections, bfd, Top
 @section Memory Usage
 BFD keeps all its internal structures in obstacks. There is one obstack
@@ -355,37 +356,37 @@ operation and reopen the BFD again, to get a fresh copy of the data structures.
 
 @node Sections,Symbols ,Memory Usage, Top
 @include  section.texi
-@page
+
 @node Symbols, Archives ,Sections, To
 @include  syms.texi
-@page
+
 @node Archives, Formats, Symbols, Top
 @include  archive.texi
-@page
+
 @node Formats, Relocations, Archives, Top
 @include  format.texi
-@page
+
 @node Relocations, Core Files,Formats, Top
 @include  reloc.texi
-@page
+
 @node Core Files, Targets,  Relocations, Top
 @include  core.texi
-@page
+
 @node Targets, Architectures, Core Files, Top
 @include  targets.texi
-@page
+
 @node Architectures, Opening and Closing, Targets, Top
 @include  archures.texi
-@page
+
 @node Opening and Closing, Internal, Architectures, Top
 @include  opncls.texi
-@page
+
 @node Internal, File Caching, Opening and Closing, Top
 @include  libbfd.texi
-@page
+
 @node File Caching, Top, Internal, Top
 @include  cache.texi
-@page
+
 @chapter BFD back end
 @node BFD back end, ,BFD front end, Top
 @menu
@@ -398,17 +399,16 @@ operation and reopen the BFD again, to get a fresh copy of the data structures.
 @end menu
 @node What to Put Where, aout backends, BFD back end, BFD back end
 All of BFD lives in one directory.
-@page
+
 @node aout backends, coff backends, What to Put Where, BFD back end
 @include  aoutx.texi
-@page
+
 @node coff backends, oasys backends, aout backends, BFD back end
 @include  coffcode.texi
-@page
+
 @node Index,  , BFD, Top
 @unnumbered Function Index
 @printindex  fn
-@setchapternewpage on
 @unnumbered Index
 @printindex cp
 
index 7f1a32890b54cab52a514f95303601f3933e560a..b22dfa8c1b271781bb364780b7df7ba727db5318 100644 (file)
@@ -49,7 +49,7 @@ DEFUN(bfd_core_file_failing_command,(abfd),
 
 /*proto* bfd_core_file_failing_signal
 Returns the signal number which caused the core dump which generated
-the file the BFD is attatched to.
+the file the BFD is attached to.
 
 *; PROTO(int, bfd_core_file_failing_signal, (bfd *));
 */
@@ -66,8 +66,8 @@ bfd_core_file_failing_signal (abfd)
 
 
 /*proto* core_file_matches_executable_p
-Returns @code{true} if the core file attatched to @var{core_bfd} was
-generated by a run of the executable file attatched to @var{exec_bfd},
+Returns @code{true} if the core file attached to @var{core_bfd} was
+generated by a run of the executable file attached to @var{exec_bfd},
 or else @code{false}.
 *; PROTO(boolean, core_file_matches_executable_p,
     (bfd *core_bfd, bfd *exec_bfd));
index bf84142500010181d73329a82e03dac879568213..f7b29121b92edbe36ae435aa0887f3e66c472849 100644 (file)
@@ -232,7 +232,7 @@ Initialize a BFD by putting it on the cache LRU.
 /*
 
 *i bfd_cache_close
-Remove the BFD from the cache. If the attatched file is open, then close it too.
+Remove the BFD from the cache. If the attached file is open, then close it too.
 */
  PROTO(void, bfd_cache_close, (bfd *));
 
index 962eeb0a6aedcf656386f9c1006ca254bacf3342..e542ff51e718e8ef0326dcf2253c7e7470ea85d3 100644 (file)
@@ -282,7 +282,7 @@ pending operations are completed and the file written out and closed.
 If the created file is executable, then @code{chmod} is called to mark
 it as such.
 
-All memory attatched to the BFD's obstacks is released. 
+All memory attached to the BFD's obstacks is released. 
 
 @code{true} is returned if all is ok, otherwise @code{false}.
 *; PROTO(boolean, bfd_close,(bfd *));
index ae699d69fb4a82a1e0780d6728933c49e7d7d951..466497ef9a4b42b78cacbfacceb56424d682b045 100644 (file)
@@ -136,7 +136,7 @@ returned by the back end's get_symtab action. @xref{Symbols}. The
 symbol is referenced through a pointer to a pointer so that tools like
 the linker can fixup all the symbols of the same name by modifying
 only one pointer. The relocation routine looks in the symbol and uses
-the base of the section the symbol is attatched to and the value of
+the base of the section the symbol is attached to and the value of
 the symbol as the initial relocation offset. If the symbol pointer is
 zero, then the section provided is looked up.
 @item address
index ec1df2a11203d93566d1f073da9f9a89cb3d609f..fff67e59924ef70e37ed565c5766c67e78908f1d 100644 (file)
@@ -85,7 +85,7 @@ the BFD, and is freed when the BFD is closed.
 @node Writing Symbols, typedef asymbol, Reading Symbols, Symbols
 @subsection Writing Symbols
 Writing of a symbol table is automatic when a BFD open for writing
-is closed. The application attatches a vector of pointers to pointers to symbols
+is closed. The application attaches a vector of pointers to pointers to symbols
 to the BFD being written, and fills in the symbol count. The close and
 cleanup code reads through the table provided and performs all the
 necessary operations. The outputing code must always be provided with