<div id="Ampersand-modules"></div>
<div class="header">
<p>
Next: [[cvs: Excluding directories#Excluding directories|Excluding directories]], Previous: [[cvs: Regular modules#Regular modules|Regular modules]], Up: [[cvs: The modules file#The modules file|modules]] &nbsp; |[[cvs: Index#SEC_Contents|Contents]]||[[cvs: Index#Index|Index]]|</p>
</div>

----

<div id="Ampersand-modules-1"></div>
==== Ampersand modules ====
<div id="index-Ampersand-modules"></div>
<div id="index-_0026_002c-in-modules-file"></div>

A module definition can refer to other modules by
including &lsquo;<code>&amp;<var>module</var></code>&rsquo; in its definition.
<div class="example" style="margin-left: 3.2em">
 <var>mname</var> <nowiki>[</nowiki> options <nowiki>]</nowiki> <var>&amp;module</var>&hellip;
</div>

Then getting the module creates a subdirectory for each such
module, in the directory containing the module.  For
example, if modules contains

<div class="example" style="margin-left: 3.2em">
 ampermod &amp;first-dir
</div>

then a checkout will create an <code>ampermod</code> directory
which contains a directory called <code>first-dir</code>,
which in turns contains all the directories and files
which live there.  For example, the command

<div class="example" style="margin-left: 3.2em">
 $ cvs co ampermod
</div>

will create the following files:

<div class="example" style="margin-left: 3.2em">
 ampermod/first-dir/file1
 ampermod/first-dir/file2
 ampermod/first-dir/sdir/sfile
</div>

There is one quirk/bug: the messages that <small>CVS</small>
prints omit the &lsquo;<tt>ampermod</tt>&rsquo;, and thus do not
correctly display the location to which it is checking
out the files:

<div class="example" style="margin-left: 3.2em">
 $ cvs co ampermod
 cvs checkout: Updating first-dir
 U first-dir/file1
 U first-dir/file2
 cvs checkout: Updating first-dir/sdir
 U first-dir/sdir/sfile
 $
</div>

Do not rely on this buggy behavior; it may get fixed in
a future release of <small>CVS</small>.


This document was generated on <i>a sunny day</i> using [http://www.nongnu.org/texi2html/ <i>texi2html</i>].
