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>
X-Mailer:	Evolution 3.4.4 (3.4.4-2.fc17)
Mime-Version:	1.0
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

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

- Raw text -