From: Bastien Guerry <bzg@gnu.org>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: Achim Gratz <Stromeko@nexgo.de>, Org Mode List <emacs-orgmode@gnu.org>
Subject: Re: [RFC] Moving "manual.org" into core
Date: Sat, 03 Mar 2018 16:57:33 +0100 [thread overview]
Message-ID: <87bmg5xic2.fsf@bzg.fr> (raw)
In-Reply-To: <87y3j9gzy5.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Sat, 03 Mar 2018 12:29:06 +0100")
Hi Nicolas,
Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
> I don't understand this part. Currently, "manual.org" is exported as
> "org.texi" per
>
> #+export_file_name: org.texi
>
> So we are getting the best of both worlds. Am I missing something?
No, I was missing the "#+export_file_name: org.texi" part.
>> Or org-manual.org, which seems more readable.
>
> I think "manual.org" is simpler, but I do not mind renaming it to
> "org-manual.org". However, I find "org.org" silly.
>
> In any case, I let you decide the name before moving forward.
I don't have a strong opinion on this.
The rationale for using org.org (which, I agree, sounds a bit
childish) is that this is the current convention for naming GNU
manual is [package-name].[extension].
See emacs.texi, gnus.texi, calc.texi, etc.
If using Org becomes popular, it makes sense to have emacs.org,
gnus.org, calc.org but I find emacs-manual.org, gnus-manual.org
calc-manual.org to be cumbersome.
Ok, we're not there yet, I know :)
But still: RMS recently raised the question on emacs-devel of
whether using .rst for the GNU documentation would be better,
so using .org for this purpose is not entirely hypothetical.
What people think? Let's just collect votes on this.
+1 for org.org
--
Bastien
next prev parent reply other threads:[~2018-03-03 15:57 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 [this message]
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
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=87bmg5xic2.fsf@bzg.fr \
--to=bzg@gnu.org \
--cc=Stromeko@nexgo.de \
--cc=emacs-orgmode@gnu.org \
--cc=mail@nicolasgoaziou.fr \
/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).