On Sat, May 17, 2008 at 9:03 AM, Hans-Christoph Steiner <hans@eds.org> wrote:

On May 17, 2008, at 5:50 PM, Enrique Erne wrote:

> Hans-Christoph Steiner wrote:
>> There is much that can and should be done.  Here's some ideas
>> ranked into of difficulty:
>> - file a bug report when a help patch is not working
>> - write and improve help patches, and submit them to the patch
>> tracker
>
> is there a convention about how to make it work? i.e. should one
> use declare, import or namespace prefix?
>
> i guess all help-files that are not loaded on default would need a
> declare/import/or-namespace in order to work...
>
> i want to contribute and help to make "all"/more helpfiles work. i
> know there is pddp but afaik it does not solve the declare/import/
> or-namespace problem.
>
> could all developers express their opinion and agree on how to make
> all helpfiles work? :)

Starting with the PDDP template is a good place to start:

http://pure-data.svn.sourceforge.net/viewvc/pure-data/trunk/doc/pddp/
templates/

> i'm not a developer but i would vote for declare
> i.e. [declare -stdlib mrpeach] to packOSC-help.pd
> then it would work with pd vanilla too.

This isn't working for me, using the latest pd-extended.  When I start pd with the '-verbose' flag and then use a [declare] statement, what I am declaring is not getting searched (or at least it isn't posting that it is.  Anyways, the object in that directory isn't found).
 
I think this would be a good approach, similar to python's "from x import *" mechanism, but probably not good for help files, as they could introduce nameclashes that are avoided with namespaces.

Personally, I would use namespace prefixes:   [mrpeach/packOSC].
This will make more sense when there are libraries organized around
concepts rather than authors.  So something like [osc/packOSC]

This seems appropriate for help files, as it also tells you where to find the object within the extra folder.  Sort of self-documenting. 
 


>> - add a search pane to the help panel
>
> is this done in tcl/tk? is there any documentation about that on
> puredata.info?

It is done however you want to, more or less, but I think a pure Tcl
solution would be possible, and perhaps easiest.

.hc


>
>
>
>
>
>> - help design and code a library format that bundles
>> objectclasses, helpfiles, manuals, examples, etc then write code
>> to index it all, and create a GUI to navigate that content
>> At this point, I think it is mostly a waste of time to do constant
>> little workarounds like moving around objects.  We should be
>> putting our scarce resources towards real improvements, not
>> temporary fixes, IMHO.
>> .hc
>>



------------------------------------------------------------------------
----

News is what people want to keep hidden and everything else is
publicity.          - Bill Moyers



_______________________________________________
PD-list@iem.at mailing list
UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list