[wp-hackers] Inline documentation

[Robert Deaton]

On 3/30/06, Carthik Sharma <carthik at gmail.com> wrote:
> On 3/30/06, Alex King <lists at alexking.org> wrote:
> > I think the conversation should change to: What is the best way to
> > create and maintain inline documentation if it won't be checked into
> > core.
>
> I thought of this,and can't think of any automated way of syncing with
> svn while preserving the comments on a local copy. I spent a half hour
> researching if svn can be taught to ignore comments when updating the
> checked out code, but came short of useful info.
>
> If you, or indeed anyone else knows of or can devise a way to "svn up"
> while ignoring local comments, please list it out here. Once we have
> that, we can set up a doc repo for the source, and get phpdoc and
> whatever else running off of that repo.

Simple, store the comments elsewhere linked to the source files when
needed by a helper tool. Much like Owen did with his site

--
--Robert Deaton
http://somethingunpredictable.com