From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kaushal Modi Subject: Re: [RFC] Moving "manual.org" into core Date: Mon, 22 Jan 2018 17:31:51 +0000 Message-ID: References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87tvveqi7u.fsf@bzg.fr> <87wp0a57i5.fsf@nicolasgoaziou.fr> <87lggp6fvh.fsf@nicolasgoaziou.fr> <87d1216ca1.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="089e0823d720e5b974056360cef1" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46321) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1edfx0-0002Cq-V6 for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 12:32:09 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1edfwz-00088q-Oh for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 12:32:06 -0500 In-Reply-To: <87d1216ca1.fsf@nicolasgoaziou.fr> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Nicolas Goaziou Cc: Bastien Guerry , Achim Gratz , Org Mode List --089e0823d720e5b974056360cef1 Content-Type: text/plain; charset="UTF-8" On Mon, Jan 22, 2018 at 12:20 PM Nicolas Goaziou wrote: > > Again, Org manual, as published in "orgmode.org", is generated through > Texinfo, which treats "begin_src org" exactly as "begin_example". So, > switching to "begin_src org" will not give us Org fontification in HTML > output. > Ah, OK. Understood now. I didn't know that.. would have been nice if that meta data was somehow retained. > This is not about typing. When the markup is more visible than the > contents, it is visual clutter. > OK. It is a matter of taste. I tested both when updating the manual, and > eventually settled for example blocks. > > In any case, I have no strong opinion about it. I just lean towards > simplicity. > Thank you. I'd like to see Org snippets in src blocks as they are not any "raw" monospace text blocks. But if no one else has a strong opinion for using src blocks for Org snippets, then I guess I'll have to concede. > While pasting that example, I realized, that you don't even need to > > specially made an Org snippet an src block just because you want to use > it > > as a noweb ref in the manual. Making Org snippets, src blocks, always, > just > > feels like the right thing. > > I didn't understand this part. > AFAIK noweb-ref can be used only for src blocks. So in the case you need to use Org snippets as noweb refs, you would then need to make those Org snippets src blocks instead of example blocks. I was just trying to make that point. Overall, I am glad to see consistency edits being made in the manual.. will make it easier to contribute to it by just following by example. Thanks. -- Kaushal Modi --089e0823d720e5b974056360cef1 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Mon, Jan 22= , 2018 at 12:20 PM Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:

Again, Org manual, as published in "orgmode.org", is generated throu= gh
Texinfo, which treats "begin_src org" exactly as "begin_exam= ple". So,
switching to "begin_src org" will not give us Org fontification i= n HTML
output.

Ah, OK. Understood now. I didn&= #39;t know that.. would have been nice if that meta data was somehow retain= ed.
=C2=A0
This is not about typing. When the markup is more visible than the
contents, it is visual clutter.

OK.

It is a matter of taste. I tested both when updating the manual, and
eventually settled for example blocks.

In any case, I have no strong opinion about it. I just lean towards
simplicity.

Thank you. I'd like to = see Org snippets in src blocks as they are not any "raw" monospac= e text blocks. But if no one else has a strong opinion for using src blocks= for Org snippets, then I guess I'll have to concede.
> While pasting that example, I realized, that you don't even need t= o
> specially made an Org snippet an src block just because you want to us= e it
> as a noweb ref in the manual. Making Org snippets, src blocks, always,= just
> feels like the right thing.

I didn't understand this part.

AFAI= K noweb-ref can be used only for src blocks. So in the case you need to use= Org snippets as noweb refs, you would then need to make those Org snippets= src blocks instead of example blocks. I was just trying to make that point= .

Overall, I am glad to see consistency edits bein= g made in the manual.. will make it easier to contribute to it by just foll= owing by example.

Thanks.

--

Kaushal Modi

--089e0823d720e5b974056360cef1--