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