emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Need to update documentation to reflect export block syntax
@ 2016-06-30 14:53 Mark Edgington
  2016-06-30 14:58 ` Mark Edgington
  2016-06-30 15:14 ` Nicolas Goaziou
  0 siblings, 2 replies; 6+ messages in thread
From: Mark Edgington @ 2016-06-30 14:53 UTC (permalink / raw)
  To: emacs-orgmode

I recently updated my org-mode git repository (for a long time I've
had an older git version that I was using), and I am now having
problems when doing latex exports.

I bisected with git to find that the "problem" starts with this revision:

commit 54318add34f09ff39d3fd034a4c1a89f60fd8759
Author: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Date:   Tue Feb 3 16:16:54 2015 +0100

    Change export block syntax

It seems that #+begin_latex is no longer supported, and that when
using it, it results in escaped latex comment symbols (e.g. \% in the
tex file instead of just %), as well as \begin{latex} and \end{latex}
in the exported code.

If it is no longer supported, then it is important that the org-mode
documentation be updated (see e.g.
http://orgmode.org/manual/Quoting-LaTeX-code.html ), since those using
the latest release will have trouble exporting using the old syntax.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Need to update documentation to reflect export block syntax
  2016-06-30 14:53 Need to update documentation to reflect export block syntax Mark Edgington
@ 2016-06-30 14:58 ` Mark Edgington
  2016-06-30 15:14   ` Nicolas Goaziou
  2016-06-30 15:14 ` Nicolas Goaziou
  1 sibling, 1 reply; 6+ messages in thread
From: Mark Edgington @ 2016-06-30 14:58 UTC (permalink / raw)
  To: emacs-orgmode

It also might be worthwhile to have org-mode warn users (at least for a
number of new releases) who happen to be using the old format, explaining
that they need to use the new one to avoid problems when exporting.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Need to update documentation to reflect export block syntax
  2016-06-30 14:53 Need to update documentation to reflect export block syntax Mark Edgington
  2016-06-30 14:58 ` Mark Edgington
@ 2016-06-30 15:14 ` Nicolas Goaziou
  1 sibling, 0 replies; 6+ messages in thread
From: Nicolas Goaziou @ 2016-06-30 15:14 UTC (permalink / raw)
  To: Mark Edgington; +Cc: emacs-orgmode

Hello,

Mark Edgington <edgimar@gmail.com> writes:

> I recently updated my org-mode git repository (for a long time I've
> had an older git version that I was using), and I am now having
> problems when doing latex exports.
>
> I bisected with git to find that the "problem" starts with this revision:
>
> commit 54318add34f09ff39d3fd034a4c1a89f60fd8759
> Author: Nicolas Goaziou <mail@nicolasgoaziou.fr>
> Date:   Tue Feb 3 16:16:54 2015 +0100
>
>     Change export block syntax
>
> It seems that #+begin_latex is no longer supported, and that when
> using it, it results in escaped latex comment symbols (e.g. \% in the
> tex file instead of just %), as well as \begin{latex} and \end{latex}
> in the exported code.
>
> If it is no longer supported, then it is important that the org-mode
> documentation be updated (see e.g.
> http://orgmode.org/manual/Quoting-LaTeX-code.html ), since those using
> the latest release will have trouble exporting using the old syntax.

Manual is already updated. You are probably looking at an old manual
version.

Regards,

-- 
Nicolas Goaziou

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Need to update documentation to reflect export block syntax
  2016-06-30 14:58 ` Mark Edgington
@ 2016-06-30 15:14   ` Nicolas Goaziou
  2016-06-30 15:21     ` Kaushal Modi
  0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Goaziou @ 2016-06-30 15:14 UTC (permalink / raw)
  To: Mark Edgington; +Cc: emacs-orgmode

Mark Edgington <edgimar@gmail.com> writes:

> It also might be worthwhile to have org-mode warn users (at least for a
> number of new releases) who happen to be using the old format, explaining
> that they need to use the new one to avoid problems when exporting.

This already done in ORG-NEWS.

Regards,

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Need to update documentation to reflect export block syntax
  2016-06-30 15:14   ` Nicolas Goaziou
@ 2016-06-30 15:21     ` Kaushal Modi
  2016-06-30 20:10       ` Mark Edgington
  0 siblings, 1 reply; 6+ messages in thread
From: Kaushal Modi @ 2016-06-30 15:21 UTC (permalink / raw)
  To: Mark Edgington, emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 271 bytes --]

@Mark The online documentation corresponds to the stable releases of
org-mode only.

The master branch is the dev branch. The only way to access the latest
documentation is via the Info manual (M-x info in emacs to access that is
the best way IMO).
-- 

-- 
Kaushal Modi

[-- Attachment #2: Type: text/html, Size: 407 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Need to update documentation to reflect export block syntax
  2016-06-30 15:21     ` Kaushal Modi
@ 2016-06-30 20:10       ` Mark Edgington
  0 siblings, 0 replies; 6+ messages in thread
From: Mark Edgington @ 2016-06-30 20:10 UTC (permalink / raw)
  To: emacs-orgmode

Kaushal Modi <kaushal.modi <at> gmail.com> writes: 
>  <at> Mark The online documentation corresponds to the stable releases of
org-mode only.
> The master branch is the dev branch. The only way to access the latest
documentation is via the Info manual (M-x info in emacs to access that is
the best way IMO).

Thanks, I see that now -- I had mistakenly assumed that because the current
stable release date was later than the date of Nicolas' commit, that it had
been included in the release.

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2016-06-30 20:10 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-06-30 14:53 Need to update documentation to reflect export block syntax Mark Edgington
2016-06-30 14:58 ` Mark Edgington
2016-06-30 15:14   ` Nicolas Goaziou
2016-06-30 15:21     ` Kaushal Modi
2016-06-30 20:10       ` Mark Edgington
2016-06-30 15:14 ` Nicolas Goaziou

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).