* ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) @ 2018-06-13 14:59 Alain.Cochard 2018-06-13 19:26 ` Nicolas Goaziou 0 siblings, 1 reply; 6+ messages in thread From: Alain.Cochard @ 2018-06-13 14:59 UTC (permalink / raw) To: emacs-orgmode Hello. In section "15.2 Easy templates" of the manual, I think that under Org comes with these pre-defined easy templates: the line related to VERBATIM is missing. -- EOST (École et Observatoire des Sciences de la Terre) IPG (Institut de Physique du Globe) | alain.cochard@unistra.fr 5 rue René Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44 F-67084 Strasbourg Cedex, France | Fax: +33 (0)3 68 85 01 25 ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) 2018-06-13 14:59 ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) Alain.Cochard @ 2018-06-13 19:26 ` Nicolas Goaziou 2018-06-14 12:56 ` Alain.Cochard 0 siblings, 1 reply; 6+ messages in thread From: Nicolas Goaziou @ 2018-06-13 19:26 UTC (permalink / raw) To: Alain.Cochard; +Cc: emacs-orgmode Hello, Alain.Cochard@unistra.fr writes: > In section "15.2 Easy templates" of the manual, I think that under > > Org comes with these pre-defined easy templates: > > the line related to VERBATIM is missing. The "Easy templates" section does not exist anymore in new manual. Also, there is no such thing as a "verbatim" environment. IOW, it is already solved in master. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) 2018-06-13 19:26 ` Nicolas Goaziou @ 2018-06-14 12:56 ` Alain.Cochard 2018-06-14 18:43 ` Nicolas Goaziou 0 siblings, 1 reply; 6+ messages in thread From: Alain.Cochard @ 2018-06-14 12:56 UTC (permalink / raw) To: Nicolas Goaziou; +Cc: emacs-orgmode Nicolas Goaziou writes on Wed 13 Jun 2018 21:26: > The "Easy templates" section does not exist anymore in new > manual. Also, there is no such thing as a "verbatim" environment. > > IOW, it is already solved in master. Thanks for the feedback. I had been made aware of the verbatim block type by the following excerpt of section 14 (Working with source code) of the manual: Org’s ‘src’ code block type is one of many block types, such as quote, export, verse, latex, example, and verbatim. If I am not mistaken, this excerpt is still present in the new (master) version of the manual. Also, I was a bit confused by section 15.2 (Structure Templates) of the new manual. The formatting suggests (to me anyway) that the list at the end (a ‘#+BEGIN_EXPORT ascii’ . . . ‘#+END_EXPORT’, etc.) indicates what can be obtained by the '< key TAB' mechanism when org-tempo is enabled. But since there is a one-to-one correspondence between this list and the list inside org-structure-template-alist [fn:1], it appears more specifically related to the default insertion mechanism (that is, without org-tempo). Sure, there is nothing wrong but maybe the formulation could be made more explicit -- also listing the few keys specific of org-tempo could help. [fn:1] Well, almost: the "E" entry is missing in the manual. Finally, looking at the docstring of org-tempo-keywords-alist, I think the sentence For example "<l" at the beginning of a line... should be For example "<L" at the beginning of a line... Regards -- EOST (École et Observatoire des Sciences de la Terre) IPG (Institut de Physique du Globe) | alain.cochard@unistra.fr 5 rue René Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44 F-67084 Strasbourg Cedex, France | Fax: +33 (0)3 68 85 01 25 ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) 2018-06-14 12:56 ` Alain.Cochard @ 2018-06-14 18:43 ` Nicolas Goaziou 2018-06-14 20:36 ` Alain.Cochard 0 siblings, 1 reply; 6+ messages in thread From: Nicolas Goaziou @ 2018-06-14 18:43 UTC (permalink / raw) To: Alain.Cochard; +Cc: emacs-orgmode Hello, Alain.Cochard@unistra.fr writes: > Nicolas Goaziou writes on Wed 13 Jun 2018 21:26: > > > The "Easy templates" section does not exist anymore in new > > manual. Also, there is no such thing as a "verbatim" environment. > > > > IOW, it is already solved in master. > > Thanks for the feedback. > > I had been made aware of the verbatim block type by the following > excerpt of section 14 (Working with source code) of the manual: > > Org’s ‘src’ code block type is one of many block types, such as > quote, export, verse, latex, example, and verbatim. > > If I am not mistaken, this excerpt is still present in the new > (master) version of the manual. I don't think so. I couldn't find it in the guide either. > Also, I was a bit confused by section 15.2 (Structure Templates) of > the new manual. The formatting suggests (to me anyway) that the list > at the end (a ‘#+BEGIN_EXPORT ascii’ . . . ‘#+END_EXPORT’, etc.) > indicates what can be obtained by the '< key TAB' mechanism when > org-tempo is enabled. But since there is a one-to-one correspondence > between this list and the list inside org-structure-template-alist > [fn:1], it appears more specifically related to the default insertion > mechanism (that is, without org-tempo). > > Sure, there is nothing wrong but maybe the formulation could be made > more explicit -- also listing the few keys specific of org-tempo could > help. Feel free to send a patch if you think you can improve the wording. > [fn:1] Well, almost: the "E" entry is missing in the manual. Fixed. Thank you. > Finally, looking at the docstring of org-tempo-keywords-alist, I think > the sentence > > For example "<l" at the beginning of a line... > > should be > > For example "<L" at the beginning of a line... Fixed. Thank you. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) 2018-06-14 18:43 ` Nicolas Goaziou @ 2018-06-14 20:36 ` Alain.Cochard 2018-06-14 23:20 ` Nicolas Goaziou 0 siblings, 1 reply; 6+ messages in thread From: Alain.Cochard @ 2018-06-14 20:36 UTC (permalink / raw) To: Nicolas Goaziou; +Cc: emacs-orgmode Nicolas Goaziou writes on Thu 14 Jun 2018 20:43: > > [...] the following excerpt of section 14 (Working with source > > code) of the manual: > > > > Org’s ‘src’ code block type is one of many block types, such > > as quote, export, verse, latex, example, and verbatim. > > > > If I am not mistaken, this excerpt is still present in the new > > (master) version of the manual. > I don't think so. I couldn't find it in the guide either. That is strange. I did the following: git clone https://code.orgmode.org/bzg/org-mode.git cd org-mode && make && make doc From there, I don't know how to view the manual with Info (like I do with the elpa version), but I had assumed it would be essentially the same content as what is in the org.pdf file which is in the doc directory. There is indeed the absence of the old "Easy templates" section, the new parts about the new insertion mechanism. And the above excerpt is also there (p.200). I can also see the same excerpt in files org-manual.org and org.texi... Regards -- EOST (École et Observatoire des Sciences de la Terre) IPG (Institut de Physique du Globe) | alain.cochard@unistra.fr 5 rue René Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44 F-67084 Strasbourg Cedex, France | Fax: +33 (0)3 68 85 01 25 ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) 2018-06-14 20:36 ` Alain.Cochard @ 2018-06-14 23:20 ` Nicolas Goaziou 0 siblings, 0 replies; 6+ messages in thread From: Nicolas Goaziou @ 2018-06-14 23:20 UTC (permalink / raw) To: Alain.Cochard; +Cc: emacs-orgmode Hello, Alain.Cochard@unistra.fr writes: > That is strange. I did the following: > > git clone https://code.orgmode.org/bzg/org-mode.git > > cd org-mode && make && make doc > > From there, I don't know how to view the manual with Info (like I do > with the elpa version), but I had assumed it would be essentially the > same content as what is in the org.pdf file which is in the doc > directory. There is indeed the absence of the old "Easy templates" > section, the new parts about the new insertion mechanism. And the > above excerpt is also there (p.200). > > I can also see the same excerpt in files org-manual.org and > org.texi... I see it now. Fixed. Thank you. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2018-06-14 23:20 UTC | newest] Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2018-06-13 14:59 ‘V’ ‘#+BEGIN_VERBATIM ... #+END_VERBATIM’ missing in manual(?) Alain.Cochard 2018-06-13 19:26 ` Nicolas Goaziou 2018-06-14 12:56 ` Alain.Cochard 2018-06-14 18:43 ` Nicolas Goaziou 2018-06-14 20:36 ` Alain.Cochard 2018-06-14 23:20 ` 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).