浏览代码

Create texinfo node structures for new chapter

Dan Davison 15 年之前
父节点
当前提交
58c3358a0e
共有 2 个文件被更改,包括 28 次插入2 次删除
  1. 3 2
      doc/org.texi
  2. 25 0
      doc/source-code-chapter.texi

+ 3 - 2
doc/org.texi

@@ -107,6 +107,7 @@ license to the document, as described in section 6 of the license.
 * Markup::                      Prepare text for rich export
 * Markup::                      Prepare text for rich export
 * Exporting::                   Sharing and publishing of notes
 * Exporting::                   Sharing and publishing of notes
 * Publishing::                  Create a web site of linked Org files
 * Publishing::                  Create a web site of linked Org files
+* Working With Source Code::    Using Org for literate programming, reproducible research and code evaluation.
 * Miscellaneous::               All the rest which did not fit elsewhere
 * Miscellaneous::               All the rest which did not fit elsewhere
 * Hacking::                     How to hack your way around
 * Hacking::                     How to hack your way around
 * MobileOrg::                   Viewing and capture on a mobile device
 * MobileOrg::                   Viewing and capture on a mobile device
@@ -10118,7 +10119,7 @@ and the description from the body (limited to
 How this calendar is best read and updated, depends on the application
 How this calendar is best read and updated, depends on the application
 you are using.  The FAQ covers this issue.
 you are using.  The FAQ covers this issue.
 
 
-@node Publishing, Miscellaneous, Exporting, Top
+@node Publishing, Working With Source Code, Exporting, Top
 @chapter Publishing
 @chapter Publishing
 @cindex publishing
 @cindex publishing
 @cindex O'Toole, David
 @cindex O'Toole, David
@@ -10619,7 +10620,7 @@ This may be necessary in particular if files include other files via
 
 
 @include source-code-chapter.texi
 @include source-code-chapter.texi
 
 
-@node Miscellaneous, Hacking, Publishing, Top
+@node Miscellaneous, Hacking, Working With Source Code, Top
 @chapter Miscellaneous
 @chapter Miscellaneous
 
 
 @menu
 @menu

+ 25 - 0
doc/source-code-chapter.texi

@@ -1,3 +1,6 @@
+@node Working With Source Code, Miscellaneous, Publishing, Top
+@comment  node-name,  next,  previous,  up
+@comment Working With Source Code, Miscellaneous, Publishing, Top
 @chapter ``Working With Source Code'' or ``Embedded Source Code''
 @chapter ``Working With Source Code'' or ``Embedded Source Code''
 
 
 Source code can be included in Org-mode documents using a @samp{src} block:
 Source code can be included in Org-mode documents using a @samp{src} block:
@@ -25,8 +28,18 @@ Code execution, with results captured in the Org buffer (@ref{Evaluating Code Bl
 Using code blocks in table formulas
 Using code blocks in table formulas
 @end itemize
 @end itemize
 
 
+@menu
+* Structure of Code Blocks::
+* Editing Source Code::         
+* Exporting Code Blocks::       
+* Extracting Source Code::      
+* Evaluating Code Blocks::      
+@end menu
 
 
 
 
+@node Structure of Code Blocks, Editing Source Code, Working With Source Code, Working With Source Code
+@comment  node-name,  next,  previous,  up
+@comment  Structure of Code Blocks, Editing Source Code, Working With Source Code, Working With Source Code
 @section Structure of Code Blocks
 @section Structure of Code Blocks
 
 
 The basic structure of code blocks is as follows:
 The basic structure of code blocks is as follows:
@@ -52,6 +65,9 @@ FIXME link/relocate switches discussion in ``Literal examples'' section
 The code
 The code
 @end table
 @end table
 
 
+@node Editing Source Code, Exporting Code Blocks, Structure of Code Blocks, Working With Source Code
+@comment  node-name,  next,  previous,  up
+@comment  Editing Source Code, Exporting Code Blocks, Structure of Code Blocks, Working With Source Code
 @section Editing Source Code
 @section Editing Source Code
 
 
 Use @kbd{C-c '} to edit the code block at point. This brings up a
 Use @kbd{C-c '} to edit the code block at point. This brings up a
@@ -80,10 +96,19 @@ By default, Org will ask before returning to an open edit buffer. Set
 to a non-nil value to switch without asking.
 to a non-nil value to switch without asking.
 @end table
 @end table
 
 
+@node Exporting Code Blocks, Extracting Source Code, Editing Source Code, Working With Source Code
+@comment  node-name,  next,  previous,  up
+@comment  Exporting Code Blocks, Extracting Source Code, Editing Source Code, Working With Source Code
 @section Exporting Code Blocks
 @section Exporting Code Blocks
 
 
+@node Extracting Source Code, Evaluating Code Blocks, Exporting Code Blocks, Working With Source Code
+@comment  node-name,  next,  previous,  up
+@comment  Extracting Source Code, Evaluating Code Blocks, Exporting Code Blocks, Working With Source Code
 @section Extracting Source Code
 @section Extracting Source Code
 
 
+@node Evaluating Code Blocks,  , Extracting Source Code, Working With Source Code
+@comment  node-name,  next,  previous,  up
+@comment  Evaluating Code Blocks,  , Extracting Source Code, Working With Source Code
 @section Evaluating Code Blocks
 @section Evaluating Code Blocks
 
 
 This syntax can be expanded by naming the source code block.
 This syntax can be expanded by naming the source code block.