Re: Revision tracking in phpdoc and peardoc
| From: | Richard Quadling | Date: | Wed, 12 Nov 2008 11:04:53 +0000 |
| Subject: | Re: Revision tracking in phpdoc and peardoc | ||
| References: | 1 2 3 4 5 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969379676@lists.php.net to get a copy of this message | ||
2008/11/12 Richard Quadling <rquadling@googlemail.com>:
> 2008/11/12 Hannes Magnusson <hannes.magnusson@gmail.com>:
>> On Wed, Nov 12, 2008 at 03:09, Philip Olson <philip@roshambo.org> wrote:
>>>
>>> On 10 Nov 2008, at 12:32, Hannes Magnusson wrote:
>>>
>>>> On Sun, Nov 9, 2008 at 00:05, Christian Weiske <cweiske@cweiske.de> wrote:
>>>>>
>>>>> So what do people think now, one year after the last discussion?
>>>>
>>>> I still think manual bumping is the way-to-go, but I can live with
>>>> automaticbumping if someone writes such a svn hook.
>>>
>>> If the committer does nothing with a revision tag, then it should be assumed
>>> that the commit is translation worthy. However, if the committer feels it
>>> should not be translated (like simply typo, WS, ...), then said committer
>>> should be able to easily say so thus not outdate any translations with the
>>> commit. In other words, I prefer we lean towards the side of caution here by
>>> not requiring a manual bump.
>>
>> I guess.
>> "Tagging" commit messages with "[NOBUMP]" (i.e. "[NOBUMP] Fixed
>> typo,
>> no need to translate") when the revision shouldn't increased..
>> The problem there is however people will actually have to remember to
>> use that "tag"..
>>
>>
>>> How? I'm not sure. But once we all agree on a general route then I'm
>>> guessing we could figure out how to implement. Also, I'm guessing the move
>>> to SVN will open up a few more options here too.
>>
>> But we have to be ready before the SVN move as the move will destroy
>> our current revision checks. It cannot work and will get fucked right
>> after the first commit to SVN unless we have the hooks ready.
>>
>> -Hannes
>>
>
> Is there a way to create a template for commits?
>
> [ ] Typo/WS
> [ ] Minor change
> [ ] Major change/rewrite
> [ ] Example added
> Bug #
> Comments::
>
> I use Windows's TortoiseCVS and TortoiseSVN. When I commit using these
> tools I get the option of previous comments. So I can at least edit a
> previous one, though the possibility of an error here does exist.
>
> When I used Cygwin's CVS to commit changes, the editor runs with a
> template with comments telling me what to do.
>
> So, maybe there is a way to create a template for the phpdoc project
> which must/should be adhered to.
>
> Richard.
>
> --
> -----
> Richard Quadling
> Zend Certified Engineer :
> http://zend.com/zce.php?c=ZEND002498&r=213474731
> "Standing on the shoulders of some very clever giants!"
>
The Minor change option would be where the change only affects 1 file.
The Major change option would be where other files are also needing to
be changed.
I don't know for sure, but in CVS, changing 10 files in 1 commit
doesn't "group" them together (in a way that I can see anyway), but in
SVN, I think a "changeset" exists, so maybe this is a way to determine
more than 1 file. Obviously, a typo across many files in a single
commit could be seen as a "major" change.
Richard.
--
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"