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 19B743858426; Mon, 14 Nov 2022 02:49:37 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 19B743858426 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 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-out1.suse.de (Postfix) with ESMTPS id 163D822BD1; Mon, 14 Nov 2022 02:49:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1668394176; 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=EgGA+0LTx+4vMToeJm0XaMcx1vMBDNNJPWyVBHegpCQ=; b=kTN8PYN9Q1GnUudxLNegnzIhwcWrDeIzUMiAd/lexTV70bMR1u2TqCHEESj5h9t8MbdSgv 0NbnDO6eZCx1HUQJb85voCALenACRGRVqCtQ6xrLnmpKjXll2sWTr+qvGoO3Kg9Qkn+j9Q wlG8foGLcZAlR8Z8wRCLjOqosT1j2DM= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1668394176; 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=EgGA+0LTx+4vMToeJm0XaMcx1vMBDNNJPWyVBHegpCQ=; b=RL+EvybV5mpdZi2aHkgrhY5kzJ+Y8HCdB/nYklmsXD/GcdBdKKRPXsH450WXIr+eFR9ZQN ZVgddpOt68mwSJBA== 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 C77CD13273; Mon, 14 Nov 2022 02:49:35 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id MCGXL7+scWP+JQAAMHmgww (envelope-from ); Mon, 14 Nov 2022 02:49:35 +0000 Message-ID: Date: Mon, 14 Nov 2022 03:49:35 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.4.2 Subject: Revert Sphinx documentation [Was: Issues with Sphinx] To: Andrew Pinski , GCC Mailing List References: Content-Language: en-US Cc: GCC Patches From: =?UTF-8?Q?Martin_Li=c5=a1ka?= In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-5.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS,TXREP 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: Hi. The situation with the Sphinx migration went out of control. The TODO list overwhelmed me and there are road-blocks that can't be easily fixed with what Sphinx currently supports. That would require addition of an upstream support and a possible new Sphinx release. Let me summarize the biggest road blocks: 1) PR107634 - documentation is divided among much files than it used to be; plus the current filenames tend to be very long 2) Index page regressions: PR107643 and PR107651 3) PR107656 - c::macro and c::function does replace [Macro:], [Target Hook:] well 4) Makefile.am, build system issues: missing support for lib*/Makefile.am and various limitation when it comes to 'make install-*'. Moreover, gcc_release --enable-generated-files-in-srcdir is not supported yet. Plus, there are other issues linked in PR107655 and we face the issue that many web links (to GCC documentation) are in the wild and should not become 404. I would like to apologize to anybody who wasted a time with adoption to the Sphinx format which we be reverted eventually. Special thanks belongs to all people who helped me and prepared various patches. I'm going to revert the patchset during today (Monday) and I'll send a patch with a couple of new changes that landed in the period of time we used Sphinx. Thank you for your understanding. Martin