<!DOCTYPE html PUBLIC
"-//W3C//DTD HTML 4.0 Transitional//EN">
<link rel=
"STYLESHEET" href=
"dist.css" type='text/css'
/>
<link rel=
"SHORTCUT ICON" href=
"../icons/pyfav.png" type=
"image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index'
/>
<link rel=
"first" href=
"dist.html" title='Distributing Python Modules'
/>
<link rel='index' href='genindex.html' title='Index'
/>
<link rel='last' href='about.html' title='About this document...'
/>
<link rel='help' href='about.html' title='About this document...'
/>
<link rel=
"prev" href=
"manifest.html" />
<link rel=
"parent" href=
"source-dist.html" />
<link rel=
"next" href=
"built-dist.html" />
<meta name='aesop' content='information'
/>
<title>4.2 Manifest-related options
</title>
<div id='top-navigation-panel' xml:id='top-navigation-panel'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"4.1 Specifying the files"
href=
"manifest.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td>
<td class='online-navigation'
><a rel=
"parent" title=
"4. Creating a Source"
href=
"source-dist.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td>
<td class='online-navigation'
><a rel=
"next" title=
"5. Creating Built Distributions"
href=
"built-dist.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td>
<td align=
"center" width=
"100%">Distributing Python Modules
</td>
<td class='online-navigation'
><img src='../icons/blank.png'
border='
0' height='
32' alt='' width='
32'
/></td>
<td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td>
<td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td>
<div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"manifest.html">4.1 Specifying the files
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"source-dist.html">4. Creating a Source
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"built-dist.html">5. Creating Built Distributions
</A>
<!--End of Navigation Panel-->
<H1><A NAME=
"SECTION004200000000000000000"></A>
<A NAME=
"manifest-options"></A>
4.2 Manifest-related options
The normal course of operations for the
<code class=
"du-command">sdist
</code> command is as
<LI>if the manifest file,
<span class=
"file">MANIFEST
</span> doesn't exist, read
<span class=
"file">MANIFEST.in
</span> and create the manifest
<LI>if neither
<span class=
"file">MANIFEST
</span> nor
<span class=
"file">MANIFEST.in
</span> exist, create a
manifest with just the default file set
<LI>if either
<span class=
"file">MANIFEST.in
</span> or the setup script (
<span class=
"file">setup.py
</span>)
are more recent than
<span class=
"file">MANIFEST
</span>, recreate
<span class=
"file">MANIFEST
</span> by
reading
<span class=
"file">MANIFEST.in
</span>
<LI>use the list of files now in
<span class=
"file">MANIFEST
</span> (either just
generated or read in) to create the source distribution archive(s)
There are a couple of options that modify this behaviour. First, use
the
<b class=
"programopt">--no-defaults
</b> and
<b class=
"programopt">--no-prune
</b> to
disable the standard ``include'' and ``exclude'' sets.
Second, you might want to force the manifest to be regenerated--for
example, if you have added or removed files or directories that match an
existing pattern in the manifest template, you should regenerate the
<div class=
"verbatim"><pre>
python setup.py sdist --force-manifest
Or, you might just want to (re)generate the manifest, but not create a
<div class=
"verbatim"><pre>
python setup.py sdist --manifest-only
<b class=
"programopt">--manifest-only
</b> implies
<b class=
"programopt">--force-manifest
</b>.
<b class=
"programopt">-o
</b> is a shortcut for
<b class=
"programopt">--manifest-only
</b>, and
<b class=
"programopt">-f
</b> for
<b class=
"programopt">--force-manifest
</b>.
<div class='online-navigation'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"4.1 Specifying the files"
href=
"manifest.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td>
<td class='online-navigation'
><a rel=
"parent" title=
"4. Creating a Source"
href=
"source-dist.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td>
<td class='online-navigation'
><a rel=
"next" title=
"5. Creating Built Distributions"
href=
"built-dist.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td>
<td align=
"center" width=
"100%">Distributing Python Modules
</td>
<td class='online-navigation'
><img src='../icons/blank.png'
border='
0' height='
32' alt='' width='
32'
/></td>
<td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td>
<td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td>
<div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"manifest.html">4.1 Specifying the files
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"source-dist.html">4. Creating a Source
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"built-dist.html">5. Creating Built Distributions
</A>
<span class=
"release-info">Release
2.4.2, documentation updated on
28 September
2005.
</span>
<!--End of Navigation Panel-->
See
<i><a href=
"about.html">About this document...
</a></i> for information on suggesting changes.