Re: Babel Forth

["Thomas S. Dye" <tsd@tsdye.online>]

Ihor Radchenko <yantar92@posteo.net> writes:

> "Thomas S. Dye" <tsd@tsdye.online> writes:
>
>> I pushed Forth documentation to the Worg repo,
>
> Thanks!
> I have 2 comments:
>
>> +Babel evaluates Forth code blocks in an inferior Forth 
>> process.
>> +You can start an inferior Forth process with =M-x run-forth=.
>
> Does it mean that users _must_ run M-x run-forth? Otherwise, I 
> am not
> sure why this paragraph is present.

Thanks!
Edited to indicate a running Forth instance is needed to evaluate 
Forth code blocks.

>> +#+begin_example
>> +,#+begin_src forth :exports both
>> +." Hello World!"
>> +,#+end_src
>> +#+end_example
>> +
>> +#+begin_src forth :exports both
>> +." Hello World!"
>
> This will export into 3! snippets. I feel that
> https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-forth.html
> is confusing. Maybe we just put both the code and result into 
> verbatim
> example, as in
> https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-shell.html

Matt did a great job on ob-doc-shell.

I kind of like the 3 (not 3! :) snippets because they show the Org 
mode buffer, the code export, and the results export.  I feel this 
illustrates a lot of Babel capability.

Nevertheless, the multiple snippets are potentially confusing, so 
I've followed Matt's lead and changed to a single example block.

Hopefully, some Forth programmers can help flesh out this 
documentation stub.

All the best,
Tom
-- 
Thomas S. Dye
https://tsdye.online/tsdye