git的说明和使用笔记

说明：

Linus为Linux Kernel Project发起的版本控制项目。

HEAD代表当前最新状态。

tag为某个状态的标签。

SHA1为每个提交日志的唯一标识。

 

install:

 

apt-get install git-core

 

 

git clone:

 

git仓库可以使用git clone获得：

git clone git: //url

 

也可以通过浏览器浏览。

http: //url/gitweb/

 

通过git pull更新仓库，使用git init-db初始化自己的仓库。

 

 

config:

 

开发人员需要为git仓库配置相关信息，这样在提交代码时，这些信息会自动

反映在git仓库的日志中。

 

git config user.name "your name"

git config user.email yourname@email_server

git config core.editor vim

git config core.paper "less -N"

git config color.diff true

git config alias.co checkout

 

git config alias表示，可以用git co代表git checkout。git var -l可以查看

已经设置的配置。

 

 

diff:

 

开发人员在本地进行开发后，可以使用git diff查看改动。

除了直接比较当前开发后的改动外，git diff还可以：

 

git diff tag                    比较tag和HEAD之间的不同。

git diff tag file               比较一个文件在两者之间的不同。

git diff tag1..tag2             比较两个tag之间的不同。

git diff SHA11..SHA12           比较两个提交之间的不同。

git diff tag1 tag2 file or

git diff tag1:file tag2:file    比较一个文件在两个tag之间的不同。

 

 

ORIG_HEAD用于指向前一个操作状态，因此在git pull之后如果想得到pull的

内容就可以：

 

git diff ORIG_HEAD

 

git diff --stat                 用于生成统计信息。

git diff --stat ORIG_HEAD

 

 

apply:

 

git apply相当于patch命令。

--check 检查能否正常打上补丁，-v verbose模式， -R reverse模式，反打补丁。

 

 

log :

 

git log  file                    查看一个文件的改动。

git log  -p                      查看日志和改动。

git log  tag1..tag2              查看两个tag之间的日志。

git log  -p tag1..tag2 file      查看一个文件在两个tag之间的不同。

git log  tag..                   查看tag和HEAD之间的不同。

 

 

commit:

 

git commit -a -e        提交全部修改文件，并调用vim编辑提交日志。

git reset HEAD^ or

git reset HEAD~1        撤销最后一次提交。

git reset --hard HEAD^  撤销最后一次提交并清除本地修改。

git reset SHA1          回到SHA1对应的提交状态。

 

 

add/ delete /ls:

 

git add -a              添加所有文件。除了.gitignore文件中的文件。

git rm file             从git仓库中删除文件。

git commit              添加或是删除后要提交。

 

git ls-files -m         显示修改过的文件。

git ls-files            显示所有仓库中的文件。

 

git中有四种对象：blob、tree、commit、tag。

blob代表文件，tree代表目录，commit代表提交历史，tag代表标签。

这四种对象都是由SHA1值表示的。在仓库的.git目录中保存了git管理仓库

所需要的全部信息。

 

git ls-tree HEAD file   显示file在HEAD中的SHA1值。

git cat-file -t SHA1    显示一个SHA1的类型。

git cat-file type SHA1  显示一个SHA1的内容。type是blob、tree、commit、tag之一。

 

patch:

 

git format-patch -1     生成最后一个提交对应的patch文件。

git am < patch          把一个patch文件加入git仓库中。

git am --resolved       如果有冲突，在解决冲突后执行。

git am --skip           放弃当前git am所引入的patch。

 

 

conflict:

 

git merge               用于合并两个分支。

git diff                如果有冲突，直接使用diff查看，

                         冲突代码用<<<和>>>表示。手动修改冲突代码。

git update-index        更新修改后的文件状态。

git commit -a -e        提交为解决冲突而修改的代码。

 

 

branch:

 

git branch -a           查看所有分支。

git branch new_branch   创建新的分支。

git branch -d branch    删除分支。

git checkout branch     切换当前分支。-f参数可以覆盖未提交内容。

 

 

daemon:

 

有时更新公共代码仓库使用patch的方式，或者直接

用git pull git: //ip/repo branch

的方式更新每个人的代码。使用git pull的方式需要

提交代码的机器运行：

git daemon --verbose --export-all --enable=receive-pack --base-path=/repo

 

 

request-pull:

 

 

git request-pull start url      用于产生本次pull请求的统计信息。

 

 

clean:

 

 

git clean -dxf          用于清除未跟踪文件。

git clean -dnf          可以显示需要删除的文件，但不包括被.gitignore忽略的。

git reset --hard HEAD   用于清除跟踪文件的修改

=======================================================================================

使用：

