SVN的使用

Hi team,

When we commit changes into svn to resolve a redmine ticket, please remember to associate the revision number:

$ svn commit -m "Resolved a buffer overflow issue in function xxx(). This fixes #5678." (This will also marked the ticket resolved.)

$ svn commit -m "See #5678. Resolved a buffer overflow issue in function xxx()." (This will add a reference to the ticket.)

For example keyword “fixes” used in ticket #4288:

https://redmine.cpnt.net/issues/4288

[sbin]$ svn log svcs --limit 1

------------------------------------------------------------------------

r7412 | saint | 2011-05-04 14:48:08 -0700 (Wed, 04 May 2011) | 1 line

fixes #4288 to turn off logger before applying firewall rules and to turn it back on following the change

------------------------------------------------------------------------

For example keyword “see” used in ticket #4288:

https://redmine.cpnt.net/issues/4232

[trunk]$ svn log platform/base.runtime/usr/sbin/runtime --limit 1

------------------------------------------------------------------------

r7342 | rjen | 2011-04-21 10:54:36 -0700 (Thu, 21 Apr 2011) | 1 line

See #4232.

------------------------------------------------------------------------

Thanks,

Rick

各位同事，

对于SVN使用还不熟悉的同事，请认真看下Rick的邮件，关于怎么使用fixes, see关键字，关联到ticket问题。
同时，为了确保自己的修改与他人的修改是同步的，不至于造成把他人的修改覆盖掉等版本混乱问题，请注意下面几点建议：

1. $svn update -- 在做任何修改，或是提交前，请使用update命令，把他人的修改更新到自己的版本上，以便于与他人的修改同步。如果不这样做，试想这样的情况，昨天tim在makefile第22行加了一句#i am tim;现在，你要在makefile第30行处加一句# I am Liping.;然后，你直接提交了，那么，昨天我加的#i am tim就不见了。（你不能确定tim加这行是什么作用，也不用去确认）；所以，请记住，在任何时候，先update一下，尤其在你要做修改和提交前。
2. $svn status ---用这个命令来看一下，你自己修改了哪些文件。
3. $svn diff xxxx -- 用这个命令逐一查看修改的文件，与之前版本有什么不同，并确认，这些不同是确实需要这样改的。对于，你只是临时改一下，但不想提交的，最好的办法是，先从本地把这个文件删除(记住，是用shell的rm，不是svn的delete)，然后，再用svn update命令重新下载过来。
4.$svn commit ---在经过上面三个步骤后，确认你确实要提交这些改动后，再使用svn commit.

以上四个步骤，请严格依次执行，以确保不造成版本混乱。同时，还要注意下面几个问题，
5. 请不要使用root用户来进行svn操作，请退出到普通用户。
6. 请不要在不同的版本之间互相复制文件，目录。比如从firmware 3.4.x中直接复制一个文件到firmware 3.5.0上，除非你知道这个文件在3.5.0里没有，否则坚决不要这样做。请耐心的对待你要做的修改，在现有版本基础上，手工添加不同修改为宜。坚决不要直接cp目录过来.
7. 对于与ticket的信息关联，请看下面Rick的邮件。

在使用SVN做任何事情时，把握一个原则：这里不只我一个人在修改，我的修改怎么不会与别人的修改冲突？！

Thanks,
Tim