[Top][All Lists]
[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
- [Orgmode] [PATCH] use @result{} instead of --> (looks nicer), Brian Gough, 2010/12/08
- [Orgmode] [PATCH] use macro for @LaTeX name, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] make use of the provided @ie and @eg macros to fix the spacing, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] fix commas that should be full stops, semicolons or emdashes, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] fix plain text that looks better with markup, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] use kbd font, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] improvements to wording style,
Brian Gough <=
- [Orgmode] [PATCH] include explanations of how to look up a docstring, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] use a full sentence, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] tangling is not a widely-known term, describe it as literate programming, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] make "time stamps" consistent with timestamps, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] make explanation of keyword lines clearer, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] use emdashes when needed, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] put emacs functions in code font, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] use code font for example footnote labels, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] fix missing word in math formatting section, Brian Gough, 2010/12/08
- [Orgmode] [PATCH] typo/grammar fix for .done CSS explanation, Brian Gough, 2010/12/08