<br><br><div class="gmail_quote">On Sat, May 17, 2008 at 9:03 AM, Hans-Christoph Steiner <<a href="mailto:hans@eds.org">hans@eds.org</a>> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="Ih2E3d"><br>
On May 17, 2008, at 5:50 PM, Enrique Erne wrote:<br>
<br>
> Hans-Christoph Steiner wrote:<br>
>> There is much that can and should be done. Here's some ideas<br>
>> ranked into of difficulty:<br>
>> - file a bug report when a help patch is not working<br>
>> - write and improve help patches, and submit them to the patch<br>
>> tracker<br>
><br>
> is there a convention about how to make it work? i.e. should one<br>
> use declare, import or namespace prefix?<br>
><br>
> i guess all help-files that are not loaded on default would need a<br>
> declare/import/or-namespace in order to work...<br>
><br>
> i want to contribute and help to make "all"/more helpfiles work. i<br>
> know there is pddp but afaik it does not solve the declare/import/<br>
> or-namespace problem.<br>
><br>
> could all developers express their opinion and agree on how to make<br>
> all helpfiles work? :)<br>
<br>
</div>Starting with the PDDP template is a good place to start:<br>
<br>
<a href="http://pure-data.svn.sourceforge.net/viewvc/pure-data/trunk/doc/pddp/" target="_blank">http://pure-data.svn.sourceforge.net/viewvc/pure-data/trunk/doc/pddp/</a><br>
templates/<br>
<div class="Ih2E3d"><br>
> i'm not a developer but i would vote for declare<br>
> i.e. [declare -stdlib mrpeach] to packOSC-help.pd<br>
> then it would work with pd vanilla too.<br>
</div></blockquote><div><br>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).<br>
<br>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.<br><br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Personally, I would use namespace prefixes: [mrpeach/packOSC].<br>
This will make more sense when there are libraries organized around<br>
concepts rather than authors. So something like [osc/packOSC]<br>
<div class="Ih2E3d"></div></blockquote><div><br>This seems appropriate for help files, as it also tells you where to find the object within the extra folder. Sort of self-documenting. <br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="Ih2E3d"><br>
<br>
>> - add a search pane to the help panel<br>
><br>
> is this done in tcl/tk? is there any documentation about that on<br>
> <a href="http://puredata.info" target="_blank">puredata.info</a>?<br>
<br>
</div>It is done however you want to, more or less, but I think a pure Tcl<br>
solution would be possible, and perhaps easiest.<br>
<br>
.hc<br>
<div class="Ih2E3d"><br>
<br>
><br>
><br>
><br>
><br>
><br>
>> - help design and code a library format that bundles<br>
>> objectclasses, helpfiles, manuals, examples, etc then write code<br>
>> to index it all, and create a GUI to navigate that content<br>
>> At this point, I think it is mostly a waste of time to do constant<br>
>> little workarounds like moving around objects. We should be<br>
>> putting our scarce resources towards real improvements, not<br>
>> temporary fixes, IMHO.<br>
>> .hc<br>
>><br>
<br>
<br>
<br>
</div>------------------------------------------------------------------------<br>
----<br>
<br>
News is what people want to keep hidden and everything else is<br>
publicity. - Bill Moyers<br>
<div><div></div><div class="Wj3C7c"><br>
<br>
<br>
_______________________________________________<br>
<a href="mailto:PD-list@iem.at">PD-list@iem.at</a> mailing list<br>
UNSUBSCRIBE and account-management -> <a href="http://lists.puredata.info/listinfo/pd-list" target="_blank">http://lists.puredata.info/listinfo/pd-list</a><br>
</div></div></blockquote></div><br>