Re: uncompressed documentation for pgf and beamer
Dear Ohura-san
some time ago I asked about uncrompessing docs, see below email.
In fact, in preparation for post-wheezy, I would like to ask
for updates of the latex-beamer class, too. It has seen already a lot
of revisions and we will release wheezy with a quite outdated
version. 3.10 was released in 2010, and since then quite some
things have been fixed.
I have already prepared locally a git repository ready for
git-buildpackage that imports the last Debian release, plus
packages the new 3.24 release.
Please let me know what you think about this package and your future
plans, and if I can be of any help, don't hesitate to ask. I would
also be glad if we take over latex-beamer into the Debian TeX group
and continue maintaining it together.
All the best
Norbert
On Mo, 06 Aug 2012, Norbert Preining wrote:
> I would kindly ask your opinion on the following two changes in the
> packages pgf and latex-beamer you are maintaining:
>
> For pgf:
> do not compress pgf documentation so that it works properly with
> texdoc
>
> For beamer:
> - do not compress beameruserguide.pdf
> - add a symlink from below /usr/share/texmf/doc/latex/beamer to
> /usr/share/doc/latex-beamer/beameruserguide.pdf to make sure
> it is found by texdoc (Closes: #357032)
>
> Both target one and only one thing, that users on Debian can use
> texdoc beamer
> texdoc pgf
> as advertised and often recommended to find the right documentation.
>
> There are several issues here: One is that compressed documentation
> is still not perfectly supported. This is a problem on the Debian
> side since the viewer normally used (xdg-open) is non-blocking
> which makes the documentation immediately disappear (the uncompressed
> temp file).
>
> The other item is that texdoc does not search outside of the texmf
> hierarchy, so we have to link the beamer users guide also into the
> texmf tree.
>
> I have prepared NMUs for these two packages, and attach the debdiff for
> both.
>
> We would be really grateful if you could upload new versions with only
> these changes, and ask for a freeze exception, so that in Debian
> stable users have a good experience.
>
> If you prefer that I do an NMU (delayed, immediately), please let me know,
> and I will make the NMU and ask debian-release for a freeze exception.
>
> Thanks a lot for your work on maintaining these packages and
> どうぞよろしくお願いします。
>
>
> Norbert
> ------------------------------------------------------------------------
> Norbert Preining preining@{jaist.ac.jp, logic.at, debian.org}
> JAIST, Japan TeX Live & Debian Developer
> DSA: 0x09C5B094 fp: 14DF 2E6C 0307 BE6D AD76 A9C0 D2BF 4AA3 09C5 B094
> ------------------------------------------------------------------------
> DULUTH (adj.)
> The smell of a taxi out of which people have just got.
> --- Douglas Adams, The Meaning of Liff
> diff -u latex-beamer-3.10/debian/rules latex-beamer-3.10/debian/rules
> --- latex-beamer-3.10/debian/rules
> +++ latex-beamer-3.10/debian/rules
> @@ -83,7 +83,7 @@
> dh_installman
> dh_link
> dh_strip
> - dh_compress
> + dh_compress -Xbeameruserguide.pdf
> dh_fixperms
> # dh_perl
> # dh_python
> diff -u latex-beamer-3.10/debian/changelog latex-beamer-3.10/debian/changelog
> --- latex-beamer-3.10/debian/changelog
> +++ latex-beamer-3.10/debian/changelog
> @@ -1,3 +1,14 @@
> +latex-beamer (3.10-2.1) unstable; urgency=low
> +
> + * Non-maintainer upload.
> + * release to make beamer user guide be found by texdoc
> + - do not compress beameruserguide.pdf
> + - add a symlink from below /usr/share/texmf/doc/latex/beamer to
> + /usr/share/doc/latex-beamer/beameruserguide.pdf to make sure
> + it is found by texdoc (Closes: #357032)
> +
> + -- Norbert Preining <preining@debian.org> Mon, 06 Aug 2012 16:46:46 +0900
> +
> latex-beamer (3.10-2) unstable; urgency=medium
>
> * Update Standards-Version.
> only in patch2:
> unchanged:
> --- latex-beamer-3.10.orig/debian/links
> +++ latex-beamer-3.10/debian/links
> @@ -0,0 +1 @@
> +usr/share/doc/latex-beamer/beameruserguide.pdf usr/share/texmf/doc/latex/beamer/beameruserguide.pdf
> diff -u pgf-2.10/debian/rules pgf-2.10/debian/rules
> --- pgf-2.10/debian/rules
> +++ pgf-2.10/debian/rules
> @@ -90,7 +90,7 @@
> dh_installman
> dh_link
> dh_strip
> - dh_compress -X.svg
> + dh_compress -X.svg -Xpgfmanual.pdf
> dh_fixperms
> # dh_perl
> # dh_python
> diff -u pgf-2.10/debian/changelog pgf-2.10/debian/changelog
> --- pgf-2.10/debian/changelog
> +++ pgf-2.10/debian/changelog
> @@ -1,3 +1,11 @@
> +pgf (2.10-1.1) unreleased; urgency=low
> +
> + * Non-maintainer upload.
> + * do not compress pgf documentation so that it works properly with
> + texdoc
> +
> + -- Norbert Preining <preining@debian.org> Mon, 06 Aug 2012 17:19:14 +0900
> +
> pgf (2.10-1) unstable; urgency=low
>
> * New upstream release (Closes: #606128)
------------------------------------------------------------------------
Norbert Preining preining@{jaist.ac.jp, logic.at, debian.org}
JAIST, Japan TeX Live & Debian Developer
DSA: 0x09C5B094 fp: 14DF 2E6C 0307 BE6D AD76 A9C0 D2BF 4AA3 09C5 B094
------------------------------------------------------------------------
AASLEAGH (n.)
A liqueur made only for drinking at the end of a revoltingly long
bottle party when all the drinkable drink has been drunk.
--- Douglas Adams, The Meaning of Liff
Reply to: