MatCat.OpenSource/8sa1-binutils-gdb
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

C99 NEWS and README

Browse Source 
* NEWS: Mention C99 requirement.
	* README: Likewise.  Modernise examples and "Reporting bugs".
This commit is contained in:
Alan Modra 2021-04-06 13:42:18 +09:30
parent 340d00fb78
commit 4db29512ce
3 changed files with 24 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
binutils/ChangeLog
View File

@ -1,3 +1,8 @@
2021-04-06 Alan Modra <amodra@gmail.com>
* NEWS: Mention C99 requirement.
* README: Likewise. Modernise examples and "Reporting bugs".
2021-04-05 Alan Modra <amodra@gmail.com> 2021-04-05 Alan Modra <amodra@gmail.com>
* configure.ac: Assume long long is available. Don't test for * configure.ac: Assume long long is available. Don't test for

2
binutils/NEWS
View File

@ -1,5 +1,7 @@
-*- text -*- -*- text -*-
* Binutils now requires a C99 compiler and library to build.
* A new format has been added to the nm program. Specifying * A new format has been added to the nm program. Specifying
--format=just-symbols (or just using -j) will tell the program to only --format=just-symbols (or just using -j) will tell the program to only
display symbol names and nothing else. display symbol names and nothing else.

33
binutils/README
View File

@ -17,7 +17,7 @@ Copyright Notices
================= =================
Copyright years on binutils source files may be listed using range Copyright years on binutils source files may be listed using range
notation, e.g., 1991-2012, indicating that every year in the range, notation, e.g., 1991-2021, indicating that every year in the range,
inclusive, is a copyrightable year that could otherwise be listed inclusive, is a copyrightable year that could otherwise be listed
individually. individually.
@ -27,12 +27,13 @@ Unpacking and Installation -- quick overview
When you unpack the binutils archive file, you will get a directory When you unpack the binutils archive file, you will get a directory
called something like `binutils-XXX', where XXX is the number of the called something like `binutils-XXX', where XXX is the number of the
release. (Probably 2.13 or higher). This directory contains release. (Probably 2.36 or higher). This directory contains
various files and sub-directories. Most of the files in the top various files and sub-directories. Most of the files in the top
directory are for information and for configuration. The actual directory are for information and for configuration. The actual
source code is in sub-directories. source code is in sub-directories.
To build binutils, you can just do: To build binutils you will need a C99 compliant compiler and library.
You can just do:
cd binutils-XXX cd binutils-XXX
./configure [options] ./configure [options]
@ -57,13 +58,13 @@ By default, the binutils will be configured to support the system on
which they are built. When doing cross development, use the --target which they are built. When doing cross development, use the --target
configure option to specify a different target, eg: configure option to specify a different target, eg:
./configure --target=foo-elf ./configure --target=powerpc64le-linux
The --enable-targets option adds support for more binary file formats The --enable-targets option adds support for more binary file formats
besides the default. List them as the argument to --enable-targets, besides the default. List them as the argument to --enable-targets,
separated by commas. For example: separated by commas. For example:
./configure --enable-targets=sun3,rs6000-aix,decstation ./configure --enable-targets=powerpc-linux,rs6000-aix
The name 'all' compiles in support for all valid BFD targets: The name 'all' compiles in support for all valid BFD targets:
@ -142,7 +143,7 @@ the ranlib program in order to build the distribution.
Porting Porting
======= =======
Binutils-2.13 supports many different architectures, but there Binutils-2.36 supports many different architectures, but there
are many more not supported, including some that were supported are many more not supported, including some that were supported
by earlier versions. We are hoping for volunteers to improve this by earlier versions. We are hoping for volunteers to improve this
situation. situation.
@ -155,9 +156,9 @@ with gdb-5.x) may also be of help.
Reporting bugs Reporting bugs
============== ==============
Send bug reports and patches to: Please report bugs via
bug-binutils@gnu.org. https://sourceware.org/bugzilla/enter_bug.cgi?product=binutils
Please include the following in bug reports: Please include the following in bug reports:
@ -205,14 +206,14 @@ Note that your simple two line C program to trigger a problem typically
expands into several megabytes of objects by the time you include expands into several megabytes of objects by the time you include
libraries. libraries.
It is antisocial to post megabyte sized attachments to mailing lists, so There is a limit to the size of attachments accepted by bugzilla. If
please put large testcases somewhere on an ftp or web site so that only compressing your testcase does not result in an acceptable size tar or
interested developers need to download them, or offer to email them on zip file, please put large testcases somewhere on an ftp or web site.
request. Better still, try to reduce the testcase, for example, try to Better still, try to reduce the testcase, for example, try to develop
develop a ld testcase that doesn't use system libraries. However, a ld testcase that doesn't use system libraries. However, please be
please be sure it is a complete testcase and that it really does sure it is a complete testcase and that it really does demonstrate the
demonstrate the problem. Also, don't bother paring it down if that will problem. Also, don't bother paring it down if that will cause large
cause large delays in filing the bug report. delays in filing the bug report.
If you expect to be contributing a large number of test cases, it would If you expect to be contributing a large number of test cases, it would
be helpful if you would look at the test suite included in the release be helpful if you would look at the test suite included in the release