From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by sourceware.org (Postfix) with ESMTPS id 6D0453AAAC16; Thu, 24 Jun 2021 14:08:18 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6D0453AAAC16 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.cz Received: from imap.suse.de (imap-alt.suse-dmz.suse.de [192.168.254.47]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id F051D21986; Thu, 24 Jun 2021 14:08:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1624543696; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=skohDtBM5sPUN3S9jjLul2/addJRIkXWKzacSwsrY9Q=; b=RNaC2zia3++jv1ExcDvcHGUeAubd7iX9GSSAYQi9zQUobmFfbFPxKPWUS1EcwWiJt+MY1L Wzsoq04yho+XnzDeYe5AWNdr0Vy7enUM8OUgWCDG+4fX3z3pGYUwKfz9/ySF5CvTaaaQCi cgMS0XyN8XJ/SP751jnva7gnCOJkNAw= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1624543696; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=skohDtBM5sPUN3S9jjLul2/addJRIkXWKzacSwsrY9Q=; b=fP5aQbWgMPSMEnMTWCb5RcOlNV5PrJciwAA0yfVh51R2qBcXbgEd02iOIlQpYSoirpY7yt QyaUfp+0IRnWJrCQ== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id D0E3011A97; Thu, 24 Jun 2021 14:08:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1624543696; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=skohDtBM5sPUN3S9jjLul2/addJRIkXWKzacSwsrY9Q=; b=RNaC2zia3++jv1ExcDvcHGUeAubd7iX9GSSAYQi9zQUobmFfbFPxKPWUS1EcwWiJt+MY1L Wzsoq04yho+XnzDeYe5AWNdr0Vy7enUM8OUgWCDG+4fX3z3pGYUwKfz9/ySF5CvTaaaQCi cgMS0XyN8XJ/SP751jnva7gnCOJkNAw= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1624543696; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=skohDtBM5sPUN3S9jjLul2/addJRIkXWKzacSwsrY9Q=; b=fP5aQbWgMPSMEnMTWCb5RcOlNV5PrJciwAA0yfVh51R2qBcXbgEd02iOIlQpYSoirpY7yt QyaUfp+0IRnWJrCQ== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id Z4EqMtCR1GAsdAAALh3uQQ (envelope-from ); Thu, 24 Jun 2021 14:08:16 +0000 Subject: Re: GCC documentation: porting to Sphinx To: Joseph Myers Cc: GCC Development , gcc-patches@gcc.gnu.org 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> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: <87489d9a-44e2-411c-3f3a-534d07e78b95@suse.cz> Date: Thu, 24 Jun 2021 16:08:16 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.11.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, NICE_REPLY_A, 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@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: Thu, 24 Jun 2021 14:08:20 -0000 On 6/23/21 6:00 PM, Joseph Myers wrote: > 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). All right. I've just done that and it was easier than I expected. Now the dependencies are properly followed. > > 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). > Oh, and I've just recovered this one as well. Pushed changes to the me/sphinx-v2 branch and I'm waiting for more feedback. In the meantime, I'm going to prepare further integration of other manuals and targets (PDF, HTML). Martin