doc:git

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
doc:git [2011/12/07 01:12] – Typo frozenfiredoc:git [2020/09/03 01:18] (current) – avenger
Line 29: Line 29:
  
 == Properties == == Properties ==
 +
 +**svn:externals**
 Modules are achieved using the Subversion property known as svn:externals. This prop allows external Modules are achieved using the Subversion property known as svn:externals. This prop allows external
 Subversion paths to be linked into the project by URL. Subversion paths to be linked into the project by URL.
Line 35: Line 37:
   doc-base https://svn.php.net/repository/phpdoc/doc-base/trunk   doc-base https://svn.php.net/repository/phpdoc/doc-base/trunk
   en https://svn.php.net/repository/phpdoc/en/trunk   en https://svn.php.net/repository/phpdoc/en/trunk
 +
 +**svn:keywords**
 +Each xml file in the repository contains a set of keywords which are automatically substituted when
 +checked out. These allow certain terms to be automatically updated for each commit, rather than
 +maintained manually. Importantly, the Revision keyword allows translations to track what version
 +of the English translation their file is based upon.
 +
 +''svn:keywords Example''
 +  Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
  
 === Proposed Git Structure === === Proposed Git Structure ===
Line 44: Line 55:
  
 == Doc-Base == == Doc-Base ==
-Since the doc-base path of the PHP Documentation project is a global dependency for all builds, it makes up its own major project, which all wrapper repositories will include as a submodule.+Since the doc-base path of the PHP Documentation project is a global dependency for all builds, it 
 +makes up its own major project, which all wrapper repositories will include as a submodule.
  
 == "Wrapper" Repositories == == "Wrapper" Repositories ==
Line 51: Line 63:
 ''doc-en Wrapper Repository Example'' ''doc-en Wrapper Repository Example''
   git init phpdoc-en   git init phpdoc-en
-  git submodule add phpdoc-en/doc-base git://github.com/php/phpdoc-base.git +  git submodule add git://github.com/php/doc-base.git phpdoc-en/doc-base 
-  git submodule add phpdoc-en/en git://github.com/php/phpdoc-en.git+  git submodule add git://github.com/php/doc-en.git phpdoc-en/en 
 + 
 +== Attributes == 
 +Because Git does not support keywords in the same way that Subversion does, some changes may need to be 
 +made, or it may be necessary to create hackish dependencies in order to 
 +[[https://github.com/turon/git-rcs-keywords|maintain the current scheme]]. 
 + 
 +''RCS Keywords Example'' 
 +  git clone git://github.com/turon/git-rcs-keywords.git 
 +  git init phpdoc-en 
 +  cat git-rcs-keywords/.gitconfig >> phpdoc-en/.git/config 
 +  echo '*.xml filter=rcs-keywords' >> phpdoc-en/.gitattributes 
 +  cp -R git-rcs-keywords/.git_filters phpdoc-en/
doc/git.txt · Last modified: 2020/09/03 01:18 by avenger

Page Tools