Phoenix doc build

[Werner]

Hi,

Just an FYI.

When I try to do build.py sphinx I get "hash collision: 3 for both 1 and 1".

My hack is to add this at the beginning of conf.py:

# PIL hack, otherwise get "hash collision: 3 for both 1 and 1"
# other patches/changes don't work for me
# see also:
https://bitbucket.org/birkenfeld/sphinx/issue/757/again-accessinit-hash-collision-3-for-both
import PIL.Image
sys.modules['Image'] = PIL.Image

Werner

[werner]

Hi,

I am not yet succeeding correctly.

It is building but I don't get my changes. I noticed that it pulls from
the installed copy, so changed my wx.pth to point to my installed
Phoenix and copied my changed files from the svn copy to the installed
folder, is there something else I need to do?

My steps:
- change the doc stuff in wx.lib.pdfviewer
- copy the changed files to wx.lib.pdfviewer to my Phoenix install
- run build.py wxlib sphinx

Just redid it and still same problem, even renamed my other wxPython
installs to make sure it wouldn't find the wrong one along the way.

I must do something stupid but I just don't see it.

Werner

[Andrea Gavana]

Werner,

Try to remove the wxlib.pkl files in the docs/sphinx folder and rebuild. It should work...

 

--
Andrea.

"Imagination Is The Only Weapon In The War Against Reality."
http://www.infinity77.net

# ------------------------------------------------------------- #
def ask_mailing_list_support(email):

    if mention_platform_and_version() and include_sample_app():
        send_message(email)
    else:
        install_malware()
        erase_hard_drives()
# ------------------------------------------------------------- #

[werner]

Hi Andrea,

On 04/04/2013 11:09, Andrea Gavana wrote:
> Werner,
>
...

> Try to remove the wxlib.pkl files in the docs/sphinx folder and
> rebuild. It should work...

That did it.

But I need to remove it on each build - maybe build can take care of
this - or does it do it but not the way I use it - which isn't really a
"standard" use.

Thanks
Werner

[Andrea Gavana]

Hi Werner,

You can use the build command like this:

python build.py clean_sphinx

And that will remove the txt sources and the various intermediate pickle files.

Andrea.

[werner]

Hi,

When I try to build the doc I see the following exception. My work
around is just to get rid of the ".svn" folders, as I don't care about
them (in this case;-) ), but I am sure there must be a "cleaner" way.

Werner

- lib.wordwrap (module)
- lib.wxpTag (module)
Finished command: wx.lib (1m37.302s)
Running command: clean_sphinx
Traceback (most recent call last):
File "build.py", line 1506, in <module>
main(sys.argv[1:])
File "build.py", line 159, in main
function(options, args)
File "build.py", line 1316, in cmd_clean_sphinx
shutil.rmtree(d)
File "c:\python27\lib\shutil.py", line 244, in rmtree
rmtree(fullname, ignore_errors, onerror)
File "c:\python27\lib\shutil.py", line 244, in rmtree
rmtree(fullname, ignore_errors, onerror)
File "c:\python27\lib\shutil.py", line 244, in rmtree
rmtree(fullname, ignore_errors, onerror)
File "c:\python27\lib\shutil.py", line 249, in rmtree
onerror(os.remove, fullname, sys.exc_info())
File "c:\python27\lib\shutil.py", line 247, in rmtree
os.remove(fullname)
WindowsError: [Error 5] Acc�s refus:
'H:\\devProjectsT\\wxPhoenix\\docs\\html\\_static\\css\\.svn\\all-wcprops'
Finished command: clean_sphinx (0.704s)

[Robin Dunn]

I'm guessing that docs/html/_static is being copied from
docs/sphinx/_static, so that would likely be where the .svn subfolders
are coming from. They are not needed there since that is just a temp
folder used as a staging area for organizing the files to be used for
the html docs. A good fix would be to find where that copy is being
done and filter-out the .svn folders so they are not copied at all.


--
Robin Dunn
Software Craftsman
http://wxPython.org

[werner]

Hi Robin,

On 08/05/2013 19:21, Robin Dunn wrote:

...

>
> I'm guessing that docs/html/_static is being copied from
> docs/sphinx/_static, so that would likely be where the .svn subfolders
> are coming from. They are not needed there since that is just a temp
> folder used as a staging area for organizing the files to be used for
> the html docs. A good fix would be to find where that copy is being
> done and filter-out the .svn folders so they are not copied at all.

Just to be sure "docs/html/_static" is the temp/staging folder, correct?

Werner

[Robin Dunn]

Correct. Everything in docs/html is either generated by the Phoenix
build or by Sphinx, or is copied there.