Demonstrate git workflows using submodules.
Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
common
empty-super
gotcha
notes
salted-super
tutorial
.gitignore
COPYING
readme.html

readme.html

<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<!--

Copyright (C) 2008 Guy Allard

This file is part of the git Submodules Workflows project.

    The git Submodules Workflows project is free software: you can redistribute it 
    and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    The git Submodules Workflows project is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with the git Submodules Workflows project.  
    If not, see <http://www.gnu.org/licenses/>.
-->
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<meta name="author" content="Guy Allard" />
<meta name="description" content="git Submodule Scenarios Home Page" />
<meta name="keywords" content="git, SCM, Submodules" />
<link rel="stylesheet" type="text/css" href="common/submodules.css" />
<title>
git Submodules Tests and Examples
</title>
</head>
<body>
<div class="container" >

  <div class="header" >
  <h1 style="text-align: center; text-decoration: underline" >git Submodules Tests and Examples</h1>
  <br />
  </div>

  <div class="left" >
  <br />
  <a href="./notes/admin.html">Administrative</a>
  <br />
  <a href="./tutorial/readme.html">Tutorial</a>
  <br />
  <a href="./salted-super/readme.html">Salted</a>
  <br />
  <a href="./empty-super/readme.html">Empty</a>
  <br />
  <a href="./gotcha/readme.html">Gotcha</a>
  <br />
  <a href="./notes/readme.html">Miscellaneous</a>
  </div>

  <div class="content" >
  <h1>Background</h1>
  <p>This project was started after following the submodule totorial at
  <a href="http://git.or.cz/gitwiki/GitSubmoduleTutorial">git.or.cz</a>, and subsequently
  feeling the
  need for more detailed submodule workflow examples and explanations.
  </p>
  <p>
  To that end the examples herein were developed on a private system, and made public
  on April 13, 2008, hosted at <a href="http://www.github.com">GitHub</a>.
  To clone that public repository use:</p>
  <pre style="font-weight: bold; text-align: center" >
  git clone git://github.com/gmallard/submodule-workflows.git
  </pre>
  <h1>Before You Start</h1>
  <p>
  Before attempting to run any examples, you might want to modify 
  the <em>./common/setvars</em>
  script and change the <em>user=</em> shell variable to an appropriate
  user ID (if your ID can not be used).
  </p>
  <p>
  You should also review the next section covering Administrative Requirements.
  </p>
  <h1>Administrative Requirements</h1>
  <p>Several of these examples require some administrative setup before they will run properly.
  For a list of administrative requirements and constraints, see:
  <a href="./notes/admin.html">administrative requirements</a>.
  </p>
  <h1>Tutorial Examples</h1>
  <p>For a set of examples based on the previously mentioned submodules
  tutorial, see:
  <a href="./tutorial/readme.html">the tutorial example</a>.
  </p>
  <h1>Salted Supermodule Examples</h1>
  <p>An example where a supermodule is pre-salted (primed) with submodule
  definitions can be found here:
  <a href="./salted-super/readme.html">the salted supermodule example</a>.
  </p>
  <h1>Empty Supermodule Examples</h1>
  <p>An example where a supermodule is initially empty, and submodules are added
  as work progresses is here:
  <a href="./empty-super/readme.html">the empty supermodule example</a>.
  </p>
  <h1>Miscellaneous Notes</h1>
  <p>A general list of notes and explanations is here:
  <a href="./notes/readme.html">miscellaneous notes</a>.
  </p>
  </div>

  <div class="footer" >
  <p style="font-weight: bold" >git Submodules Tests and Examples</p>
  </div>
</div>
</body>
</html>