1, Linus的 git tree，AKA 'mainline kernel':

        $ git -clone git :// git .kernel.org/pub/scm/linux/kernel/ git /torvalds/linux-2.6. git 

   其他的 git trees可以在[url]http:// git .kernel.org/[/url]找到，点击进去就能看到 GIT URL。


2, 安装 git docs

   要有asciidoc、 wish 命令，安装tcl/tk和asciidoc. wish 命令在tk-x.xx.xx包中。

   编译 git 时，
          
        $ sudo make install-doc


3, 使用 git 

   $ git -config user.name "Jike Song"
   $ git -config user.email [email]albcamus@gmail.com[/email]

           注意，这样会在当前repository目录下的. git /config中写入配置信息。 如果 git -config加了--global
        选项，配置信息就会写入到~/. git config文件中。 因为你可能用不同的身份参与不同的项目，而多个
        项目都用 git 管理，所以建议不用global配置。

$ git -val -l                 //列出 git 变量

   $ git -initdb                 //除非自己创建一个工程，否则没必要使用。 它会创建. git /目录
                                   //这个目录在 git -clone时也会创建。
       
   $ git -clone git :// git .kernel.org/pub/scm/linux/kernel/ git /torvalds/linux-2.6. git 
   $ cd linux-2.6

   此时当前目录下有一个. git 目录. 以下我们都在linux-2.6/下演示：

   $ git -pull                 //更新本地的 git tree。 如果自从你clone了linus tree之后，linus tree
                           //有新的改动，那么把这些更改更新到你的本地tree中
                        //类似于cvs update

   $ git -diff                 //列出自己本地的tree和linus tree的不同
                           这也是产生patch的方式。 注意，使用 git -diff产生的patch都应该在patch(1)时指定-p1

   $ git -apply                 相当于patch(1)命令，不过 git -apply专门用来apply那些用 git -diff生成的补丁
                   --check 不真正打补丁，而只是检查补丁是否能完美的打上
                -v      verbose

   $ git - gui                  // GUI 模式，不过我觉得q git 最好用

   $ git -rev-list <ID>        以时间为顺序，反向列出revision ID。 也就是先列最新的commit ID。 也可以指定列出的数目，例如：
                  
   $ git -rev-list -2 971a71bdc9b42e74a5a8ed0433ac27ae92291024

新加文件：

   $ git -add <filename>          //类似于cvs add <filename>
   $ git -add -a                 //本目录下所有文件和子目录
   $ git -commit                 //提交。注意需要先add再commit。 又， GIT _EDITOR环境变量允许你
                                   //设置编辑器，commit时用它来编辑信息。
                        -s 选项来为commit message的最后一行添加Signed-off-by: Jike Song <[email]albcamus@gmail.com[/email]>

   $ git -commit -e -s -a
                           -s 会增加Signed-off-by行，-e会调用vim进行编辑commit message，-a表示all。

删除文件：

   $ git -rm aa.c
   $ git -commit

恢复删除了的文件：(撤消一次提交)

   $ git -log                  //注意查看上次 git -rm后的 git -commit ID
   $ git -revert adb2f08089edac8bf1912a618a74485ab42f2b86         //指定导致删除操作的commit ID，进行撤消

列出某一个commit ID对应的补丁：

   $ git -log -1 -p 721151d004dcf01a71b12bb6b893f9160284cf6e

   -1的意思是只显示一个commit。如果你想显示5个，就-5。不指定的话， git log会从该commit一直往后显示。

   还有直接的简洁方法：
   $ git -format-patch -1 721151d004dcf01a71b12bb6b893f9160284cf6e
          
        --stdout         //不写入文件，而是打印到标准输出

   或者：
   $ git -show 721151d004dcf01a71b12bb6b893f9160284cf6e                 //thanks for Xu

   或者：
   $ git -diff-tree -p 721151d004dcf01a71b12bb6b893f9160284cf6e


git -bisect的用法
/*{{{*/
   $ git -bisect start
   $ git -bisect bad    //该版本的kernel标记为bad

   或者有针对性的：
           $ git -bisect bad v2.6.22-rc1

   $ git -bisect good v2.6.22-rc2


