From mboxrd@z Thu Jan 1 00:00:00 1970 From: Brian Gough Subject: [PATCH] improvements to wording style Date: Wed, 8 Dec 2010 21:05:29 +0000 Message-ID: <1291842341-15199-7-git-send-email-bjg@network-theory.co.uk> References: <1291842341-15199-1-git-send-email-bjg@network-theory.co.uk> <1291842341-15199-2-git-send-email-bjg@network-theory.co.uk> <1291842341-15199-3-git-send-email-bjg@network-theory.co.uk> <1291842341-15199-4-git-send-email-bjg@network-theory.co.uk> <1291842341-15199-5-git-send-email-bjg@network-theory.co.uk> <1291842341-15199-6-git-send-email-bjg@network-theory.co.uk> Return-path: Received: from [140.186.70.92] (port=48816 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PQRE5-0006KA-Dk for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 16:07:10 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PQRDw-0002d4-9r for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 16:07:01 -0500 Received: from server.network-theory.com ([109.74.193.71]:40530) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PQRDv-0002cf-Vu for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 16:06:52 -0500 In-Reply-To: <1291842341-15199-6-git-send-email-bjg@network-theory.co.uk> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Cc: Barry Gidden , Brian Gough --- 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 "