bug-recutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [bug-recutils] First version of the rec-mode manual


From: John Darrington
Subject: Re: [bug-recutils] First version of the rec-mode manual
Date: Wed, 21 Nov 2012 10:34:44 +0100
User-agent: Mutt/1.5.20 (2009-06-14)

On Mon, Nov 12, 2012 at 07:09:10PM +0100, Jose E. Marchesi wrote:
     
     Yesterday I pushed a first draft of the rec-mode manual.  It is in
     doc/rec-mode.texi.  Would be great if someone can review it.
     

I had a read through it.  Some comments:

1. I suggest that you define a macro for the latin abbreviation "etc." similar
  to what you have done for "ie".

2. In this sentence:

   "The following commands iterate through the fields in a record, and to
  get information about some of the properties of the fields."

  the clause following "and" doesn't fit the subject of the sentance.

3. This sentence " The user can then select ony of the
  options by pressing the corresponding label, or cancel the operation
  by pressing @kbd{RET}." contains a typo. "ony" --> "any".


4. @item For any other kind of fields an edition buffer is opened ...

  Is the term "edition buffer" something that Emacs nerds understand? It's
  a term I've never heard before "edit buffer" sounds more natural to me.



5. There are several places where the text talks about "the user".  The GNU 
prefered
  style is to address the person using the program as "you".

J'




-- 
PGP Public key ID: 1024D/2DE827B3 
fingerprint = 8797 A26D 0854 2EAB 0285  A290 8A67 719C 2DE8 27B3
See http://keys.gnupg.net or any PGP keyserver for public key.

Attachment: signature.asc
Description: Digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]