Re: "Source URLs" as source control properties
| From: | Hannes Magnusson | Date: | Sun, 11 Dec 2011 10:43:47 +0000 |
| Subject: | Re: "Source URLs" as source control properties | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969383505@lists.php.net to get a copy of this message | ||
On Fri, Dec 9, 2011 at 08:01, Justin Martin <frozenfire@php.net> wrote:
> Hello everyone,
>
> I've been playing around in a branch of doc-base and en to see if there's an
> elegant way to implement linking to the related php-src *.c file of
> functions and methods (and possibly more, in the future).
>
> The idea is that when documenting a function or method, it's often necessary
> to pull up the source for it. To do so, one typically has to grep the
> sources or guess where the function or method is defined. My hope was to set
> a source control property on each function and method file, which points to
> the URL of the of the source file.
I'm unsure how useful this really is.
The structure of php-src is very straight forward and easy to
figureout which file the function is in..
The problem may maybe rise when talking about pecl extensions, but
then again - not all of them are in php svn tree.. so if I can't get
it on all files.. whats the point?
-Hannes