From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-io1-xd43.google.com (mail-io1-xd43.google.com [IPv6:2607:f8b0:4864:20::d43]) by sourceware.org (Postfix) with ESMTPS id 6FE793851C0B; Tue, 2 Jun 2020 11:05:31 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 6FE793851C0B Received: by mail-io1-xd43.google.com with SMTP id j8so10308638iog.13; Tue, 02 Jun 2020 04:05:31 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=chvQZYFxFh6Fp78YxGnvkOJYUVw5CP43QD6F6GSXbWE=; b=s6n4a6sVGDImqTp9FTOTM/rqsOazx3WA0tmE0pQAvuiaStdSSu2I+mVAMzaTutpAho pSuHJSNrUGCpg1d/So7t8Q1kFsD6WH2Kf1linOFJjqos7/6zePeU96xjCyHk2eVxUNCZ N0fzTT+64T7VYHncudo7vtvsaveek28Hivde0o49lVleU0fzqxABc7n9YTOub/+JwkUA ahIiPdKHObGFL/2yfABldOk/es7BXlGsFRWru+/6nHNYQDWojFte4gQBbCrYRmxS3SjQ +bjXA88/TjagKxD2a/4rcynPO1xV9jguFv+FcGnPu7NIbGUkjGRiHs7UFHjoluE3vcx6 dIeg== X-Gm-Message-State: AOAM532r2nyYqrGqYP8/wVGgAgfUdVZ1GdwkpyTF/fy/8xKsQgu8xPZt eorU+Mpx+AyEr9wng5jjRXTn4bDby2ab4iUgyNM= X-Google-Smtp-Source: ABdhPJwad/lltiRw2QuIe8+PSbfgpMzCWsuXq2mCYb1VKp2zpeoGdrP1hZGusTFfaIQRLsLwp05q81MXKh6BfIACny0= X-Received: by 2002:a6b:3e86:: with SMTP id l128mr21494830ioa.95.1591095930909; Tue, 02 Jun 2020 04:05:30 -0700 (PDT) MIME-Version: 1.0 References: <20200525224858.GO8462@tucnak> In-Reply-To: From: Jonathan Wakely Date: Tue, 2 Jun 2020 12:05:19 +0100 Message-ID: Subject: Re: [IMPORTANT] ChangeLog related changes To: Gerald Pfeifer Cc: Jakub Jelinek , "gcc@gcc.gnu.org" , gcc-patches Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, KAM_SHORT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Jun 2020 11:05:41 -0000 On Tue, 2 Jun 2020 at 11:56, Gerald Pfeifer wrote: > > On Mon, 1 Jun 2020, Jonathan Wakely via Gcc-patches wrote: > > The libstdc++ manual is written in Docbook XML, but we commit both the > > XML and generated HTML pages to Git. Sometimes a small XML file can > > result in dozens of mechanical changes to the generated HTML files, > > which we record in the ChangeLog as: > > > > * doc/html/*: Regenerated. > > > > With the new checks we need to name every generated file individually. > > > > If we add that directory to the ignored_prefixes list, we won't need > > to name them. But then the doc/html/* entry will give an error, and > > changes to the HTML files can be committed without any ChangeLog > > entry. Should we just stop mentioning the HTML in the ChangeLog? > > > > We could do something like the attached patch, but it seems overkill > > for this one special case. > > The change makes sense, but indeed it feels like a very specialized > case in a general script. Yes, that was my thought too. > Thinking out of the box (and admittedly with a dose of igorance, which > means I am likely missing something): Is not keeping the libstdc++/doc > HTML in Git a viable option? Only creating that HTML as part of releases > and maybe snapshots? It gets sync'd to https://gcc.gnu.org/onlinedocs/libstdc++ nightly. We could generate it nightly, but we'd need all the docbook stylesheets etc. on sourceware. Or we could just generate it for snapshots (which would still need the docbook stuff on the server) and only sync the onlinedocs weekly from the snapshot.