From mboxrd@z Thu Jan 1 00:00:00 1970 From: Thorsten Jolitz Subject: Re: Classification of Org mode elements Date: Mon, 17 Jun 2013 08:34:58 +0200 Message-ID: <87hagxw8h9.fsf@gmail.com> References: Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:35383) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UoT25-0002A4-2y for emacs-orgmode@gnu.org; Mon, 17 Jun 2013 02:35:18 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UoT23-00009O-P3 for emacs-orgmode@gnu.org; Mon, 17 Jun 2013 02:35:17 -0400 Received: from plane.gmane.org ([80.91.229.3]:37744) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UoT23-00009G-FR for emacs-orgmode@gnu.org; Mon, 17 Jun 2013 02:35:15 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1UoT20-0003H1-GQ for emacs-orgmode@gnu.org; Mon, 17 Jun 2013 08:35:12 +0200 Received: from g231104022.adsl.alicedsl.de ([92.231.104.22]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 17 Jun 2013 08:35:12 +0200 Received: from tjolitz by g231104022.adsl.alicedsl.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 17 Jun 2013 08:35:12 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org --=-=-= Content-Type: text/plain tsd@tsdye.com (Thomas S. Dye) writes: Hi Thomas, > The attached Org mode document contains some notes on the classification > of Org mode elements that might be a useful addition to Nicolas > Goaziou's draft Org syntax document > (http://orgmode.org/worg/dev/org-syntax.org). > > It distinguishes nine classes of element and proposes names for them. I really like the idea to make Nicolas decisions when modelling Org syntax more explicit and write them down as a quick reference overview. I compressed your table a bit to make it fit on a screen/page, and added a subtree for each element to the file that could contain a short (man-page like) descripton of syntax and semantics of that element (see my attempts for 'Property drawer' as an example). This should not compete with the manual or the cheat sheet, but rather serve as a minimal overview of the Org 8+ syntax elements. Right now I don't have the time to fill the other subtrees, but I might add to this the next days, maybe others can add to it too and then this file can be uploaded to Worg? --=-=-= Content-Type: application/vnd.lotus-organizer Content-Disposition: attachment; filename=org-mode-synatx-table.org Content-Transfer-Encoding: base64 KiBFbGVtZW50IFRhYmxlCgojK25hbWU6IGVsZW1lbnQtdGFibGUKfCBFbGVtZW50ICAgICAgICAg ICAgIHwgZz8gfCByPyB8IGE/IHwgZG8/IHwgQyB8IE4gIHwgcE4gICB8CnwtLS0tLS0tLS0tLS0t LS0tLS0tLS0rLS0tLSstLS0tKy0tLS0rLS0tLS0rLS0tKy0tLS0rLS0tLS0tfAp8IERyYXdlciAg ICAgICAgICAgICAgfCBYICB8ICAgIHwgWCAgfCAgICAgfCAxIHwgR0UgfCBHRSAgIHwKfCBEeW5h bWljIGJsb2NrICAgICAgIHwgWCAgfCAgICB8IFggIHwgICAgIHwgMSB8IEdFIHwgR0UgICB8Cnwg Rm9vdG5vdGUgZGVmaW5pdGlvbiB8IFggIHwgICAgfCBYICB8ICAgICB8IDEgfCBHRSB8IEdFICAg fAp8IEdyZWF0ZXIgYmxvY2sgICAgICAgfCBYICB8ICAgIHwgWCAgfCAgICAgfCAxIHwgR0UgfCBH RSAgIHwKfCBQbGFpbiBsaXN0ICAgICAgICAgIHwgWCAgfCAgICB8IFggIHwgICAgIHwgMSB8IEdF IHwgR0UgICB8CnwgVGFibGUgICAgICAgICAgICAgICB8IFggIHwgICAgfCBYICB8ICAgICB8IDEg fCBHRSB8IEdFICAgfAp8LS0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0rLS0tLSstLS0tKy0tLS0t Ky0tLSstLS0tKy0tLS0tLXwKfCBJbmxpbmUgdGFzayAgICAgICAgIHwgWCAgfCAgICB8ICAgIHwg ICAgIHwgMiB8IEdFIHwgSVQgICB8CnwtLS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0tLSstLS0tKy0t LS0rLS0tLS0rLS0tKy0tLS0rLS0tLS0tfAp8IFByb3BlcnR5IGRyYXdlciAgICAgfCBYICB8IFgg IHwgWCAgfCAgICAgfCAzIHwgR0UgfCBQRCAgIHwKfC0tLS0tLS0tLS0tLS0tLS0tLS0tLSstLS0t Ky0tLS0rLS0tLSstLS0tLSstLS0rLS0tLSstLS0tLS18CnwgSXRlbSAgICAgICAgICAgICAgICB8 IFggIHwgWCAgfCAgICB8ICAgICB8IDQgfCBHRSB8IExJICAgfAp8LS0tLS0tLS0tLS0tLS0tLS0t LS0tKy0tLS0rLS0tLSstLS0tKy0tLS0tKy0tLSstLS0tKy0tLS0tLXwKfCBCYWJlbCBjYWxsICAg ICAgICAgIHwgICAgfCAgICB8IFggIHwgICAgIHwgNSB8IEUgIHwgTEUgICB8CnwgQ29tbWVudCAg ICAgICAgICAgICB8ICAgIHwgICAgfCBYICB8ICAgICB8IDUgfCBFICB8IExFICAgfAp8IENvbW1l bnQgYmxvY2sgICAgICAgfCAgICB8ICAgIHwgWCAgfCAgICAgfCA1IHwgRSAgfCBMRSAgIHwKfCBE aWFyeSAgICAgICAgICAgICAgIHwgICAgfCAgICB8IFggIHwgICAgIHwgNSB8IEUgIHwgTEUgICB8 CnwgRXhhbXBsZSBibG9jayAgICAgICB8ICAgIHwgICAgfCBYICB8ICAgICB8IDUgfCBFICB8IExF ICAgfAp8IEZpeGVkIHdpZHRoIGFyZWEgICAgfCAgICB8ICAgIHwgWCAgfCAgICAgfCA1IHwgRSAg fCBMRSAgIHwKfCBIb3Jpem9udGFsIHJ1bGUgICAgIHwgICAgfCAgICB8IFggIHwgICAgIHwgNSB8 IEUgIHwgTEUgICB8CnwgS2V5d29yZCAgICAgICAgICAgICB8ICAgIHwgICAgfCBYICB8ICAgICB8 IDUgfCBFICB8IExFICAgfAp8IExhVGVYIGVudmlyb25tZW50ICAgfCAgICB8ICAgIHwgWCAgfCAg ICAgfCA1IHwgRSAgfCBMRSAgIHwKfCBTZXhwICAgICAgICAgICAgICAgIHwgICAgfCAgICB8IFgg IHwgICAgIHwgNSB8IEUgIHwgTEUgICB8CnwgU291cmNlIGJsb2NrICAgICAgICB8ICAgIHwgICAg fCBYICB8ICAgICB8IDUgfCBFICB8IExFICAgfAp8LS0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0r LS0tLSstLS0tKy0tLS0tKy0tLSstLS0tKy0tLS0tLXwKfCBQYXJhZ3JhcGggICAgICAgICAgIHwg ICAgfCAgICB8IFggIHwgWCAgIHwgNiB8IEUgIHwgZG9MRSB8CnwgVmVyc2UgYmxvY2sgICAgICAg ICB8ICAgIHwgICAgfCBYICB8IFggICB8IDYgfCBFICB8IGRvTEUgfAp8LS0tLS0tLS0tLS0tLS0t LS0tLS0tKy0tLS0rLS0tLSstLS0tKy0tLS0tKy0tLSstLS0tKy0tLS0tLXwKfCBDbG9jayAgICAg ICAgICAgICAgIHwgICAgfCAgICB8ICAgIHwgICAgIHwgNyB8IEUgIHwgdUxFICB8CnwgUGxhbm5p bmcgKFBsYW4/KSAgICB8ICAgIHwgICAgfCAgICB8ICAgICB8IDcgfCBFICB8IHVMRSAgfAp8LS0t LS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0rLS0tLSstLS0tKy0tLS0tKy0tLSstLS0tKy0tLS0tLXwK fCBOb2RlIHByb3BlcnR5ICAgICAgIHwgICAgfCBYICB8ICAgIHwgICAgIHwgOCB8IEUgIHwgTlAg ICB8CnwtLS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0tLSstLS0tKy0tLS0rLS0tLS0rLS0tKy0tLS0r LS0tLS0tfAp8IFRhYmxlIHJvdyAgICAgICAgICAgfCAgICB8IFggIHwgICAgfCBYICAgfCA5IHwg RSAgfCBUUiAgIHwKCgojK25hbWU6IGVsZW1lbnQtdGFibGUtYWJicmV2cwp8IGFiYnJldiB8IG1l YW5pbmcgICAgICAgICAgICAgICAgICAgICAgIHwKfC0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS18CnwgZz8gICAgIHwgR3JlYXRlciAgICAgICAgICAgICAgICAgICAgICAg fAp8IHI/ICAgICB8IFJlc3RyaWN0ZWQgICAgICAgICAgICAgICAgICAgIHwKfCBhPyAgICAgfCBB dHRyaWJ1dGFibGUgICAgICAgICAgICAgICAgICB8CnwgZG8/ICAgIHwgRGlyZWN0IE9iamVjdCAg ICAgICAgICAgICAgICAgfAp8IEMgICAgICB8IENsYXNzICAgICAgICAgICAgICAgICAgICAgICAg IHwKfCBOICAgICAgfCAob3JpZ2luYWwpIE5hbWUgICAgICAgICAgICAgICB8CnwgcE4gICAgIHwg KHByb3Bvc2VkKSBOYW1lICAgICAgICAgICAgICAgfAp8IEdFICAgICB8IEdyZWF0ZXIgZWxlbWVu dCAgICAgICAgICAgICAgIHwKfCBFICAgICAgfCBFbGVtZW50ICAgICAgICAgICAgICAgICAgICAg ICB8CnwgTEUgICAgIHwgTGVzc2VyIGVsZW1lbnQgICAgICAgICAgICAgICAgfAp8IHVMRSAgICB8 IFVuYXR0cmlidXRhYmxlIGxlc3NlciBlbGVtZW50IHwKfCBkb0xFICAgfCBEaXJlY3Qgb2JqZWN0 IGxlc3NlciBlbGVtZW50ICB8CnwgSVQgICAgIHwgSW5saW5lIHRhc2sgICAgICAgICAgICAgICAg ICAgfAp8IFBEICAgICB8IFByb3BlcnR5IGRyYXdlciAgICAgICAgICAgICAgIHwKfCBMSSAgICAg fCBMaXN0IGl0ZW0gICAgICAgICAgICAgICAgICAgICB8CnwgTlAgICAgIHwgTm9kZSBwcm9wZXJ0 eSAgICAgICAgICAgICAgICAgfAoKKiBFbGVtZW50cwoqKiBEcmF3ZXIKKiogRHluYW1pYyBibG9j awoqKiBGb290bm90ZSBkZWZpbml0aW9uCioqIEdyZWF0ZXIgYmxvY2sKKiogUGxhaW4gbGlzdAoq KiBUYWJsZQoqKiBJbmxpbmUgdGFzawoqKiBQcm9wZXJ0eSBkcmF3ZXIKKioqIFN5bnRheAoKIytu YW1lOnByb3BlcnR5LWRyYXdlci1leGFtcGxlCiMrYmVnaW5fc3JjIG9yZwogICAgOlBST1BFUlRJ RVM6CiAgICA6Q0FURUdPUlk6IG9mZmljZQogICAgOkVORDoKIytlbmRfc3JjCgojK25hbWU6cHJv cGVydHktZHJhd2VyLXJlZ2V4cAojK2JlZ2luX3NyYyBlbWFjcy1saXNwCiJeWyBcdF0qOlBST1BF UlRJRVM6WyBcdF0qJCIKIytlbmRfc3JjCgoqKiogU2VtYW50aWNzCgpTdG9yZSBtZXRhLWRhdGEg YW5kIGltcGxlbWVudCBzaW1wbGUgZGF0YWJhc2VzCgoqKiogSW5zZXJ0aW9uCgpNLXggb3JnLWlu c2VydC1wcm9wZXJ0eS1kcmF3ZXIKCiMrbmFtZTogcHJvcGVydHktZHJhd2Vycy1pbnNlcnRpb24t a2V5cwp8IGtleXMgICAgICB8IGFjdGlvbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgIHwKfC0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS18CnwgTS1UQUIgICAgIHwgQWZ0ZXIgaW5pdGlh bCBjb2xvbiBpbiBhIGxpbmUsIGNvbWxldGUgcHJvcGVydHkga2V5cyAgfAp8IEMtYyBDLXggcCB8 IFNldCBhIHByb3BlcnR5IChpZiBuZWNlc3NhcnksIGNyZWF0ZSBwcm9wZXJ0eSBkcmF3ZXIpIHwK CioqKiBFeHBvcnQKIytuYW1lOiBwcm9wZXJ0eS1kcmF3ZXJzLWV4cG9ydC1iYWNrZW5kcwp8IGJh Y2tlbmQgfCBleHBvcnRzIHRvIHwKfC0tLS0tLS0tLSstLS0tLS0tLS0tLS18CnwgYXNjaWkgICB8 IC0tLSAgICAgICAgfAp8IGxhdGV4ICAgfCAgICAgICAgICAgIHwKfCBodG1sICAgIHwgICAgICAg ICAgICB8CnwgICAgICAgICB8ICAgICAgICAgICAgfAoKKiogSXRlbQoqKiBCYWJlbCBjYWxsCioq IENvbW1lbnQKKiogQ29tbWVudCBibG9jawoqKiBEaWFyeQoqKiBFeGFtcGxlIGJsb2NrCioqIEZp eGVkIHdpZHRoIGFyZWEKKiogSG9yaXpvbnRhbCBydWxlCioqIEtleXdvcmQKKiogTGFUZVggZW52 aXJvbm1lbnQKKiogU2V4cAoqKiBTb3VyY2UgYmxvY2sKKiogUGFyYWdyYXBoCioqIFZlcnNlIGJs b2NrCioqIENsb2NrCioqIFBsYW5uaW5nIChQbGFuPykKKiogTm9kZSBwcm9wZXJ0eQoqKiBUYWJs ZSByb3cK --=-=-= Content-Type: text/plain -- cheers, Thorsten --=-=-=--