竭诚为您提供优质文档/双击可除
svn提交注释规范
篇一：sVn版本管理与提交代码规范
sVn版本管理，提交代码规范
项目开发要求：
1、工作目录要及时更新，不要和sVn服务器有太大的差别
2、提交代码时，如果出现冲突，必须仔细分析解决，不可以强行提交
3、提交代码之前先在本地进行测试，确保项目能编译通过，且能够正常运行，不可盲目提交
4、必须保证sVn上的版本是正确的，项目有错误时，不要进行提交
sVn注意事项，请严格按照操作顺序操作，避免提交代码导致重大事故：
一．提交之前先更新
1.sVn更新的原则是要随时更新，随时提交。当完成了一个小功能，能够通过编译并且自己测试之后，谨慎地提交。
2.如果在修改的期间别人也更改了svn的对应文件，那
么commit就可能会失败。如果别人和自己更改的是同一个文件，那么update时会自动进行合并，如果修改的是同一行，那么合并时会产生冲突，这种情况就需要同之前的开发人员联系，两个人一起协商解决冲突，解决冲突之后，需要两人一起测试保证解决冲突之后，程序不会影响其他功能。
3.在更新时注意所更新文件的列表，如果提交过程中产生了更新，则也是需要重新编译并且完成自己的一些必要测试，再进行提交。这样既能了解别人修改了哪些文件，同时也能避免sVn合并错误导致代码有错
二．保持原子性的提交
每次提交的间歇尽可能地短，以几个小时的开发工作为宜。例如在更改ui界面的时候，可以每完成一个ui界面的修改或者设计，就提交一次。在开发功能模块的时候，可以每完成一个小细节功能的测试，就提交一次，在修改bug的时候，每修改掉一个bug并且确认修改了这个bug，也就提交一次。我们提倡多提交，也就能多为代码添加上保险。
三．提交时注意不要提交本地自动生成的文件
一般配置管理员都会将项目中一些自动生成的文件或
者与本地配置环境有关的文件屏蔽提交（例如eclipse中的.classpath文件等）。如果项目中没有进行这方面的配置来强行禁止提交这样的文件，请自觉不要提交这样的文件。提交了这样的文件后，别人在更新后就可能与本地的环境冲
突从而影响大家的工作。
四．不要提交不能通过编译的代码
代码在提交之前，首先要确认自己能够在本地编译。如果在代码中使用了第三方类库，要考虑到项目组成员中有些成员可能没有安装相应的第三方类库。项目经理在准备项目工作区域的时候，需要考虑到这样的情况，确保开发小组成员在签出代码之后能够在统一的环境中进行编译。
五．不要提交自己不明白的代码
代码在提交入sVn之后，你的代码将被项目成员所分享。如果提交了你不明白的代码，你看不懂，别人也看不懂，如果在以后出现了问题将会成为项目质量的隐患。因此在引入任何第三方代码之前，确保你对这个代码有一个很清晰的了解。
六．提前协调好项目组成员的工作计划
项目经理应该合理分配工作计划。每个成员在准备开始进行某项功能的修改之前，如果有可能，先跟工作小组的成员谈谈自己的修改计划，让大家都能了解你的思想，了解你即将对软件作出的修改，这样能尽可能的减少在开发过程中可能出现的冲突，提高开发效率。同时你也能够在和成员的交流中发现自己之前设计的不足，完善你的设计。
七．对提交的信息采用明晰的标注（写注释）
在一个项目组中使用sVn，如果提交空的标注或者不确
切的标注将会让项目组中其他的成员感到很无奈，项目经理无法很清晰的掌握工作进度，无法清晰的把握此次提交的概要信息。在发现错误后也无法准确的定位引起错误的文件。所以，在提交工作时，要填写明晰的标注，能够概要的描述所提交文件的信息，让项目组其他成员在看到标注后不用详细看代码就能了解你所做的修改。
八．慎用锁定功能
在项目中要慎用锁定的功能，在你锁定了一个文件之后别人就无法继续修改提交该文件，虽然可以减少冲突的发生率，但是可能会影响项目组中其他人员的工作。平时只有在编辑那些无法合并的文件（例如图片文件，flash文件等）时，才适当的采用锁定操作。
篇二：sVn版本管理,提交代码规范
项目开发要求：
1、工作目录要及时更新，不要和sVn服务器有太大的差别
2、提交代码时，如果出现冲突，必须仔细分析解决，不可以强行提交
3、提交代码之前先在本地进行测试，确保项目能编译通过，且能够正常运行，不可盲目提交
4、必须保证sVn上的版本是正确的，项目有错误时，不要进行提交
sVn注意事项，请严格按照操作顺序操作，避免提交代码导致重大事故：
一．提交之前先更新
1.sVn更新的原则是要随时更新，随时提交。当完成了一个小功能，能够通过编译并且自己测试之后，谨慎地提交。
2.如果在修改的期间别人也更改了svn的对应文件，那么commit就可能会失败。如果别人和自己更改的是同一个文件，那么update时会自动进行合并，如果修改的是同一行，那么合并时会产生冲突，这种情况就需要同之前的开发人员联系，两个人一起协商解决冲突，解决冲突之后，需要两人一起测试保证解决冲突之后，程序不会影响其他功能。
3.在更新时注意所更新文件的列表，如果提交过程中产生了更新，则也是需要重新编译并且完成自己的一些必要测试，再进行提交。这样既能了解别人修改了哪些文件，同时也能避免sVn合并错误导致代码有错
二．保持原子性的提交
每次提交的间歇尽可能地短，以几个小时的开发工作为宜。例如在更改ui界面的时候，可以每完成一个ui界面的修改或者设计，就提交一次。在开发功能模块的时候，可以每完成一个小细节功能的测试，就提交一次，在修改bug的时候，每修改掉一个bug并且确认修改了这个bug，也就提交一次。我们提倡多提交，也就能多为代码添加上保险。
目录 第一章引言 (1) 1.1Subversion的介绍 (1) 1.2Subversion的特性 (1) 1.3SVN模式 (2) 1.4SVN操作流程 (3) 第二章SVN使用 (4) 2.1SVN软件安装 (4) 2.2事业部SVN库介绍 (4) 2.2.1事业部SVN库 (4) 2.2.2注册、权限申请 (5) 2.3基本操作 (5) 2.3.1操作介绍 (5) 2.4系统规使用 (18) 2.4.1规操作 (18) 2.4.2版本控制的使用 (19) 2.4.3与目录无关容 (19) 2.4.4文件夹目录名称规 (20) 2.4.5文件上传格式 (21) 2.4.6文件、数据放置 (21) 2.5日常使用问题 (21) 2.5.1版本库无响应 (21) 2.5.2中的路径 (21) 2.5.3系统库最上层打不开 (22) 2.5.4提交失败（Commit fail） (22) 2.5.5SVN文件夹无法下载 (23) 2.5.6特征图标的显示 (23) 2.5.7冲突问题解决 (24) 第三章权限申请流程 (26) 3.1权限定义 (26) 3.2申请流程 (26) 3.2.1普通权限申请 (26) 3.2.2单位权限申请 (26) 3.2.3特殊权限申请 (27)
3.3表单使用 (28) 附录 (1) 参考文献 (5)
SVN使用规 第一章引言 1.1Subversion的介绍 SVN是Subversion的缩写。Subversion管理随时改动的文件和目录，以二进制格式存储所有的文件，使用高效的比较二进制差异算法来计算版本之间的改动。同时，它是一个时间机器，随时记录文件和目录的每次改动，例如：文件的增加、删除、重新排列文件等。同时SVN允许你恢复以前旧版本的数据，或者检查数据变化的历史。 SVN使用类似数据库事物的方式来处理用户提交入库的过程，整个改动要么成功的被提交，要么被中断并回滚。在数据提交完之前，其他人是看不到用户提交的修改文件，你看到的要么是改动之前的状态，要么是改动之后的状态。这样的行为被称为“原子提交”。原子提交很有用，因为它能保证所有相关人员看到的总是相同的东西。原子提交过程的其中一步就是包括把你的所有改动打包为一个“修订集”（有时被称为改动集），并且再给个改动标记的修订号（绿色勾变为红色叹号）。 1.2Subversion的特性 1.2.1 版本化的目录 Subversion实现了一个可以跟踪目录树更改的“虚拟”版本化文件系统，文件和目录都是有版本的。 1.2.2 真实的版本历史 通过Subversion你可以对文件或是目录进行增加、拷贝和改名操作，也可以新增一个具有干净历史的文件。可以毫不夸的将每一个版本都可以作为一个记忆片段定点。 1.2.3 原子提交
设置注释模板的入口：Window->Preference->Java->Code Style->Code Template 然后展开Comments节点就是所有需设置注释的元素啦。现就每一个元素逐一介绍： 文件(Files)注释标签： /** * @Title: ${file_name} * @Package ${package_name} * @Description: ${todo} * @author chenguang * @date ${date} ${time} * @version V1.0 */ 类型(Types)注释标签（类的注释）： /** * 类功能说明 * 类修改者修改日期 * 修改说明 * Title: ${file_name} * Description:清大海辉科技开发平台 * Copyright: Copyright (c) 2006 * Company:北京清大海辉科技有限公司 * @author ${user} * @date ${date} ${time} * @version V1.0 */ 字段(Fields)注释标签： /** * @Fields ${field} : ${todo} */ 构造函数标签： /** * Title: * Description: * ${tags} */
方法(Constructor & Methods)标签： /** * 函数功能说明 * ${user} ${date} * 修改者名字修改日期 * 修改内容 * @param ${tags} * @return ${return_type} * @throws */ getter方法标签： /** * @return ${bare_field_name} */ setter方法标签： /** * @param ${param} ${bare_field_name} */ 加注释快捷键：选中你要加注释的方法或类，按Alt + shift + J。
SVN环境搭建及使用手册 一、SVN介绍 SVN是Subversion的简称，是一个开放源代码的版本控制系统，相较于RCS、CVS，它采用了分支管理系统，说得简单一点SVN就是用于多个人共同开发同一个项目，共用资源的目的。 二、SVN安装包介绍（安装包存放在服务器上D:\安装包\SVN） 服务端：SVN服务端安装包是VisualSVN-Server-3.6.0-x64.msi。 客户端：客户端软件主要包括下列3个文件 1. TortoiseSVN-1.8.8.25755-x64-svn-1.8.10.msi ----SVN客户端安装包 2. LanguagePack_1.9.5.27581-x64-zh_CN.msi ----SVN客户端语言包 3. AnkhSvn-2.5.12471.17.msi -----SVN针对Visual Studio的插件 三、搭建SVN服务端详细说明 第一步：搭建SVN团队项目、在服务器上打开已安装的SVN服务端、新建一个项目文件夹、创建完成后、右键项目复制项目URL 具体如下图
第二步：创建SVN用户、及设置密码、如下图 第三步：SVN服务端创建项目完成及创建用户后、使用SVN客户端将程序代码等文件提交上去、选中需要提交的程序文件、并填写正确SVN服务端项目的URL地址、
四、在日常开发中使用SVN的常用操作主要有：签出程序、文件合并、代码文件撤销、版本回滚、及历史版本控制等 说明：使用SVN版本控制，必须遵循4个原则。 1.新建文件前获取最新的程序代码、新建文件后先提交文件、再进行详细开发或编辑。 2.尽量避免多人同时处理同一个文件（svn毕竟不是那么优秀、无法智能将代码成功合并）。 3.项目成员提交程序前、必须获取最新的程序、编译且没问题、再进行提交操作。 4.提交代码必须选择解决方案进行代码提交、请勿选择其中某项目进行提交。 （1）签出最新程序：选择解决方案右键--》Update Solution to Latest Version, 如下图 （2）代码文件合并：如svn上的文件与本地文件产生冲突、则会在Pending Changes 中高亮显示、双击文件打开双方文件差异、合并完成后、点击Commit进行合并后文件提交。如下图
基于Tortoise SVN的软件产品版本管理规范[草稿]
目录 1. 引言 (1) 1.1. 目的 (1) 1.2. 范围 (1) 1.3. 术语定义 (1) 1.4. 参考资料 (2) 1.5. 版本控制记录 (2) 1.6. 版本更新记录 (2) 1.版本管理 (4) 2.1. 版本标示方法 (4) 2.1.1. 正式版本 (4) 2.2. 目录结构 (5) 2.3. 文档的存放 (6) 2.3.1. 开发文档的存放 (6) 2.3.2. 源代码的存放 (6) 2.3.3. SQL的语句存放 (7) 2.3.4. 发行文档的存放 (7) 2.4. 配置管理流程 (7) 2.5. 权限控制的管理 (8) 2.更新管理 (9) 3.1. 源程序的修改 (9) 3.2. 版本升级 (10) 3.2.1. 版本升级原则 (10) 3.2.2. 新版本发布 (11) 3.3. 文档的变更 (11) 3.备份管理 (12) 4.版本工具Tortoise SVN的使用 (13)
1.引言 版本控制就是对软件开发过程中所创建的配置对象不同版本进行管理，保证任何时间都可以取到正确的版本以及版本的组合。 版本控制的主要功能是记录开发过程中的每一次修改，让开发的工作可以随时检查过往历史记录和获得正确版本，是系统的成长记录。 1.1.目的 本文档的编制是为了规范产品部、研发部、测试部对软件产品版本的管理。 1.2.范围 本文档为产品部、研发部、测试部的管理员提供有关版本管理规范的相关 内容，包括： ●●●●版本标识方法 软件系统数据的存放文档的修改控制 文档的备份制度 1.3.术语定义 SCM 软件配置管理（Software Configuration Management）缩写SVM 软件版本管理（Software Version Management）缩写 SVN 一个开源的版本控制系统Subversion. 文档
Eclipse自动添加注释 我们在用Eclipse开发工具编写代码时，常常需要在类的头部加上一下注释，标明类的作者，创建时间等等。我们常用的做法是： 方式1：在新建类时勾选：Generate comments 如图1。 图1 创建类时指定生成注释 这种方式固然可以生成，但是只会是Eclipse默认的，仅有@author xxxx
方式2：快捷键生成 第二种就是我们生成类的时，也许忘了勾选。那么我们就会使用Eclipse提供的快捷键ctrl+alt+j 图2 快捷键添加注释 当然这种方式也需要开发者，现将鼠标定位类名行或者方法名行。然后生成对应的注释。那么如果我们想要自己定义自己的注释呢？ 方式三：自动生成自定义注释 Eclipse最大好处就是很多东西都能让开发者自己来定义。下面说说如何自定义生成注释。 3.1首先自定义注释模板 打开：windows-->preference -->Java-->code style -->code templates --> code -->new java file 按照如上操作打开到相应对话框，如下图3
图3：注释模板对话框 当进入到这个对话框后，点击右侧“Edit”编辑按钮，进入到注释模板编辑对话框，如下图4：
图4 编辑自定义注释模板 在这个对话框中编辑你想要的注释模板，编辑完成后点击OK。 附：注释基本模板： 当点击OK退出模板编辑对话框后，勾选：automatically add comments for new methods and types，如图5
图5 设置自动添加注释 当然，你还可以设置很多注释，包括getter、setter等等的注释，都在这里，有兴趣的你都可以多试试。
S V N使用手册版 Document serial number【NL89WT-NY98YT-NC8CB-NNUUT-NUT108】
S V N环境搭建及使用手册 一、SVN介绍 SVN是Subversion的简称，是一个开放源代码的版本控制系统，相较于RCS、CVS，它采用了分支管理系统，说得简单一点SVN就是用于多个人共同开发同一个项目，共用资源的目的。 二、SVN安装包介绍（安装包存放在服务器上 D:\安装包\SVN） 服务端：SVN服务端安装包是。 客户端：客户端软件主要包括下列3个文件 1. ----SVN客户端安装包 2. ----SVN客户端语言包 3. -----SVN针对Visual Studio的插件 三、搭建SVN服务端详细说明 第一步：搭建SVN团队项目、在服务器上打开已安装的SVN服务端、新建一个项目文件夹、创建完成后、右键项目复制项目URL 具体如下图
第二步：创建SVN用户、及设置密码、如下图 第三步：SVN服务端创建项目完成及创建用户后、使用SVN客户端将程序代码等文件提交上去、选中需要提交的程序文件、并填写正确SVN服务端项目的URL地址、
四、在日常开发中使用SVN的常用操作主要有：签出程序、文件合并、代码文件撤销、版本回滚、及历史版本控制等 说明：使用SVN版本控制，必须遵循4个原则。 1.新建文件前获取最新的程序代码、新建文件后先提交文件、再进行详细开发或编辑。 2.尽量避免多人同时处理同一个文件（svn毕竟不是那么优秀、无法智能将代码成功合并）。 3.项目成员提交程序前、必须获取最新的程序、编译且没问题、再进行提交操作。 4.提交代码必须选择解决方案进行代码提交、请勿选择其中某项目进行提交。（1）签出最新程序：选择解决方案右键--》Update Solution to Latest Version, 如下图
一、TortoiseSVN客户端的安装 1．客户端软件：TortoiseSVN-1.7.12.24070-win32-svn-1.7.9.msi 下载：\\10.0.0.127\share\SVN\SVN 客户端 中文语言包：LanguagePack_1.7.12.24070-win32-zh_CN.msi 下载：\\10.0.0.127\share\SVN\SVN 客户端\语言包 （客户端安装在系统的默认位置，不需要特殊的配置，安装完成后需要重新起动系统, 重启之后鼠标的右键菜单会多出这么一组命令） 2. 中文语言包的安装如下：
二、Subversion基本工作流程 这部分最重要，也是大家经常要用到的，即如何利用TortoiseSVN客户端对subversion库中的文件进行操作。 1.如何把subversion库中已经保存的文件版本检出到本地、并作修改后提交、从服务器端更新本地文件的版本。 检出到本地： 初次检出到本地文件夹时，在本地新建一个空文件夹，具体操作如下图： 如果要检出最新的版本可选中上图的（最新版本(H)）单选按钮。 如果想检出自己需要的版本可选中上图的（版本(R)）单选按钮，然后选择自己需要的版本文件。 在弹出的对话框中输入自己的用户名和密码。
修改文件后提交：(修改文件夹中的内容后文件夹会自动变成带有红色标记) 在信息框中为修改的文件添加说明信息。如下图 在变更列表中选中更变的文件。如下图
点击确定后会提示输入用户名和密码。
从服务器端更新本地文件的版本： 如果服务器上的版本库已经是第7版本,自己本机的版本还是第1版本。这时你可以更新自己本地的版本为第7版本。
SVN管理规则 编写目的：为了保存项目资料，管理项目版本。提高开发的工作效率，管理项目文件，特别制定此规定。使用范围：开发部 文件类型：程序文件技术文件作业文件外来文件质量记录表格 受控级别：保密非保密 正文内容： 一.SVN安装和使用 1：SVN使用TortoiseSVN-1.5.8.15348-win32-svn-1.5.5.msi版本。 2：请按照使用说明书的方法使用。 使用说明书目录：\\172.16.0.2\RD_Share\TortoiseSVN-1.5.8.15348-win32-svn-1.5.5目录下。 这里简单说明几个重要的使用的命令： 1)updata ：为更新SVN资料，相当于下载的功能。 2)check out ：这个命令是在收到工作流程的时候，分配的一个路径的时候，可以用这个命令把相关资料 下载到本机目录下。 3)commit ：上传修改的项目文件。 4)show log ：显示当前SVN版本，和此版本修改的信息。 二.SVN目录管理规定 Xxxx_项目名称 | |——DOC | |——user 存放相关用户DOC文件 | |——product 存放相关产品DOC文件 | |——refer 存放相关产品设计参考资料 | |——tech 存放产品技术文件 | |——test 存放产品测试文件 | |——firmware | |——main 存放产品代码 | |——test 存放产品测试代码 | |——hardware | |——main 存放产品电路设计 | |——test 存放产品测试工装电路设计 | |——release 存放产品发布的资料（针对管理部） 1）按照规定，把开发资料存放到相关的目录下。 2）文件的名称命名以“项目名称+相关文件名称”。名称不需要加上版本号。SVN将自动保存版本号。 例如： 0901_DryContact 项目，他的清单命名为《DryContact元器件清单.doc》 三.SVN日常管理规定 1）开发人员所有的项目资料必须上传SVN。
程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:
目录 1.修改SVN访问密码 (1) 2.SVN客户端使用说明 (2) 2.1.安装SVN客户端 (2) 2.2.迁出配置库内容 (3) 2.3.维护工作文件 (4) 2.3.1.增加文件 (4) 2.3.2.更新文件 (8) 2.3.3.删除文件 (9) 2.3.4.修改文件 (10) 2.3.5.比较版本差异 (10) 2.3.6.撤销更改 (13) 2.3.7.锁定和解锁 (13) 2.3.8.重命名文件 (14) 2.3.9.获取历史文件 (14) 2.3.10.检查冲突 (15) 2.3.11.解决冲突 (16) 2.3.12.忽略无需版本控制的文件 (16) 2.3.13.去除SVN标志 (17) 2.3.14.查看文件每行的修改信息 (17) 2.3.15.重置访问路径 (18) 2.3.16.本地路径转换 (18) 2.4.浏览版本库 (18) 2.5.建立标签 (19) 2.6.建立分支 (19) 2.7.清除用户名等信息 (20) 2.8.统计信息 (21) 3.MYECLIPSE集成SVN (23) 3.1.安装SVN插件 (23) 3.2.配置M Y E CLIPSE提交目录 (28)
1. 修改SVN访问密码 打开IE，在地址栏中输入地址：http:// /svnmanager/index.php，进入SVNManager的欢迎界面，如下图所示： 点击“登陆”按钮进入登陆界面，如下图所示： 输入已知的用户名和密码，点击“登陆”按钮进入用户管理界面，点击“用户管理”按钮显示“编辑用户”菜单，如下图所示： 点击“编辑用户”按钮，进入用户信息修改界面，如下图所示：
文档名称：软件总代码行数_软件注释 率分析 作者: 日期：
1. cncc 1.1 工具简介 度量工具名称cncc 网址https://www.doczj.com/doc/a76870664.html,/ 操作方式命令行 实现语言C++ 适用的操作系统Windows 可以度量的属性code-lines, empty-lines, comment-lines, total-lines 备注 1.2 工具优缺点总结 最新版本 cncc-1-3-1，在sourceforge中2004年已经停止更新。最大的优点是源代码全部存于一个cpp文件，便于集成。 缺点： 1.代码基本没有注释。 2.下载的代码编译有9个错误。 3.费了2个多小时也没搞定。 1.3 使用例程 无。 2. CodeCount 2.1 工具简介 度量工具名称CodeCount 网址https://www.doczj.com/doc/a76870664.html,/downloads421/sourcecode/windows
/control/detail1783204.html 操作方式GUI 实现语言C++ 适用的操作系统Windows 可以度量的属性total-lines, empty-lines, comment-lines, code-lines, 备注 2.2 工具优缺点总结 优点： 工具比较精简，统计源文件总行数、代码行数、空白行数、注释行数，代码有一定的注释。 缺点： 下载的源码是vc7工程，由于机器并没有vc7，利用工具进行工程类型转换，将vc7的工程转换为vc6的工作，编译出错。 核心代码如下： BOOL bCommentSet = FALSE; //注释行统计标识有"/*"时TRUE, "*/"时FALSE BOOL bQuatoSet = FALSE; //字符串统计标识首次一行有奇数个"时TRUE, 下一行有奇数个"时FALSE int nLength = (int)file.GetLength(); CString bufRead; int nLineCommentBegin = 0; while(file.ReadString(bufRead)!=FALSE) { BOOL bStatedComment = FALSE;//本行作为注释行是否已统计过 BOOL bStatedCode = FALSE; //本行作为代码行是否已统计过 nLines++; bufRead.TrimLeft(); //先将文件头的空格或制表符去掉 if(bufRead.GetLength()==0) //为空白行
Subversion管理规范 一Subversion介绍 Subversion (Subversion)是一个时间机器，随时记录文件和目录的每次改动，例如：文件的增加、删除、重新排列文件等。同时SUBVERSION允许你恢复以前旧版本的数据，或者检查数据变化的历史。 SVN使用类似数据库事物的方式来处理用户提交入库的过程，整个改动要么成功的被提交，要么被中断并回滚。在数据提交完之前，其他人是看不到用户提交的修改文件，你看到的要么是改动之前的状态，要么是改动之后的状态。这样的行为被称为“原子提交”。原子提交很有用，因为它能保证所有相关人员看到的总是相同的东西。原子提交过程的其中一步就是包括把你的所有改动打包为
一个“修订集”（有时被称为改动集），并且再给个改动标记的修订号（绿色勾变为红色叹号）。 图 1 图1总体概括了SVN 整个操作过程：首先用户从版本库通过网络“检出”到本地工作副本中，然后，在本地工作副本中进行增加、修改、删除文件后“提交”到版本库中，如果本地工作副本中版本较系统版本过时，用户使用“更新”功能与系统上版本保持一致。 二 Subversion 的目录结构 每个SVN 版本库下需要有trunk(可用项目名做目录名)、branches 及tags 目录，trunk 表示开发时版本存放的目录，即在开发阶段的代码都提交到该目录上。branches 表示发布的版本存放的目录，即项目上线时发布的稳定版本存放在该目录中。tags 表示保存测试无问题的发布版本，不可修改。branches/tags 命名规则：项目名[_说明]_版本号。 在这需要说明下分三个目录的原因，如果项目分为一期、二期、三期等，那么一期上线时的稳定版本就应该在一期完成时将代码copy 到branches 上，这样二期开发的代码就对一期的代码没有影响，如新增的模块就不会部署到生产环境上。而branches 上的稳定的版本就是发布到生产环境上的代码，如果用户使用的过程中发现有bug ，则只要在branches 上修改该bug ，修改完bug 后再编译branches 上最新的代码发布到生产环境即可。tags 的作用是将在branches 上修改的bug 的代码合并到trank 上时创建个版本标识，以后branches 上修改的bug 代码再合并到trunk 上时就从tags 的version 到branches ，最新的version 合并到trunk ，以保证前期修改的bug 代码不会在合并。 版本库 本地工作副本
SVN命令使用手册修改版本记录 M：修改A：添加D：删除
SVN命令使用 一、常用命令 1.Svnadmin create创建库 svnadmin create path 在windows版本上： D:\>svnadmin create test2 D:\> 通过dir来列出目录中文件，已经包含test2，如图1所示： 图1 说明此时已经成功建立 2.Svn import导入项目 svn import project_path svn_lib_path -m “comment” 举例： 假设有一个工程名称unismg，代码的文件目录是unicom； A、我们在D盘新建目录unismg，在此目录下新建三个文件目录，如图2所示： 图2
trunk中存放的是项目主线；branches中存放源码分支；tags存放在开发过程中做的标签。 B、我们将代码unicom放到d:\unismg\trunk\中 C、执行命令D:\>svn import d:\unismg file:///d:/test2/unismg -m "initial import unismg" 结果如图3所示： 图3 这样我们就将工程代码导入svn库中管理。此时删除D:\>unismg目录也没有关系，因为你的源代码已经在SVN库中管理了。 有人会有疑问，为什么我到test2目录中去找*.c文件怎么一个没有找到啊，是的SVN 管理代码，并不是简单的保存文件，而是利用bdb管理的，所以你看不到源码存在。 之后你可以使用后续的命令来工作了。 多说一句，关于svn_lib_path的几种形式： file:///直接版本访问（本地磁盘） http://通过配置subversion的Apache服务器的WebDAV协议 https://与http://相似，只不过增加了ssh协议 Svn://通过svnserver服务自定义的协议 Svn+ssh://与svn://相似，但是通过SSH协议封装 比如，联通在信网关在30.251linux服务器上，使用的是svnserver服务自定义的协议，那么，导入工程代码时应采用的命令是： svn import $path/proj/unismg svn://192.168.30.251:3482-m "initial import unismg" 3.Svn co: 将文件checkout到本地目录 svn checkout path（path是服务器上的目录） 例如：svn checkout svn://192.168.1.1/pro/domain 简写：svn co 举例： svn co svn://192.168.30.251:3482/trunk/unicom 下面信息就是从库中下载的代码信息。
1.使用注意事项 负责而谨慎地提交自己的代码（先更新后提交） SVN更新的原则是要随时更新，随时提交。当完成了一个小功能，能够通过编译并且并且自己测试之后，谨慎地提交。 如果提交过程中产生了冲突，则需要同之前的开发人员联系，两个人一起协商解决冲突，解决冲突之后，需要两人一起测试保证解决冲突之后，程序不会影响其他功能。 如果提交过程中产生了更新，则也是需要重新编译并且完成自己的一些必要测试，再进行提交。 保持原子性的提交 每次提交的间歇尽可能地短，以一个小时，两个小时的开发工作为宜。如在更改UI界面的时候，可以每完成一个UI界面的修改或者设计，就提交一次。在开发功能模块的时候，可以每完成一个小细节功能的测试，就提交一次，在修改bug 的时候，每修改掉一个bug并且确认修改了这个bug，也就提交一次。我们提倡多提交，也就能多为代码添加上保险。 不要提交自动生成的文件 Visual Studio在生成过程中会产生很多自动文件，如.suo等配置文件，Debug,Release,Obj等编译文件，以及其他的一些自动生成，同编译代码无关的文件，这些文件在提交的时候不应该签入，如果不小心签入了，需要使用Delete 命令从仓库中删除。这个可以使用SVN过滤功能，在设置里面设置ignore lists. 不要提交不能通过编译的代码 代码在提交之前，首先要确认自己能够在本地编译。如果在代码中使用了第三方类库，要考虑到项目组成员中有些成员可能没有安装相应的第三方类库或者没有放入GAC（针对.Net Framework）中，项目经理在准备项目工作区域的时候，需要考虑到这样的情况，确保开发小组成员在签出代码之后能够在统一的环境中进行编译。 不要提交自己不明白的代码 代码在提交入SVN之后，你的代码将被项目成员所分享。如果提交了你不明白的代码，你看不懂，别人也看不懂，如果在以后出现了问题将会成为项目质量的隐患。因此在引入任何第三方代码之前，确保你对这个代码有一个很清晰的了解。提前宣布自己的工作计划 在自己准备开始进行某项功能的修改之前，先给工作小组的成员谈谈自己的修改计划，让大家都能了解你的思想，了解你即将对软件作出的修改，这样能尽可能的减少在开发过程中可能出现的冲突，提高开发效率。同时你也能够在和成员的交流中发现自己之前设计的不足，完善你的设计。 对提交的信息采用明晰的标注 +) 表示增加了功能 *) 表示对某些功能进行了更改 -) 表示删除了文件，或者对某些功能进行了裁剪，删除，屏蔽。 b) 表示修正了具体的某个bug
svnaddvalues/strings.xml//--添加 svnst//--查看状态 svnci//--提交svnci-msvnci,permission 1、将文件checkout到本地目录 svncheckoutpath(path是服务器上的目录) 例如：svncheckoutsvn://192.168.1.1/pro/domain 简写：svnco 2、往版本库中添加新的文件 svnaddfile 例如：svnaddtest.php(添加test.php) svnadd*.php(添加当前目录下所有的php文件) 3、将改动的文件提交到版本库 svncommit-mLogMessage[-N][--no-unlock]PATH(如果选择了保持锁，就使用--no-unlock开关) 例如：svncommit-maddtestfileformytesttest.php 简写：svnci 4、加锁/解锁 svnlock-mLockMessage[--force]PATH 例如：svnlock-mlocktestfiletest.php svnunlockPATH 5、更新到某个版本 svnupdate-rmpath
例如： svnupdate如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。 svnupdate-r200test.php(将版本库中的文件test.php还原到版本200) svnupdatetest.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svnresolved，最后再提交commit) 简写：svnup 6、查看文件或者目录状态 1)svnstatuspath(目录下的文件和子目录的状态，正常状态不显示) 【?：不在svn的控制中;M：内容被修改;C：发生冲突;A：预定加入到版本库;K：被锁定】 2)svnstatus-vpath(显示文件和子目录状态) 第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。 注：svnstatus、svndiff和svnrevert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。 简写：svnst 7、删除文件 svndeletepath-mdeletetestfle 例如：svndeletesvn://192.168.1.1/pro/domain/test.php-mdeletetestfile 或者直接svndeletetest.php然后再svnci-m'deletetestfile‘，推荐使用这种 简写：svn(del,remove,rm) 8、查看日志 svnlogpath 例如：svnlogtest.php显示这个文件的所有修改记录，及其版本号的变化
SVN提交规范文件编号： SVN提交规范 第 1 页共5页
SVN提交规范文件编号： 修订记录 第 2 页共5页
SVN提交规范文件编号： 目录 1、规范的目的 (3) 2、术语和定义 (4) 3、适用范围 (4) 4、参考和引用 (4) 5、细则 (4) 6、补充说明 (5) 1、规范的目的 本规范规定在产品开发过程中涉及的代码在SVN上的提交规则，确保分类清晰、提交格式统一、 第 3 页共5页
SVN提交规范文件编号： 简洁、便于管理。 2、术语和定义 代码：包括软件开发过程中从开发商获取的源代码、自己开发的代码、针对测试反馈的bug进行修改的代码。 工作目录：软件开发人员本地主机或者编译服务器上，用于调试问题、解决BUG的源代码目录。 编译目录：软件开发人员本地主机或者编译服务器上，用于编译版本、提交代码到SVN的源代码目录。 模块名：为本次提交代码的主要模块名称，采用全大写字母标识，尽量与程序中模块的命名相同，且前后应保持一致，不应同一模块出现多种不同的命名方式。 3、适用范围 本规范适用于规范研发体系所有软件工程师的SVN提交。 4、参考和引用 5、细则 5.1 SVN注释 SVN的提交时对注释的规范： 1、注释文字可以使用中文或英文，推荐使用中文，要求都能清晰表述要表达的意思 2、注释说明符合要求的格式以及内容完整，包括如下的内容： 格式要求：注释包括2个部分，中间用“| ”隔开，第一个部分描述操作的类别；第二部分对该操作的目的、方法、可能的注意事项进行描述。第一部分的第一个词为类别关键词，具体分类和关键词如下： Vendor：供应商提供的原始代码加入SVN进行受控管理 Develop：支持新特性的开发提交代码，包括功能优化和性能提升等的相关开发工作 Bug：开发阶段完成后，各测试环节反馈的问题修改，包括测试部、现场、工厂等 Customize：客制化需求软件制作过程中代码的修改 内容完整要求：SVN提交时必须说明该操作的目的，并尽可能的对相关的实现方法或注意事项进行说明；要尽量详细、清晰的说明修改内容，不允许为空或仅使用“Fix、Mofidy”等简单字词进行备注； 其他要求：为便于检索、跟踪，推荐在注释的内容中尽可能多的包括功能特性相关的模块或特性名称 5.2 SVN提交要求 代码的提交遵循如下的规则： 1、供应商提供的代码：需在代码提交时注明对应的供应商，以及该代码支持的硬件情况进行 第 4 页共5页
Zdeveloper2.x代码规范1 ZDeveloper命名规范 常见JAVA包命名(以platform插件为例)。 2 公共包 plugins存放所有插件配置文件; lang存放所有插件国际化配置文件; JAVA存放所有插件java类文件; DB目录存放zdm文件。
3 一般情况java包 *.ui子包存放本插件所属UI类(*.ui省略前面的com.zving.platform,下同); *.service子包存放本插件所属扩展服务类; *.service.impl子包存放扩展服务项实现类; *.extend子包存放本插件扩展相关的类( 扩展点接口类或抽象类) ; *.extend.impl子包存放本插件扩展实现类( 扩展行为或其它扩展实现类) ; *.bl子包存放本插件所属后台业务逻辑类。 4 特殊扩展服务用到java包 *.code子包存放本插件所属扩展代码管理扩展服务的扩展项类; *.privilege子包存放本插件扩展菜单权限服务的扩展项类; *.config子包存放本插件扩展配置项扩展服务的扩展项类; *.properties子包存放本插件扩展栏目或站点配置项相关的扩展服务的扩展项类; *.tag子包存放本插件扩展标签服务的扩项类; *.tempalte子包存放本插件扩展模板服务的扩展项类;
( 插件包的命名参展以上方式, 项目需要能够酌情添加有一定意义的子包) 5 插件包 插件包统一以”com.zving.”+插件名称来命名(公司名称域名+插件名称)。 6 插件类 插件名称+”Plugin”, 位于插件所属包根目录下。 7 插件配置文件 ”com.zving.”+插件名称+”.plugin”。 8 UI类 页面名称+”UI”, 类存放位置为”com.zving.”+插件名称+”.ui”子包。
竭诚为您提供优质文档/双击可除 svn管理规范,华为 篇一：svn管理规范 安生sVn管理规范 第一章总则 第一条目的 通过对具备sVn管理权限的员工进行sVn规范的落实工作，促使员工不断改善工作效率，规范操作过程，从而提高公司对sVn仓库的合理、充分、高效利用的能力。 第二条适用范围 本制度适用于浙江安生信息科技有限公司（以下简称“公司”）及下属子分公司全体员工。 第三条责任说明 对于公司离职的员工，原则上由其所在部门具备sVn管理系统管理权限人员负责清除权限，同时人事行政部必须及时通知离职员工所在部门具备sVn管理系统管理权限人员（通常为部门主管）的权限清除工作。 第二章细则 第一条库管理
1，公司的所有sVn仓库（包括杭州）将整合在统一的sVn服务器上。2，公司历史迁移库在访问uRl中以“svn-past”标记，新建库在访问uRl中以“svn”标记。 第二条权限下放原则 1，由具备系统管理员权限（可配置）的管理人员分配库管理员。2，库管理员允许多个，通常将库管理员赋给对应于某库的项目经理。3，项目经理具备分配拥有项目（对应于某库）的人员以及权限的能力。3，sVn访问时统一将 ip替换为“https://www.doczj.com/doc/a76870664.html,”，端口为90。 第三条目录规范 1，按业务领域创建库，再按区域和平台性质划分分支目录，在分支目录下管理开发分支（适用于开发部）。 2，所有新建仓库默认结构为： --branches--tags--trunk各目录下的所有子目录均不允许出现trunk、tags、branches。3，开发分支命名规范：年月日-时分秒-编号，如“20xx1223-000000-001”。4，标签命名规范：年月日-时分秒-release-编号，如 “20xx1223-000000-release-001”。 第四条其他约束 1，对于仓库目录结构的操作，一律通过sVn管理系统进行，禁止使用eclipse5，编号为branches或则tags下已存在目录数量加1的结果。svn插件或则tortoisesVn客户
1、目的： 本制度为研发部SVN配置管理的准则和依据，所有与SVN配置管理的行为都必须遵照并服从于本制度。 2、适用范围： 本制度适用于研发部全体员工。 3、控制要求和方法： 3.1 操作流程 首先用户从svn版本库通过网络“检出”到本地工作副本中，然后，在本地工作副本中进行增加、修改、删除文件后“提交”到版本库中，如果本地工作副本中版本较系统版本过时，用户使用“更新”功能与系统上版本保持一致。 3.2 帐号注册、权限申请 1. 用户帐号注册：新进员工没有SVN帐号，通过联系SVN管理员，注明申请SVN普 通帐号，管理员处理完帐号注册事宜后，通知使用并介绍使用规范。 注：普通帐号，只对目录有读取权限，无法更改。 2. 权限的申请：根据员工所参与的项目，SVN管理员对其开放相应目录的读、写权限。 3. 账号注销：员工离职后，对其账号进行注销。 3.3 操作规范 1. 每日进行开发工作之前更新代码，下班时提交代码。 2. 各员工需牢记各自的账户和密码，不得向他人透漏，严禁使用他人账户进行SVN各项操作。
3. 不要签出整个目录，除非特别必要，不应同时签出过多的项目。 4. 文件提交时要求必须提交注释，注明相关修改信息，日志信息描述的越详细越好，让项目组其他成员在看到标注后不用详细看代码就能了解你所做的修改。 5. 代码变动及时提交，避免丢失本地修改后无法恢复。 6. 在提交之前要编译代码并修正错误。要保证新增加的文件同时被提交，否则只在你本地能正常工作，导致其它人不能编译通过。 7. 提交之前要测试所改变的应用，测试改变后的效果是否达到预期的目的。 8. 多次检查提交的内容。提交之前应先做SVN更新或与资源库同步，注意到SVN关于冲突、错误的信息。资源库同步会告诉你将要提交的内容与资源库内容之间的差别，确认它们是不是你真正想要提交的。 9. 如果别人和自己更改的是同一个文件，那么Update时会自动进行合并，如果修改的是同一行，那么合并时会产生冲突，这种情况就需要同之前的开发人员联系，两个人一起协商解决冲突，解决冲突之后，需要两人一起测试保证解决冲突之后，程序不会影响其他功能。 10. 在更新时注意所更新文件的列表，如果提交过程中产生了更新，则也是需要重新编译并且完成自己的一些必要测试，再进行提交。这样既能了解别人修改了哪些文件，同时也能避免SVN合并错误导致代码有错。 11. 提前宣布修改计划。当你计划进行修改，需要影响到SVN里的许多文件时，先通过邮件或者当面通知其他开发者。例如，修改底层数据库模块时，有可能影响到业务逻辑层调用数据库模块的地方。这样其他开发者会有准备，也会对修改提出意见和建议。 12. 每次提交尽量是一个最小粒度的修改。比如一个小功能提交一次。 13. 不要提交不能通过编译的代码。代码在提交之前，首先要确认自己能够在本地编译。如果在代码中使用了第三方类库，要考虑到项目组成员中有些成员可能没有安装相应的第三方类库。 14. 提交时注意不要提交本地自动生成的文件，提交的文件必须是开发者共用的程序文件，程序编译中产生的中间文件或文件夹，如/Debug/、/Release/、*.ncb、*.obj、*.o、Thumbs.db、/build/、*.class、/classes/、/data/等不要提交到SVN里。 15. SVN管理员需对SVN的所有项目定期备份。 16. SVN的资料不允许公开给其他部门人员，确实要分发的，必须通过总经理同意。 重要说明文件要求: 硬件开发：