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 23:10:57 +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="6300"; 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 23:13:00 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 1nxb4u-0001Oz-U5 for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jun 2022 23:13:00 +0200 Original-Received: from localhost ([::1]:41464 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nxb4s-0001CT-Ip for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jun 2022 17:12:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40828) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxb39-0008HS-Va for emacs-devel@gnu.org; Sat, 04 Jun 2022 17:11:12 -0400 Original-Received: from mail-io1-f49.google.com ([209.85.166.49]:34685) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nxb38-0006vB-Fj; Sat, 04 Jun 2022 17:11:11 -0400 Original-Received: by mail-io1-f49.google.com with SMTP id z197so4668291iof.1; Sat, 04 Jun 2022 14:11:09 -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=1aD/40BkFDxNkl/mpsxPaYCUDKFfArFUSmVxRShbUwk=; b=2EonpPQoseHXunxPz6RkmPvN7LPZkgylIkFPVL3hlNBy98AdsBnZgfMciyVf5wlqDM yMutF5Er6Wk0mEONLAix8OMINTbCvCXtAz4KuivSzmsP3wsXr39iXWbzAMaAwgvyxmec uTXhVm31uxm2PIpbwT6Mr5ss7vd0PWDPbRi6cNk+9IlDFBRq9CxGqc97youBhbsYdSiI KKi49GIhgdHHQsyZ9tfgZawUMv9CA5J4gFbmLv17y8CPGW7vV7qDiem50eQ8ssIh2lBB 5WEnFzGcWHw+2OvGaeX6FqEIwJJdVa9ME/QNFxyYemJU0sWZD7P/ZfmuiGfTmXvVXKwO +vNw== X-Gm-Message-State: AOAM532JIRK9DFYgp/yfklPhshvWZ4MPrgXbgVxQcAWXPjTjeFIYZ7vT n2NAW9sSp1B/QH+osV0b+jRcO0sRsAYRTHOFILQ= X-Google-Smtp-Source: ABdhPJzRA3I3NJfB+wsnryeLh/FbusSlL6U77FibF+/DGygfIQuug7bT3GIrCVCQ8SBy/YUL7P7JcBnoV6Z8+z81pFg= X-Received: by 2002:a05:6602:2c51:b0:664:2b00:e756 with SMTP id x17-20020a0566022c5100b006642b00e756mr7908497iov.15.1654377068935; Sat, 04 Jun 2022 14:11:08 -0700 (PDT) In-Reply-To: Received-SPF: pass client-ip=209.85.166.49; envelope-from=stefankangas@gmail.com; helo=mail-io1-f49.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:290675 Archived-At: Alan Mackenzie writes: > We're talking about READMEs here. They're > typically 20 to 100 lines long. A text file is ideal for these. A text file is fine of course, but they lack useful features such as including images (e.g. screenshots). You would need some markup for that, and Org-mode happens to have solid built-in support. > > Texinfo has its strengths of course, but it is unfortunately perceived > > as arcane and hard to use by many. > > It's moderately easy to use, somewhat difficult to learn. Agreed. > > And Org-mode can be converted to be read in 'M-x info'. > > You mean it _has_ to be converted to be read? I don't think so, no. I'm just saying that you can do what we do with the org manual, so you get to write Org-mode, but still get to read in 'M-x info'.