From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-bugzilla@gcc.gnu.org>
Received: by sourceware.org (Postfix, from userid 48)
 id 6A4933858C54; Sun,  8 May 2022 22:18:16 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6A4933858C54
From: "bruno at clisp dot org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug other/105527] New: configure option --with-zstd is not documented
Date: Sun, 08 May 2022 22:18:16 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: other
X-Bugzilla-Version: 12.1.0
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: normal
X-Bugzilla-Who: bruno at clisp dot org
X-Bugzilla-Status: UNCONFIRMED
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: bug_id short_desc product version bug_status
 bug_severity priority component assigned_to reporter target_milestone
Message-ID: <bug-105527-4@http.gcc.gnu.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
X-BeenThere: gcc-bugs@gcc.gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gcc-bugs mailing list <gcc-bugs.gcc.gnu.org>
List-Unsubscribe: <https://gcc.gnu.org/mailman/options/gcc-bugs>,
 <mailto:gcc-bugs-request@gcc.gnu.org?subject=unsubscribe>
List-Archive: <https://gcc.gnu.org/pipermail/gcc-bugs/>
List-Post: <mailto:gcc-bugs@gcc.gnu.org>
List-Help: <mailto:gcc-bugs-request@gcc.gnu.org?subject=help>
List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/gcc-bugs>,
 <mailto:gcc-bugs-request@gcc.gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 May 2022 22:18:16 -0000

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=3D105527

            Bug ID: 105527
           Summary: configure option --with-zstd is not documented
           Product: gcc
           Version: 12.1.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: bruno at clisp dot org
  Target Milestone: ---

A GCC 12.1.0 build of mine is failing with the error messages

/usr/lib/gcc-cross/i686-linux-gnu/10/../../../../i686-linux-gnu/bin/ld:
/build-loongarch64-linux/gcc-12.1.0/gcc/../../../../sources/gcc-12.1.0/gcc/=
lto-compress.cc:170:
undefined reference to `ZSTD_isError'
/usr/lib/gcc-cross/i686-linux-gnu/10/../../../../i686-linux-gnu/bin/ld:
/build-loongarch64-linux/gcc-12.1.0/gcc/../../../../sources/gcc-12.1.0/gcc/=
lto-compress.cc:171:
undefined reference to `ZSTD_getErrorName'
collect2: error: ld returned 1 exit status
make: *** [/sources/gcc-12.1.0/gcc/c/Make-lang.in:87: cc1] error 1

Obviously, the ZStd prerequisite is missing. The documentation (in
gcc-12.1.0/gcc/doc/gccinstall.info and in
https://gcc.gnu.org/install/prerequisites.html) merely says "Alternatively,=
 the
--with-zstd configure option should be used." But what is its argument?

I would expect to see this documented
1. in gcc-12.1.0/gcc/doc/gccinstall.info node "Configuration",
2. also in https://gcc.gnu.org/install/configure.html.

The only hint I can get is by running "gcc-12.1.0/gcc/configure --help", wh=
ich
prints

  --with-zstd=3DPATH        specify prefix directory for installed zstd lib=
rary.
                          Equivalent to --with-zstd-include=3DPATH/include =
plus
                          --with-zstd-lib=3DPATH/lib
  --with-zstd-include=3DPATH
                          specify directory for installed zstd include files
  --with-zstd-lib=3DPATH    specify directory for the installed zstd library

This text gives the answer. It should be added to the .texi documentation.=