[PD-dev] packaging the pddp docs

[Jonathan Wilkes]

--- On Mon, 6/27/11, Hans-Christoph Steiner <hans at at.or.at> wrote:

> From: Hans-Christoph Steiner <hans at at.or.at>
> Subject: [PD-dev] packaging the pddp docs
> To: pd-dev at iem.at
> Date: Monday, June 27, 2011, 9:21 PM
> 
> Now that the core Pd docs (i.e. /usr/lib/pd/doc/*) are
> split out into a
> separate Debian package, I think it could make sense to
> package the PDDP
> docs in a kind of mirror or replacement package. 
> Something like
> pddp-doc.  Jonathan, in particular, I was thinking
> that since you have
> wanted to work on all the patches there, we could set it up
> so the
> pddp-doc package mirrors the whole /usr/lib/pd/doc*
> directory and patch
> structure, have this in SVN, git, or whatever
> somewhere.  Then people
> could choose the pddp-doc package if they so choose.

The PDDP docs I did are all for vanilla objects (exceptions are 
expr family, and the other "vanilla" extras).  If a new user clicks 
"Help" on a vanilla object, it should show the revised PDDP help 
patch by default.  

So instead of what you propose, please make something like a 
legacy-vanilla-help package.  That way, if someone really prefers 
the old docs, they can still find them, and we won't waste new users' time 
by forcing them to use outdated and unmaintained docs (until they figure 
out they're supposed to download a separate package for the current 
vanilla help patches, which nobody has to do for any of the external 
packages).

-Jonathan

> 
> Here's the files in puredata-doc:
> http://packages.debian.org/sid/all/puredata-doc/filelist
> 
> .hc
> 
> _______________________________________________
> Pd-dev mailing list
> Pd-dev at iem.at
> http://lists.puredata.info/listinfo/pd-dev
>