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 2070A38515E2; Thu, 10 Jun 2021 16:50:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 2070A38515E2 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: 5C4eA7ynZpDPnBQ6TImQG0mKFdY4T5jMOopT2yJOFWiAc3BkrmcIN272lw0OINPxNHMz9GK+Td Zfwvr9XfIU6satu+E1MVowY0DubixgSQP6u2ysZe1skyk4pjGGahgeX4lcDtJd1lzplSJW4kkA BOfsu1WN/EWg6hMGzZ5FrAO+Bvc1GmQ2In/SXBfmMcrmENn1wVaqzaZDibU/nbNNfsVSHWqGog GHiJS1JfZnUrbTvj/a94xoeoU7KAsb5nwP/5Nw4CEAeDbrirgw/9/NvnVoLICYz+9m64YVY8nH GIw= X-IronPort-AV: E=Sophos;i="5.83,264,1616486400"; d="scan'208";a="62237243" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa3.mentor.iphmx.com with ESMTP; 10 Jun 2021 08:49:59 -0800 IronPort-SDR: 4dl+sn3ruAUrrLLyBZVveLHDHkQ2QjKrNRXOmiuSSKYuv/nblTWc8AgraYQhjE8afvvr3jO1Fu B+vRDZZ8yUZ1h+UV09CsrMYCrtvaxwp1uA3txVLaKi0BsnbX95IfeAuu2BDKOXNYkFvqlR71/h yBiXFU3tHy53W08IF6Q4sivvnuedgjiecDtT8FFPiIkenRUIw8gXFujQbKDhDvAjbB7qHRnVgB sYJhgDR8IjRaTHPB35Z5KwzyhV+AAiHH85B4+O8Hx0fAjapXXavwvtYDhRN5FEB0TM9oNrMG17 AF0= Date: Thu, 10 Jun 2021 16:49:53 +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: <8641dc55-5412-fbd7-bafd-13604311f5ad@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> 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.7 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: Thu, 10 Jun 2021 16:50:02 -0000 On Thu, 10 Jun 2021, Martin Liška wrote: > 1) Can we organize the new documentation in $gccroot/doc folder > similarly to what I have in texi2rst-generated repo? Would be beneficial > as we can have a single Makefile and shared content will be in a same > depth to the individual manuals. Where languages have their own manuals, I think it's more appropriate for those to go under the language-specific directories. That doesn't stop the use of shared makefile code. Make-lang.in is a fragment included from gcc/Makefile.in ("-include $(LANG_MAKEFRAGS)"). I certainly expect it should be possible to write GNU make code in gcc/Makefile.in for building and installing manuals, such that subdirectories only need to define a few variables describing what manuals they have and everything else is handled by common code. -- Joseph S. Myers joseph@codesourcery.com