From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: chad Newsgroups: gmane.emacs.devel Subject: Re: Org mode and Emacs Date: Sat, 11 Jun 2022 23:54:39 -0400 Message-ID: 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> <87y1y2irhn.fsf@yahoo.com> <87wndmaaow.fsf@localhost> <87ilp6iohe.fsf@yahoo.com> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="0000000000002e963105e13822ef" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="563"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Ihor Radchenko , Richard Stallman , Tim Cross , Stefan Monnier , Alan Mackenzie , EMACS development team To: Po Lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 12 05:56:29 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 1o0EiC-000AbG-Es for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jun 2022 05:56:28 +0200 Original-Received: from localhost ([::1]:45094 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o0EiB-0004eD-4u for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 23:56:27 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44216) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o0Egj-0003uu-JQ for emacs-devel@gnu.org; Sat, 11 Jun 2022 23:54:57 -0400 Original-Received: from mail-lf1-x136.google.com ([2a00:1450:4864:20::136]:40480) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o0Egh-0005Sg-Db; Sat, 11 Jun 2022 23:54:57 -0400 Original-Received: by mail-lf1-x136.google.com with SMTP id t25so4116753lfg.7; Sat, 11 Jun 2022 20:54:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=zElS7J+ZeL1jHBvfmK6nS4pYeIPYG4RdvCAKZWCXafY=; b=NOb4llM8v+pIN5v8sEKRAjehIGPcMKVhvkKttsOGxceKK9+NjMAiA3Q86mp56CFF2i v3CQ0nY78rWFQ+r4nzRvQR0nIGIE9ndCKqqrJ7Iv9U6LXtGyoaZO1ztXNse5Nt5ds8Pg YyCCDt1Y9WXzhVGKmMtgiQEV93Cb5TFwoOHQmEqoVa4FAk5Oa+wxJXVkRN4M7kdBkl8c XngAmHBBp6OTnXyo7yA1kYT3dgGljJJ9jcG6uBjjeJoRs/JfslgHGzlKpGiHWgOS0iA3 bUp2pwW/b0lG8fBqWUGkmVIusx9xYuwXhSOsh72haCIep9Wmko7YBNrnVEzIio3xZ6mn hCWQ== 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=zElS7J+ZeL1jHBvfmK6nS4pYeIPYG4RdvCAKZWCXafY=; b=p54LO7NGuZmV7O+a45/RgywkHUIXVBtuyCItrfeB+aHVSOj/5sU6wekHue2DKRgaBh bZV7fTB4Z4SodxG8Yqq540WKmbBKrgTDHsatUYoYF67mPWbh/A9cBUoAh/X0DcHILWR/ DMtYWNFsL0MaVt9IjK1uO2pBhPhcJgmd61wt9il29G+i92TZCEq086vK4D7wwkTXDaj1 3gwM/5TQL/dJBuHI3UTQ5Lyq3LrperFcKDUMxkhjO4WeUESwrciouZuhbK4pjwjr4M3e 8K92ey4suWsS52gPcbU5HBAUviM1gllxlGRl2YxkfWYezOJlDe5eP99pQY4W3m8cuZH6 843g== X-Gm-Message-State: AOAM533N4QrQVI2i5rwdiebBF5uY+a6UHESl4O5t2zdtwzLGXVdYq3Am oCwl1Sd84tiwJMSF+rlZuUyNCBiBxP7ut4F6RZI= X-Google-Smtp-Source: ABdhPJycwHQ14m5VY9+05DXHuPAyssoX30FGNMo3/kTf/RAJm8JHASjhAcRqLnrUtqIQk6i+ZnDJv8sxGJ7RGLDZWvY= X-Received: by 2002:a05:6512:3f4:b0:478:ff65:7820 with SMTP id n20-20020a05651203f400b00478ff657820mr34453237lfq.367.1655006091448; Sat, 11 Jun 2022 20:54:51 -0700 (PDT) In-Reply-To: <87ilp6iohe.fsf@yahoo.com> Received-SPF: pass client-ip=2a00:1450:4864:20::136; envelope-from=yandros@gmail.com; helo=mail-lf1-x136.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, HTML_MESSAGE=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:291059 Archived-At: --0000000000002e963105e13822ef Content-Type: text/plain; charset="UTF-8" On Sat, Jun 11, 2022 at 10:52 PM Po Lu wrote: > I don't see why we should be serious about using Org for our > documentation, when most people already know texinfo and are quite happy > with it. > I think a reasonable examination of the emacs-devel archives as well as the common practices of most of the people publishing emacs lisp packages today would lead to a very different conclusion. There are several threads about maintenance concerns around makeinfo/texinfo, and many discussions about replacing texinfo with, for example, HTML.There are periodic threads where people claim that they won't try to add their project to GNU because the burden of learning and using texinfo is too high, although those have died down in volume since it became more practical to translate other formats to texinfo. None of this is to say that Org is the "right" format for Emacs documentation. I just don't think it's correct to say "most people already know texinfo and are quite happy with it". ~Chad --0000000000002e963105e13822ef Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

On Sat, Jun 11, 2022 at 10:52 PM Po Lu &l= t;luangruo@yahoo.com> wrote:
I don't see w= hy we should be serious about using Org for our
documentation, when most people already know texinfo and are quite happy with it.

I think a reasonable examinati= on of the emacs-devel archives as well as the common practices of most of t= he people publishing emacs lisp packages today would lead to a very differe= nt conclusion. There are several threads about maintenance concerns around = makeinfo/texinfo, and many discussions about replacing texinfo with, for ex= ample, HTML.There are periodic threads where people claim that they won'= ;t try to add their project to GNU because the burden of learning and using= texinfo is too high, although those have died down in volume since it beca= me more practical to translate other formats to texinfo.

None of this is to say that Org is the "right" format for = Emacs documentation. I just don't think it's correct to say "m= ost people already know texinfo and are quite happy with it".
=C2=A0
~Chad
--0000000000002e963105e13822ef--