From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Convert README.org to plain text README while installing package Date: Sat, 4 Jun 2022 18:09:45 +0200 Message-ID: References: <87leuca7v7.fsf@disroot.org> <87czfopmsd.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37372"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Tassilo Horn , Akib Azmain Turja , Emacs developers To: Alan Mackenzie Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jun 04 18:11:16 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nxWMt-0009XP-Hd for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jun 2022 18:11:15 +0200 Original-Received: from localhost ([::1]:33774 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nxWMs-0008CK-03 for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jun 2022 12:11:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34206) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxWLg-0007Qg-8w for emacs-devel@gnu.org; Sat, 04 Jun 2022 12:10:00 -0400 Original-Received: from mail-io1-f53.google.com ([209.85.166.53]:39618) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nxWLe-0000qu-ND; Sat, 04 Jun 2022 12:09:59 -0400 Original-Received: by mail-io1-f53.google.com with SMTP id i201so2797175ioa.6; Sat, 04 Jun 2022 09:09:57 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=e+aMqFvVjtyPhrzeYFNZmFeWxY1cnUQS1jHzNTziRdM=; b=okCFY53qQSLGagqIgji/3grnZ+OBNZ0MgZ3Do+lJhKXh2Vtn7sX7xaOyGwZnF61HCp uggajr02EAJ7xSev2A/g6dJX2k2WZyTagQDqSeSwqJg79cL/p6uZ3JPwk9tW+QvEPDgA h5Q6mvwPNKwvtxhS4cw7IxvkbXBwS8bHzD67Za+Ea3OIPG4OB11LH125DNFxYn+qVQog MCkq9JWpkO9GIyhRr7OMUezXvrueI0DhkkdSYvrbDlJ+hLCo7hV8EhbrRnDaxiVgXWZW n6mAg+pw6XwaR5FoUU6elCw8+MBMqh53jLr63BtnG1p6MILRIMTA8f6vlHUJfsCwsTe+ eCHg== X-Gm-Message-State: AOAM5325Hgze25siwkRDrZTmxiSpkqgvVxFu6gf0sdor1FKXyjEHGy1U trdvRtztNwHs7KmyQnQkvuC7WP2gxXW6YbldhU4fDFY9LSI= X-Google-Smtp-Source: ABdhPJzogaI49Jo8p+HHybOx7lH0JLN2pa6Ne2RbG+nHmpOFwrXNpDxFWHofZNL9U6lTV3k+1WPdALv4Iw5kjCsRTJ0= X-Received: by 2002:a05:6638:240d:b0:32e:80af:6a25 with SMTP id z13-20020a056638240d00b0032e80af6a25mr9399693jat.233.1654358996685; Sat, 04 Jun 2022 09:09:56 -0700 (PDT) In-Reply-To: Received-SPF: pass client-ip=209.85.166.53; envelope-from=stefankangas@gmail.com; helo=mail-io1-f53.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:290661 Archived-At: Alan Mackenzie writes: > No, no, no, no! Org mode is a highly complicated, obscure mode which is > NOT part of core Emacs, and mustn't become so. AFAICT, Org-mode has been distributed with Emacs for more than five major releases by now (approx. 15 years). > Surely the solution has got to be to encourage package authors to write > plain text (or .texi) documentation, by pointing out the difficulties > the non-standard .org format creates. In the Emacs community, Org-mode is ubiquitous. I think we should actively encourage using it for most types of documentation, certainly for README type files. Texinfo has its strengths of course, but it is unfortunately perceived as arcane and hard to use by many. And Org-mode can be converted to be read in 'M-x info'.