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 4DFAD386FC1B; Wed, 23 Jun 2021 16:04:05 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4DFAD386FC1B Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com IronPort-SDR: W/8GShqd+O4IMOPemrqZN8nowSmomUne7vABovmjnuj0RzRQD507r2evFKwqUy0MUWHu2mA72r KBv136x7eKnocLhFAmpZSMcjld+8Gg3SHpaC4GwvIaqrWay7GmoCwMZcQo/kR/uOSQFEzeeN3N UJeU/kAI/1B3SRGbpw8yqor2bIzzrTL8tj/PaNn3GxCYsP1MDjgsxVAwsyS6WY5t6xgpsqJSPJ 9klw6B4iZc0DdphUv/5pm2I4vG5qzX62qbAvHdkhNTc+GobQ1fikCT3UdQxQUwrjt7oU36MqcS Qos= X-IronPort-AV: E=Sophos;i="5.83,294,1616486400"; d="scan'208";a="62704102" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa3.mentor.iphmx.com with ESMTP; 23 Jun 2021 08:04:04 -0800 IronPort-SDR: tkKWEhxf7GmmMba3XwGSP9eFIf7API9lyKczdd7O89OFSkQeQjLFhVGfCc1omUmFR1sEOtWbuU JwC91wTDZCCOqeMlPgAxdVuEsrPINkapCr45OxleHOx0uVhpFhaAL6Vl0t0eBQ1ihWVWqHU6PW tpdyLHM48HbaAqFq07VG4nf/8ey7cRA67i3cWYsZUpQVpqvFxINR6lGyahqFRxEVdULAQLkewm z3AQHotio16S1oLeQra670r5CNgb6vfHXELZy2GprUqwByQTuJxPbRcx861/cDSRVYzAYiTUbs vJ0= Date: Wed, 23 Jun 2021 16:00:17 +0000 From: Joseph Myers X-X-Sender: jsm28@digraph.polyomino.org.uk To: =?ISO-8859-15?Q?Martin_Li=A8ka?= CC: GCC Development , Subject: Re: GCC documentation: porting to Sphinx In-Reply-To: <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz> Message-ID: References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz> <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz> User-Agent: Alpine 2.22 (DEB 394 2020-01-19) MIME-Version: 1.0 X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: SVR-IES-MBX-07.mgc.mentorg.com (139.181.222.7) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-Spam-Status: No, score=-3120.5 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 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8BIT X-Content-Filtered-By: Mailman/MimeDel 2.1.29 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: Wed, 23 Jun 2021 16:04:06 -0000 On Wed, 23 Jun 2021, Martin Liška wrote: > @Joseph: Can you share your thoughts about the used Makefile integration? What > do you suggest for 2) > (note that explicit listing of all .rst file would be crazy)? You can write dependencies on e.g. doc/gcc/*.rst (which might be more files than actually are relevant in some cases, if the directory includes some common files shared by some but not all manuals, but should be conservatively safe if you list appropriate directories there), rather than needing to name all the individual files. Doing things with makefile dependencies seems better than relying on what sphinx-build does when rerun unnecessarily (if sphinx-build avoids rebuilding in some cases where the makefiles think a rebuild is needed, that's fine as an optimization). It looks like this makefile integration loses some of the srcinfo / srcman support. That support should stay (be updated for the use of Sphinx) so that release tarballs (as generated by maintainer-scripts/gcc_release, which uses --enable-generated-files-in-srcdir) continue to include man pages / info files (and make sure that, if those files are present in the source directory, then building and installing GCC does install them even when sphinx-build is absent at build/install time). -- Joseph S. Myers joseph@codesourcery.com