emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Orgmode] [PATCH] improvements to wording style


From: Brian Gough
Subject: [Orgmode] [PATCH] improvements to wording style
Date: Wed, 8 Dec 2010 21:05:29 +0000

---
 doc/org.texi |   26 ++++++++++----------------
 1 files changed, 10 insertions(+), 16 deletions(-)

diff --git a/doc/org.texi b/doc/org.texi
index d1a00c2..b9ff083 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -1854,8 +1854,7 @@ item.
 @cindex editing tables
 
 Org comes with a fast and intuitive table editor.  Spreadsheet-like
-calculations are supported in connection with the Emacs @file{calc}
-package
+calculations are supported using the Emacs @file{calc} package
 @ifinfo
 (@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual}).
 @end ifinfo
@@ -2116,7 +2115,7 @@ will then set the width of this column to this value.
 
 @noindent
 Fields that are wider become clipped and end in the string @samp{=>}.
-Note that the full text is still in the buffer, it is only invisible.
+Note that the full text is still in the buffer but is hidden.
 To see the full text, hold the mouse over the field---a tool-tip window
 will show the full content.  To edit such a field, use the command
 @kbd{C-c `} (that is @kbd{C-c} followed by the backquote).  This will
@@ -2499,8 +2498,7 @@ interpolated as Lisp numbers, without quotes.  If you 
provide the
 I.e., if you want a reference to be interpreted as a string by the Lisp
 form, enclose the reference operator itself in double-quotes, like
 @code{"$3"}.  Ranges are inserted as space-separated fields, so you can
-embed them in list or vector syntax.  A few examples, note how the
address@hidden mode is used when we do computations in Lisp.
+embed them in list or vector syntax.  Here are a few examples---note how the 
@samp{N} mode is used when we do computations in Lisp:
 
 @example
 @r{Swap the first two characters of the content of column 1}
@@ -2524,7 +2522,7 @@ evaluated, and the current field replaced with the result.
 
 @cindex #+TBLFM
 Formulas are stored in a special line starting with @samp{#+TBLFM:}
-directly below the table.  If you typed the equation in the 4th field of
+directly below the table.  If you type the equation in the 4th field of
 the 3rd data line in the table, the formula will look like
 @samp{@@3$4=$1+$2}.  When inserting/deleting/swapping column and rows
 with the appropriate commands, @i{absolute references} (but not relative
@@ -5482,8 +5480,7 @@ The headline will be listed under the given 
address@hidden will still
 be listed on that date after it has been marked DONE.  If you don't like
 this, set the variable @code{org-agenda-skip-scheduled-if-done}.}.  In
 addition, a reminder that the scheduled date has passed will be present
-in the compilation for @emph{today}, until the entry is marked DONE.
address@hidden the task will automatically be forwarded until completed.
+in the compilation for @emph{today}, until the entry is marked DONE, @ie{} the 
task will automatically be forwarded until completed.
 
 @example
 *** TODO Call Trillian for a date on New Years Eve.
@@ -5628,7 +5625,7 @@ forgot to call your father for 3 weeks, it does not make 
sense to call
 him 3 times in a single day to make up for it.  Finally, there are tasks
 like changing batteries which should always repeat a certain time
 @i{after} the last time you did it.  For these tasks, Org-mode has
-special repeaters markers with @samp{++} and @samp{.+}.  For example:
+special repeaters  @samp{++} and @samp{.+}.  For example:
 
 @example
 ** TODO Call Father
@@ -8923,9 +8920,7 @@ construct complex HTML code.
 @cindex @TeX{} interpretation
 @cindex @LaTeX{} interpretation
 
-Plain ASCII is normally sufficient for almost all note taking.  One
-exception, however, are scientific notes which need to be able to contain
-mathematical symbols and the occasional formula.  @address@hidden@LaTeX{}
+Plain ASCII is normally sufficient for almost all note taking.  Exceptions 
include scientific notes, which often require mathematical symbols and the 
occasional formula.  @address@hidden@LaTeX{}
 is a macro system based on Donald E. Knuth's @TeX{} system.  Many of the
 features described here as address@hidden'' are really from @TeX{}, but for
 simplicity I am blurring this distinction.}  is widely used to typeset
@@ -9743,7 +9738,7 @@ inclusion of these defaults off, customize
 @code{org-export-html-style-include-default}}.  You may overwrite these
 settings, or add to them by using the variables @code{org-export-html-style}
 (for Org-wide settings) and @code{org-export-html-style-extra} (for more
-granular settings, like file-local settings).  To set the latter variable
+fine-grained settings, like file-local settings).  To set the latter variable
 individually for each file, you can use
 
 @cindex #+STYLE
@@ -10717,8 +10712,7 @@ produce @file{file.org} and @file{file.org.html} in the 
publishing
 address@hidden@file{file-source.org} and @file{file-source.org.html} if
 source and publishing directories are equal.  Note that with this kind of
 setup, you need to add @code{:exclude "-source\\.org"} to the project
-definition in @code{org-publish-project-alist} to avoid that the published
-source files will be considered as new org files the next time the project is
+definition in @code{org-publish-project-alist} to prevent the published source 
files from being considered as new org files the next time the project is
 published.}.  Other files like images only need to be copied to the
 publishing destination; for this you may use @code{org-publish-attachment}.
 For non-Org files, you always need to specify the publishing function:
@@ -12595,7 +12589,7 @@ For example, on an empty line, typing "<e" and then 
pressing TAB, will expand
 into a complete EXAMPLE template.
 
 You can install additional templates by customizing the variable
address@hidden Refer docstring of the variable for
address@hidden See the docstring of the variable for
 additional details.
 
 @node Speed keys, Code evaluation security, Easy Templates, Miscellaneous
-- 
1.6.0.6




reply via email to

[Prev in Thread] Current Thread [Next in Thread]