From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Tim Cross Newsgroups: gmane.emacs.devel Subject: Re: Org mode and Emacs (was: Convert README.org to plain text README while installing package) Date: Sat, 11 Jun 2022 17:59:46 +1000 Message-ID: <875yl7y6fc.fsf@gmail.com> References: <87h74ztshe.fsf@gmx.de> <871qw31ois.fsf@yahoo.com> <8735gj4ceo.fsf@gnu.org> <87ee038ipt.fsf@gmx.de> <87o7z61v59.fsf@gmail.com> <87bkv527p5.fsf@gmail.com> <835yld93w7.fsf@gnu.org> <877d5t0yrn.fsf@gmail.com> <87r140yuof.fsf@gmail.com> <875yl9e7zm.fsf@gmail.com> <83czfh12kp.fsf@gnu.org> <87pmjhghu2.fsf@localhost> <835yl910gp.fsf@gnu.org> <87wndndbhq.fsf@gmail.com> <83bkuzznws.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15158"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.7.27; emacs 28.1.50 Cc: yantar92@gmail.com, rms@gnu.org, monnier@iro.umontreal.ca, acm@muc.de, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jun 11 10:09:46 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 1nzwBl-0003jn-Cw for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 10:09:45 +0200 Original-Received: from localhost ([::1]:34682 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nzwBj-0006Jo-Uk for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 04:09:43 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54790) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzw4E-0003IH-H9 for emacs-devel@gnu.org; Sat, 11 Jun 2022 04:01:58 -0400 Original-Received: from mail-pg1-x532.google.com ([2607:f8b0:4864:20::532]:44648) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nzw4C-0001zT-Pb; Sat, 11 Jun 2022 04:01:58 -0400 Original-Received: by mail-pg1-x532.google.com with SMTP id c18so1163044pgh.11; Sat, 11 Jun 2022 01:01:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=references:user-agent:from:to:cc:subject:date:in-reply-to :message-id:mime-version; bh=xMjA3N8kKfXIWN4Hfw7fA/kYyAMDaGaNcWj4YHCdFzQ=; b=Nd7D16R+OkfppOJgc7loOJwIu39NeuyC1w1ByPit8nwlbFD5vnjJqKTQHFqR2yMYHX oQMh0RJvDf5cRVulr6WPLp4xtnAcQp1SeYPA86aWg0YgkjixhO2Na0+GuZyE/6LpklN0 dvdey/35Ci2nSRtA4gS5195jhuW2AjOAfJIPOIE/OXy3Nfx5GuBTQ9lJX4+kyINkYYlt wkzHpMqX64UMSliqd3MWXkT1XCt3Ov0ksCnZKSvn5DEP/qCOwaHtn9Sn18OQUXxPdjaq KQ9x628h3kHNMUZd/d8GUAq+COHn/UpYqI9Yb4sG33aj0qYWjIkKBmA8m/IYKa1jaP5e UJtA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:references:user-agent:from:to:cc:subject:date :in-reply-to:message-id:mime-version; bh=xMjA3N8kKfXIWN4Hfw7fA/kYyAMDaGaNcWj4YHCdFzQ=; b=p76wbF3WebETM+iiTmQqKUkuUwp+Pi9tYXf2EBVgjTox/83P42RB4UFAbKDrBji8SR 84QyM8sT2mYbHD3dqfhCteEti+f8Xu522VCLZ1UhR2SET/tlw2qa8KOQMkv7/BpBTbF0 SoBJOeSY+yROjFZT28DsxV8hRIL+MZQLRFHx++frj38JtkfqXx6X8tjkpuVm2A+ujTeE lu2VpLLhwjQEGlckOOngt9/Bl7HbZiCs2nXhwTuScoGsYUASDondVqbtZ60MapjDwKFa j8iPcZ7h0P3qTZeu1vRuF8woYGhJWzNIJw/4O0GwdOmX4iBy/kG4OBAmnBO8JiWPW4eg ZIKg== X-Gm-Message-State: AOAM5338HOsAEC1gnEP6Nx1R5fCRrtliJ4kWxQd3Pc3tQk1J8u2cbkAQ oYIAVH6sO28KrVve59jT2Ft8gGtBXx8= X-Google-Smtp-Source: ABdhPJxMKWMgDFOL+KSBqOVBRtg+eAnNhWvIFvPq0ZcI/ZcyT8NX7KTge2E2LDqDrRhp2f8QPGEAWw== X-Received: by 2002:a63:6a42:0:b0:3fe:2556:c629 with SMTP id f63-20020a636a42000000b003fe2556c629mr17301540pgc.159.1654934511377; Sat, 11 Jun 2022 01:01:51 -0700 (PDT) Original-Received: from dingbat (2001-44b8-31f2-bb00-358b-7027-65fe-0462.static.ipv6.internode.on.net. [2001:44b8:31f2:bb00:358b:7027:65fe:462]) by smtp.gmail.com with ESMTPSA id q17-20020a17090a431100b001e33e264fd6sm867932pjg.40.2022.06.11.01.01.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 11 Jun 2022 01:01:50 -0700 (PDT) In-reply-to: <83bkuzznws.fsf@gnu.org> Received-SPF: pass client-ip=2607:f8b0:4864:20::532; envelope-from=theophilusx@gmail.com; helo=mail-pg1-x532.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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:291023 Archived-At: Eli Zaretskii writes: >> From: Tim Cross >> Cc: Ihor Radchenko , rms@gnu.org, >> monnier@iro.umontreal.ca, acm@muc.de, emacs-devel@gnu.org >> Date: Sat, 11 Jun 2022 14:49:21 +1000 >> >> >> >> I"m also not convinced that org mode would be the right solution for >> >> >> Emacs documentation. >> >> > >> >> > Then why Org's own manual is written in Org instead of Texinfo? >> >> >> >> I do not know if Org mode would be a good solution for Emacs >> >> documentation. However, compared to texinfo, our manual is lacking index >> >> entries in all the exported versions but texinfo. >> > >> > Lack of an index makes for a less useful manual, IME. >> > >> > Anyway, is the lack of the index the _only_ missing feature from what >> > the Org markup provides as compared to Texinfo? Tim's message sounded >> > like there are many more omissions. >> >> My statement is simply waht it says. I am not convinced org mode would >> be the right solution for Emacs documentation. This is for many reasons, >> some relating to org, some relating to the fact I'm not convinced there >> is a need to replace texinfo, especially given that in some areas, I >> think texinfo is more feature rich and consistent and some relating to the feeling I have >> that the result is hard to justify given the amount of work it would >> require. > > Well, it is hard to say anything intelligent without knowing those > "many reasons". > > And if your POV is shared by the Org developers, then I ask again: why > is the Org manual, which weighs in at 23,000 lines, is being written > in Org? I have never claimed my POV was that of the org developers, I've never claimed to be an org developer or to speak in any way for org developers.