TortoiseSVN 命令 (命令行执行工具）

http://jiangzhixiang123.blog.163.com/blog/static/278020622012114114556558/

TortoiseSVN是一个GUI客户端，这个自动化指导为你展示了让TortoiseSVN对话框显示并收集客户输入，如果你希望编写不需要输入的脚本，你应该使用官方的Subversion命令行客户端。

TortoiseSVN的GUI程序叫做
TortoiseProc.exe
。所有的命令通过参数
/command:abcd
指定，其中
abcd
是必须的命令名。大多数此类命令至少需要一个路径参数，使用
/path:"some\path"
指定。在下面的命令表格中，命令引用的是
/command:abcd
参数，余下的代表了
/path:"some\path"
参数。

因为一些命令需要一个目标路径的列表(例如提交一些特定的文件)，
/path
参数可以接收多个路径，使用
*
分割。

TortoiseSVN 使用临时文件在 shell 扩展和主程序之间传递多个参数。从 TortoiseSVN 1.5.0 开始，废弃
/notempfile
参数，不再需要增加此参数。

The progress dialog which is used for commits, updates and many more commands usually stays open after the command has finished until the user presses theOK button. This can be changed by checking the corresponding option in the settings dialog. But using that setting will close the progress dialog, no matter if you start the command from your batch file or from the TortoiseSVN context menu.

To specify a different location of the configuration file, use the parameter 
/configdir:"path\to\config\directory"
. This will override the default path, including any registry setting.

如果想在进度对话框执行完毕后自动关闭，而又不必设置永久性的参数，可以传递
/closeonend
参数。

/closeonend:0
 不自动关闭对话框

/closeonend:1
 如果没发生错误则自动关闭对话框

/closeonend:2
 如果没发生错误和冲突则自动关闭对话框

/closeonend:3
如果没有错误、冲突和合并，会自动关闭

/closeonend:4
如果没有错误、冲突和合并，会自动关闭

下面的列表列出了所有可以使用TortoiseProc.exe访问的命令，就像上面的描述，必须使用
/command:abcd
的形式，在列表中，因为节省空间的关系省略了
/command
的前缀。

表 D.1. 有效命令及选项列表

命令描述:about显示关于对话框。如果没有给命令也会显示。:log打开日志对话框，
/path
 指定了显示日志的文件或目录，另外还有三个选项可以设置: 
/startrev:xxx
、
/endrev:xxx
和
/strict:checkout打开检出对话框，
/path
指定了目标路径，而
/url
制定了检出的URL。:import打开导入对话框，
/path
 指定了数据导入路径。:update将工作副本的
/path
更新到HEAD，如果给定参数
/rev
，就会弹出一个对话框询问用户需要更新到哪个修订版本。为了防止指定修订版本号
/rev:1234
的对话框，需要选项
/nonrecursive
和
/ignoreexternals
。:commit打开提交对话框，
/path
 指定了目标路径或需要提交的文件列表，你也可以使用参数 
/logmsg
 给提交窗口传递预定义的日志信息，或者你不希望将日志传递给命令行，你也可以使用
/logmsgfile:path
，
path
 指向了保存日志信息的文件。为了预先填入bug的ID(如果你设置了集成bug追踪属性)，你可以使用
/bugid:"the bug id here"
完成这个任务。:add将
/path
的文件添加到版本控制 。:revert恢复工作副本的本地修改，
/path
说明恢复哪些条目。:cleanup清理中断和终止的操作，将工作副本的
/path
解锁。:resolve将
/path
指定文件的冲突标示为解决，如果给定
/noquestion
，解决不会向用户确认操作。:repocreate在
/path
创建一个版本库。:switch打开选项对话框。
/path
 指定目标目录。:export将
/path
的工作副本导出到另一个目录，如果
/path
指向另一个未版本控制目录，对话框会询问要导出到
/path
的URL。:mergeOpens the merge dialog. The 
/path
 specifies the target directory. For merging a revision range, the following options are available: 
/fromurl:URL
, 
/revrange:string
. For merging two repository trees, the following options are available: 
/fromurl:URL
, 
/tourl:URL
, 
/fromrev:xxx
 and 
/torev:xxx
. These pre-fill the relevant fields in the merge dialog.:mergeallOpens the merge all dialog. The 
/path
 specifies the target directory.:copyBrings up the branch/tag dialog. The 
/path
 is the working copy to branch/tag from. And the 
/url
 is the target URL. You can also specify the 
/logmsg
 switch to pass a predefined log message to the branch/tag dialog. Or, if you don't want to pass the log message on the command line, use 
/logmsgfile:path
, where 
path
 points to a file containing the log message.:settings打开设置对话框。:remove从版本控制里移除
/path
中的文件。:rename重命名
/path
的文件，会在对话框中询问新文件，为了防止一个步骤中询问相似文件，传递
/noquestion
。:diffStarts the external diff program specified in the TortoiseSVN settings. The 
/path
 specifies the first file. If the option 
/path2
 is set, then the diff program is started with those two files. If 
/path2
 is omitted, then the diff is done between the file in 
/path
 and its BASE. To explicitly set the revision numbers use 
/startrev:xxx
 and 
/endrev:xxx
. If
/blame
 is set and 
/path2
 is not set, then the diff is done by first blaming the files with the given revisions.:showcompare

Depending on the URLs and revisions to compare, this either shows a unified diff (if the option 
unified
 is set), a dialog with a list of files that have changed or if the URLs point to files starts the diff viewer for those two files.

The options 
url1
, 
url2
, 
revision1
 and 
revision2
 must be specified. The options 
pegrevision
, 
ignoreancestry
, 
blame
 and 
unified
 are optional.

:conflicteditorStarts the conflict editor specified in the TortoiseSVN settings with the correct files for the conflicted file in 
/path
.:relocate打开重定位对话框，
/path
指定了重定位的工作副本路径。:help打开帮助文件:repostatus打开为修改检出对话框，
/path
 指定了工作副本目录。:repobrowserStarts the repository browser dialog, pointing to the URL of the working copy given in 
/path
 or 
/path
 points directly to an URL. An additional option 
/rev:xxx
 can be used to specify the revision which the repository browser should show. If the 
/rev:xxx
 is omitted, it defaults to HEAD. If 
/path
 points to an URL, the 
/projectpropertiespath:path/to/wc
specifies the path from where to read and use the project properties.:ignore将
/path
中的对象加入到忽略列表，也就是将这些文件添加到 
svn:ignore
 属性。:blame

为 
/path
 选项指定的文件打开追溯对话框。

如果设置了 
/startrev
 和 
/endrev
 选项，不会显示询问追溯范围对话框，直接使用这些选项中的版本号。

如果设置了 
/line:nnn
 选项，TortoiseBlame 会显示指定行数。

也支持 
/ignoreeol
，
/ignorespaces
 和 
/ignoreallspaces
 选项。

:cat将
/path
指定的工作副本或URL的文件保存到
/savepath:path
，修订版本号在
/revision:xxx
，这样可以得到特定修订版本的文件。:createpatch创建
/path
下的补丁文件。:revisiongraph显示
/path
目录下的版本变化图。:lockLocks a file or all files in a directory given in 
/path
. The 'lock' dialog is shown so the user can enter a comment for the lock.:unlockUnlocks a file or all files in a directory given in 
/path
.:rebuildiconcacheRebuilds the windows icon cache. Only use this in case the windows icons are corrupted. A side effect of this (which can't be avoided) is that the icons on the desktop get rearranged. To suppress the message box, pass 
/noquestion
.:properties显示 
/path
 给出的路径之属性对话框。

Examples (which should be entered on one line):

TortoiseProc.exe /command:commit                   /path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"                   /logmsg:"test log message" /closeonend:0    TortoiseProc.exe /command:update /path:"c:\svn_wc\" /closeonend:0    TortoiseProc.exe /command:log /path:"c:\svn_wc\file1.txt"                   /startrev:50 /endrev:60 /closeonend:0