From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nick Dokos Subject: Re: Fwd: Questions about org-element Date: Wed, 29 May 2019 23:43:35 -0400 Message-ID: <87y32oip3s.fsf@alphaville.usersys.redhat.com> References: <87ef4l599r.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([209.51.188.92]:37179) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hWByn-0006do-DW for emacs-orgmode@gnu.org; Wed, 29 May 2019 23:43:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hWBym-0002wG-8Y for emacs-orgmode@gnu.org; Wed, 29 May 2019 23:43:49 -0400 Received: from [195.159.176.226] (port=51756 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hWBym-0002uy-1W for emacs-orgmode@gnu.org; Wed, 29 May 2019 23:43:48 -0400 Received: from list by blaine.gmane.org with local (Exim 4.89) (envelope-from ) id 1hWByi-000ES1-4l for emacs-orgmode@gnu.org; Thu, 30 May 2019 05:43:44 +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" To: emacs-orgmode@gnu.org Ngor writes: > Hi Org community. > > I am re-posting my questions here according to Nicolas' recommendation. > > I am working on a standalone parser implementation for Org which is basically a translation of elisp program to Rust > https://github.com/org-rs/org-rs > > There are couple of things I wanted to ask about: > > 1) I have discovered several inconsistencies and errors in the Syntax/API documentation > https://orgmode.org/worg/dev/org-element-api.html vs https://orgmode.org/worg/dev/org-syntax.html vs elisp source > And I don't know the right way to report them. > > 2) I think I have found a bug in the algorithm (org-element-collect affiliated keywords does not take granularity into accound and seems to be always parsing objects in Caption > keyword) > > 3) I have a question regarding the elisp source source (specifically about the :parent of the parsed objects of the keyword) > > I can elaborate on each point but I don't want to overwhelm everybody with details right from the start. I guess the meta-question is where and how > should I discuss these points? - I never used mailing lists before (If I did something incorrectly or do not follow the established rituals/traditions please do not judge me harshly. > ) > No need for metaquestions: ask away. You might want to report related problems together, but if the connection is tenuous or non-existent, then separate posts to the mailing list will probably work better. Asking your question in a separate post is probably best, so it doesn't get lost in the forest of detail when reporting problems. If you suspect a bug, then use 'M-x org-submit-bug-report`: the bug report will end up here and will contain a lot of information about your set-up which might be helpful. Finally, be patient: do not expect answers (particularly when the questions are complicated, as it seems yours will be). It takes a while for people to get around to even reading the posts, let alone coming up with answers (or, as is likely, more quesions for you). And welcome to mailing lists in general and this mailing list in particular! -- Nick "There are only two hard problems in computer science: cache invalidation, naming things, and off-by-one errors." -Martin Fowler