[qmtest] building the documentation via 'python setup.py build_doc'

Mark Mitchell mark at codesourcery.com
Thu Aug 28 17:16:14 UTC 2003


On Thu, 2003-08-28 at 10:03, Stefan Seefeld wrote:
> Mark Mitchell wrote:
> >>+    As this command is only ever used on 'posix' platforms, no efford
> >>+    has been made to make this code portable to other platforms such
> >>+    as 'nt'."""
> > 
> > 
> > Spelling: "effort",  not "efford".  Also, there's no need to include the
> > OS names in single quotes, but they should be spelled as their
> > trademark-holders prefer: "POSIX" and "Windows".
> 
> I was actually using the values reported by the os.name attribute, as
> that is what lots of modules seem to base their decisions on.
> (distutils, for example).

OK.

> well, I took it out for consistency. Alternatively, I should replace all
> other ocurrences of paths containing '/' (such as the path search lists
> containing '/usr/share/doc' etc.) by appropriate calls to os.path.join,
> too, no ?

Yes, I think that makes sense.  

Using os.path.join seems best; it can't hurt, and it might help. :-)

You can go ahead and make the change you suggest and check that in,
along with the others.  Please make a ChangeLog entry as well.

Thanks,

-- 
Mark Mitchell
CodeSourcery, LLC
mark at codesourcery.com




More information about the qmtest mailing list