* Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines @ 2022-08-30 7:54 Alain.Cochard 2022-08-31 1:57 ` Ihor Radchenko 0 siblings, 1 reply; 4+ messages in thread From: Alain.Cochard @ 2022-08-30 7:54 UTC (permalink / raw) To: Org Mode List Hello. When I visit an org buffer containing only: foo[fn:1] [fn:1] bar #+begin_example x #+end_example then, hitting <TAB> when the cursor is on either '#' does nothing (i.e., no folding). Tested with 'emacs -Q' and the following combinations: GNU Emacs 27.2 (build 1, x86_64-redhat-linux-gnu, GTK+ Version 3.24.30, cairo version 1.17.4) of 2021-08-07 Org mode version 9.4.4 (release_9.4.4 @ /usr/share/emacs/27.2/lisp/org/) GNU Emacs 28.1 (build 3, x86_64-pc-linux-gnu, GTK+ Version 3.24.30, cairo version 1.17.4) of 2022-08-16 Org mode version 9.5.2 (release_9.5.2-25-gaf6f12 @ /home/cochard/usr/local/emacs-28.1/lisp/org/) GNU Emacs 29.0.50 (build 2, x86_64-pc-linux-gnu, GTK+ Version 3.24.30, cairo version 1.17.4) of 2022-08-22 Org mode version 9.5.4 (release_9.5.4-17-g6e991f @ /home/cochard/usr/local/emacs-29/lisp/org/) -- EOST (École et Observatoire des Sciences de la Terre) ITE (Institut Terre & Environnement) | alain.cochard@unistra.fr 5 rue René Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44 F-67084 Strasbourg Cedex, France | [ slot available for rent ] ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines 2022-08-30 7:54 Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines Alain.Cochard @ 2022-08-31 1:57 ` Ihor Radchenko 2022-08-31 12:23 ` Alain.Cochard 0 siblings, 1 reply; 4+ messages in thread From: Ihor Radchenko @ 2022-08-31 1:57 UTC (permalink / raw) To: alain.cochard; +Cc: Org Mode List Alain.Cochard@unistra.fr writes: > Hello. When I visit an org buffer containing only: > > foo[fn:1] > > [fn:1] bar > #+begin_example > > > x > #+end_example > > then, hitting <TAB> when the cursor is on either '#' does nothing > (i.e., no folding). This is not a bug. Just unintuitive syntax: https://orgmode.org/manual/Creating-Footnotes.html#Creating-Footnotes >> A footnote is started by a footnote marker in square brackets in >> column 0, no indentation allowed. It ends at the next footnote >> definition, headline, or after two consecutive empty lines. The >> footnote reference is simply the marker in square brackets, inside >> text. Markers always start with ‘fn:’. The important part is: It ends at the next footnote definition, headline, or after two consecutive empty lines. So, your example is foo[fn:1] <begin footnote-definition>[fn:1] bar #+begin_example ;; <- this is not considered an example block because no major org elements can be inside a footnote definition. <end footnote-definition after two empty lines> <begin paragraph>x #+end_example <end paragraph> -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92 ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines 2022-08-31 1:57 ` Ihor Radchenko @ 2022-08-31 12:23 ` Alain.Cochard 2022-09-02 12:41 ` Syntax of footnote-definition: can we allow double empty lines inside? (was: Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines) Ihor Radchenko 0 siblings, 1 reply; 4+ messages in thread From: Alain.Cochard @ 2022-08-31 12:23 UTC (permalink / raw) To: Ihor Radchenko; +Cc: alain.cochard, Org Mode List Ihor Radchenko writes on Wed 31 Aug 2022 09:57: > This is not a bug. Just unintuitive syntax: > [...] > The important part is: It ends at the next footnote definition, > headline, or after two consecutive empty lines. > > So, your example is > > foo[fn:1] > > <begin footnote-definition>[fn:1] bar > #+begin_example ;; <- this is not considered an example block because no > major org elements can be inside a footnote definition. > > > <end footnote-definition after two empty lines> > <begin paragraph>x > #+end_example > <end paragraph> Thanks a lot for answering. Is there an official definition for "major org element" ? (I could not find anything relevant in the manual.) I guess a headline would qualify (and it would not have occurred to me to use a headline within a footnote; the manual is clear in that respect anyway). But then a list item would probably qualify as well? But, as far as I can see, lists and footnotes work perfectly well together... (because 2 consecutive empty lines also mark the end of a list item?) Furthermore, as long as there is not more than one empty line in a row, blocks also appear to me to work just fine within footnotes, including upon latex export, and I use things like the following all the time: #+LATEX_HEADER: \usepackage{fancyvrb} #+LATEX_HEADER: \VerbatimFootnotes foot[fn:1] [fn:1] note #+begin_src fortran print*,"foo" #+end_src I simply never had to use 2 consecutive empty lines in blocks up to now... So I guess I'll turn my "suspected bug" into a feature request: that #+BEGIN ... #+END blocks behave the same way whether they are within a footnote or not. Regards -- EOST (École et Observatoire des Sciences de la Terre) ITE (Institut Terre & Environnement) | alain.cochard@unistra.fr 5 rue René Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44 F-67084 Strasbourg Cedex, France | [ slot available for rent ] ^ permalink raw reply [flat|nested] 4+ messages in thread
* Syntax of footnote-definition: can we allow double empty lines inside? (was: Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines) 2022-08-31 12:23 ` Alain.Cochard @ 2022-09-02 12:41 ` Ihor Radchenko 0 siblings, 0 replies; 4+ messages in thread From: Ihor Radchenko @ 2022-09-02 12:41 UTC (permalink / raw) To: Alain.Cochard; +Cc: Org Mode List Alain.Cochard@unistra.fr writes: > Ihor Radchenko writes on Wed 31 Aug 2022 09:57: > > > This is not a bug. Just unintuitive syntax: > > [...] > > The important part is: It ends at the next footnote definition, > > headline, or after two consecutive empty lines. > > > > So, your example is > > > > foo[fn:1] > > > > <begin footnote-definition>[fn:1] bar > > #+begin_example ;; <- this is not considered an example block because no > > major org elements can be inside a footnote definition. > > > > > > <end footnote-definition after two empty lines> > > <begin paragraph>x > > #+end_example > > <end paragraph> > > Thanks a lot for answering. > > Is there an official definition for "major org element" ? (I could not > find anything relevant in the manual.) Sorry, I actually confused things in attempt to make things more clear. The official Org syntax defines 2 types of syntax structures: elements and objects. Elements can be: (1) headings, (2) sections, (3) greater elements, (4) lesser elements. Each Org document is a sequence of elements with no gaps in-between. Objects (e.g. markup) may be separated by plain text and must always be inside an existing element. Headings, sections, and greater elements can contain other elements inside, while lesser elements cannot. By "major element" I was actually referring to lesser element (non-object). Not only I was wrong (footnote-definition is a greater element), but also used a confusing terminology. You can refer to https://orgmode.org/worg/dev/org-syntax.html for more detailed info. > I guess a headline would qualify (and it would not have occurred to me > to use a headline within a footnote; the manual is clear in that > respect anyway). > > But then a list item would probably qualify as well? But, as far as I > can see, lists and footnotes work perfectly well together... (because > 2 consecutive empty lines also mark the end of a list item?) > > Furthermore, as long as there is not more than one empty line in a > row, blocks also appear to me to work just fine within footnotes, > including upon latex export, and I use things like the following all > the time: > > #+LATEX_HEADER: \usepackage{fancyvrb} > #+LATEX_HEADER: \VerbatimFootnotes > foot[fn:1] > > [fn:1] note > #+begin_src fortran > print*,"foo" > #+end_src > > I simply never had to use 2 consecutive empty lines in blocks up to > now... > > So I guess I'll turn my "suspected bug" into a feature request: that > #+BEGIN ... #+END blocks behave the same way whether they are within a > footnote or not. You are right, there is currently no way to have double blank lines _inside_ footnote definition. This is because Org syntax prohibits elements inside a greater element to influence the parent boundaries. Once Org parser encounters ^[fn:...] right after previously parsed element, it immediately looks forward for (1) next footnote definition ^[fn:...]; (2) headline ^\*+ ; (3) double blank lines; and sets the footnote definition boundaries accordingly. Unconditionally. No backtracking is allowed for the performance reasons. The consequence is inability to have source blocks containing double blank lines inside a footnote definition. This is not an easy problem because we need to ensure backwards compatibility and avoid doing major changes to Org syntax. The best I can think of is allowing to escape blank lines like #+ and * lines inside the code blocks with ",". See 12.6 Literal Examples section of the manual, for example: #+BEGIN_EXAMPLE ,* I am no real headline #+END_EXAMPLE We may add the same for double blank lines #+BEGIN_EXAMPLE ,* I am no real headline , #+END_EXAMPLE The downside is overly verbose ordinary code blocks. Double blank lines may not be uncommon in the wild; sprinkling commas around many source blocks will be ugly. Alternative ideas are welcome. -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92 ^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2022-09-02 12:41 UTC | newest] Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2022-08-30 7:54 Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines Alain.Cochard 2022-08-31 1:57 ` Ihor Radchenko 2022-08-31 12:23 ` Alain.Cochard 2022-09-02 12:41 ` Syntax of footnote-definition: can we allow double empty lines inside? (was: Suspected bug: example block in a footnote doesn't fold if starts with 2 blank lines) Ihor Radchenko
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).