From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: [Accepted] org.texi: Document quick insertion of empty structural elements Date: Sun, 15 Aug 2010 09:14:45 +0200 (CEST) Message-ID: <20100815071445.AB5AE1AF1C78@carsten-dominiks-macbook-pro.local> References: <814oeyax0d.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: Received: from [140.186.70.92] (port=45662 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Okx6h-0003GX-Ky for emacs-orgmode@gnu.org; Mon, 16 Aug 2010 06:40:01 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Okx6X-000081-D6 for emacs-orgmode@gnu.org; Mon, 16 Aug 2010 06:39:55 -0400 Received: from u016822.science.uva.nl ([146.50.39.34]:52515 helo=carsten-dominiks-macbook-pro.local) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Okx6X-00007a-27 for emacs-orgmode@gnu.org; Mon, 16 Aug 2010 06:39:45 -0400 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Patch 219 (http://patchwork.newartisans.com/patch/219/) is now "Accepted". Maintainer comment: No comment This relates to the following submission: http://mid.gmane.org/%3C814oeyax0d.fsf%40gmail.com%3E Here is the original message containing the patch: > Content-Type: text/plain; charset="utf-8" > MIME-Version: 1.0 > Content-Transfer-Encoding: 7bit > Subject: [Orgmode] org.texi: Document quick insertion of empty structural > elements > Date: Sat, 14 Aug 2010 04:55:14 -0000 > From: Jambunathan K > X-Patchwork-Id: 219 > Message-Id: <814oeyax0d.fsf@gmail.com> > To: emacs-orgmode@gnu.org > > org.texi: Document quick insertion of empty structural elements > > Sources: > > 1. http://article.gmane.org/gmane.emacs.orgmode/6670/ > See section titled 'Completion of structure elements' > > 2. http://article.gmane.org/gmane.emacs.orgmode/18004/ > >From 540d8f2c03d300b6007c0d8595bb78ad172d8eac Mon Sep 17 00:00:00 2001 > From: Jambunathan K > Date: Sat, 14 Aug 2010 04:24:34 +0530 > Subject: [PATCH] org.texi: Document quick insertion of empty structural elements > > * org.texi (Easy Templates): New section. Documents quick insertion of empty > structural elements. > > TINYCHANGE > > --- > doc/org.texi | 49 ++++++++++++++++++++++++++++++++++++++++++++++++- > 1 files changed, 48 insertions(+), 1 deletions(-) > > diff --git a/doc/org.texi b/doc/org.texi > index ac52c70..508d2ce 100644 > --- a/doc/org.texi > +++ b/doc/org.texi > @@ -12320,6 +12320,7 @@ emacsclient \ > @chapter Miscellaneous > > @menu > +* Easy Templates:: Quick insertion of structural elements > * Completion:: M-TAB knows what you need > * Speed keys:: Electric commands at the beginning of a headline > * Code evaluation security:: Org mode files evaluate inline code > @@ -12331,8 +12332,54 @@ emacsclient \ > * Interaction:: Other Emacs packages > @end menu > > +@node Easy Templates, Completion, Miscellaneous, Miscellaneous > +@section Easy Templates > +@cindex insertion, of '#+begin_src #+end_src' > +@cindex insertion, of '#+begin_example #+end_example' > +@cindex insertion, of '#+begin_quote #+end_quote' > +@cindex insertion, of '#+begin_verse #+end_verse' > +@cindex insertion, of '#+begin_center #+end_center' > +@cindex insertion, of '#+begin_latex #+end_latex' > +@cindex insertion, of '#+latex:' > +@cindex insertion, of '#+begin_html #+end_html' > +@cindex insertion, of '#+html:' > +@cindex insertion, of '#+begin_ascii #+end_ascii' > +@cindex insertion, of '#+ascii:' > +@cindex insertion, of '#+include:' > + > +Org-mode supports insertion of empty structural elements (like #+BEGIN_SRC > +and #+END_SRC pairs) with just a few key strokes. This is achieved through a > +native template expansion mechanism. > + > +To insert a structural element, type a '<', followed by a template selector > +and TAB. Completion takes effect only when the above keystrokes are typed on > +a line by itself. > + > +Following template selectors are currently supported. > + > +@multitable @columnfractions 0.1 0.9 > +@item s @tab Insert '#+begin_src #+end_src' > +@item e @tab Insert '#+begin_example #+end_example' > +@item q @tab Insert '#+begin_quote #+end_quote' > +@item v @tab Insert '#+begin_verse #+end_verse' > +@item c @tab Insert '#+begin_center #+end_center' > +@item l @tab Insert '#+begin_latex #+end_latex' > +@item L @tab Insert '#+latex:' line > +@item h @tab Insert '#+begin_html #+end_html' > +@item H @tab Insert '#+html:' line > +@item a @tab Insert '#+begin_ascii #+end_ascii' > +@item A @tab Insert '#+ascii:' line > +@item i @tab Insert '#+include:' line > +@end multitable > + > +For example, on an empty line, typing " +into a complete EXAMPLE template. > + > +You can install additional templates by customizing the variable > +@code{org-structure-template-alist}. Refer docstring of the variable for > +additional details. > > -@node Completion, Speed keys, Miscellaneous, Miscellaneous > +@node Completion, Speed keys, Easy Templates, Miscellaneous > @section Completion > @cindex completion, of @TeX{} symbols > @cindex completion, of TODO keywords >