From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eric Abrahamsen Subject: Re: Org-element once again Date: Wed, 08 Oct 2014 10:44:07 +0800 Message-ID: <8761fvz3ew.fsf@ericabrahamsen.net> References: <87k34blbly.fsf@wmi.amu.edu.pl> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:56452) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XbhEr-0003v0-If for emacs-orgmode@gnu.org; Tue, 07 Oct 2014 22:44:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XbhEl-0003An-O7 for emacs-orgmode@gnu.org; Tue, 07 Oct 2014 22:44:29 -0400 Received: from plane.gmane.org ([80.91.229.3]:52394) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XbhEk-00038M-Hx for emacs-orgmode@gnu.org; Tue, 07 Oct 2014 22:44:23 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XbhEh-0006RD-Cz for emacs-orgmode@gnu.org; Wed, 08 Oct 2014 04:44:20 +0200 Received: from 125.77.224.30 ([125.77.224.30]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Oct 2014 04:44:19 +0200 Received: from eric by 125.77.224.30 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Oct 2014 04:44:19 +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 Marcin Borkowski writes: > Hi list, > > does there exist any place I could find the specs of the org-element > data structure? From what I can see, it is a list whose car is the type > of the element, then a (somewhat mysterious or me) plist follows, and > then the children. Where could I find more info? If the answer is > "read the source, Luke" ;-) , which functions should I start with? > > Best, Have you looked at this page? http://orgmode.org/worg/dev/org-element-api.html That and the pages linked from it seem to cover most of what's going on. The mysterious plist holds all the properties for a given element. Most are generated by the parsing process (eg :contents-begin and :contents-end, see the link above for all the different properties the various elements/objects might get), while headlines will also have their actual property-drawer properties put into the list. The only thing that remains a little opaque to me is the "section" element, which apparently gets wrapped around a heading's subtree. I don't know what it does, but it's never gotten in my way so I haven't worried about it. Hope that helps, Eric