Re: [bug-recutils] Work needed in the user manuals

[Jose E. Marchesi]

Hi John.
    
    2. I couldn't find the word "escalar" in any English dictionary.  Should
       this read "scalar" or is it some specialist terminology which is supposed
       to be familiar to the readership?

That is indeed a typo.  I just pushed a patch fixing this.
    
    4. I recommend that all the chapters whose names begin with %  be retitled, 
       to something more descriptive.
    
    5. Like you say, the chapters descibing the tools are very terse and read 
like a 
       reference rather than a tutorial.   I recommend that these chapters be 
       made into an appendix, and in their place three or four new tutorial 
type 
       chapters:
    
       "Retrieving your data" - covering the use of recinf, recsel and recfmt
       "Entering data" -- covering recins
       "Editing entries" -- covering recset and recdel (maybe recfix too)
       "Importing and Exporting" -- all the rec2* utilities.

That looks like a nice partitioning of the topics.  Would you like to
help writing some of the contents?  I have some development work to do
before 1.6, so if the manual could be improved in the meanwhile it would
be great.
    
    6. There is no index.  The manual is big enough that it could use
    one.

Yes, definitely.

-- 
Jose E. Marchesi         http://www.jemarch.net
GNU Project              http://www.gnu.org