From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.3 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 09EE5C47082 for ; Mon, 31 May 2021 23:19:49 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id CE18C6124B for ; Mon, 31 May 2021 23:19:48 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231240AbhEaXV2 (ORCPT ); Mon, 31 May 2021 19:21:28 -0400 Received: from hera.aquilenet.fr ([185.233.100.1]:56334 "EHLO hera.aquilenet.fr" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231144AbhEaXV2 (ORCPT ); Mon, 31 May 2021 19:21:28 -0400 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 94875CB8; Tue, 1 Jun 2021 01:19:45 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id PUQ0vzAgTzBm; Tue, 1 Jun 2021 01:19:44 +0200 (CEST) Received: from begin (unknown [IPv6:2a01:cb19:956:1b00:de41:a9ff:fe47:ec49]) by hera.aquilenet.fr (Postfix) with ESMTPSA id A55BE281; Tue, 1 Jun 2021 01:19:44 +0200 (CEST) Received: from samy by begin with local (Exim 4.94.2) (envelope-from ) id 1lnrCB-004Da5-Fp; Tue, 01 Jun 2021 01:19:43 +0200 Date: Tue, 1 Jun 2021 01:19:43 +0200 From: Samuel Thibault To: Gregory Nowak Cc: Igor Matheus Andrade Torrente , speakup@linux-speakup.org, corbet@lwn.net, gregkh@linuxfoundation.org, grandmaster@al2klimov.de, rdunlap@infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: docs: Convert the Speakup guide to rst Message-ID: <20210531231943.gfimbfqd2hrleuxg@begin> Mail-Followup-To: Samuel Thibault , Gregory Nowak , Igor Matheus Andrade Torrente , speakup@linux-speakup.org, corbet@lwn.net, gregkh@linuxfoundation.org, grandmaster@al2klimov.de, rdunlap@infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20210531215737.8431-1-igormtorrente@gmail.com> <20210531220754.h4ep2dj65wl6hejf@begin> <20210531231515.GB8130@gregn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20210531231515.GB8130@gregn.net> Organization: I am not organized User-Agent: NeoMutt/20170609 (1.8.3) X-Spamd-Bar: -- Authentication-Results: hera.aquilenet.fr X-Rspamd-Server: hera X-Rspamd-Queue-Id: 94875CB8 X-Spamd-Result: default: False [-2.50 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FREEMAIL_ENVRCPT(0.00)[gmail.com]; MIME_GOOD(-0.10)[text/plain]; HAS_ORG_HEADER(0.00)[]; RCVD_COUNT_THREE(0.00)[3]; RCPT_COUNT_SEVEN(0.00)[9]; RCVD_NO_TLS_LAST(0.10)[]; FROM_EQ_ENVFROM(0.00)[]; MID_RHS_NOT_FQDN(0.50)[]; FREEMAIL_CC(0.00)[gmail.com]; BAYES_HAM(-3.00)[100.00%] Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Gregory Nowak wrote: > Could a txtdocs option be implemented as a documentation > target for kernel builds, which would produce plain text files? Building html files from this is usual, for instance on Debian the html files are available in the linux-doc package. Gregory Nowak wrote: > Another concern is that if the speakup guide is maintained in RST, > that could dissuade others from keeping it updated who don't already > know RST. The RST syntax is very trivial in the end. Personally I don't really know RST myself, I just mimic what I see in the file and that works alright. Samuel