[PD] help files was: Re: call for testing on the nightly builds!

Hans-Christoph Steiner hans at eds.org
Mon May 19 20:13:16 CEST 2008

On May 19, 2008, at 6:55 PM, Martin Peach wrote:

> Hans-Christoph Steiner wrote:
>> On May 18, 2008, at 12:09 PM, Roman Haefeli wrote:
>>> On Sun, 2008-05-18 at 05:40 -0400, Enrique Erne wrote:
>>>> Roman Haefeli wrote:
>>>>> On Sat, 2008-05-17 at 19:50 +0200, IOhannes m zmoelnig wrote:
>>>>>> Hans-Christoph Steiner wrote:
>>>>>>>> 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.
>>>>>>> The declare/namespace/import stuff is still very undefined, so I
>>>>>>> think some experiementation would be good.  I think you  
>>>>>>> should go
>>>>>>> ahead and try it using what you propose.  That will be a good  
>>>>>>> test
>>>>>>> case.  Then we'll figure out what works best.
>>>>>> putting the helppatches besides the objects should fix most of  
>>>>>> the
>>>>>> problems, no?
>>>>>> no need for [declare] orgies and such
>>>>> yo.. it would seem strange having to put [declare]s into help-  
>>>>> patches in
>>>>> order to load the the objects, that they are explaining, IMO.
>>>> maybe i miss something:
>>>> to it seems _not_ strange to have a working help patch. the   
>>>> declare is
>>>> documenting how one can use the object-class of the external  
>>>> (one  of the
>>>> 4, 5... 6 ways).
>>> there are only so many in pd-extended, there aren't that many in
>>> pd-vanilla ( i can think of [declare] and pd-settings file only).
>>>> or do you think a user should configure the plist/pdrc/registry  
>>>> first
>>>> and restart Pd before he can use the documentation/helpfile?
>>> i think, as IOhannes said, that it would make sense to put classes
>>> (libraries, abstractions, single-object files) and their help- 
>>> files at
>>> the same place. i don't see a benefit in having to tell a help-file
>>> where to find the class.
>> Yeah, that's the idea of libdirs.  It just needs to be  
>> implemented  fully.  It's pretty close.
> I have all my help files in the same place as the source code in  
> the svn repository but they end up separated in pd-extended (the  
> binaries go to extra/mrpeach and the help files are in doc/ 
> 5.reference/mrpeach). As has already been remarked, I can  
> instantiate for example [mrpeach/tcpclient] but not [tcpclient] but  
> in either case the help file isn't found and if I open it manually  
> it won't make [tcpclient] either. So I'm just wondering what I can  
> do about that...
> If I put [mrpeach/tcpclient] in the help file it will work but it  
> doesn't do anything to make the help file findable. Is there some  
> make file I need to edit or does the libdir thing fix this?

What would fix this well is a completed libdir format.  If the help  
files are included in the same folder as the objectclasses, then the  
help files will be found either way, AFAIK.  But since 0.41-4 is out,  
and Pd-extended 0.40 has a lot of changes that are pretty well  
tested, I think it makes sense to release 0.40, then work on the  
whole libdir/import/declare issue in 0.41 (though I really hoped to  
do it for 0.40).

I am fine with leaving this how it is for this release, then fixing  
it properly for the next release.



                   ¡El pueblo unido jamás será vencido!

More information about the Pd-list mailing list