ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add documentation for org-eval.el.

This commit is contained in:
Carsten Dominik 2008-05-06 11:37:51 +02:00
parent 6fdfd10c18
commit 62fc2c1083
1 changed files with 40 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
contrib/lisp/org-eval.el
View File

@ -1,10 +1,10 @@
;;; org-eval.el --- Display result of evaluating code in various languanges
;;; org-eval.el --- Display result of evaluating code in various languages
;; Copyright (C) 2008 Free Software Foundation, Inc.
;;
;; Author: Carsten Dominik <carsten at orgmode dot org>
;; Keywords: outlines, hypermedia, calendar, wp
;; Homepage: http://orgmode.org
;; Version: 0.03
;; Version: 0.04
;;
;; This file is not yet part of GNU Emacs.
;;
@ -27,10 +27,44 @@
;;; Commentary:
;;
;; This modules allows to include output from various commands into an
;; Org-mode buffer. This technique has been copied from Emacs-Muse, and
;; we try to make it work here in a way as simila as possible to
;; Muse.
;; Org-mode buffer, both for live display, and for export.
;; This technique has been copied from emacs-wiki and Emacs Muse, and
;; we try to make it work here in a way as similar as possible to
;; Muse, so that people who move between both worlds don't need to learn
;; new syntax.
;;
;; Basically it works like this:
;;
;; <lisp>(concat "aaa" "bbb")</lisp>
;;
;; will display "aaabbb" in the buffer and export like that as well.
;; The leading lisp tag will also accept the attributes "markup" and
;; "lang", to specify how the text should be formatted during export.
;; For example,
;;
;; <lisp markup="src" lang="emacs-lisp"> .... </lisp>
;;
;; will format the result of the lisp form as if it was lisp source
;; code. Internally, it will wrap the text into a
;;
;; #+begin_src emacs-lisp
;; #+end_src
;;
;; structure so that the right things happen when the exporter is running.
;;
;; By default, only the <lisp> tag is turned on, but you can configure
;; the variable `org-eval-interpreters' to add more interpreters like
;; `perl', `python', or the `shell'.
;;
;; Please note that this mechanism is potentially dangerous, because it
;; executes code that you don't even see. This gives you great power,
;; but also enough rope to hang yourself. And, it gives your friends
;; who send you Org files plenty of opportunity for good and bad jokes.
;; This is also why this module is not turned on by default, but only
;; available as a contributed package.
;;
;;
;;
(require 'org)
;;; Customization