From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <mark@klomp.org>
Received: from gnu.wildebeest.org (wildebeest.demon.nl [212.238.236.112])
 by sourceware.org (Postfix) with ESMTPS id 992C13857036
 for <debugedit@sourceware.org>; Thu, 29 Apr 2021 18:47:44 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 992C13857036
Authentication-Results: sourceware.org;
 dmarc=none (p=none dis=none) header.from=klomp.org
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mark@klomp.org
Received: from tarox.wildebeest.org (tarox.wildebeest.org [172.31.17.39])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by gnu.wildebeest.org (Postfix) with ESMTPSA id ABBE93075E92;
 Thu, 29 Apr 2021 20:47:38 +0200 (CEST)
Received: by tarox.wildebeest.org (Postfix, from userid 1000)
 id 5B769413CB92; Thu, 29 Apr 2021 20:47:38 +0200 (CEST)
Message-ID: <1c15ba69edcc67b83e7adcfc879a159da8e20aa5.camel@klomp.org>
Subject: Re: [PATCH] debugedit: Add manual using help2man
From: Mark Wielaard <mark@klomp.org>
To: "Dmitry V. Levin" <ldv@altlinux.org>
Cc: debugedit@sourceware.org
Date: Thu, 29 Apr 2021 20:47:38 +0200
In-Reply-To: <20210429163625.GC24650@altlinux.org>
References: <20210429162722.21085-1-mark@klomp.org>
 <20210429163625.GC24650@altlinux.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Mailer: Evolution 3.28.5 (3.28.5-10.el7) 
Mime-Version: 1.0
X-Spam-Status: No, score=-5.0 required=5.0 tests=BAYES_00, JMQ_SPF_NEUTRAL,
 KAM_DMARC_STATUS, SPF_HELO_NONE, SPF_PASS,
 TXREP autolearn=no autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
X-BeenThere: debugedit@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: debugedit development mailing list <debugedit.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/debugedit>,
 <mailto:debugedit-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/debugedit/>
List-Post: <mailto:debugedit@sourceware.org>
List-Help: <mailto:debugedit-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/debugedit>,
 <mailto:debugedit-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Thu, 29 Apr 2021 18:47:49 -0000

Hi Dmitry,

On Thu, 2021-04-29 at 19:36 +0300, Dmitry V. Levin wrote:=20
> > +# Manual pages are generated for dist
> > +dist_man_MANS =3D debugedit.1
> > +
> > +debugedit.1: tools/debugedit.c $(top_srcdir)/configure.ac
> > +	$(MAKE) $(AM_MAKEFLAGS) debugedit$(EXEEXT)
> > +	$(HELP2MAN) -N --output=3D$@ \
> > +	  --name=3D'debug source path manipulation tool' \
> > +	  ./debugedit$(EXEEXT)
>=20
> The usual way of generating debugedit.1 would be to make it depend on
> debugedit$(EXEEXT) instead.  Is this written to avoid any attempts to
> regenerate debugedit.1 at build time?

Yes, that is the idea. It is also what the automake manual recommends
because the man page is a generated file that is distributed.

Cheers,

Mark