From: Brian Gough <bjg@network-theory.co.uk>
To: emacs-orgmode@gnu.org
Cc: Barry Gidden <barryg@network-theory.co.uk>,
Brian Gough <bjg@network-theory.co.uk>
Subject: [PATCH] improvements to wording style
Date: Wed, 8 Dec 2010 21:05:29 +0000 [thread overview]
Message-ID: <1291842341-15199-7-git-send-email-bjg@network-theory.co.uk> (raw)
In-Reply-To: <1291842341-15199-6-git-send-email-bjg@network-theory.co.uk>
---
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
-@samp{N} 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 date@footnote{It 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.
-@Ie{} 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. @LaTeX{}@footnote{@LaTeX{}
+Plain ASCII is normally sufficient for almost all note taking. Exceptions include scientific notes, which often require mathematical symbols and the occasional formula. @LaTeX{}@footnote{@LaTeX{}
is a macro system based on Donald E. Knuth's @TeX{} system. Many of the
features described here as ``@LaTeX{}'' 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
directory@footnote{@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
-@code{org-structure-template-alist}. Refer docstring of the variable for
+@code{org-structure-template-alist}. See the docstring of the variable for
additional details.
@node Speed keys, Code evaluation security, Easy Templates, Miscellaneous
--
1.6.0.6
next prev parent reply other threads:[~2010-12-08 21:07 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-12-08 21:05 [PATCH] use @result{} instead of --> (looks nicer) Brian Gough
2010-12-08 21:05 ` [PATCH] use macro for @LaTeX name Brian Gough
2010-12-08 21:05 ` [PATCH] make use of the provided @ie and @eg macros to fix the spacing Brian Gough
2010-12-08 21:05 ` [PATCH] fix commas that should be full stops, semicolons or emdashes Brian Gough
2010-12-08 21:05 ` [PATCH] fix plain text that looks better with markup Brian Gough
2010-12-08 21:05 ` [PATCH] use kbd font Brian Gough
2010-12-08 21:05 ` Brian Gough [this message]
2010-12-08 21:05 ` [PATCH] include explanations of how to look up a docstring Brian Gough
2010-12-08 21:05 ` [PATCH] use a full sentence Brian Gough
2010-12-08 21:05 ` [PATCH] tangling is not a widely-known term, describe it as literate programming Brian Gough
2010-12-08 21:05 ` [PATCH] make "time stamps" consistent with timestamps Brian Gough
2010-12-08 21:05 ` [PATCH] make explanation of keyword lines clearer Brian Gough
2010-12-08 21:05 ` [PATCH] use emdashes when needed Brian Gough
2010-12-08 21:05 ` [PATCH] put emacs functions in code font Brian Gough
2010-12-08 21:05 ` [PATCH] use code font for example footnote labels Brian Gough
2010-12-08 21:05 ` [PATCH] fix missing word in math formatting section Brian Gough
2010-12-08 21:05 ` [PATCH] typo/grammar fix for .done CSS explanation Brian Gough
2010-12-08 21:05 ` [PATCH] explain how to check the default version of Org Brian Gough
2010-12-08 21:05 ` [PATCH] add index entries Brian Gough
2011-02-01 11:37 ` [Accepted] " Bastien Guerry
2011-02-01 11:36 ` [Accepted] explain how to check the default version of Org Bastien Guerry
2011-02-01 11:34 ` [Accepted] typo/grammar fix for .done CSS explanation Bastien Guerry
2011-02-01 11:33 ` [Accepted] use code font for example footnote labels Bastien Guerry
2011-02-01 11:32 ` [Accepted] put emacs functions in code font Bastien Guerry
2011-02-01 11:29 ` [Accepted] make "time stamps" consistent with timestamps Bastien Guerry
2010-12-09 17:38 ` [PATCH] include explanations of how to look up a docstring Giovanni Ridolfi
2011-01-26 17:33 ` [Accepted] use @result{} instead of --> (looks nicer) Bastien Guerry
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1291842341-15199-7-git-send-email-bjg@network-theory.co.uk \
--to=bjg@network-theory.co.uk \
--cc=barryg@network-theory.co.uk \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).