Re: I Need a Chapter Number for The GUI Help Chapter

[Selma Leathem]

Hello,

 

I'll incorporate your comments into the chapter as well and remove all those @example tags. Sorry, I misunderstood what that reprented. Just to clairfy; in order to make it easier to read I used @emph for buttons and dialogue labels some of the sentences... This has the effect of italicizing. Is this ok or should I use different tags? I felt that since it's a gui with the @code might not be approriate for button labels. I know that variables should be italicized though.

 

Thanks

 

Selma

From: John Darrington <address@hidden>
To: Selma Leathem <address@hidden>
Cc: "address@hidden" <address@hidden>; John Darrington <address@hidden>; Ben Pfaff <address@hidden>
Sent: Wednesday, September 19, 2012 3:51 AM
Subject: Re: I Need a Chapter Number for The GUI Help Chapter

Hi Selma,

Thanks for the update.

I had a look at your Texinfo file, and have the following comments:

1. Please avoid very long lines.  For example your first paragraph
  "The PSPP graphical user interface ..." contains just one line,
  which is over 370 characters long.  This makes it difficult to read.
  Also, you will notice that this paragraph contains three sentences,
  but you have inadvertendlty omittedd the space after the . of the
  second sentence.  I like to start each sentence on a new line, since
  it avoids these kind of errors, and makes it easier to cut/paste
  whole sentences.

2. Your use of the @example environment is incorrect.  @example should
  only be used to indicate text which the user sees on the screen or
  types into the keyboard.

3. You have a lot of instances of @citem.  @citem does not seem to be a
  Texinfo command, so these cause errors.

4.  File->Open->Syntax  should be writtem like this:
  @clicksequence{File @click{} Open @click{} Syntax}

5.  There seems to be a lot of places where @menu/@example/@enumerate/@itemize
  are all jumbled up.  Consequently texi2dvi is refusing to compile it.


Other than that, it looks like it's coming along well.  I suggest that the next
step should be to integrate the file into manual such that texi2dvi processes
it without errors, and take things from there.

Thanks for doing this.


J'




Regarding your question about which chapter number, there is already a (very small)
chapter on the GUI entitled "Invoking Psppire".  I suggest that your chapter should
replace this one.

On Tue, Sep 18, 2012 at 02:07:43PM -0700, Selma Leathem wrote:
    Hello All,
    ?
    I'm at that stage where I'm fine tuning the texinfo file, and would like to ask what chapter number it would be.
    The Help file describes every single aspect of the GUI interface: every menu item with an example of every statistical function, general formating and editing, tool bar, status bar ect...
    ?
    Again, sorry for the long absence without notice. It's a long story that I'd rather not have be google searchable.
    ?
    Regards,
    ?
    Selma
--
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.