Re: Capitalisation and good taste ?

[Nick Dokos <nicholas.dokos@hp.com>]

François Pinard <pinard@iro.umontreal.ca> wrote:

> P.S. By the way, the node mentions "#+begin_ascii", but the manual does
> not tell about what it is.  (Or at least "t s begin_ascii RET s RET" in
> the Info node only finds the Easy Templates reference.)
> 

In general, #+begin_foo ... #+end_foo will include the contents of the
block for foo export but get rid of it for non-foo export. So if you
don't intend to export to ascii, you can use an ascii block to include
comments in your file (and similarly for other formats). Of course, you
can also use #+begin_comment...#+end_comment, but afaict, there is an
inconsistency here: the latter can not be indented, whereas the other blocks
can. I haven't tried this with org-indent-mode though[fn:1].

> P.P.S. How about amending the manual for consistent capitalization?
> 
Knock yourself out! ;-)

Nick

Footnotes:

[fn:1] Here is a test file:

--8<---------------cut here---------------start------------->8---

* foo export

  #+begin_ascii
  This is not exported in anything other than ascii.
  #+end_ascii

  #+begin_comment
  foo
  #+end_comment


  #+begin_example
  This is exported in anything.  
  #+end_example

  #+begin_html
  This is not exported in anything other than html.
  #+end_html

  #+begin_latex
  This is not exported in anything other than latex.
  #+end_latex
--8<---------------cut here---------------end--------------->8---