1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>gitmodules(
5)
</title>
312 gitmodules(
5) Manual Page
315 <div class=
"sectionbody">
317 defining submodule properties
322 <div class=
"sectionbody">
323 <div class=
"para"><p>$GIT_WORK_DIR/.gitmodules
</p></div>
325 <h2 id=
"_description">DESCRIPTION
</h2>
326 <div class=
"sectionbody">
327 <div class=
"para"><p>The
<tt>.gitmodules
</tt> file, located in the top-level directory of a git
328 working tree, is a text file with a syntax matching the requirements
329 of
<a href=
"git-config.html">git-config(
1)
</a>.
</p></div>
330 <div class=
"para"><p>The file contains one subsection per submodule, and the subsection value
331 is the name of the submodule. Each submodule section also contains the
332 following required keys:
</p></div>
333 <div class=
"vlist"><dl>
335 submodule.
<name
>.path
339 Defines the path, relative to the top-level directory of the git
340 working tree, where the submodule is expected to be checked out.
341 The path name must not end with a
<tt>/
</tt>. All submodule paths must
342 be unique within the .gitmodules file.
346 submodule.
<name
>.url
350 Defines an url from where the submodule repository can be cloned.
354 submodule.
<name
>.update
358 Defines what to do when the submodule is updated by the superproject.
359 If
<em>checkout
</em> (the default), the new commit specified in the
360 superproject will be checked out in the submodule on a detached HEAD.
361 If
<em>rebase
</em>, the current branch of the submodule will be rebased onto
362 the commit specified in the superproject. If
<em>merge
</em>, the commit
363 specified in the superproject will be merged into the current branch
365 This config option is overridden if
<em>git submodule update
</em> is given
366 the
<em>--merge
</em> or
<em>--rebase
</em> options.
371 <h2 id=
"_examples">EXAMPLES
</h2>
372 <div class=
"sectionbody">
373 <div class=
"para"><p>Consider the following .gitmodules file:
</p></div>
374 <div class=
"literalblock">
375 <div class=
"content">
376 <pre><tt>[submodule
"libfoo"]
378 url = git://foo.com/git/lib.git
</tt></pre>
380 <div class=
"literalblock">
381 <div class=
"content">
382 <pre><tt>[submodule
"libbar"]
384 url = git://bar.com/git/lib.git
</tt></pre>
386 <div class=
"para"><p>This defines two submodules,
<tt>libfoo
</tt> and
<tt>libbar
</tt>. These are expected to
387 be checked out in the paths
<em>include/foo
</em> and
<em>include/bar
</em>, and for both
388 submodules an url is specified which can be used for cloning the submodules.
</p></div>
390 <h2 id=
"_see_also">SEE ALSO
</h2>
391 <div class=
"sectionbody">
392 <div class=
"para"><p><a href=
"git-submodule.html">git-submodule(
1)
</a> <a href=
"git-config.html">git-config(
1)
</a></p></div>
394 <h2 id=
"_documentation">DOCUMENTATION
</h2>
395 <div class=
"sectionbody">
396 <div class=
"para"><p>Documentation by Lars Hjemli
<hjemli@gmail.com
></p></div>
398 <h2 id=
"_git">GIT
</h2>
399 <div class=
"sectionbody">
400 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
403 <div id=
"footer-text">
404 Last updated
2010-
02-
13 01:
00:
01 UTC