[PD] should I use pddp/link in help patches?

[Roman Haefeli]

On Fre, 2017-06-02 at 10:42 +0000, Liam Goodacre wrote:
> Hi Roman
> 
> Context, the system I'm documenting, is far too big to be explained
> in a single help-patch, so I want the 'context-help.pd' file to
> function more like a Table of Contents for the rest of the
> documentation (plus a few quick examples). It would be nice if the
> TOC could link to other files.


When you want to use [pddplink], I'd simply do so and declare it a
dependency of your system. I wouldn't care so much about what users
have already installed, I'd rather care whether dependencies are easily
available/installable. If [pddplink] is in deken, the most important
thing is to document that Context requires pddplink (or whatever the
library is called).

Roman




> From: Pd-list <pd-list-bounces at lists.iem.at> on behalf of Roman
> Haefeli <reduzent at gmail.com>
> Sent: 02 June 2017 11:03
> To: pd-list at lists.iem.at
> Subject: Re: [PD] should I use pddp/link in help patches?
>  
> On Fre, 2017-06-02 at 09:45 +0000, Liam Goodacre wrote:
> > Hi José
> > 
> > This will only work with a pre-loaded abstraction or subpatch. I'm
> > talking about opening a new file that isn't already loaded.
> > 
> > You can open files like this:
> > 
> > [; pd open file.pd my/directory(
> > 
> > but it will only work with absolute, not relative directory paths.
> 
> It works with relative paths, too, but relative to Pd's start
> locaction
> and not relative to calling patch (which basically boils down to
> absolute in practice).
> 
> 
> Why not simply create the object/abstraction, so that you just right-
> click -> help when you want to follow the 'link'? It's how many help-
> patches, including the ones of Pd, reference other objects.
> 
> Roman
> 
> 
> 
> > From: José de Abreu <abreubacelar at gmail.com>
> > Sent: 02 June 2017 10:21
> > To: Liam Goodacre; PD list
> > Subject: Re: [PD] should I use pddp/link in help patches?
> >  
> > Maybe
> > |; pd-nameOfSubpatch vis 1(
> > 
> > Em Sex, 2 de jun de 2017 03:03, Liam Goodacre <liamg_uw at hotmail.com
> >
> > escreveu:
> > > The [link] object is great for linking between help files, but I
> > > don't know how many people use it now that Extended has gone. By
> > > way of a survey, how many people have this external installed
> > > already? Seems like it will just be a nuisance if people have to
> > > download it just to read a help patch, but on the other hand it's
> a
> > > shame to give up on it since it's such a useful tool.
> > > 
> > > Assuming that it's not widely used any more, are there any other
> > > ways of opening a relative path from within PD?
> > > _______________________________________________
> > > Pd-list at lists.iem.at mailing list
> > > UNSUBSCRIBE and account-management -> https://lists.puredata.info
> /l
> > > istinfo/pd-list
> > > 
> > _______________________________________________
> > Pd-list at lists.iem.at mailing list
> > UNSUBSCRIBE and account-management -> https://lists.puredata.info/l
> is
> > tinfo/pd-list
> _______________________________________________
> Pd-list at lists.iem.at mailing list
> UNSUBSCRIBE and account-management -> https://lists.puredata.info/lis
> tinfo/pd-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 473 bytes
Desc: This is a digitally signed message part
URL: <http://lists.puredata.info/pipermail/pd-list/attachments/20170602/a453a18d/attachment.sig>