[Python-modules-team] Bug#747567: Bug#747567: python3-pygame doesn't contain Pygame's documentation

[Vincent Cheng]

Hi Jonathan,

On Fri, May 9, 2014 at 7:48 PM, Jonathan Ballet <jon at multani.info> wrote:
> Package: python3-pygame
> Version: 1.9.2~pre~r3348-1
> Severity: normal
>
> Dear Maintainer,
>
> at the moment, python3-pygame only contains tutorials but
> not the reference documentation (API, etc.)
> However, python-pygame does contain everything.
>
> danio:~$ dpkg -L python3-pygame | grep html
> /usr/lib/python3/dist-packages/pygame/install.html
> /usr/lib/python3/dist-packages/pygame/readme.html
> /usr/lib/python3/dist-packages/pygame/docs/logos.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/MoveIt.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/ImportInit.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/DisplayModes.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/camera/CameraIntro.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/games6.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/games5.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/games4.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/games3.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/games2.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/tom/MakeGames.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/surfarray/SurfarrayIntro.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/intro/intro.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/chimp/chimp.py.html
> /usr/lib/python3/dist-packages/pygame/docs/tut/chimp/ChimpLineByLine.html
> /usr/lib/python3/dist-packages/pygame/docs/ref/pygame_cursor.html
> /usr/lib/python3/dist-packages/pygame/docs/ref/index.html
> danio:~$ dpkg -L python-pygame | grep html
> /usr/share/doc/python-pygame/logos.html
> /usr/share/doc/python-pygame/tut/newbieguide.html
> [...]
> /usr/share/doc/python-pygame/tut/MoveIt.html
> /usr/share/doc/python-pygame/ref/locals.html
> /usr/share/doc/python-pygame/ref/mixer.html
> /usr/share/doc/python-pygame/ref/tests.html
> /usr/share/doc/python-pygame/ref/draw.html
> /usr/share/doc/python-pygame/ref/mouse.html
> /usr/share/doc/python-pygame/ref/movie.html
> /usr/share/doc/python-pygame/ref/surfarray.html
> /usr/share/doc/python-pygame/ref/cdrom.html
> [...]
>
> Is it possible to provide the documentation without having to install
> both packages?
>
> (On a side note, this documentation should probably be moved to
> /usr/share/doc instead of being shipped in the Python package
> directory.)

It's on my todo list (along with other things like migrating to
pybuild and running the test suite with xvfb, etc.), but I doubt I'll
have time to get around to this anytime soon. Anyways, patches welcome
as always. :)

Regards,
Vincent