summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarsten Dominik <carsten.dominik@gmail.com>2013-10-01 05:28:27 +0200
committerCarsten Dominik <carsten.dominik@gmail.com>2013-10-01 05:28:27 +0200
commite0dd999a7b3cacf33f95a7da31f8d1b926ee610d (patch)
tree41852e97287ad7e10101fbdf918f2a5ee8536885
parent31d1f2b69da6d8c9096e9961e21e7b3a65a9be79 (diff)
downloadorg-mode-e0dd999a7b3cacf33f95a7da31f8d1b926ee610d.tar.gz
Manual: Improvements to summary by Thomas Dye
-rw-r--r--doc/org.texi18
1 files changed, 9 insertions, 9 deletions
diff --git a/doc/org.texi b/doc/org.texi
index bfbc43c..0271d70 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -798,10 +798,9 @@ MobileOrg
@section Summary
@cindex summary
-Org is a mode for keeping notes, maintaining TODO lists, and doing project
-planning with a fast and effective plain-text system. It also is an
-authoring system with unique support for literal programming and reproducible
-research.
+Org is a mode for keeping notes, maintaining TODO lists, and project planning
+with a fast and effective plain-text system. It also is an authoring system
+with unique support for literate programming and reproducible research.
Org is implemented on top of Outline mode, which makes it possible to keep
the content of large files well structured. Visibility cycling and structure
@@ -819,12 +818,13 @@ Allen's GTD system.
Org files can serve as a single source authoring system with export to many
different formats such as HTML, @LaTeX{}, Open Document, and Markdown. New
-export backends be derived from existing ones, or defined from scratch.
+export backends can be derived from existing ones, or defined from scratch.
-Org mode supports working with embedded source code blocks in a file, which
-makes it uniquely suited for authoring technical documents with code
-examples. It facilitates code evaluation, capturing code output into the
-document, documentation, and literate programming techniques.
+Org files can include source code blocks, which makes Org uniquely suited for
+authoring technical documents with code examples. Org source code blocks are
+fully functional; they can be evaluated in place and their results can be
+captured in the file. This makes it possible to create a single file
+reproducible research compendium.
Org keeps simple things simple. When first fired up, it should feel like a
straightforward, easy to use outliner. Complexity is not imposed, but a