From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa3.mentor.iphmx.com (esa3.mentor.iphmx.com [68.232.137.180]) by sourceware.org (Postfix) with ESMTPS id D3C93385802D for ; Mon, 23 Nov 2020 19:45:36 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org D3C93385802D Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=joseph_myers@mentor.com IronPort-SDR: cB8tUNaS/Izi5NtAXqoGeqSC1chkY0mtmuF7oypss0tdU3i7/dT5DcSVvyrvMffoAWXgMDTxaa ub8LwC3HJlvg2IhqVJRsTPnqTKCY564SWG/nsvQe0QkobeQsm0zakcauvcV1ZyvgbI80nYi4Yd xI5/LOmpJNKPDXEJ9Rh4z+NJrpv4VC5+7M4WiQ+Rj3bO3fVeOLQEzfjH2cz1BHiUvvr2I0PSaf 2PrHPgLEtVehWA22D4pAc63PhzcZbXsS9PyrRDwpvlN5W/llmOvWZeScNepL0P+40kfZp6A7IQ aU8= X-IronPort-AV: E=Sophos;i="5.78,364,1599552000"; d="scan'208";a="55387823" Received: from orw-gwy-02-in.mentorg.com ([192.94.38.167]) by esa3.mentor.iphmx.com with ESMTP; 23 Nov 2020 11:45:35 -0800 IronPort-SDR: UpoIf4B+or218s5HMGD/BhkeJv+egZliMKQDPD25VsFmbFkXJ67PkmZvC41MYqgbiXn/fRnLkR pmMRZheOTdRikmhOe6oE2kXz+MtyVdCiS128bob0sQblWA0/yWj0HqMtcPqf5EvO199R415yON dzJQfJf5BHB6uS3ubQSJktNkBrE01IpmsW4BGQSy+bLP7Mgm52uUYFwihk1faUhceuJaK5pyVz eBE7q5+t27Jnk18vvMIkS8/p6Nb+C0zXuQzm3BmYtiW9otBotshVd8FpZvanOtaOIv//Krg47a Lg8= Date: Mon, 23 Nov 2020 19:45:30 +0000 From: Joseph Myers X-X-Sender: jsm28@digraph.polyomino.org.uk To: Martin Sebor CC: =?ISO-8859-15?Q?Martin_Li=A8ka?= , GCC Development Subject: Re: broken check: You should edit tm.texi.in rather than tm.texi In-Reply-To: Message-ID: References: User-Agent: Alpine 2.22 (DEB 394 2020-01-19) MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: SVR-IES-MBX-04.mgc.mentorg.com (139.181.222.4) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-Spam-Status: No, score=-3125.1 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, SPF_HELO_PASS, 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: gcc@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 23 Nov 2020 19:45:38 -0000 On Mon, 23 Nov 2020, Martin Sebor via Gcc wrote: > I never did understand what it was complaining about, or the point > of making us jump through these hoops for updates to the internals > manual when the (arguably far more impactful) changes to GCC source > code or the user-visible manual aren't subject to the same check. The point of this check is that the FSF was unable to come up with a dual licensing notice allowing a single source file with content explicitly dual-licensed under the GPL and GFDL, so instead both GPL and GFDL copies of that content (doc strings for target hooks) need to be checked into the repository, and the check makes sure that the two copies are in sync. The person contributing such documentation should commit it with both copies in sync to ensure it's properly available under both licenses. Otherwise, e.g. moving existing internals manual text documenting a target macro into such a doc string for a target hook and so making it available under a new license, a global reviewer or docstring relicensing maintainer can approve the move. -- Joseph S. Myers joseph@codesourcery.com