head 1.2; access; symbols netbsd-11-0-RC6:1.1.1.1 netbsd-11-0-RC5:1.1.1.1 netbsd-11-0-RC4:1.1.1.1 netbsd-11-0-RC3:1.1.1.1 netbsd-11-0-RC2:1.1.1.1 netbsd-11-0-RC1:1.1.1.1 perseant-exfatfs-base-20250801:1.1.1.1 netbsd-11:1.1.1.1.0.4 netbsd-11-base:1.1.1.1 perseant-exfatfs:1.1.1.1.0.2 perseant-exfatfs-base-20240630:1.1.1.1 binutils-2-42:1.1.1.1 FSF:1.1.1; locks; strict; comment @# @; 1.2 date 2025.08.25.15.47.39; author christos; state dead; branches; next 1.1; commitid 83YQOH8LeFn9V78G; 1.1 date 2024.06.30.16.01.00; author christos; state Exp; branches 1.1.1.1; next ; commitid Eqxmo2uubpM9w1gF; 1.1.1.1 date 2024.06.30.16.01.00; author christos; state Exp; branches 1.1.1.1.2.1; next ; commitid Eqxmo2uubpM9w1gF; 1.1.1.1.2.1 date 2024.06.30.16.01.00; author perseant; state dead; branches; next 1.1.1.1.2.2; commitid NkoYLLCQWWw9v4gF; 1.1.1.1.2.2 date 2024.07.01.01.00.14; author perseant; state Exp; branches; next ; commitid NkoYLLCQWWw9v4gF; desc @@ 1.2 log @merge conflicts @ text @@@c ---------------------------------------------------------------------------- @@c This is the Texinfo source file for the gp-display-src man page. @@c @@c Author: Ruud van der Pas @@c ---------------------------------------------------------------------------- @@ifset man \input texinfo @@c -*-texinfo-*- @@setfilename gp-display-src @@settitle Display source code and optionally disassembly of the target object @@include gp-macros.texi @@end ifset @@c ---------------------------------------------------------------------------- @@c This is from the man-pages(7) man page @@c @@c "The list below shows conventional or suggested sections. Most manual pages @@c should include at least the highlighted sections. Arrange a new manual @@c page so that sections are placed in the order shown in the list." @@c @@c NAME @@c SYNOPSIS @@c CONFIGURATION [Normally only in Section 4] @@c DESCRIPTION @@c OPTIONS [Normally only in Sections 1, 8] @@c EXIT STATUS [Normally only in Sections 1, 8] @@c RETURN VALUE [Normally only in Sections 2, 3] @@c ERRORS [Typically only in Sections 2, 3] @@c ENVIRONMENT @@c FILES @@c VERSIONS [Normally only in Sections 2, 3] @@c ATTRIBUTES [Normally only in Sections 2, 3] @@c CONFORMING TO @@c NOTES @@c BUGS @@c EXAMPLES @@c AUTHORS [Discouraged] @@c REPORTING BUGS [Not used in man-pages] @@c COPYRIGHT [Not used in man-pages] @@c SEE ALSO @@c @@c This is what the texi2pod.pl tool recognizes: @@c @@c for $sect (qw(NAME SYNOPSIS TARGET DESCRIPTION OPTIONS ENVIRONMENT FILES @@c BUGS NOTES FOOTNOTES SEEALSO AUTHOR COPYRIGHT)) { @@c @@c What is interesting is that it places "SEE ALSO" before "COPYRIGHT", which @@c makes sense and adhered to for the other formats. @@c ---------------------------------------------------------------------------- @@c ---------------------------------------------------------------------------- @@c NAME section @@c ---------------------------------------------------------------------------- @@ManPageStart{NAME} @@c man begin NAME gp-display-src - Display the source code, optionally interleaved with the disassembly of the target object @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c SYNOPSIS section @@c ---------------------------------------------------------------------------- @@ManPageStart{SYNOPSIS} @@c man begin SYNOPSIS @@command{gprofng display src} [@@var{option(s)}] @@var{target-file} @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c DESCRIPTION section @@c ---------------------------------------------------------------------------- @@ManPageStart{DESCRIPTION} @@c man begin DESCRIPTION Display the source code listing, or source code interleaved with disassembly code, as extracted from the target file (an executable, shared object, object file, or a Java .class file). For example, this command displays the source code and disassembly listing for a function called @@samp{mxv_core} that is part of object file @@samp{mxv.o}: @@smallexample $ gprofng display src -disasm mxv_core mxv.o @@end smallexample To list the source code and disassembly for all the functions in this file, use the following command: @@smallexample $ gprofng display src -disasm all -1 mxv.o @@end smallexample The @@var{target-file} is the name of an executable, a shared object, an object file (.o), or a Java .class file. If no options are given, the source code listing of the @@var{target-file} is shown. This is equivalent to @@samp{-source all -1}. If this information is not available, a message to this extent is printed. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c OPTIONS section @@c ---------------------------------------------------------------------------- @@ManPageStart{OPTIONS} @@c man begin OPTIONS @@table @@gcctabopt @@item --version @@ifclear man @@IndexSubentry{Options, @@code{--version}} @@end ifclear Print the version number and exit. @@item --help @@ifclear man @@IndexSubentry{Options, @@code{--help}} @@end ifclear Print usage information and exit. @@item -functions @@ifclear man @@IndexSubentry{Options, @@code{-functions}} @@IndexSubentry{Commands, @@code{functions}} @@end ifclear List all the functions from the given object. @@item -source @@var{item} @@var{tag} @@ifclear man @@IndexSubentry{Options, @@code{-source}} @@IndexSubentry{Commands, @@code{source}} @@end ifclear Show the source code for @@var{item} in @@var{target-file}. The @@var{tag} is used to differentiate in case there are multiple occurences with the same name. See the @@samp{NOTES} section for the definition of @@var{item} and @@var{tag}. @@item -disasm @@var{item} @@var{tag} @@ifclear man @@IndexSubentry{Options, @@code{-disasm}} @@IndexSubentry{Commands, @@code{disasm}} @@end ifclear Include the disassembly in the source listing. The default listing does not include the disassembly. If the source code is not available, show a listing of the disassembly only. See the @@samp{NOTES} section for the definition of @@var{item} and @@var{tag}. @@item -outfile @@var{filename} @@ifclear man @@IndexSubentry{Options, @@code{-outfile}} @@IndexSubentry{Commands, @@code{outfile}} @@end ifclear Write results to file @@var{filename}. A dash (@@minus{}) writes to stdout. This is also the default. Note that this option only affects those options included to the right of the option. @@end table @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c NOTES section @@c ---------------------------------------------------------------------------- @@ManPageStart{NOTES} @@c man begin NOTES Use @@var{item} to specify the name of a function, or of a source or object file that was used to build the executable, or shared object. The @@var{tag} is an index used to determine which item is being referred to when multiple functions have the same name. It is required, but will be ignored if not necessary to resolve the function. The @@var{item} may also be specified in the form @@samp{function`file`}, in which case the source or disassembly of the named function in the source context of the named file will be used. The special @@var{item} and @@var{tag} combination @@samp{all -1}, is used to indicate generating the source, or disassembly, for all functions in the @@var{target-file}. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c SEEALSO section @@c ---------------------------------------------------------------------------- @@ManPageStart{SEE ALSO} @@c man begin SEEALSO gprofng(1), gp-archive(1), gp-collect-app(1), gp-display-gui(1), gp-display-html(1), gp-display-text(1) @@iftex @@vspace{1} @@end iftex The user guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are correctly installed, the command @@command{info gprofng} should give access to this document. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c COPYRIGHT section @@c ---------------------------------------------------------------------------- @@ManPageStart{COPYRIGHT} @@c man begin COPYRIGHT Copyright @@copyright{} 2022-2024 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.3 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''. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c If this text is used for a man page, exit. Otherwise we need to continue. @@c ---------------------------------------------------------------------------- @@ifset man @@bye @@end ifset @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @Import binutils-2.42 (last was 2.39) 2024-01-15 Nick Clifton * 2.42 branch point. 2023-11-15 Arsen Arsenović * intl: Remove directory. Replaced with out-of-tree GNU gettext. * .gitignore: Add '/gettext*'. * configure.ac (host_libs): Replace intl with gettext. (hbaseargs, bbaseargs, baseargs): Split baseargs into {h,b}baseargs. (skip_barg): New flag. Skips appending current flag to bbaseargs. : Exempt --with-libintl-{type,prefix} from target and build machine argument passing. * configure: Regenerate. * Makefile.def (host_modules): Replace intl module with gettext module. (configure-ld): Depend on configure-gettext. * Makefile.in: Regenerate. * src-release.sh: Remove references to the intl/ directory. 2023-07-03 Nick Clifton 2.41 Branch Point. 2023-06-26 Nick Clifton * Import these updates to the config scripts commit 4ad4bb7c30aca1e705448ba8d51a210bbd47bb52 Author: Paul Eggert Date: Fri Jun 23 09:55:10 2023 -0700 Quote 'like this', not `like this'. commit 63acb96f92473ceb5e21d873d7c0aee266b3d6d3 Author: Paul Eggert Date: Sat Jan 21 00:15:01 2023 -0600 Fix config.sub spelling typo for "athlon" commit 4ce12a5c9125cedc0d0ba584444a6865396923ec Author: Dmitry V. Levin Date: Sun Jan 1 08:00:00 2023 +0000 Update copyright years commit c397e2c040bce50bcdccb131f90115ba7e8bfc19 Author: Arsen Arsenovi Date: Sat Sep 17 23:34:48 2022 +0200 config.sub: add linux-mlibc targets commit 9f9f9b0b13197269848c76e3e057a3ed0680b4bf Author: Arsen Arsenovi Date: Sat Sep 17 23:34:47 2022 +0200 config.guess: support running on Managarm systems commit 87e6687749da7bb2ab158a79fa83721c19ed9246 Author: Arsen Arsenovi Date: Sat Sep 17 23:34:46 2022 +0200 config.sub: add managarm-{mlibc,kernel} targets commit 20403c5701973a4cbd7e0b4bbeb627fcd424a0f1 Author: Xiaotian Wu Date: Mon Aug 1 16:05:29 2022 +0800 Remove loongarchx32 commit 02ba26b218d3d3db6c56e014655faf463cefa983 Author: Alexander von Gluck IV Date: Wed May 25 15:43:13 2022 -0500 config.guess: Update Haiku guesses commit f56a7140386d08a531bcfd444d632b28c61a6329 Author: Bruno Haible Date: Sun May 8 19:08:08 2022 +0200 config.guess (x86_64:Linux:*:*): Detect 32-bit ABI. 2023-04-20 Nick Clifton * SECURITY.txt: New file. * src-release.sh (DEVO_SUPPORT): Add SECURITY.txt. 2022-12-31 Nick Clifton * 2.40 binutils branch created. 2022-10-10 Nick Clifton * src-release.sh: Add "-r " option to create reproducible tarballs based upon a fixed timestamp of . * binutils/README-how-to-make-a-release: Add a line showing how to use -r when creating a binutils release. 2022-10-04 Nick Clifton * README-maintainer-mode: Add a minimum version of dejagnu requirement. 2022-09-08 Nick Clifton * README-maintainer-mode: Update minimum version of gettext required. @ text @@ 1.1.1.1.2.1 log @file gp-display-src.texi was added on branch perseant-exfatfs on 2024-07-01 01:00:14 +0000 @ text @d1 249 @ 1.1.1.1.2.2 log @Sync with HEAD. @ text @a0 249 @@c ---------------------------------------------------------------------------- @@c This is the Texinfo source file for the gp-display-src man page. @@c @@c Author: Ruud van der Pas @@c ---------------------------------------------------------------------------- @@ifset man \input texinfo @@c -*-texinfo-*- @@setfilename gp-display-src @@settitle Display source code and optionally disassembly of the target object @@include gp-macros.texi @@end ifset @@c ---------------------------------------------------------------------------- @@c This is from the man-pages(7) man page @@c @@c "The list below shows conventional or suggested sections. Most manual pages @@c should include at least the highlighted sections. Arrange a new manual @@c page so that sections are placed in the order shown in the list." @@c @@c NAME @@c SYNOPSIS @@c CONFIGURATION [Normally only in Section 4] @@c DESCRIPTION @@c OPTIONS [Normally only in Sections 1, 8] @@c EXIT STATUS [Normally only in Sections 1, 8] @@c RETURN VALUE [Normally only in Sections 2, 3] @@c ERRORS [Typically only in Sections 2, 3] @@c ENVIRONMENT @@c FILES @@c VERSIONS [Normally only in Sections 2, 3] @@c ATTRIBUTES [Normally only in Sections 2, 3] @@c CONFORMING TO @@c NOTES @@c BUGS @@c EXAMPLES @@c AUTHORS [Discouraged] @@c REPORTING BUGS [Not used in man-pages] @@c COPYRIGHT [Not used in man-pages] @@c SEE ALSO @@c @@c This is what the texi2pod.pl tool recognizes: @@c @@c for $sect (qw(NAME SYNOPSIS TARGET DESCRIPTION OPTIONS ENVIRONMENT FILES @@c BUGS NOTES FOOTNOTES SEEALSO AUTHOR COPYRIGHT)) { @@c @@c What is interesting is that it places "SEE ALSO" before "COPYRIGHT", which @@c makes sense and adhered to for the other formats. @@c ---------------------------------------------------------------------------- @@c ---------------------------------------------------------------------------- @@c NAME section @@c ---------------------------------------------------------------------------- @@ManPageStart{NAME} @@c man begin NAME gp-display-src - Display the source code, optionally interleaved with the disassembly of the target object @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c SYNOPSIS section @@c ---------------------------------------------------------------------------- @@ManPageStart{SYNOPSIS} @@c man begin SYNOPSIS @@command{gprofng display src} [@@var{option(s)}] @@var{target-file} @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c DESCRIPTION section @@c ---------------------------------------------------------------------------- @@ManPageStart{DESCRIPTION} @@c man begin DESCRIPTION Display the source code listing, or source code interleaved with disassembly code, as extracted from the target file (an executable, shared object, object file, or a Java .class file). For example, this command displays the source code and disassembly listing for a function called @@samp{mxv_core} that is part of object file @@samp{mxv.o}: @@smallexample $ gprofng display src -disasm mxv_core mxv.o @@end smallexample To list the source code and disassembly for all the functions in this file, use the following command: @@smallexample $ gprofng display src -disasm all -1 mxv.o @@end smallexample The @@var{target-file} is the name of an executable, a shared object, an object file (.o), or a Java .class file. If no options are given, the source code listing of the @@var{target-file} is shown. This is equivalent to @@samp{-source all -1}. If this information is not available, a message to this extent is printed. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c OPTIONS section @@c ---------------------------------------------------------------------------- @@ManPageStart{OPTIONS} @@c man begin OPTIONS @@table @@gcctabopt @@item --version @@ifclear man @@IndexSubentry{Options, @@code{--version}} @@end ifclear Print the version number and exit. @@item --help @@ifclear man @@IndexSubentry{Options, @@code{--help}} @@end ifclear Print usage information and exit. @@item -functions @@ifclear man @@IndexSubentry{Options, @@code{-functions}} @@IndexSubentry{Commands, @@code{functions}} @@end ifclear List all the functions from the given object. @@item -source @@var{item} @@var{tag} @@ifclear man @@IndexSubentry{Options, @@code{-source}} @@IndexSubentry{Commands, @@code{source}} @@end ifclear Show the source code for @@var{item} in @@var{target-file}. The @@var{tag} is used to differentiate in case there are multiple occurences with the same name. See the @@samp{NOTES} section for the definition of @@var{item} and @@var{tag}. @@item -disasm @@var{item} @@var{tag} @@ifclear man @@IndexSubentry{Options, @@code{-disasm}} @@IndexSubentry{Commands, @@code{disasm}} @@end ifclear Include the disassembly in the source listing. The default listing does not include the disassembly. If the source code is not available, show a listing of the disassembly only. See the @@samp{NOTES} section for the definition of @@var{item} and @@var{tag}. @@item -outfile @@var{filename} @@ifclear man @@IndexSubentry{Options, @@code{-outfile}} @@IndexSubentry{Commands, @@code{outfile}} @@end ifclear Write results to file @@var{filename}. A dash (@@minus{}) writes to stdout. This is also the default. Note that this option only affects those options included to the right of the option. @@end table @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c NOTES section @@c ---------------------------------------------------------------------------- @@ManPageStart{NOTES} @@c man begin NOTES Use @@var{item} to specify the name of a function, or of a source or object file that was used to build the executable, or shared object. The @@var{tag} is an index used to determine which item is being referred to when multiple functions have the same name. It is required, but will be ignored if not necessary to resolve the function. The @@var{item} may also be specified in the form @@samp{function`file`}, in which case the source or disassembly of the named function in the source context of the named file will be used. The special @@var{item} and @@var{tag} combination @@samp{all -1}, is used to indicate generating the source, or disassembly, for all functions in the @@var{target-file}. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c SEEALSO section @@c ---------------------------------------------------------------------------- @@ManPageStart{SEE ALSO} @@c man begin SEEALSO gprofng(1), gp-archive(1), gp-collect-app(1), gp-display-gui(1), gp-display-html(1), gp-display-text(1) @@iftex @@vspace{1} @@end iftex The user guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are correctly installed, the command @@command{info gprofng} should give access to this document. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c COPYRIGHT section @@c ---------------------------------------------------------------------------- @@ManPageStart{COPYRIGHT} @@c man begin COPYRIGHT Copyright @@copyright{} 2022-2024 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.3 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''. @@c man end @@ManPageEnd{} @@c ---------------------------------------------------------------------------- @@c If this text is used for a man page, exit. Otherwise we need to continue. @@c ---------------------------------------------------------------------------- @@ifset man @@bye @@end ifset @