Date: Wed, 4 Mar 2015 21:18:30 +0300
From: Vladimir Zhbanov <vzhbanov AT gmail DOT com>
To: geda-user AT delorie DOT com
Subject: Re: [geda-user] work on gEDA
Message-ID: <20150304181830.GB27431@localhost.localdomain>
Mail-Followup-To: geda-user AT delorie DOT com
References: <20150215021721 DOT 28d94fde AT jive>
 <mcvthm$db0$1 AT ger DOT gmane DOT org>
 <20150303183148 DOT GA22832 AT localhost DOT localdomain>
 <md5qfb$f4g$1 AT ger DOT gmane DOT org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <md5qfb$f4g$1@ger.gmane.org>
User-Agent: Mutt/1.5.23 (2014-03-12)
Reply-To: geda-user AT delorie DOT com
Errors-To: nobody AT delorie DOT com
Precedence: bulk

Hi, Kai-Martin.
On Wed, Mar 04, 2015 at 03:25:46AM +0100, Kai-Martin Knaak wrote:
...
> > In gschem, select File->Evaluate script... and type:
> 
> Ah, so did indeed miss something!
> 
> In my git head copy of gschem a file chooser dialog launches if I 
> select file->Execute_script..  But fair enough. I put the guile 
Sorry, my fault. I meant the menu 'Edit->Evaluate macro' which can
be invoked hitting <:> as well. Though this doesn't matter.

> commands into a file.
> 
> > (use-modules (geda page))
> > (use-modules (geda object))
> > (page-append! (active-page) (make-component/library "resistor-2.sym"
> > '(40000 . 40000) 0 #t #f))
> 
> 
> The script did place a resistor on the page. But unlike a symbol 
> placed via the GUI no attributes got promoted and instantiated in the 
> schematic. The refdes rendered in red and were not editable. 
> 
> I tried to promote the refdes attribute manually via the context menu 
> in the attribute editor. This produced a promoted copy of the 
> attribute at some default position, not identical to the position 
> given to the refdes in the *.sym file. The unpromoted version of the 
> refdes attribute remained visible.

Try this:

(use-modules (geda page))
(use-modules (geda object))
(define R
  (make-component/library "resistor-2.sym" '(40000 . 40000) 0 #t #f))
(page-append!  (active-page) R)
(promote-attribs! R)

>  
> > Please look at 'info geda-scheme' for more info on this. 
> 
> Err, well ... this is well hidden. 
> How should I know that "geda-scheme" is the term to look for in info?
You already know the answer, right? ;)

> There is no info node for gschem so info defaults to the man page. The 
> man page does not mention scheme at all. It is quite brief and refers 
On my system I do:
  info
Search for 'geda'
  /geda
and see the pointer 'gEDA scheme' under the header 'The Algorithmic
Language Scheme'. 'geda-scheme' is related to all geda-gaf tools, not
only gschem. And nobody wrote 'info gschem' yet.

> the reader to "the program's  `Help' menu.". The help menu of gschem 
> opens an offline copy of
>      http://wiki.geda-project.org/geda:documentation
> (BTW, the file characterizes itself as "on-line documentation". 
> Somebody with write access to the wiki might remove the attribute "on-
> line" to make the heading compatible for offline use, too)
I believed you do have write access, do you? ;) A link to the real
online documentation would be useful, too.

> 
> Unlike the on-line version of the wiki, the static HTML pages do not 
> offer a search facility. But let's assume I was smart enough to browse 
> to the "gEDA gschem User guide". (BTW, wouldn't it be nice to refer 
> the user directly to the manual in the first place?) The very last 
My gschem has 'Gschem User Guide' as the first entry in the 'Help' menu
(<H><G>). Does yours has one? (However, all the 'Help' menu entries
don't work for me for some reason :) Wine seems to have broke them, I
see some strange Wine-like errors and m$windows paths in my terminal
when I click on them.)

> section of the manual is "Appendix: Extending gschem". This section 
> focuses on ways to change gschem itself not on ways to change the 
> schematic. 
> It says: "The gEDA Scheme Reference Manual is **also** available as an 
> Info manual (info geda-scheme)." (emphasis by me)
> I did not find any other place for the geda scheme references than the 
> info page. Did I miss something again?
Nothing, I think :) However, the info manual could be converted into
HTML and placed some place on geda-project.org. (Willst Du aber nicht es
alles auf meine Shulter legen, richtig? (Ich sherze, sei gelassen :))
Probably, this might be the reason for such a word (?)...

> 
> Anyway, I got the good news: 
> Scripted manipulation of schematics works -- sort of. 
> 
> ---<)kaimartin(>---
> 

Cheers,
  Vladimir