X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=date:from:to:subject:message-id:mail-followup-to:mime-version
         :content-type:content-disposition:user-agent;
        bh=bUfaZRzOK4jSxMoUi2FdXwNHEaeN/+ESRRw7oF7YjZs=;
        b=uoq0BC5BYJLEFc6doOYm5A1ff93hwfcuDkdpa7PxTDJHqE2o/zQUvsmqhyA8/v1zAi
         6HEQfdJKrqrEVM8mGNQYVWraWYaTgwg6c+cYbs04JpOm1loKknV/2a9vlUYKRDQcNaA3
         fIz577vlb2qgrThoZP/mvdHQ7s98ROsFGMueQ3UzDLltXH8H8Ew7ct8beDujtPZEoYhP
         O3ZkJ13Ve0/LObL/7bCcIRQtLzbSfoH2CwAr4saOgqAJ5m7z+7KAPj97KUPDDRH3W/jv
         4VJJXqe96WQT1IL2hW9eam//kx6spOXuiyXPjxFpMqutFv8ubOBUQ4WH6DJ4NKC253Qf
         VxsQ==
X-Received: by 10.152.27.169 with SMTP id u9mr10579952lag.8.1373301735156;
        Mon, 08 Jul 2013 09:42:15 -0700 (PDT)
Date: Mon, 8 Jul 2013 20:42:10 +0400
From: Vladimir Zhbanov <vzhbanov AT gmail DOT com>
To: geda-user AT delorie DOT com
Subject: [geda-user] gaf utility documentation
Message-ID: <20130708164210.GA28932@localhost.localdomain>
Mail-Followup-To: geda-user AT delorie DOT com
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
User-Agent: Mutt/1.5.21 (2010-09-15)
Reply-To: geda-user AT delorie DOT com


Hello, all.

I have dug into the gaf sources and written a document describing
the gaf utility [1] which can be found in gEDA/gaf v. 1.9.1. It contains
information additional to the gaf man page. It mainly covers the 'gaf
config' utility, its parameters, and provides some examples. It also has
links pointed to some freedesktop standards found during this work.  It
describes the current state of the program which, I believe, may change
in the future.

This work was caused by some requests here as well as by lack of
info on it. Probably, it would be better to include this
information into the manual page, I don't know.

I tried to carefully check all commands described there.
However, since English is not my first language, I ask you all to
review this document to fix my possible silly errors and probably
rephrase unintelligible sentences, or to just tell me here and
I'll add all these corrections myself. Any help, suggestions, fixes,
edits, spelling, etc are welcome.

In addition to the information given there, there is a patch at
[2] allowing setting up the same font for both the gschem and gaf
programs, thus providing you with WYSIWYG while using not default font.

It should be borne in mind that the utility seems to be developed
yet.  Errors, caused by invalid values in the config files, are
not handled properly, so the user may write, say, 'False' instead
of 'false' or 'portrat' instead of 'portrait' and not understand
why it doesn't work. Anyhow, many thanks to Peter Brett, who has
written this utility, and to all gEDA developers which work it is
based on!

[1] wiki.geda-project.org/geda:gaf_utility
[2] https://bugs.launchpad.net/geda/+bug/1099453