bfd.texinfo revision 78828
1\input texinfo.tex 2@setfilename bfd.info 3@c Copyright 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1997, 2000 4@c Free Software Foundation, Inc. 5@c 6@tex 7% NOTE LOCAL KLUGE TO AVOID TOO MUCH WHITESPACE 8\global\long\def\example{% 9\begingroup 10\let\aboveenvbreak=\par 11\let\afterenvbreak=\par 12\parskip=0pt 13\lisp} 14\global\long\def\Eexample{% 15\Elisp 16\endgroup 17\vskip -\parskip% to cancel out effect of following \par 18} 19@end tex 20@synindex fn cp 21 22@ifinfo 23@format 24START-INFO-DIR-ENTRY 25* Bfd: (bfd). The Binary File Descriptor library. 26END-INFO-DIR-ENTRY 27@end format 28@end ifinfo 29 30@ifinfo 31This file documents the BFD library. 32 33Copyright (C) 1991, 2000 Free Software Foundation, Inc. 34 35 Permission is granted to copy, distribute and/or modify this document 36 under the terms of the GNU Free Documentation License, Version 1.1 37 or any later version published by the Free Software Foundation; 38 with no Invariant Sections, with no Front-Cover Texts, and with no 39 Back-Cover Texts. A copy of the license is included in the 40 section entitled "GNU Free Documentation License". 41 42@ignore 43Permission is granted to process this file through Tex and print the 44results, provided the printed document carries copying permission 45notice identical to this one except for the removal of this paragraph 46(this paragraph not being relevant to the printed manual). 47 48@end ignore 49@end ifinfo 50@iftex 51@c@finalout 52@setchapternewpage on 53@c@setchapternewpage odd 54@settitle LIB BFD, the Binary File Descriptor Library 55@titlepage 56@title{libbfd} 57@subtitle{The Binary File Descriptor Library} 58@sp 1 59@subtitle First Edition---BFD version < 3.0 60@subtitle April 1991 61@author {Steve Chamberlain} 62@author {Cygnus Support} 63@page 64 65@tex 66\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$ 67\xdef\manvers{\$Revision: 1.2.2.1 $} % For use in headers, footers too 68{\parskip=0pt 69\hfill Cygnus Support\par 70\hfill sac\@cygnus.com\par 71\hfill {\it BFD}, \manvers\par 72\hfill \TeX{}info \texinfoversion\par 73} 74\global\parindent=0pt % Steve likes it this way 75@end tex 76 77@vskip 0pt plus 1filll 78Copyright @copyright{} 1991 Free Software Foundation, Inc. 79 80 Permission is granted to copy, distribute and/or modify this document 81 under the terms of the GNU Free Documentation License, Version 1.1 82 or any later version published by the Free Software Foundation; 83 with no Invariant Sections, with no Front-Cover Texts, and with no 84 Back-Cover Texts. A copy of the license is included in the 85 section entitled "GNU Free Documentation License". 86 87@end titlepage 88@end iftex 89 90@node Top, Overview, (dir), (dir) 91@ifinfo 92This file documents the binary file descriptor library libbfd. 93@end ifinfo 94 95@menu 96* Overview:: Overview of BFD 97* BFD front end:: BFD front end 98* BFD back ends:: BFD back ends 99* GNU Free Documentation License:: GNU Free Documentation License 100* Index:: Index 101@end menu 102 103@node Overview, BFD front end, Top, Top 104@chapter Introduction 105@cindex BFD 106@cindex what is it? 107BFD is a package which allows applications to use the 108same routines to operate on object files whatever the object file 109format. A new object file format can be supported simply by 110creating a new BFD back end and adding it to the library. 111 112BFD is split into two parts: the front end, and the back ends (one for 113each object file format). 114@itemize @bullet 115@item The front end of BFD provides the interface to the user. It manages 116memory and various canonical data structures. The front end also 117decides which back end to use and when to call back end routines. 118@item The back ends provide BFD its view of the real world. Each back 119end provides a set of calls which the BFD front end can use to maintain 120its canonical form. The back ends also may keep around information for 121their own use, for greater efficiency. 122@end itemize 123@menu 124* History:: History 125* How It Works:: How It Works 126* What BFD Version 2 Can Do:: What BFD Version 2 Can Do 127@end menu 128 129@node History, How It Works, Overview, Overview 130@section History 131 132One spur behind BFD was the desire, on the part of the GNU 960 team at 133Intel Oregon, for interoperability of applications on their COFF and 134b.out file formats. Cygnus was providing GNU support for the team, and 135was contracted to provide the required functionality. 136 137The name came from a conversation David Wallace was having with Richard 138Stallman about the library: RMS said that it would be quite hard---David 139said ``BFD''. Stallman was right, but the name stuck. 140 141At the same time, Ready Systems wanted much the same thing, but for 142different object file formats: IEEE-695, Oasys, Srecords, a.out and 68k 143coff. 144 145BFD was first implemented by members of Cygnus Support; Steve 146Chamberlain (@code{sac@@cygnus.com}), John Gilmore 147(@code{gnu@@cygnus.com}), K. Richard Pixley (@code{rich@@cygnus.com}) 148and David Henkel-Wallace (@code{gumby@@cygnus.com}). 149 150 151 152@node How It Works, What BFD Version 2 Can Do, History, Overview 153@section How To Use BFD 154 155To use the library, include @file{bfd.h} and link with @file{libbfd.a}. 156 157BFD provides a common interface to the parts of an object file 158for a calling application. 159 160When an application sucessfully opens a target file (object, archive, or 161whatever), a pointer to an internal structure is returned. This pointer 162points to a structure called @code{bfd}, described in 163@file{bfd.h}. Our convention is to call this pointer a BFD, and 164instances of it within code @code{abfd}. All operations on 165the target object file are applied as methods to the BFD. The mapping is 166defined within @code{bfd.h} in a set of macros, all beginning 167with @samp{bfd_} to reduce namespace pollution. 168 169For example, this sequence does what you would probably expect: 170return the number of sections in an object file attached to a BFD 171@code{abfd}. 172 173@lisp 174@c @cartouche 175#include "bfd.h" 176 177unsigned int number_of_sections(abfd) 178bfd *abfd; 179@{ 180 return bfd_count_sections(abfd); 181@} 182@c @end cartouche 183@end lisp 184 185The abstraction used within BFD is that an object file has: 186 187@itemize @bullet 188@item 189a header, 190@item 191a number of sections containing raw data (@pxref{Sections}), 192@item 193a set of relocations (@pxref{Relocations}), and 194@item 195some symbol information (@pxref{Symbols}). 196@end itemize 197@noindent 198Also, BFDs opened for archives have the additional attribute of an index 199and contain subordinate BFDs. This approach is fine for a.out and coff, 200but loses efficiency when applied to formats such as S-records and 201IEEE-695. 202 203@node What BFD Version 2 Can Do, , How It Works, Overview 204@section What BFD Version 2 Can Do 205@include bfdsumm.texi 206 207@node BFD front end, BFD back ends, Overview, Top 208@chapter BFD front end 209@include bfdt.texi 210 211@menu 212* Memory Usage:: 213* Initialization:: 214* Sections:: 215* Symbols:: 216* Archives:: 217* Formats:: 218* Relocations:: 219* Core Files:: 220* Targets:: 221* Architectures:: 222* Opening and Closing:: 223* Internal:: 224* File Caching:: 225* Linker Functions:: 226* Hash Tables:: 227@end menu 228 229@node Memory Usage, Initialization, BFD front end, BFD front end 230@section Memory usage 231BFD keeps all of its internal structures in obstacks. There is one obstack 232per open BFD file, into which the current state is stored. When a BFD is 233closed, the obstack is deleted, and so everything which has been 234allocated by BFD for the closing file is thrown away. 235 236BFD does not free anything created by an application, but pointers into 237@code{bfd} structures become invalid on a @code{bfd_close}; for example, 238after a @code{bfd_close} the vector passed to 239@code{bfd_canonicalize_symtab} is still around, since it has been 240allocated by the application, but the data that it pointed to are 241lost. 242 243The general rule is to not close a BFD until all operations dependent 244upon data from the BFD have been completed, or all the data from within 245the file has been copied. To help with the management of memory, there 246is a function (@code{bfd_alloc_size}) which returns the number of bytes 247in obstacks associated with the supplied BFD. This could be used to 248select the greediest open BFD, close it to reclaim the memory, perform 249some operation and reopen the BFD again, to get a fresh copy of the data 250structures. 251 252@node Initialization, Sections, Memory Usage, BFD front end 253@include init.texi 254 255@node Sections, Symbols, Initialization, BFD front end 256@include section.texi 257 258@node Symbols, Archives, Sections, BFD front end 259@include syms.texi 260 261@node Archives, Formats, Symbols, BFD front end 262@include archive.texi 263 264@node Formats, Relocations, Archives, BFD front end 265@include format.texi 266 267@node Relocations, Core Files, Formats, BFD front end 268@include reloc.texi 269 270@node Core Files, Targets, Relocations, BFD front end 271@include core.texi 272 273@node Targets, Architectures, Core Files, BFD front end 274@include targets.texi 275 276@node Architectures, Opening and Closing, Targets, BFD front end 277@include archures.texi 278 279@node Opening and Closing, Internal, Architectures, BFD front end 280@include opncls.texi 281 282@node Internal, File Caching, Opening and Closing, BFD front end 283@include libbfd.texi 284 285@node File Caching, Linker Functions, Internal, BFD front end 286@include cache.texi 287 288@node Linker Functions, Hash Tables, File Caching, BFD front end 289@include linker.texi 290 291@node Hash Tables, , Linker Functions, BFD front end 292@include hash.texi 293 294@node BFD back ends, GNU Free Documentation License, BFD front end, Top 295@chapter BFD back ends 296@menu 297* What to Put Where:: 298* aout :: a.out backends 299* coff :: coff backends 300* elf :: elf backends 301@ignore 302* oasys :: oasys backends 303* ieee :: ieee backend 304* srecord :: s-record backend 305@end ignore 306@end menu 307@node What to Put Where, aout, BFD back ends, BFD back ends 308All of BFD lives in one directory. 309 310@node aout, coff, What to Put Where, BFD back ends 311@include aoutx.texi 312 313@node coff, elf, aout, BFD back ends 314@include coffcode.texi 315 316@node elf, , coff, BFD back ends 317@include elf.texi 318@c Leave this out until the file has some actual contents... 319@c @include elfcode.texi 320 321@node GNU Free Documentation License, Index, BFD back ends, Top 322@chapter GNU Free Documentation License 323@cindex GNU Free Documentation License 324 325 GNU Free Documentation License 326 327 Version 1.1, March 2000 328 329 Copyright (C) 2000 Free Software Foundation, Inc. 330 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 331 332 Everyone is permitted to copy and distribute verbatim copies 333 of this license document, but changing it is not allowed. 334 335 3360. PREAMBLE 337 338The purpose of this License is to make a manual, textbook, or other 339written document "free" in the sense of freedom: to assure everyone 340the effective freedom to copy and redistribute it, with or without 341modifying it, either commercially or noncommercially. Secondarily, 342this License preserves for the author and publisher a way to get 343credit for their work, while not being considered responsible for 344modifications made by others. 345 346This License is a kind of "copyleft", which means that derivative 347works of the document must themselves be free in the same sense. It 348complements the GNU General Public License, which is a copyleft 349license designed for free software. 350 351We have designed this License in order to use it for manuals for free 352software, because free software needs free documentation: a free 353program should come with manuals providing the same freedoms that the 354software does. But this License is not limited to software manuals; 355it can be used for any textual work, regardless of subject matter or 356whether it is published as a printed book. We recommend this License 357principally for works whose purpose is instruction or reference. 358 359 3601. APPLICABILITY AND DEFINITIONS 361 362This License applies to any manual or other work that contains a 363notice placed by the copyright holder saying it can be distributed 364under the terms of this License. The "Document", below, refers to any 365such manual or work. Any member of the public is a licensee, and is 366addressed as "you". 367 368A "Modified Version" of the Document means any work containing the 369Document or a portion of it, either copied verbatim, or with 370modifications and/or translated into another language. 371 372A "Secondary Section" is a named appendix or a front-matter section of 373the Document that deals exclusively with the relationship of the 374publishers or authors of the Document to the Document's overall subject 375(or to related matters) and contains nothing that could fall directly 376within that overall subject. (For example, if the Document is in part a 377textbook of mathematics, a Secondary Section may not explain any 378mathematics.) The relationship could be a matter of historical 379connection with the subject or with related matters, or of legal, 380commercial, philosophical, ethical or political position regarding 381them. 382 383The "Invariant Sections" are certain Secondary Sections whose titles 384are designated, as being those of Invariant Sections, in the notice 385that says that the Document is released under this License. 386 387The "Cover Texts" are certain short passages of text that are listed, 388as Front-Cover Texts or Back-Cover Texts, in the notice that says that 389the Document is released under this License. 390 391A "Transparent" copy of the Document means a machine-readable copy, 392represented in a format whose specification is available to the 393general public, whose contents can be viewed and edited directly and 394straightforwardly with generic text editors or (for images composed of 395pixels) generic paint programs or (for drawings) some widely available 396drawing editor, and that is suitable for input to text formatters or 397for automatic translation to a variety of formats suitable for input 398to text formatters. A copy made in an otherwise Transparent file 399format whose markup has been designed to thwart or discourage 400subsequent modification by readers is not Transparent. A copy that is 401not "Transparent" is called "Opaque". 402 403Examples of suitable formats for Transparent copies include plain 404ASCII without markup, Texinfo input format, LaTeX input format, SGML 405or XML using a publicly available DTD, and standard-conforming simple 406HTML designed for human modification. Opaque formats include 407PostScript, PDF, proprietary formats that can be read and edited only 408by proprietary word processors, SGML or XML for which the DTD and/or 409processing tools are not generally available, and the 410machine-generated HTML produced by some word processors for output 411purposes only. 412 413The "Title Page" means, for a printed book, the title page itself, 414plus such following pages as are needed to hold, legibly, the material 415this License requires to appear in the title page. For works in 416formats which do not have any title page as such, "Title Page" means 417the text near the most prominent appearance of the work's title, 418preceding the beginning of the body of the text. 419 420 4212. VERBATIM COPYING 422 423You may copy and distribute the Document in any medium, either 424commercially or noncommercially, provided that this License, the 425copyright notices, and the license notice saying this License applies 426to the Document are reproduced in all copies, and that you add no other 427conditions whatsoever to those of this License. You may not use 428technical measures to obstruct or control the reading or further 429copying of the copies you make or distribute. However, you may accept 430compensation in exchange for copies. If you distribute a large enough 431number of copies you must also follow the conditions in section 3. 432 433You may also lend copies, under the same conditions stated above, and 434you may publicly display copies. 435 436 4373. COPYING IN QUANTITY 438 439If you publish printed copies of the Document numbering more than 100, 440and the Document's license notice requires Cover Texts, you must enclose 441the copies in covers that carry, clearly and legibly, all these Cover 442Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on 443the back cover. Both covers must also clearly and legibly identify 444you as the publisher of these copies. The front cover must present 445the full title with all words of the title equally prominent and 446visible. You may add other material on the covers in addition. 447Copying with changes limited to the covers, as long as they preserve 448the title of the Document and satisfy these conditions, can be treated 449as verbatim copying in other respects. 450 451If the required texts for either cover are too voluminous to fit 452legibly, you should put the first ones listed (as many as fit 453reasonably) on the actual cover, and continue the rest onto adjacent 454pages. 455 456If you publish or distribute Opaque copies of the Document numbering 457more than 100, you must either include a machine-readable Transparent 458copy along with each Opaque copy, or state in or with each Opaque copy 459a publicly-accessible computer-network location containing a complete 460Transparent copy of the Document, free of added material, which the 461general network-using public has access to download anonymously at no 462charge using public-standard network protocols. If you use the latter 463option, you must take reasonably prudent steps, when you begin 464distribution of Opaque copies in quantity, to ensure that this 465Transparent copy will remain thus accessible at the stated location 466until at least one year after the last time you distribute an Opaque 467copy (directly or through your agents or retailers) of that edition to 468the public. 469 470It is requested, but not required, that you contact the authors of the 471Document well before redistributing any large number of copies, to give 472them a chance to provide you with an updated version of the Document. 473 474 4754. MODIFICATIONS 476 477You may copy and distribute a Modified Version of the Document under 478the conditions of sections 2 and 3 above, provided that you release 479the Modified Version under precisely this License, with the Modified 480Version filling the role of the Document, thus licensing distribution 481and modification of the Modified Version to whoever possesses a copy 482of it. In addition, you must do these things in the Modified Version: 483 484A. Use in the Title Page (and on the covers, if any) a title distinct 485 from that of the Document, and from those of previous versions 486 (which should, if there were any, be listed in the History section 487 of the Document). You may use the same title as a previous version 488 if the original publisher of that version gives permission. 489B. List on the Title Page, as authors, one or more persons or entities 490 responsible for authorship of the modifications in the Modified 491 Version, together with at least five of the principal authors of the 492 Document (all of its principal authors, if it has less than five). 493C. State on the Title page the name of the publisher of the 494 Modified Version, as the publisher. 495D. Preserve all the copyright notices of the Document. 496E. Add an appropriate copyright notice for your modifications 497 adjacent to the other copyright notices. 498F. Include, immediately after the copyright notices, a license notice 499 giving the public permission to use the Modified Version under the 500 terms of this License, in the form shown in the Addendum below. 501G. Preserve in that license notice the full lists of Invariant Sections 502 and required Cover Texts given in the Document's license notice. 503H. Include an unaltered copy of this License. 504I. Preserve the section entitled "History", and its title, and add to 505 it an item stating at least the title, year, new authors, and 506 publisher of the Modified Version as given on the Title Page. If 507 there is no section entitled "History" in the Document, create one 508 stating the title, year, authors, and publisher of the Document as 509 given on its Title Page, then add an item describing the Modified 510 Version as stated in the previous sentence. 511J. Preserve the network location, if any, given in the Document for 512 public access to a Transparent copy of the Document, and likewise 513 the network locations given in the Document for previous versions 514 it was based on. These may be placed in the "History" section. 515 You may omit a network location for a work that was published at 516 least four years before the Document itself, or if the original 517 publisher of the version it refers to gives permission. 518K. In any section entitled "Acknowledgements" or "Dedications", 519 preserve the section's title, and preserve in the section all the 520 substance and tone of each of the contributor acknowledgements 521 and/or dedications given therein. 522L. Preserve all the Invariant Sections of the Document, 523 unaltered in their text and in their titles. Section numbers 524 or the equivalent are not considered part of the section titles. 525M. Delete any section entitled "Endorsements". Such a section 526 may not be included in the Modified Version. 527N. Do not retitle any existing section as "Endorsements" 528 or to conflict in title with any Invariant Section. 529 530If the Modified Version includes new front-matter sections or 531appendices that qualify as Secondary Sections and contain no material 532copied from the Document, you may at your option designate some or all 533of these sections as invariant. To do this, add their titles to the 534list of Invariant Sections in the Modified Version's license notice. 535These titles must be distinct from any other section titles. 536 537You may add a section entitled "Endorsements", provided it contains 538nothing but endorsements of your Modified Version by various 539parties--for example, statements of peer review or that the text has 540been approved by an organization as the authoritative definition of a 541standard. 542 543You may add a passage of up to five words as a Front-Cover Text, and a 544passage of up to 25 words as a Back-Cover Text, to the end of the list 545of Cover Texts in the Modified Version. Only one passage of 546Front-Cover Text and one of Back-Cover Text may be added by (or 547through arrangements made by) any one entity. If the Document already 548includes a cover text for the same cover, previously added by you or 549by arrangement made by the same entity you are acting on behalf of, 550you may not add another; but you may replace the old one, on explicit 551permission from the previous publisher that added the old one. 552 553The author(s) and publisher(s) of the Document do not by this License 554give permission to use their names for publicity for or to assert or 555imply endorsement of any Modified Version. 556 557 5585. COMBINING DOCUMENTS 559 560You may combine the Document with other documents released under this 561License, under the terms defined in section 4 above for modified 562versions, provided that you include in the combination all of the 563Invariant Sections of all of the original documents, unmodified, and 564list them all as Invariant Sections of your combined work in its 565license notice. 566 567The combined work need only contain one copy of this License, and 568multiple identical Invariant Sections may be replaced with a single 569copy. If there are multiple Invariant Sections with the same name but 570different contents, make the title of each such section unique by 571adding at the end of it, in parentheses, the name of the original 572author or publisher of that section if known, or else a unique number. 573Make the same adjustment to the section titles in the list of 574Invariant Sections in the license notice of the combined work. 575 576In the combination, you must combine any sections entitled "History" 577in the various original documents, forming one section entitled 578"History"; likewise combine any sections entitled "Acknowledgements", 579and any sections entitled "Dedications". You must delete all sections 580entitled "Endorsements." 581 582 5836. COLLECTIONS OF DOCUMENTS 584 585You may make a collection consisting of the Document and other documents 586released under this License, and replace the individual copies of this 587License in the various documents with a single copy that is included in 588the collection, provided that you follow the rules of this License for 589verbatim copying of each of the documents in all other respects. 590 591You may extract a single document from such a collection, and distribute 592it individually under this License, provided you insert a copy of this 593License into the extracted document, and follow this License in all 594other respects regarding verbatim copying of that document. 595 596 5977. AGGREGATION WITH INDEPENDENT WORKS 598 599A compilation of the Document or its derivatives with other separate 600and independent documents or works, in or on a volume of a storage or 601distribution medium, does not as a whole count as a Modified Version 602of the Document, provided no compilation copyright is claimed for the 603compilation. Such a compilation is called an "aggregate", and this 604License does not apply to the other self-contained works thus compiled 605with the Document, on account of their being thus compiled, if they 606are not themselves derivative works of the Document. 607 608If the Cover Text requirement of section 3 is applicable to these 609copies of the Document, then if the Document is less than one quarter 610of the entire aggregate, the Document's Cover Texts may be placed on 611covers that surround only the Document within the aggregate. 612Otherwise they must appear on covers around the whole aggregate. 613 614 6158. TRANSLATION 616 617Translation is considered a kind of modification, so you may 618distribute translations of the Document under the terms of section 4. 619Replacing Invariant Sections with translations requires special 620permission from their copyright holders, but you may include 621translations of some or all Invariant Sections in addition to the 622original versions of these Invariant Sections. You may include a 623translation of this License provided that you also include the 624original English version of this License. In case of a disagreement 625between the translation and the original English version of this 626License, the original English version will prevail. 627 628 6299. TERMINATION 630 631You may not copy, modify, sublicense, or distribute the Document except 632as expressly provided for under this License. Any other attempt to 633copy, modify, sublicense or distribute the Document is void, and will 634automatically terminate your rights under this License. However, 635parties who have received copies, or rights, from you under this 636License will not have their licenses terminated so long as such 637parties remain in full compliance. 638 639 64010. FUTURE REVISIONS OF THIS LICENSE 641 642The Free Software Foundation may publish new, revised versions 643of the GNU Free Documentation License from time to time. Such new 644versions will be similar in spirit to the present version, but may 645differ in detail to address new problems or concerns. See 646http://www.gnu.org/copyleft/. 647 648Each version of the License is given a distinguishing version number. 649If the Document specifies that a particular numbered version of this 650License "or any later version" applies to it, you have the option of 651following the terms and conditions either of that specified version or 652of any later version that has been published (not as a draft) by the 653Free Software Foundation. If the Document does not specify a version 654number of this License, you may choose any version ever published (not 655as a draft) by the Free Software Foundation. 656 657 658ADDENDUM: How to use this License for your documents 659 660To use this License in a document you have written, include a copy of 661the License in the document and put the following copyright and 662license notices just after the title page: 663 664@smallexample 665 Copyright (c) YEAR YOUR NAME. 666 Permission is granted to copy, distribute and/or modify this document 667 under the terms of the GNU Free Documentation License, Version 1.1 668 or any later version published by the Free Software Foundation; 669 with the Invariant Sections being LIST THEIR TITLES, with the 670 Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. 671 A copy of the license is included in the section entitled "GNU 672 Free Documentation License". 673@end smallexample 674 675If you have no Invariant Sections, write "with no Invariant Sections" 676instead of saying which ones are invariant. If you have no 677Front-Cover Texts, write "no Front-Cover Texts" instead of 678"Front-Cover Texts being LIST"; likewise for Back-Cover Texts. 679 680If your document contains nontrivial examples of program code, we 681recommend releasing these examples in parallel under your choice of 682free software license, such as the GNU General Public License, 683to permit their use in free software. 684 685@node Index, , GNU Free Documentation License , Top 686@unnumbered Index 687@printindex cp 688 689@tex 690% I think something like @colophon should be in texinfo. In the 691% meantime: 692\long\def\colophon{\hbox to0pt{}\vfill 693\centerline{The body of this manual is set in} 694\centerline{\fontname\tenrm,} 695\centerline{with headings in {\bf\fontname\tenbf}} 696\centerline{and examples in {\tt\fontname\tentt}.} 697\centerline{{\it\fontname\tenit\/} and} 698\centerline{{\sl\fontname\tensl\/}} 699\centerline{are used for emphasis.}\vfill} 700\page\colophon 701% Blame: doc@cygnus.com, 28mar91. 702@end tex 703 704@contents 705@bye 706