From e016ec1f8c240fcadf90d1a1bd918a054599c70e Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Fri, 26 Oct 2007 12:00:33 +0000 Subject: [PATCH] * doc/binutils.texi: Move top stuff to the top. Use @direntry/@dircategory, format entries to play nicely with others. Avoid duplicate copying strings. Don't misspell "Texinfo". --- binutils/ChangeLog | 8 +++++ binutils/doc/binutils.texi | 84 +++++++++++++++++----------------------------- 2 files changed, 39 insertions(+), 53 deletions(-) diff --git a/binutils/ChangeLog b/binutils/ChangeLog index b4e8f6c..d3e7e7d 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,3 +1,11 @@ +2007-10-26 Karl Berry + + * doc/binutils.texi: Move top stuff to the top. + Use @direntry/@dircategory, format entries to play nicely with + others. + Avoid duplicate copying strings. + Don't misspell "Texinfo". + 2007-10-25 Daniel Jacobowitz * readelf.c (display_power_gnu_attribute): Add support for diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index 1c6fa0a..3598dff 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -1,36 +1,13 @@ \input texinfo @c -*- Texinfo -*- @setfilename binutils.info -@c Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007 -@c Free Software Foundation, Inc. +@settitle @sc{gnu} Binary Utilities +@finalout +@synindex ky cp @c man begin INCLUDE @include bfdver.texi @c man end -@ifinfo -@format -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 -@end format -@end ifinfo - @copying @c man begin COPYRIGHT Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, @@ -46,22 +23,32 @@ section entitled ``GNU Free Documentation License''. @c man end @end copying -@synindex ky cp -@c -@c This file documents the GNU binary utilities "ar", "ld", "objcopy", -@c "objdump", "nm", "size", "strings", "strip", "readelf" and "ranlib". -@c -@c Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -@c 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. -@c -@c This text may be freely distributed under the terms of the GNU -@c Free Documentation License. -@c - -@setchapternewpage odd -@settitle @sc{gnu} Binary Utilities +@dircategory Software development +@direntry +* Binutils: (binutils). The GNU binary utilities. +@end direntry + +@dircategory Individual utilities +@direntry +* 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. +@end direntry + @titlepage -@finalout @title The @sc{gnu} Binary Utilities @ifset VERSION_PACKAGE @subtitle @value{VERSION_PACKAGE} @@ -76,20 +63,11 @@ section entitled ``GNU Free Documentation License''. @tex {\parskip=0pt \hfill Cygnus Support\par \hfill -\TeX{}info \texinfoversion\par } +Texinfo \texinfoversion\par } @end tex @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''. - +@insertcopying @end titlepage @contents @@ -156,7 +134,7 @@ Create the files needed to build and use Dynamic Link Libraries This document is distributed under the terms of the GNU Free Documentation License. A copy of the license is included in the -section entitled "GNU Free Documentation License". +section entitled ``GNU Free Documentation License''. @menu * ar:: Create, modify, and extract from archives -- 2.7.4