[FM Discuss] CLI

[TJB]

I finished editing the Command Line Interface manual for format and
consistency.

* The Perl chapter, still marked "incomplete", is as complete as the
chapters on Python and Ruby.  So either it's ready to go or the others
aren't.  ;-)

* I did work on the Redirection, Searching and Processes chapters, all
of which are still marked "unpublished" but which are ready for
publication, IMHO, except that Redirection and Processes lack a
closing paragraph, such as the ones that appear in almost every other
chapter.

* You can at least mark the Glossary as proofed now.  Barring any
additions to it, I say it is ready to go too.

* I did not do any work on the five "incomplete" or "unpublished"
chapters at the end (CoolOneLiners, FurtherMastery, RMSIntro,
SomeSimpleScripts and VirtualTerminals).  A quick glance at each of
them shows that their respective statuses are accurate.

As I was working my way through this excellent publication, I couldn't
help but visualize a youngster going through it and applying the
examples it contains.  This book has the opportunity to prime the next
generation of power users.  Way to go!

Tom


On 4/30/2009 12:37 PM, Andy Oram wrote:
> Thanks for taking on this rather tedious work. We don't want to burden authors by asking them to follow a laundry list of conventions while they're writing (and they'd probably ignore conventions anyway), so doing it at the end is probably easiest, as you're doing.
> 
> Andy
> 
> ----- Original Message -----
> From: TJB <tjb.olpc at gmail.com>
> To: discuss at lists.flossmanuals.net
> Sent: Thu, 30 Apr 2009 12:24:21 -0400 (EDT)
> Subject: Re: [FM Discuss] CLI
> 
> This manual is another very clean one.  Very, very few typos, but
> since it was written by various authors, it is a worthwhile exercise
> for me to "standardize" the text: examples of commands in code format
> ("<code>...</code>"); filenames and directory names in italics;
> keyboard keys in bold; double quote marks instead of apostrophes in
> text (not in examples!); etc., i.e., copy-editing as Andy Oram
> suggested a while ago.
> 
> It's taking me longer than I expected, but I will finish standardizing
> it. I have finished 24 of 44 chapters so far.
> 
> Marcelo, I don't want to hold you up on your Spanish translation
> effort.  The vast majority of the changes I'm making are in format,
> not content.  If you subscribe to get changes to the manual, you will
> see my changes if you are running ahead of me.  I am working the
> chapters in sequence.
> 
> Tom
> 
> 
>  On Sun, 2009-04-19 at 01:33 -0400, TJB wrote:
>> Ed, Andy and Adam, I will start editing the manual for format and
>> consistency.  With about 40 chapters, it may take up to a week, I
>> reckon.  I'll start Sunday.
>>
>> Tom Boyle
>>
>>
>> On 4/18/2009 6:00 AM, Andy Oram wrote:
>>> Now that we're in less of a rush, I agree somebody should copy-edit the book. I'm probably too close to the material now. Maybe on Sunday I can proof the Glossary, though; thanks so much for taking responsibility for it, Ed. I'm not sure I'll have time for the Glossary because I'm leaving on Monday for a week-long trip.
>>>
>>> Andy
>>> ----- Original Message -----
>>> From: Edward Cherlin <echerlin at gmail.com>
>>> To: FM Discuss <discuss at lists.flossmanuals.net>
>>> Sent: Sat, 18 Apr 2009 04:14:56 -0400 (EDT)
>>> Subject: [FM Discuss] CLI
>>>
>>> I finished adding items to the CLI glossary. I deliberately did not
>>> include terms specific to a particular editor or scripting language,
>>> and well defined in that chapter. Please review my work.
>>>
>>> I fixed some typos and other glitches, and noticed that the whole book
>>> could use a good copy-editing. It is definitely not as clean as the
>>> work we did on Circumvention. There are some inconsistent points of
>>> style. I don't think I know what they all should be, so I am asking
>>> for someone who knows the style to review them. Watch out for spaces
>>> at the very beginning of paragraphs. They are an artifact of the
>>> software.
>>>
>>> When we come back to this book, I can see several places where we can
>>> improve the presentation, and a number of other commands for possible
>>> inclusion.
>>>
>>> I would do more, but I have two other pressing projects on the OLPC XS
>>> school server and on teaching math in Turtle Art through discovery
>>> rather than lessons. I sent my iconized no-text TA tiles to Walter
>>> Bender, and hope to make them publicly available soon.
>>>
>>> The chat on the Web site is out. We didn't get anywhere near enough
>>> chat during the CLI sprint and its followup, compared with talking
>>> face-to-face in an onsite sprint. We didn't have the oversight I
>>> thought we needed on getting chapters done and reviewed. When I left
>>> off tonight, some of the file status selections seemed to be
>>> inconsistent.
>>>
>> _______________________________________________
>> Discuss mailing list
>> Discuss at lists.flossmanuals.net
>> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> 
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>