[OpenSPARC-T2-DV] / tools / src / nas,5.n2.os.2 / lib / python / html / python / dist / node14.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<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="meta-data.html" />
<link rel="parent" href="setup-script.html" />
<link rel="next" href="setup-config.html" />
<meta name='aesop' content='information' />
<title>2.8 Debugging the setup script</title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="2.7 Additional meta-data"
  href="meta-data.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="2. Writing the Setup"
  href="setup-script.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="3. Writing the Setup"
  href="setup-config.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>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="meta-data.html">2.7 Additional meta-data</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="setup-script.html">2. Writing the Setup</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="setup-config.html">3. Writing the Setup</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION002800000000000000000">
2.8 Debugging the setup script</A>
</H1>

<P>
Sometimes things go wrong, and the setup script doesn't do what the
developer wants.

<P>
Distutils catches any exceptions when running the setup script, and
print a simple error message before the script is terminated.  The
motivation for this behaviour is to not confuse administrators who
don't know much about Python and are trying to install a package.  If
they get a big long traceback from deep inside the guts of Distutils,
they may think the package or the Python installation is broken
because they don't read all the way down to the bottom and see that
it's a permission problem.

<P>
On the other hand, this doesn't help the developer to find the cause
of the failure. For this purpose, the DISTUTILS_DEBUG environment
variable can be set to anything except an empty string, and distutils
will now print detailed information what it is doing, and prints the
full traceback in case an exception occurs.

<P>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="2.7 Additional meta-data"
  href="meta-data.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="2. Writing the Setup"
  href="setup-script.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="3. Writing the Setup"
  href="setup-config.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>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="meta-data.html">2.7 Additional meta-data</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="setup-script.html">2. Writing the Setup</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="setup-config.html">3. Writing the Setup</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
Commit	Line	Data
86530b38 AT	1	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	2	<html>
	3	<head>
	4	<link rel="STYLESHEET" href="dist.css" type='text/css' />
	5	<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
	6	<link rel='start' href='../index.html' title='Python Documentation Index' />
	7	<link rel="first" href="dist.html" title='Distributing Python Modules' />
	8	<link rel='index' href='genindex.html' title='Index' />
	9	<link rel='last' href='about.html' title='About this document...' />
	10	<link rel='help' href='about.html' title='About this document...' />
	11	<link rel="prev" href="meta-data.html" />
	12	<link rel="parent" href="setup-script.html" />
	13	<link rel="next" href="setup-config.html" />
	14	<meta name='aesop' content='information' />
	15	<title>2.8 Debugging the setup script</title>
	16	</head>
	17	<body>
	18	<DIV CLASS="navigation">
	19	<div id='top-navigation-panel' xml:id='top-navigation-panel'>
	20	<table align="center" width="100%" cellpadding="0" cellspacing="2">
	21	<tr>
	22	<td class='online-navigation'><a rel="prev" title="2.7 Additional meta-data"
	23	href="meta-data.html"><img src='../icons/previous.png'
	24	border='0' height='32' alt='Previous Page' width='32' /></A></td>
	25	<td class='online-navigation'><a rel="parent" title="2. Writing the Setup"
	26	href="setup-script.html"><img src='../icons/up.png'
	27	border='0' height='32' alt='Up One Level' width='32' /></A></td>
	28	<td class='online-navigation'><a rel="next" title="3. Writing the Setup"
	29	href="setup-config.html"><img src='../icons/next.png'
	30	border='0' height='32' alt='Next Page' width='32' /></A></td>
	31	<td align="center" width="100%">Distributing Python Modules</td>
	32	<td class='online-navigation'><img src='../icons/blank.png'
	33	border='0' height='32' alt='' width='32' /></td>
	34	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
	35	border='0' height='32' alt='Module Index' width='32' /></a></td>
	36	<td class='online-navigation'><a rel="index" title="Index"
	37	href="genindex.html"><img src='../icons/index.png'
	38	border='0' height='32' alt='Index' width='32' /></A></td>
	39	</tr></table>
	40	<div class='online-navigation'>
	41	<b class="navlabel">Previous:</b>
	42	<a class="sectref" rel="prev" href="meta-data.html">2.7 Additional meta-data</A>
	43	<b class="navlabel">Up:</b>
	44	<a class="sectref" rel="parent" href="setup-script.html">2. Writing the Setup</A>
	45	<b class="navlabel">Next:</b>
	46	<a class="sectref" rel="next" href="setup-config.html">3. Writing the Setup</A>
	47	</div>
	48	<hr /></div>
	49	</DIV>
	50	<!--End of Navigation Panel-->
	51
	52	<H1><A NAME="SECTION002800000000000000000">
	53	2.8 Debugging the setup script</A>
	54	</H1>
	55
	56	<P>
	57	Sometimes things go wrong, and the setup script doesn't do what the
	58	developer wants.
	59
	60	<P>
	61	Distutils catches any exceptions when running the setup script, and
	62	print a simple error message before the script is terminated. The
	63	motivation for this behaviour is to not confuse administrators who
	64	don't know much about Python and are trying to install a package. If
65	they get a big long traceback from deep inside the guts of Distutils,
66	they may think the package or the Python installation is broken
67	because they don't read all the way down to the bottom and see that
68	it's a permission problem.
69
70	<P>
71	On the other hand, this doesn't help the developer to find the cause
72	of the failure. For this purpose, the DISTUTILS_DEBUG environment
73	variable can be set to anything except an empty string, and distutils
74	will now print detailed information what it is doing, and prints the
75	full traceback in case an exception occurs.
76
77	<P>
78
79	<DIV CLASS="navigation">
80	<div class='online-navigation'>
81	<p></p><hr />
82	<table align="center" width="100%" cellpadding="0" cellspacing="2">
83	<tr>
84	<td class='online-navigation'><a rel="prev" title="2.7 Additional meta-data"
85	href="meta-data.html"><img src='../icons/previous.png'
86	border='0' height='32' alt='Previous Page' width='32' /></A></td>
87	<td class='online-navigation'><a rel="parent" title="2. Writing the Setup"
88	href="setup-script.html"><img src='../icons/up.png'
89	border='0' height='32' alt='Up One Level' width='32' /></A></td>
90	<td class='online-navigation'><a rel="next" title="3. Writing the Setup"
91	href="setup-config.html"><img src='../icons/next.png'
92	border='0' height='32' alt='Next Page' width='32' /></A></td>
93	<td align="center" width="100%">Distributing Python Modules</td>
94	<td class='online-navigation'><img src='../icons/blank.png'
95	border='0' height='32' alt='' width='32' /></td>
96	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
97	border='0' height='32' alt='Module Index' width='32' /></a></td>
98	<td class='online-navigation'><a rel="index" title="Index"
99	href="genindex.html"><img src='../icons/index.png'
100	border='0' height='32' alt='Index' width='32' /></A></td>
101	</tr></table>
102	<div class='online-navigation'>
103	<b class="navlabel">Previous:</b>
104	<a class="sectref" rel="prev" href="meta-data.html">2.7 Additional meta-data</A>
105	<b class="navlabel">Up:</b>
106	<a class="sectref" rel="parent" href="setup-script.html">2. Writing the Setup</A>
107	<b class="navlabel">Next:</b>
108	<a class="sectref" rel="next" href="setup-config.html">3. Writing the Setup</A>
109	</div>
110	</div>
111	<hr />
112	<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
113	</DIV>
114	<!--End of Navigation Panel-->
115	<ADDRESS>
116	See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
117	</ADDRESS>
118	</BODY>
119	</HTML>