[pmwiki-users] Re: Re: documentation for mkdirp()

[chr at home.se]

On Tue, 2 Aug 2005, Ben Wilson wrote:

> Quoting Joachim Durchholz <jo at durchholz.org>:
> 
> > Ben Wilson wrote:
> >> Quoting Christophe David <pmwiki at christophedavid.org>:
> >>
> >>>> Could someone please document mkdirp() ? It is only mentioned in
> >>>> PmWiki/FilePermissions, but should definitely be listed in
> >>>> PmWiki/Functions .
> >>>
> >>> Or rather Cookbook.Functions ?
> >>
> >> Methinks it should be PmWiki Functions as it is a standard PmWiki
> >> device.
> >
> > Due to historic accident, PHP functions are documented in
> > Cookbook.Functions and variables in PmWiki.Variables. If this is a
> > concern, one of the pages should be moved - having two Functions pages
> > would be confusing.
> 
> I should think that PmWiki.Functions is more proper for core functions.
> Although, if recipes share functions it would be prudent to have
> Cookbook.Functions (that is, if two/more recipes interoperate). However, I'm
> thinking that it might be better to (in those cases) document the functions
> within the recipe page after all the how-to use stuff.

I think we could do with more than one page describing the page -
basically depending on the audience. One quick stop that gives you an
overview, and another page that gives you various gory details. Btw, this 
page exists

	http://www.pmwiki.org/wiki/PmWiki/Functions

although it's not exactly full... It's time we decided on some structure 
for this though..

cheers
/Christian

-- 
Christian Ridderström, +46-8-768 39 44               http://www.md.kth.se/~chr