[Top][All Lists]

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

Re: [patch #7692] Gui Documentation / Online Help

From: John Darrington
Subject: Re: [patch #7692] Gui Documentation / Online Help
Date: Sun, 18 Dec 2011 19:49:29 +0000
User-agent: Mutt/1.5.18 (2008-05-17)

Regarding recent discussions about Online Help.  This patch
shows one way we can achieve it without radical changes.

It uses the existing user manual to document the dialog boxes
- screenshots included. It then hooks onto the Help button on
the dialog to start the Yelp browswer at the respective change.
Yelp 2.30 is rather slow, and starts a new instance for each
click instead of moving any existing instance to the wanted page.
But I'm told these problems are fixed in version 3.0

At the same time, the manual, complete with screenshots are
still available in the Postscript, PDF and DVI formats.

There are however some new external dependencies - Imagemagick
to convert the screenshots to all the required formats. And
there are some GNU specific Makefile constructs. 

I have an idea, which if it works, will allow the screenshots
to be automatically generated from the .ui files.  That will
avoid the problem I see with a lot of GUI manuals where the
GUI changes too rapidly for the documentation to keep up.

I'm not claiming the actuall text that I've written here to be 
good example of how to write documentation. But it shows the 

On Sun, Dec 18, 2011 at 07:29:26PM +0000, John Darrington wrote:
                      Summary: Gui Documentation / Online Help
                      Project: PSPP
                 Submitted by: jmd
                 Submitted on: Sun 18 Dec 2011 08:29:25 PM CET
                     Category: None
                   Item Group: None
                       Status: None
                  Assigned to: None
             Originator Email: 
                  Open/Closed: Open
              Discussion Lock: Any
     File Attachments:
     Date: Sun 18 Dec 2011 08:29:25 PM CET  Name:
     0001-Added-rudimentary-examples-documenting-the-GUI-and-m.patch  Size: 
     By: jmd
     Reply to this item at:
       Message sent via/by Savannah

PGP Public key ID: 1024D/2DE827B3 
fingerprint = 8797 A26D 0854 2EAB 0285  A290 8A67 719C 2DE8 27B3
See 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]