X-Authentication-Warning: delorie.com: mail set sender to geda-help-bounces using -f
X-Recipient: geda-help AT delorie DOT com
Message-ID: <1355254388.14812.95.camel@hoho6.chidig.com>
Subject: Re: [geda-help] Dirt Dumb Level..
From: Bob Gustafson <bobgus AT rcn DOT com>
To: geda-help AT delorie DOT com
Date: Tue, 11 Dec 2012 13:33:08 -0600
In-Reply-To: <CAGde_xMGc-P=ZaE63hq0QefnjbAxHPS+sNo=+GxC+xAjye-6eA@mail.gmail.com>
References: <1355205873 DOT 14812 DOT 39 DOT camel AT hoho6 DOT chidig DOT com>
	 <20121211084739 DOT C023482204B9 AT turkos DOT aspodata DOT se>
	 <1355234721 DOT 14812 DOT 42 DOT camel AT hoho6 DOT chidig DOT com>
	 <CAGde_xMGc-P=ZaE63hq0QefnjbAxHPS+sNo=+GxC+xAjye-6eA AT mail DOT gmail DOT com>
Content-Type: text/plain; charset="UTF-8"
X-Mailer: Evolution 3.4.4 (3.4.4-2.fc17) 
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Junkmail-Whitelist: YES (by domain whitelist at mr17.lnh.mail.rcn.net)
Reply-To: geda-help AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: geda-help AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

On Tue, 2012-12-11 at 15:35 +0100, Svenn Are Bjerkem wrote:
> On 11 December 2012 15:05, Bob Gustafson <bobgus AT rcn DOT com> wrote:
> > Cool - thanks much.
> >
> > One needs to get one's head around Guile before approaching gEDA..
> >
> > Perhaps a mini-note somewhere in the beginning tutorial..
> >
> > Yes, I know - write it myself.
> >
> 
> Don't forget to mention that Guile is not Skill in your manual in case
> a cadence composer user happens to drop by.....
> 

Here is a stab at documentation enhancement:

At the top of the document geda:gsch2pcb_tutorial,
just above gschem -> gsch2pcb -> PCB

*** This document is geda:gsch2pcb_tutorial
*** http://wiki.geda-project.org/geda:gsch2pcb_tutorial

The reason is that if this document is saved to a local file, the source
and name of the file is lost.

----

Just above the code fragment
(component-library "${HOME}/gaf/gschem-sym")
in the Setup section

*** The ${HOME} in the lines below are a little misleading.
*** The ${HOME} implies that there is something that will
*** evaluate an expression HOME=/home/user1/gEDA or something
*** like that. This is NOT the case as the syntax is that of
*** a Guile (Scheme (lisp)) source script, not bash. In Guile,
*** there is no implicit evaluation of the phrase ${HOME}.
***
*** To define the ${HOME} for use in the lines below, one way is:
*** (define "${HOME}" "/home/user1/gEDA")
*** or similar. If you get strange error messages, the documentation
*** on the Guile language may be helpful. Guile is not Skill.
***
*** Be also aware that some symbols, such as 'source-library' and
*** 'build-path' are not native Guile, but gEDA functions with their
*** own particular argument requirements and syntax.

Feel free to correct/hack it up.

Equipped as I am with a virgin pair of eyeballs, I can only write what I
see..  Hopefully my eyes will improve with experience, but that might
not be good for the next noobies coming along.

Best regards

Bob G