emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* What is Babel's language model?
@ 2014-07-23 14:09 Grant Rettke
  2014-07-28  9:18 ` Bastien
  0 siblings, 1 reply; 2+ messages in thread
From: Grant Rettke @ 2014-07-23 14:09 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

Good morning,

Whenever I learn a new programming language, I want to start by learning
about it's language model. The language model explains, among other
things, the order of evaluation, eagerness of evaluation, scope, and
binding approach. For example the Racket programming language has their
documentation here [1].

When I started learning `babel', I viewed it only as a means to and end,
the end being literate programming. Consequently, I just identified
goals and then either found a way to do it myself or had the kind and
generous `org-mode' users here explain the right way to do it. Please
don't take my laziness in learning as a mark of disrespect to `babel' or
to the community. The thing is that I failed to internalize literate
programming when I failed to view `babel' as a programming
language. Despite having read this [2] quite informative paper, I still
kind of missed the point. Now, I think that I get that I missed the
point, and here is how: when I read through [org-scraps], I still get
surprised and confused.

`org-scraps' is great. I understand 10% of it and have a lot to
learn. It never occurred to me that we may utilize the data structures
that define the document itself. That is so /lispy/. Looking at how one
may easily utilize souce code to assemble the very document in which it
is defined is really, really great. When I play with it though, I get it
wrong. My language model in my head is wrong, clearly.

My goal, then, is to develop a correct language model for `babel'.

My questions are:
• What is the best possible way to approach this goal?
• How have other `babelers' been documenting their pursuit of that goal?

Some thoughts on the goal:
• Thinking of a typical LISP language learning approach of evalutaion
  and binding review and study
  • `org-scraps' does this already, I just don't understand it
• Thinking of a flow chart of how things are processed between
  • The document
  • The meta-language in which `babel' itself runs via emacs-lisp
  • The guest languages managed and data-brokered with `babel'
• Target audience would be `babel' users but not implementers
  • Wouldn't need to dig into the source or `babel'
    • Or is that the best approach?
  • Measure of success would be to have people be productive without
    using up the time and resources of the `babel' maintainers
  • Perhaps users who want to understand the language model would need
    to also learn [org-element] just as one would understand how to
    parse/implement a LISP interpreter in LISP?

Looking for comments, questions, and concerns about this goal.

Kind regards,

gcr


[org-scraps]
https://raw.githubusercontent.com/eschulte/org-scraps/master/scraps.org

[org-element]
http://orgmode.org/w/?p=org-mode.git;a=blob;f=lisp/org-element.el;h=352482ef825fa495fd4e0daa7f6f236a442d2b01;hb=0be96db56e0ab973463376997fe1198a28d89e5b



Footnotes
─────────

[1] [http://docs.racket-lang.org/reference/model.html]

[2] [http://www.jstatsoft.org/v46/i03]

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: What is Babel's language model?
  2014-07-23 14:09 What is Babel's language model? Grant Rettke
@ 2014-07-28  9:18 ` Bastien
  0 siblings, 0 replies; 2+ messages in thread
From: Bastien @ 2014-07-28  9:18 UTC (permalink / raw)
  To: Grant Rettke; +Cc: emacs-orgmode@gnu.org

Hi Grant,

my suggestion is to start with a verbose report of your own
understanding and exploration of Babel, then to refine it so
that it can look like a "langage model" (whatever that means.)

Anything that takes the users and the developers by the hand
would be... handy :)

2 cts of course,

-- 
 Bastien

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2014-07-28 17:25 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-07-23 14:09 What is Babel's language model? Grant Rettke
2014-07-28  9:18 ` Bastien

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).