Ihor Radchenko <yanta...@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

Reply via email to