LABEL:           在你指定了bad和good之后，如果这两个版本之间有1000个revisions， git 就默认剔除了500个，你应该在此时测试该版本：
          
   创建一个临时性的output目录
        $ make ../ git _bisect_output/
   编译：
           $ sudo make O=../ git _bisect_output/ menuconfig && make O=../ git _bisect_output/ V=1 -j4 && make O=../ git _bisect_output/ V=1 modules_install install
        注意，最好在menuconfig时，给local version加上一个string，例如step1、step2等。

   启动新编译的kernel，如果还有BUG：
           $ git -bisect bad
        goto LABEL; //再编译，验证。

   直到某个时候，只剩下一个revision可以怀疑，那时候就可以确认是它引入了补丁。

   当bisect结束，恢复到master版本：
          
        $ git -bisect reset

   [注意]
           git bisect是一个漫长而痛苦的过程。我在Dell Optiplex745(2G内存/Core2双核2G)机器上足足做了一天，才定位到一个commit。

   [replay的用法]
           如果该输入 git -bisect good的时候，不小心输入了 git -bisect bad，则可以这样：
               
                1) git -bisect log | tee ../ git .bisect.log
                2) 修改../ git .bisect.log，删掉最后两行 -- 也就是回退1步
                3) git -bisect replay ../ git .bisect.log

   [visualize的用法]
           git -bisect的时间很长，因为可能需要编译N次内核。 在此期间，可以用：
               
                $ git -bisect visualize
        来在 git k中查看目前还在的那些Revs。
        FYI: 如果你象我一样更喜欢q git ，可以修改`which git -bisect`脚本，将' git k'字样替换成'q git '。
   /*}}}*/
                  
          
git -citool GUI 界面的 git -commit。 不但可以提交，而且可以编辑上次commit的信息。


git -diff的用法

   列出自己tree和master的不同：
   $ git -diff

   列出自己的tree和某一个version的不同：
   $ git -diff v2.6.22

   列出某一个文件，和以前某个version的该文件的不同：
   $ git diff v2.6.20 init/main.c
   注意结果中+表示自己的tree，-表示2.6.20的。

   列出两个tag中某一文件的不同：
   $ git -diff v2.6.23 v2.6.24-rc1 init/main.c



查看某一文件都被哪些补丁改动过：

   $ git -whatchanged -p security/Kconfig      //thanks to Herbert Xu


从本地 git 仓库中提取某个版本的kernel：

   $ git -archive -v v2.6.18 | (cd ../linux-2.6.18/ && tar xf -)
   -v表示--verbose，注意'v2.6.18'必须是 git -tag -l列出来的tags中的一个。

或者打成tarball:

   $ git -archive -v --format=tar v2.6.24 |bzip2 > ../linux-2.6.24.tar.bz2


把当前本地的 git 仓库export到另一个目录(为了测试最新的Linus Tree而又不弄乱 git 仓库)

   $ git -status         //FIXME: 我不确定该用 git -status还是 git -branch
                                                   //或者别的什么命令
   $ On branch master
   nothing to commit (working directory clean)
   $ git -archive -v master | (cd ../linux-2.6-Jan14/ && tar xf -)

你的本地存储乱了，恢复到mailine：

   $ git -reset --hard                 //WARNING: 这会使你的本地改动全部丢失，慎用！


(FIXME: 该方法根本不对！commit log还是乱的！
                                  或许应该用 git -reset --hard)
       
        $ git -diff |tee ../local_against_mainline.diff
        $ git -apply -R < ../local_against_mainline.diff
   或者：
        $ git -diff | git -apply -R
   即可。

git 分析邮件：
       
    $ git -mailinfo msg patch <   <your-email-file.eml> 

    分析邮件，把commit log写到msg文件，补丁写到patch文件。 其他信息打印到标准输出。

从mail文件中打补丁：
       
        $ git -am < <your-email-file.eml>

git -send-email:

    例如
    $ git -send-email --compose --to [email]jeff@garzik.org[/email] --cc [email]davem@davemloft.net[/email] /
      --cc [email]akpm@linux-foundation.org[/email] --cc [email]netdev@vger.kernel.org[/email] /
      -cc [email]linux-kernel@vger.kernel.org[/email] --smtp-server <your-smtp-server> /
      <your-patch-name.patch>

      注意，我的smtp server不需要验证，如果你需要验证，用
      
              --smtp-user=<your account> --smtp-pass=<your passwd>

       来指定。


使用 git -tools来处理mbox里的patch：
   
        $ git clone git :// git .kernel.org/pub/scm/linux/kernel/ git /torvalds/ git -tools. git 

   然后编译、安装。
   它提供了applypatch, cvs2 git , dotest, mailinfo, mailsplit, stripspace这些工具。


email注意事项：
       
1) 可以用xclip程序来复制补丁

            $ git -format-patch -1 --stdout <SHA-id> | xclip
    
     然后鼠标中键粘贴。

2) 小心确认你的编辑器
    
     如使用thunderbird的插件：External Editor指定Vim编辑器等，确认不wrap word。
     我不太敢确保是否~/.vimrc中设置了：
            
          set textwidth=0 
          set wrapmargin=0

     就能不自动插入<EOL>。 不过用:r命令读入补丁文件肯定没问题。