Browse Source

Merge branch 'master' into tangle

Eric Schulte 16 years ago
parent
commit
aad03ff615
1 changed files with 22 additions and 3 deletions
  1. 22 3
      org-babel.org

+ 22 - 3
org-babel.org

@@ -3,6 +3,25 @@
 #+OPTIONS: H:3 num:nil toc:t
 #+OPTIONS: H:3 num:nil toc:t
 #+STARTUP: oddeven hideblocks
 #+STARTUP: oddeven hideblocks
 
 
+Through Org-Babel Org-Mode can communicate with programming languages.
+Code contained in source-code blocks can be evaluated passing and
+receiving data to and from org-mode files, tables, other source-code
+blocks, and interactive comint buffers.
+
+In this document:
+- The [[* Introduction][Introduction]] :: provides a brief overview of the design and use
+     of Org-Babel including tutorials and examples.
+- The [[* Tasks][Tasks]] :: section contains current and past tasks roughly ordered
+     by TODO state, then importance or date-completed.  This would be
+     a good place to suggest ideas for development.
+- The [[* Bugs][Bugs]] :: section contains bug reports.
+- The [[* Tests][Tests]] :: section consists of a large table which can be
+     evaluated to run Org-Babel's functional test suite.  This
+     provides a good overview of the current functionality with
+     pointers to example source blocks.
+- The [[* Sandbox][Sandbox]] :: demonstrates much of the early/basic functionality
+     through commented source-code blocks.
+
 * Introduction
 * Introduction
 
 
 Org-Babel enables *communication* between programming languages and
 Org-Babel enables *communication* between programming languages and
@@ -24,10 +43,8 @@ and outputs.
 *** simple execution
 *** simple execution
 with both scalar, file, and table output
 with both scalar, file, and table output
 
 
-
 *** reading information from tables
 *** reading information from tables
 
 
-
 *** reading information from other source blocks (disk usage in your home directory)
 *** reading information from other source blocks (disk usage in your home directory)
 
 
 This will work for Linux and Mac users, not so sure about shell
 This will work for Linux and Mac users, not so sure about shell
@@ -62,7 +79,6 @@ cd ~ && du -sc * |grep -v total
 pie(dirs[,1], labels = dirs[,2])
 pie(dirs[,1], labels = dirs[,2])
 #+end_src
 #+end_src
 
 
-
 *** operations in/on tables
 *** operations in/on tables
 
 
 #+tblname: grades-table
 #+tblname: grades-table
@@ -113,6 +129,9 @@ org-babels own functional tests are contained in a large org-mode
 table, allowing the test suite to be run be evaluation of the table
 table, allowing the test suite to be run be evaluation of the table
 and the results to be collected in the same table.
 and the results to be collected in the same table.
 
 
+*** Emacs initialization files stored in Org-Mode buffers
+Once org-babel-tangle is completed this could be a very compelling use case.
+
 
 
 ** features
 ** features