Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
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


  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