From: Kaushal Modi <kaushal.modi@gmail.com>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: Bastien <bzg@gnu.org>, Glenn Morris <rgm@gnu.org>,
Achim Gratz <Stromeko@nexgo.de>,
Org Mode List <emacs-orgmode@gnu.org>
Subject: Re: [RFC] Moving "manual.org" into core
Date: Mon, 05 Mar 2018 16:23:34 +0000 [thread overview]
Message-ID: <CAFyQvY1Gf8i9K+TcEJwEzhY4BwX-7OiGkR9YjQcYaqDGp98AZQ@mail.gmail.com> (raw)
In-Reply-To: <87k1uq4n90.fsf@nicolasgoaziou.fr>
[-- Attachment #1: Type: text/plain, Size: 1522 bytes --]
On Mon, Mar 5, 2018 at 9:21 AM Nicolas Goaziou <mail@nicolasgoaziou.fr>
wrote:
>
> > Again, the question is: what problem are we trying to solve?
>
> Org boasts itself as a format to write, among other things,
> documentation. Do you think it is confidence-inspiring if we do not
> write our own documentation in our format? See also
> <https://en.wikipedia.org/wiki/Eating_your_own_dog_food>. This problem
> is now solved.
>
> Also, no matter how you look at it, doing any non-trivial edit in
> "org.texi" is painful. I want to ease that pain for current contributors
> (at least me), too.
>
+1 Editing Org is so much natural than .texi. And by this flow, we are not
obsoleting .texi, just having it generate automatically instead of
manually. It like writing a higher level language like C or Python instead
of tinkering in Assembly.
> Also, I'm not suggesting to get rid of "org.texi". I'm suggesting to
> generate it from "manual.org" and to avoid as much as possible editing
> it manually thereafter. In practice, this change is so small that I do
> not understand what all this fuss is about. This should be simple: move
> "manual.org" to doc/, overwrite "org.texi", and, when we feel confident
> enough, if it ever happens, remove "org.texi" altogether from the
> repository, generating it only before bundling a new Org release or
> merging it with Emacs.
>
Exactly. Emacs will anyways ship with org.texi. So moving the manual source
to Org in the Org repo shouldn't concern the Emacs repo.
--
Kaushal Modi
[-- Attachment #2: Type: text/html, Size: 2417 bytes --]
next prev parent reply other threads:[~2018-03-05 16:23 UTC|newest]
Thread overview: 77+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-01-20 14:43 [RFC] Moving "manual.org" into core Nicolas Goaziou
2018-01-20 17:41 ` Achim Gratz
2018-01-20 18:15 ` Nicolas Goaziou
2018-01-20 18:36 ` Achim Gratz
2018-01-20 18:51 ` Nicolas Goaziou
2018-01-20 17:41 ` Thomas S. Dye
2018-01-22 10:51 ` Bastien Guerry
2018-01-22 13:48 ` Nicolas Goaziou
2018-01-22 15:30 ` Kaushal Modi
2018-01-22 16:02 ` Nicolas Goaziou
2018-01-22 17:00 ` Kaushal Modi
2018-01-22 17:20 ` Nicolas Goaziou
2018-01-22 17:31 ` Kaushal Modi
2018-01-22 19:52 ` Nicolas Goaziou
2018-01-23 15:19 ` Kaushal Modi
2018-01-23 16:30 ` Julius Dittmar
2018-01-23 16:33 ` Nicolas Goaziou
2018-01-23 16:37 ` Kaushal Modi
2018-01-22 16:35 ` Bastien Guerry
2018-01-22 16:53 ` Kaushal Modi
2018-01-22 16:35 ` Bastien Guerry
2018-01-22 16:31 ` Bastien Guerry
2018-01-22 17:03 ` Nicolas Goaziou
2018-01-23 8:07 ` org-adapt-indentation 'content (was Re: [RFC] Moving "manual.org" into core) Christian Moe
2018-03-06 19:01 ` Bastien Guerry
2018-01-22 19:04 ` [RFC] Moving "manual.org" into core Achim Gratz
2018-03-03 9:17 ` Nicolas Goaziou
2018-03-03 10:18 ` Bastien Guerry
2018-03-03 11:29 ` Nicolas Goaziou
2018-03-03 15:57 ` Bastien Guerry
2018-03-03 16:15 ` Joseph Vidal-Rosset
2018-03-03 19:48 ` Glenn Morris
2018-03-04 9:30 ` Bastien Guerry
2018-01-23 20:06 ` Thomas S. Dye
2018-01-22 13:54 ` Rasmus
2018-01-22 15:23 ` Kaushal Modi
2018-01-24 8:39 ` Yasushi SHOJI
2018-01-24 11:28 ` Nicolas Goaziou
2018-01-26 8:52 ` Yasushi SHOJI
2018-01-26 10:32 ` Nicolas Goaziou
2018-01-27 8:40 ` Yasushi SHOJI
2018-01-28 15:17 ` Nicolas Goaziou
2018-01-29 2:40 ` Yasushi SHOJI
2018-01-29 14:41 ` Nicolas Goaziou
2018-02-01 11:43 ` Yasushi SHOJI
2018-02-01 12:11 ` Yasushi SHOJI
2018-02-04 9:05 ` Nicolas Goaziou
2018-02-01 14:55 ` Nicolas Goaziou
2018-02-02 2:07 ` Yasushi SHOJI
2018-02-04 9:40 ` Nicolas Goaziou
2018-02-06 14:11 ` Yasushi SHOJI
2018-01-22 16:41 ` Thomas S. Dye
2018-01-23 8:08 ` Christian Moe
2018-01-23 21:00 ` Samuel Wales
2018-03-04 9:32 ` Bastien Guerry
2018-03-04 10:06 ` Nicolas Goaziou
2018-03-04 10:29 ` Bastien
2018-03-05 14:20 ` Nicolas Goaziou
2018-03-05 16:23 ` Kaushal Modi [this message]
2018-03-06 17:41 ` Bastien Guerry
2018-03-06 21:39 ` Achim Gratz
2018-03-05 18:08 ` Thomas S. Dye
2018-03-06 1:08 ` Bastien Guerry
2018-03-06 9:57 ` Thomas S. Dye
2018-03-06 11:55 ` Eric S Fraga
2018-03-06 17:39 ` Bastien
2018-03-06 18:45 ` Thomas S. Dye
2018-03-06 19:19 ` Bastien
2018-03-07 2:53 ` Thomas S. Dye
2018-03-05 19:01 ` Achim Gratz
2018-03-06 19:02 ` Bastien
2018-03-06 18:59 ` Bastien Guerry
[not found] ` <WM!6f8274ba0065f984ff76586f7cf117703ccda15adbb5042672b0d2695ee5ac6b367ee58f70aacbbc9c2b10eecb9672ea!@mailhub-mx3.ncl.ac.uk>
2018-03-05 16:22 ` Phillip Lord
2018-03-06 17:47 ` Bastien Guerry
2018-03-04 10:54 ` Bastien Guerry
2018-03-05 14:26 ` Nicolas Goaziou
2018-03-06 17:43 ` Bastien Guerry
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAFyQvY1Gf8i9K+TcEJwEzhY4BwX-7OiGkR9YjQcYaqDGp98AZQ@mail.gmail.com \
--to=kaushal.modi@gmail.com \
--cc=Stromeko@nexgo.de \
--cc=bzg@gnu.org \
--cc=emacs-orgmode@gnu.org \
--cc=mail@nicolasgoaziou.fr \
--cc=rgm@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).