From: Simon Marchi <simon.marchi@efficios.com>
To: gdb-patches@sourceware.org
Cc: Simon Marchi <simon.marchi@efficios.com>
Subject: [PATCH 1/7] gdb: update README about the GNU make requirement
Date: Mon, 31 Aug 2026 14:51:40 -0400 [thread overview]
Message-ID: <20260831185300.572297-2-simon.marchi@efficios.com> (raw)
In-Reply-To: <20260831185300.572297-1-simon.marchi@efficios.com>
The README still suggests that GDB can be built with a make other than GNU
make, which is not the case since 2016 (f2ff9acd32b4 "Document new hard
requirement on GNU make").
The manual already lists GNU make in the requirements:
GNU make
GDB's build system relies on features only found in the GNU make
program. Other variants of make will not work.
and the minimum version is documented in gdb/NEWS:
* Building GDB and GDBserver now requires GNU make >= 3.82.
Bring the README in line with that.
- Mention the GNU make requirement, including the minimum version, near
where we also state the C++17 compiler requirement.
- Drop the "if your make program handles the VPATH feature correctly"
part from the "Compiling GDB in another directory" section.
- Drop the warning about --srcdir requiring GNU make.
- Drop the "If you use GNU make" conditional from the paragraph about
running the testsuite in parallel.
Change-Id: I5c0387d977ab87069c01c0249c51b2f30318a0c7
---
gdb/README | 15 +++++++--------
1 file changed, 7 insertions(+), 8 deletions(-)
diff --git a/gdb/README b/gdb/README
index 492b0891668d..791bbd23b6c2 100644
--- a/gdb/README
+++ b/gdb/README
@@ -82,6 +82,9 @@ list of options, invoke the subdirectory `configure', like:
(Take note of how this differs from the invocation used to actually
configure the build tree.)
+ Building GDB requires GNU make version 3.82 or later; other `make'
+programs will not work.
+
GDB requires a C++17 compiler. If you do not have a
C++17 compiler for your system, you may be able to download and install
the GNU CC compiler. It is available via anonymous FTP from the
@@ -254,10 +257,8 @@ Compiling GDB in another directory
you need a different `gdb' compiled for each combination of host and
target. `configure' is designed to make this easy by allowing you to
generate each configuration in a separate subdirectory, rather than in
-the source directory. If your `make' program handles the `VPATH'
-feature correctly (GNU `make' and SunOS 'make' are two that should),
-running `make' in each of these directories builds the `gdb' program
-specified there.
+the source directory. Running `make' in each of these directories
+builds the `gdb' program specified there.
To build `gdb' in a separate directory, run `configure' with the
`--srcdir' option to specify where to find the source. (You also need
@@ -367,8 +368,6 @@ more obscure GDB `configure' options are not listed here.
`DIR'.
`--srcdir=PATH'
- *Warning: using this option requires GNU `make', or another `make'
- that compatibly implements the `VPATH' feature.*
Use this option to make configurations in directories separate
from the GDB source directories. Among other things, you can use
this to build (or maintain) several configurations simultaneously,
@@ -778,8 +777,8 @@ When using a `make'-based method, you can use the Makefile variable
make RUNTESTFLAGS=--directory=gdb.cp check
-If you use GNU make, you can use its `-j' option to run the testsuite
-in parallel. This can greatly reduce the amount of time it takes for
+You can use the `-j' option of `make' to run the testsuite in
+parallel. This can greatly reduce the amount of time it takes for
the testsuite to run. In this case, if you set `RUNTESTFLAGS' then,
by default, the tests will be run serially even under `-j'. You can
override this and force a parallel run by setting the `make' variable
--
2.55.0
next prev parent reply other threads:[~2026-08-31 18:53 UTC|newest]
Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-31 18:51 [PATCH 0/7] Some Makefile cleanups Simon Marchi
2026-08-31 18:51 ` Simon Marchi [this message]
2026-09-01 12:26 ` [PATCH 1/7] gdb: update README about the GNU make requirement Eli Zaretskii
2026-09-01 13:36 ` Simon Marchi
2026-08-31 18:51 ` [PATCH 2/7] gdb, gdbserver: require gcc-style dependency generation, drop the depcomp fallback Simon Marchi
2026-09-01 16:32 ` Tom Tromey
2026-09-01 20:16 ` Simon Marchi
2026-09-02 7:37 ` Rainer Orth
2026-09-02 12:26 ` Simon Marchi
2026-08-31 18:51 ` [PATCH 3/7] gdbserver: fix missing dependency tracking for gdbreplay.o Simon Marchi
2026-09-01 16:33 ` Tom Tromey
2026-08-31 18:51 ` [PATCH 4/7] gdb, gdbserver: always use order-only prerequisites for generated files Simon Marchi
2026-09-01 16:34 ` Tom Tromey
2026-08-31 18:51 ` [PATCH 5/7] gdb, gdbserver: remove the .NOEXPORT target Simon Marchi
2026-09-01 16:37 ` Tom Tromey
2026-08-31 18:51 ` [PATCH 6/7] gdb: remove the explicit ada-exp.o rule Simon Marchi
2026-09-01 16:38 ` Tom Tromey
2026-08-31 18:51 ` [PATCH 7/7] gdb, gdbserver: create the dependency directories from the Makefiles Simon Marchi
2026-09-01 16:47 ` Tom Tromey
2026-09-01 20:18 ` Simon Marchi
2026-09-01 20:37 ` Simon Marchi
2026-09-02 18:36 ` Tom Tromey
2026-09-03 13:45 ` Simon Marchi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260831185300.572297-2-simon.marchi@efficios.com \
--to=simon.marchi@efficios.com \
--cc=gdb-patches@sourceware.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox