From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-pl1-x635.google.com (mail-pl1-x635.google.com [IPv6:2607:f8b0:4864:20::635]) by sourceware.org (Postfix) with ESMTPS id 3ED443857C42 for ; Thu, 2 Dec 2021 21:38:15 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 3ED443857C42 Received: by mail-pl1-x635.google.com with SMTP id o14so669172plg.5 for ; Thu, 02 Dec 2021 13:38:15 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=+9vKbsIe5a/x/+1OJmM6uPbdzfym8fQQzxQUjCyDFsg=; b=mZqTGtXhD+OYvjUyBLA2n/zEp6Xzp/2OlUaD0frz01ekZGXEzdOD4Nx6/JxDqNoOtC 9iYQuMptFWvC6IErEtIo7mjmWv3+h52ElzcnkF/1gQXIQXeYyWy9OjphTEO+puFwohnY sJPMXCEcg6AL5rna6xy8H3a4Zvl5qRMu5VuQK8dbjDt1mCN+v/J1hdIpQy8RpprIeClm uroSgUXF3CxNmxHcGEvAdMpz/nYJIBbIeW4lccmXvOGq7zu/mLCGbQSQYmHjEK9wPyec aNhil2FN8WDBlZZDFZY6w3wZk8iUINYYTTVNCeZaYlK656l8mmqvWD+6e7qSmWapScgC r+LQ== X-Gm-Message-State: AOAM532ZpZS6R+IGHxYaoMP8g9Xr2QL8gMj8Xgr7pt384rKGoeLMYmRL rpYULrZlyd7svaJVSTLS2N22+PlFREY= X-Google-Smtp-Source: ABdhPJycB2cOudQowFlqt+iQk114MVXoqx94fOwv/d8iKkJjLYY1cOS9BggjgmpjWh6Jn51/XkN7lQ== X-Received: by 2002:a17:902:b189:b0:143:8079:3d3b with SMTP id s9-20020a170902b18900b0014380793d3bmr18043005plr.71.1638481094037; Thu, 02 Dec 2021 13:38:14 -0800 (PST) Received: from squeak.grove.modra.org ([2406:3400:51d:8cc0:1704:7217:d0c:781d]) by smtp.gmail.com with ESMTPSA id z93sm414786pjj.7.2021.12.02.13.38.12 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 02 Dec 2021 13:38:13 -0800 (PST) Received: by squeak.grove.modra.org (Postfix, from userid 1000) id 73F1F1140B2E; Fri, 3 Dec 2021 08:08:10 +1030 (ACDT) Date: Fri, 3 Dec 2021 08:08:10 +1030 From: Alan Modra To: binutils@sourceware.org Subject: Re: what is the point of bfd/doc/ header generation rules Message-ID: References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-3030.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Dec 2021 21:38:17 -0000 On Thu, Dec 02, 2021 at 11:44:37AM -0500, Mike Frysinger wrote: > On 02 Dec 2021 17:39, Alan Modra via Binutils wrote: > > On Wed, Dec 01, 2021 at 11:57:10PM -0500, Mike Frysinger wrote: > > > bfd/doc/ has a few curious files that i can't seem to find docs on or any > > > references to. are they just uncommon maintainer-esque rules ? or are > > > they obsolete things that i can delete ? > > > > > > specifically, what is the point of: > > > $ cd bfd/doc/ > > > $ make libbfd.h libcoff.h bfd.h > > > > See the headers rule in bfd/Makefile.am. The above files are made in > > bfd/doc when regenerating bfd/libbfd.h, bfd/libcoff.h, and > > bfd/bfd-in2.h. > > ok, but why is it in the doc/ dir to begin with ? It's ancient history. I suppose because some of the doc files are generated from C files, as are parts of these headers. > doesn't it make more > sense to move all of those rules/logic to the top-level Makefile.am ? If your goal is to remove doc/Makefile then yes, that would make sense. Otherwise I don't see much benefit. -- Alan Modra Australia Development Lab, IBM