Re: [HappyDoc-discuss] incantation for multiple packages

[Donnal W. <don...@ya...>]

--- Doug Hellmann <do...@he...> wrote:
> On Monday 18 March 2002 07:36, Donnal Walter wrote:
> > Using Python 2.2 on Windows 2000 Pro, I am working on an
> > application contained in three packages:
> 
> [...]
> 
> > How can I generate ALL of the documentation in \Docs\api (and
> > its corresponding subdirectories)? Thanks.
> 
> There are still some bugs with path handling on win32 systems.  I
> think I've worked out what the problems are, but I haven't had a
> chance to boot into windows to work on the fixes.  Try not using
> the "C:" on the front of your paths, since I know drive letters
> confuse the path code right now.
> 
> For example, try:
> 
> C:\>C:\Python22\Scripts\happydocwin.py -d \Prism\Docs\api
> \Prism\Lib
> 
> Please let me know if that works, since it will confirm my
> suspicions about what is broken.

No, this still generated all of the module HTML pages inside the
packages where the modules are located.

> If that does not work, this workaround might help until I fix the
> problem.  If you do not specify *any* path using the -d option,
> the output should be written to C:\Prism\Lib\docs.  You could
> then rename/move that directory to where you want it to be.

Okay, so I tried:
C:\>C:\Python22\Scripts\happydocwin.py  \Prism\Lib

Unfortunately this did exactly the same thing. All of the HTML
pages were written to the directories where the modules were. I
tried two or three other combinations that did not work either.
Then I stumbled onto this formula:

C:\>cd Prism\Lib
C:\Prism\Lib>C:\Python22\Scripts\happydocwin.py ..\Lib

This worked!! ALL the output was written to C:\Prism\Lib\doc, which
I moved and renamed as you suggested. Emboldened by this success,
however, I tried naming the destination again:

C:\>cd Prism\Lib
C:\Prism\Lib>C:\Python22\Scripts\happydocwin.py
 -d ..\Docs\api ..\Lib

This worked too, writing everything to C:\Prism\Docs\api. Then I
tried simplifying it one more step:

C:\>cd Prism
C:\Prism>C:\Python22\Scripts\happydocwin.py -d .\Docs\api .\Lib

This incantation works too. The output is gorgeous (and extremely
helpful). Thank you for your help.



=====
Donnal Walter
Arkansas Children's Hospital

__________________________________________________
Do You Yahoo!?
Yahoo! Sports - live college hoops coverage
http://sports.yahoo.com/