# This file:
#   http://angg.twu.net/2021-org-for-non-users/2021-org-for-non-users.org.html
#   http://angg.twu.net/2021-org-for-non-users/2021-org-for-non-users.org
#           (find-angg "2021-org-for-non-users/2021-org-for-non-users.org")
# Author: Eduardo Ochs <eduardoochs@gmail.com>
# Version: 2021dec11
#
# See:
#   http://angg.twu.net/2021-org-for-non-users.html
#   http://angg.twu.net/#eev


























  Org for non-users
  Eduardo Ochs,
    2021dec11

    http://angg.twu.net/#eev






















  Long story short:

  • In 2021 I finally understood why I
    have always found Org Mode so hard to learn.

  • The documentation of Org is written for "users".
    I am a very bad "user" -
    I am a "non-user" =/

  • I can use eev to write the documentation
    that I need - creating lots of elisp hyperlinks -
    and this _MAY_ be useful to other non-users like me

  • eev lets you "take executable notes" -
    • save all commands sent to "shell-like programs"
    • "save elisp hyperlinks to everything interesting
       that you find"

      ^ Most people CAN'T IMAGINE how is the
        workflow of someone who does this -
        I'm working on making this easier to understand.
        See: (find-saving-links-intro)



















        user   ->   How do I use code blocks in Org?
                      -> key sequences
                      -> examples
                      -> does NOT want to see
                         the source code

    non-user   ->   How does Org handle code blocks?
                      -> data structures
                      -> source code
                      -> repeatable tests































# (require 'ob-shell)
# (setq org-confirm-babel-evaluate nil)

#+BEGIN_SRC sh
# Run:   (eek "C-c C-c")
#        (org-babel-execute-src-block)
#  See:  (eek "M-h M-k  C-c C-c  ;; org-ctrl-c-ctrl-c")
#        (find-efunctiondescr      'org-ctrl-c-ctrl-c)
#        (find-efunction           'org-ctrl-c-ctrl-c)
#        (find-efunction           'org-babel-execute-src-block)

# Clear the results: (org-babel-remove-result)
#  See:  (eek "M-h M-k  C-c C-v k  ;; org-babel-remove-result-one-or-many")
#        (find-efunctiondescr        'org-babel-remove-result-one-or-many)
#        (find-efunction             'org-babel-remove-result-one-or-many)

# Parse:                  (org-element-context)
#        (find-epp        (org-element-context))
#        (find-epp  (cadr (org-element-context)))
#        (find-eppp (cadr (org-element-context)))
#           (setq p (cadr (org-element-context)))
#        (find-elnode "Property Lists")
#           (plist-get p :begin)
#                                (plist-get p :end)
#  (eeflash (plist-get p :begin) (plist-get p :end))

seq 10 14

#+END_SRC





# (find-orgnode "Structure Templates")
# (eek "M-h M-k  C-c C-,  ;; org-insert-structure-template")
# (find-efunctiondescr      'org-insert-structure-template)
# (find-efunction           'org-insert-structure-template)
# (find-evardescr           'org-structure-template-alist)
# (find-evardescr           'org-structure-template-alist "src")
# (find-evariable           'org-structure-template-alist)
# (eek "C-c C-, s")

#+begin_src sh
cat > /tmp/foo <<'%%%'
bloc
%%%
#+end_src









# Local Variables:
# coding:  utf-8-unix
# End: