Merge lp:~maphew/leo-editor/doc-edits into lp:leo-editor

[Matt Wilkie]

a few minor edits to LeoDocs.leo >> Preliminaries

a few minor edits to LeoDocs.leo >> Preliminaries.

They are suggestions, feel free to pick and choose the ones you like.

[lp:~maphew/leo-editor/doc-edits]

6172. By Matt Wilkie on 2013-10-21

add best guess for date of Joe's endorsement. (On general principle I think all of the long quotes should be dated, and, where possible linked to the first post)

6173. By Matt Wilkie on 2013-10-21

one typo, and fix formatting on a numbered list

[Edward K. Ream (edreamleo)]

On Mon, Oct 21, 2013 at 12:15 AM, Matt Wilkie <email address hidden> wrote:

> Matt Wilkie has proposed merging lp:~maphew/leo-editor/doc-edits into
> lp:leo-editor.
>

​Thanks for the edits. I'll review them and merge by hand into LeoDocs.leo.

Edward

[Matt Wilkie (maphew)]

you're welcome. :)

Since it appears hand merging is a preferred workflow to using launchpad,
is there are also a better way to give you corrections?

I used bzr because of the simpleness of using the commit message to share
the reasoning behind each of the changes.

On Mon, Oct 21, 2013 at 9:36 AM, Edward K. Ream <email address hidden> wrote:

> On Mon, Oct 21, 2013 at 12:15 AM, Matt Wilkie <email address hidden> wrote:
>
> > Matt Wilkie has proposed merging lp:~maphew/leo-editor/doc-edits into
> > lp:leo-editor.
> >
>
> Thanks for the edits. I'll review them and merge by hand into LeoDocs.leo.
>
> Edward
>
> --
> https://code.launchpad.net/~maphew/leo-editor/doc-edits/+merge/191938
> You are the owner of lp:~maphew/leo-editor/doc-edits.
>

[Edward K. Ream (edreamleo)]

On Mon, Oct 21, 2013 at 4:30 PM, Matt Wilkie <email address hidden> wrote:

> you're welcome. :)
>
> Since it appears hand merging is a preferred workflow to using launchpad,
> ​ ​
> is there are also a better way to give you corrections?
>
> I used bzr because of the simpleness of using the commit message to share
> ​ ​
> the reasoning behind each of the changes.
>

​The bzr diffs suffice, I think. But you could simply describe the
corrections if that is easier for you.

Edward

[Edward K. Ream (edreamleo)]

On Mon, Oct 21, 2013 at 12:15 AM, Matt Wilkie <email address hidden> wrote:

a few minor edits to LeoDocs.leo >> Preliminaries.
>
> They are suggestions, feel free to pick and choose the ones you like.
>

​Done. Thanks for your help.

Edward

Unmerged revisions

6173. By Matt Wilkie on 2013-10-21

one typo, and fix formatting on a numbered list

6172. By Matt Wilkie on 2013-10-21

add best guess for date of Joe's endorsement. (On general principle I think all of the long quotes should be dated, and, where possible linked to the first post)

6171. By Matt Wilkie on 2013-10-21

Joe Orr's website is gone, perhaps the Web Archive?

6170. By Matt Wilkie on 2013-10-21

Corrected date and linked to the public posting for Speed's mini Leo review

6169. By Matt Wilkie on 2013-10-21

unattributed quote now attributed to anonymous

6168. By Matt Wilkie on 2013-10-21

'traditional editors' instead of 'any other'; sounds less arrogant, and admits possib.of another editor which could do this, possibly (we just don't know about it).

=== modified file 'leo/doc/LeoDocs.leo'
--- leo/doc/LeoDocs.leo	2013-10-19 23:56:05 +0000
+++ leo/doc/LeoDocs.leo	2013-10-21 05:41:35 +0000
@@ -3261,7 +3261,7 @@
 .. .. |leoAtFileNamedChild| image:: screen-shots/leo-qt-at-file-named-child.JPG
 </t>
 <t tx="ekr.20050830074815.1">"I am using Leo since a few weeks and I brim over with enthusiasm for it. I
-think it is the most amazing software since the invention of the spreadsheet."
+think it is the most amazing software since the invention of the spreadsheet." -- Anon
 
 "We who use Leo know that it is a breakthrough tool and a whole new way of
 writing code." -- Joe Orr
@@ -3315,7 +3315,9 @@
 
 </t>
 <t tx="ekr.20050830074815.11"></t>
-<t tx="ekr.20050830074815.12">September 3, 2002
+<t tx="ekr.20050830074815.12">.. _`on slashdot`:http://slashdot.org/comments.pl?sid=38848&amp;cid=4171478
+
+August 28, 2002 `on slashdot`_.
 
 Hello, my full name is David Speed Ream. I am known as Speed to friends and
 enemies alike, but I gladly answer to David or most any other handle. I am an
@@ -3398,7 +3400,9 @@
 Enough of this commentary, I just looked at the clock. Best wishes to anyone
 willing to try Leo for a week. I hope you will be glad you did.
 </t>
-<t tx="ekr.20050830074815.13">The Word outlines are very useful. But Leo makes Word look like a clunky toy.
+<t tx="ekr.20050830074815.13">_circa 2005_
+
+The Word outlines are very useful. But Leo makes Word look like a clunky toy.
 
 #1 Reason would probably be clone nodes. One node can point to another. Another
 way of putting this is is that a leaf can be on more than one tree. For
@@ -3409,6 +3413,7 @@
 put a new species, you could put the species under two simultaneously. In
 effect, you can build a 3-D tree. For a further illustration see
 http://www.3dtree.com/ev/e/sbooks/leo/sbframetoc_ie.htm
+(domain shut down, perhaps try the `Web Archive`_)
 
 #2 Reason would probably be that Leo outlines can be embedded in external text
 files. So, a Leo outline is more than an outline, it is a meta-structure that
@@ -3427,17 +3432,22 @@
 edited separately.
 
 Some other cool things about Leo which Word doesn't feature:
+
 1. Pure xml output that is easy to transform into other formats (next
 version of Word will have true XML format, but not as easy to work with).
 One consequence of this is that Leo files can be transformed pretty easily
 to web pages with their outlining capability intact.
+
 2. Easy to add features since is programmed in Python and open source. Maybe
 your average user can't start hacking on it, but a surprising amount can be
-tacked on...
-.. by flipping through the Tk manual.
+tacked on by flipping through the Tk manual.
+
 3. Free, opensource, multi-platform
+
 4. Leo is scriptable with Python. It should be possible to build a Tickler
 into Leo using Python scripting, for example.
+
+.. _`Web Archive`:http://web.archive.org/web/http://www.3dtree.com/ev/e/sbooks/leo/sbframetoc_ie.htm
 </t>
 <t tx="ekr.20050830074815.14">First of all, kudos to you for the excellent progress you've been making with
 Leo. I upgraded today after about three months of using and older version and I
@@ -22536,7 +22546,7 @@
   outline's data, but the outline structure as well.
 
 - Features such as @test nodes and @button nodes can not even be *thought*
-  in any other editor. Leo implements such features easily; other editors
+  in traditional editors. Leo implements such features easily; other editors
   could only simulate them--laboriously and unnaturally.
    
 - Leo's outlines are based `Directed Acyclic Graphs`_. As a result, Leo can