Re: Status of syntax specification

2020-05-19 Thread Gerry Agbobada
> It would need proof reading, and comparing with "org-element.el", the
> actual implementation of the syntax. Formalization may be better better,
> too.

I didn't know that there was a single point of entry to parse elements. I think 
my first step will be to try to write spec tests in elisp then. Hopefully I can 
cover most cases in the draft, and then see if org-element returns the tree 
that I expect for a cursor in various positions.

Spec tests should use ERT too right ? If I try to write those, I might as well 
make them in a suitable way for integration in org-mode codebase.

Thanks for the draft at least, it is a very helpful kickstart !


Gerry Agbobada

Re: Status of syntax specification

2020-05-18 Thread Nicolas Goaziou
Hello,

"Gerry Agbobada"  writes:

> I found on Worg a "draft" for org syntax description : 
> https://orgmode.org/worg/dev/org-syntax.html
>
> Do you think this paper marked as draft is good enough to use as
> a source to make a parser ?

It is "good enough", but possibly slightly inaccurate at some points.

It would need proof reading, and comparing with "org-element.el", the
actual implementation of the syntax. Formalization may be better better,
too.

> I think it'd be nice to try to finalize this ; but I don't know who to 
> contact to see how I can help
> if I know almost nothing about standards and technical writing.

Reading it and comparing with documentation might help.

Regards,

-- 
Nicolas Goaziou



Status of syntax specification

2020-05-17 Thread Gerry Agbobada
Hello,

I found on Worg a "draft" for org syntax description : 
https://orgmode.org/worg/dev/org-syntax.html

Do you think this paper marked as draft is good enough to use as a source to 
make a parser ?  
I think it'd be nice to try to finalize this ; but I don't know who to contact 
to see how I can help
 if I know almost nothing about standards and technical writing.


Best regards,
Gerry Agbobada