C99 NEWS and README

* 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

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>
* configure.ac: Assume long long is available. Don't test for

View File

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

View File

@ -17,7 +17,7 @@ Copyright Notices
=================
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
individually.
@ -27,12 +27,13 @@ Unpacking and Installation -- quick overview
When you unpack the binutils archive file, you will get a directory
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
directory are for information and for configuration. The actual
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
./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
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
besides the default. List them as the argument to --enable-targets,
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:
@ -142,7 +143,7 @@ the ranlib program in order to build the distribution.
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
by earlier versions. We are hoping for volunteers to improve this
situation.
@ -155,9 +156,9 @@ with gdb-5.x) may also be of help.
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:
@ -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
libraries.
It is antisocial to post megabyte sized attachments to mailing lists, so
please put large testcases somewhere on an ftp or web site so that only
interested developers need to download them, or offer to email them on
request. Better still, try to reduce the testcase, for example, try to
develop a ld testcase that doesn't use system libraries. However,
please be sure it is a complete testcase and that it really does
demonstrate the problem. Also, don't bother paring it down if that will
cause large delays in filing the bug report.
There is a limit to the size of attachments accepted by bugzilla. If
compressing your testcase does not result in an acceptable size tar or
zip file, please put large testcases somewhere on an ftp or web site.
Better still, try to reduce the testcase, for example, try to develop
a ld testcase that doesn't use system libraries. However, please be
sure it is a complete testcase and that it really does demonstrate the
problem. Also, don't bother paring it down if that will cause large
delays in filing the bug report.
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