Re: Re: PEAR CS Documentation Incorrect?
| From: | Chuck Burgess | Date: | Wed, 09 Sep 2009 23:30:17 +0000 |
| Subject: | Re: Re: PEAR CS Documentation Incorrect? | ||
| References: | 1 2 3 4 5 6 | Groups: | php.pear.dev php.pear.doc |
| Request: | Send a blank email to pear-dev+get-52797@lists.php.net to get a copy of this message | ||
Since there's no keyword substitution property already set on the file,
plain old "$Id$" should do it then... I've committed that fix now.
CRB
On Wed, Sep 9, 2009 at 7:13 AM, Jan Rosier <rosier@interstroom.nl> wrote:
> With subversion keyword substitution is "file-based". You can turn it off
> by removing the svn:keywords property on that file.
>
> With no svn:keywords property set on that file, Subversion will do nothing
> special.
>
>
> ΂iØ·â™Íê
> ÚÜÉhttp://svnbook.red-bean.com/en/1.5/svn-book.html#svn.advanced.props.special.keywords
>
> Just my 2 cents,
> Jan Rosier
>
>
> On Sep 9, 2009, at 1:31 PM, Ken Guest wrote:
>
> Chuck
>> you're proposed solution makes sense - it is an example after-all...
>>
>>
>> k.
>>
>> On Wed, Sep 9, 2009 at 12:24 PM, Chuck Burgess <demon.gene@gmail.com>
>> wrote:
>>
>> On Mon, Sep 7, 2009 at 2:38 PM, Mark Wiesemann <wiesemann@php.net>
>>> wrote:
>>>
>>> Hannes Magnusson wrote:
>>>>
>>>> As you can see by the highlighting, that example is b0rked.
>>>>> I assume the documentor was trying to prevent the $Id$ keyword being
>>>>> expanded by SVN.
>>>>> This _could_ also be a bug in the application rendering the markup
>>>>> (PhD)...
>>>>>
>>>>> Please file this as a documentation bug report :]
>>>>>
>>>>>
>>>> The bug report already exists since March:
>>>> http://bugs.php.net/bug.php?id=47679
>>>>
>>>> Regards,
>>>> Mark
>>>>
>>>
>>>
>>>
>>> I took a look at that PHP bug, as well as looking at both the example in
>>> the
>>> docs and its source in standards.xml. Since both occurrences are
>>> examples
>>> of usage, should it matter if CVS/SVN expands the $Id$ keyword? If it
>>> doesn't, then the example shows you what you should write in your
>>> @version
>>> tag... if it does, the example shows what a fully expanded @version tag
>>> looks like. Either/both are reasonable example content, IMO. If there
>>> are
>>> no objections to this line of thinking, then I can solve the bug by
>>> simply
>>> using "$Id$" in those two instances and commit it.
>>>
>>> Thoughts?
>>> --
>>> CRB
>>>
>>>
>>
>>
>> --
>> http://blogs.linux.ie/kenguest/
>>
>