binutils.texi frontmatter

[Karl Berry]

I noticed some infelicities in the Texinfo frontmatter of
binutils.texi.  I'll append a diff and the new file.

In short:
- move top stuff to the top
- use @direntry/@dircategory, format entries to play nicely with others
- avoid duplicate copying strings
- don't misspell "Texinfo".

I hope this can be installed for next time.  Of course just let know if
any questions.

Thanks,
Karl

--- /usr/local/gnu/src/binutils-2.18/binutils/doc/ORIG/binutils.texi    
2007-08-06 12:56:16.000000000 -0700
+++ /usr/local/gnu/src/binutils-2.18/binutils/doc/binutils.texi 2007-10-24 
12:50:44.000000000 -0700
@@ -2,4 +2,5 @@
 @setfilename binutils.info
address@hidden Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007
address@hidden Free Software Foundation, Inc.
address@hidden @sc{gnu} Binary Utilities
address@hidden
address@hidden ky cp
 
@@ -9,26 +10,2 @@
 
address@hidden
address@hidden
-START-INFO-DIR-ENTRY
-* Binutils: (binutils).         The GNU binary utilities.
-* ar: (binutils)ar.               Create, modify, and extract from archives
-* nm: (binutils)nm.               List symbols from object files
-* objcopy: (binutils)objcopy.    Copy and translate object files
-* objdump: (binutils)objdump.     Display information from object files
-* ranlib: (binutils)ranlib.       Generate index to archive contents
-* readelf: (binutils)readelf.    Display the contents of ELF format files.
-* size: (binutils)size.           List section sizes and total size
-* strings: (binutils)strings.     List printable strings from files
-* strip: (binutils)strip.         Discard symbols
-* c++filt: (binutils)c++filt.    Filter to demangle encoded C++ symbols
-* cxxfilt: (binutils)c++filt.     MS-DOS name for c++filt
-* addr2line: (binutils)addr2line. Convert addresses to file and line
-* nlmconv: (binutils)nlmconv.     Converts object code into an NLM
-* windres: (binutils)windres.    Manipulate Windows resources
-* windmc: (binutils)windmc.      Generator for Windows message resources
-* dlltool: (binutils)dlltool.    Create files needed to build and use DLLs
-END-INFO-DIR-ENTRY
address@hidden format
address@hidden ifinfo
-
 @copying
@@ -48,18 +25,28 @@
 
address@hidden ky cp
address@hidden
address@hidden This file documents the GNU binary utilities "ar", "ld", 
"objcopy",
address@hidden  "objdump", "nm", "size", "strings", "strip", "readelf" and 
"ranlib".
address@hidden
address@hidden Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 
1999, 2000,
address@hidden 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software 
Foundation, Inc.
address@hidden
address@hidden This text may be freely distributed under the terms of the GNU
address@hidden Free Documentation License.
address@hidden
address@hidden Software development
address@hidden
+* Binutils: (binutils).         The GNU binary utilities.
address@hidden direntry
+
address@hidden Individual utilities
address@hidden
+* addr2line: (binutils)addr2line. Convert addresses to file and line.
+* ar: (binutils)ar.               Create, modify, and extract from archives.
+* c++filt: (binutils)c++filt.    Filter to demangle encoded C++ symbols.
+* cxxfilt: (binutils)c++filt.     MS-DOS name for c++filt.
+* dlltool: (binutils)dlltool.    Create files needed to build and use DLLs.
+* nlmconv: (binutils)nlmconv.     Converts object code into an NLM.
+* nm: (binutils)nm.               List symbols from object files.
+* objcopy: (binutils)objcopy.    Copy and translate object files.
+* objdump: (binutils)objdump.     Display information from object files.
+* ranlib: (binutils)ranlib.       Generate index to archive contents.
+* readelf: (binutils)readelf.    Display the contents of ELF format files.
+* size: (binutils)size.           List section sizes and total size.
+* strings: (binutils)strings.     List printable strings from files.
+* strip: (binutils)strip.         Discard symbols.
+* windmc: (binutils)windmc.      Generator for Windows message resources.
+* windres: (binutils)windres.    Manipulate Windows resources.
address@hidden direntry
 
address@hidden odd
address@hidden @sc{gnu} Binary Utilities
 @titlepage
address@hidden
 @title The @sc{gnu} Binary Utilities
@@ -78,3 +65,3 @@
 {\parskip=0pt \hfill Cygnus Support\par \hfill
-\TeX{}info \texinfoversion\par }
+Texinfo \texinfoversion\par }
 @end tex
@@ -82,12 +69,3 @@
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
-2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
-
-      Permission is granted to copy, distribute and/or modify this document
-      under the terms of the GNU Free Documentation License, Version 1.1
-      or any later version published by the Free Software Foundation;
-      with no Invariant Sections, with no Front-Cover Texts, and with no
-      Back-Cover Texts.  A copy of the license is included in the
-      section entitled ``GNU Free Documentation License''.
-
address@hidden
 @end titlepage
@@ -158,3 +136,3 @@
 Documentation License.  A copy of the license is included in the
-section entitled "GNU Free Documentation License".
+section entitled ``GNU Free Documentation License''.

binutils.texi
Description: Binary data