From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out2.suse.de (smtp-out2.suse.de [IPv6:2001:67c:2178:6::1d]) by sourceware.org (Postfix) with ESMTPS id 4DF4D385841A for ; Wed, 7 Sep 2022 12:29:08 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4DF4D385841A Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=fail smtp.mailfrom=suse.cz Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id 11A2F203DD; Wed, 7 Sep 2022 12:29:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1662553747; 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=Qkaeo8clehwXfth/kEwQA+N1gdHK2F1bDt9hveV1Yo8=; b=Vs9Bn1/EBSof+5rm1FLpCIMlPFcV8NmbYrZjuWE/ja4kbkGJ+m4XhE3CnV1thCQkRvGb43 aVQWZqvtpMs0knOMO4Ka0ZlLblgeQLhF/FR/xkaSiMvCBBF0QvgXsrJ612b3okhh+sJKev BoyiDhR9jGGoA9ao1vrMGReERoDDCDw= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1662553747; 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=Qkaeo8clehwXfth/kEwQA+N1gdHK2F1bDt9hveV1Yo8=; b=WIMEtKgvTKjJl/b5emH6wkFvsmPtobtODn+kG2t1YAyH16cWoGkqSAWwRC8gQ8C7tuq2Wn uRHkYmzpRePjCJCA== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id F415113A66; Wed, 7 Sep 2022 12:29:06 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id o4WfOpKOGGMwAQAAMHmgww (envelope-from ); Wed, 07 Sep 2022 12:29:06 +0000 Message-ID: Date: Wed, 7 Sep 2022 14:29:06 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.1 Subject: Re: Modula-2: merge followup (brief update on the progress of the new linking implementation) Content-Language: en-US From: =?UTF-8?Q?Martin_Li=c5=a1ka?= To: Gaius Mulley Cc: gcc-patches@gcc.gnu.org References: <87h73qy3vb.fsf@debian> <87ler60z9c.fsf@debian> <163022e2-1f71-da70-abd4-0539e3579a13@suse.cz> <87tu5t3fre.fsf@debian> <87fshc360m.fsf@debian> In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-7.5 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_EU,NICE_REPLY_A,SPF_HELO_NONE,SPF_SOFTFAIL,TXREP,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On 8/31/22 15:25, Martin Liška wrote: > On 8/31/22 15:19, Gaius Mulley wrote: >> Martin Liška writes: >> >>> How do you mean that? You should ideally generate .rst (Sphinx markup) >>> instead of the *.texi files. These will be then included in the converted >>> Sphinx manual similarly to how you include it now to the Texinfo manual. >>> >>> Does it make sense? >>> >>> Cheers, >>> Martin >> >> ah right - yes this makes sense. > > Goo! > >> I mistakenly thought the .rst files >> could be automatically generated from texinfo sources. In any case >> generating .rst directly will likely contain advantages, > > Yes, that's what I'm doing for the existing documentation, but the conversion > is not perfect and I had to make some manual changes to the emitted .rst content. > > So please fix the crash I reported and I can convert GM2 texi manual. Note I've just converted the current Modula-2 manual to RST (Sphinx): https://splichal.eu/scripts/sphinx/ It contains some minor issues, but in general it should be pretty fine. Note pygments contains a corresponding lexer: https://pygments.org/docs/lexers/#multi-dialect-lexer-for-modula-2 Martin > > Cheers, > Martin > >> >> regards, >> Gaius >