Bug#917270: texlive-latex-extra-doc: Please add dtx files for dtxgallery
Hi Karl,
On Tue, 25 Dec 2018, Braun Gábor wrote:
> Open the dtxgallery document with 'texdoc dtxgallery'.
> A PDF file opens, and on the very first page prominently lists four example dtx files
> without any information how to open them:
>
> single-source.dtx
> conditional-code.dtx
> rearrange.dtx
> dtxgallery.dtx
>
> Note that on the top of the second page, the document explicitly recommends
> examining these dtx files directly, but the lack of any information where these are make it
> very hard. They don't seem to be included in the package, at least not in an obvious location:
These files are in the source files part of dtxgallery:
**************
name dtxgallery
category Package
revision 15878
shortdesc A small collection of minimal DTX examples
longdesc A collection of files that demonstrate simple things that are
longdesc possible with the flexible and under-appreciated docstrip file
longdesc format. Each file of the collection is provided as a .dtx file
longdesc and as the corresponding .pdf. The set is intended as a
longdesc companion to Scott Pakin's excellent and influential dtxtut
longdesc example of producing LaTeX packages in this way.
containersize 584
containerchecksum 2c73069596d5c99c6f9f9ea9f9e65f5f731854068d1b56a6317e5966a023ad057c81d8c62ef38fc3af962b7307cbff45dbcd3867fdb4caf7bcd3a2c83a722674
doccontainersize 349372
doccontainerchecksum 31e82752179fb78fd8db1871eee1b3c254e78f4254540c43d63a4243f59a0ec5efcfef6211c0d9012e2dc336164ad65e1ec38d9a1f0274208600b188ff86bdfa
docfiles size=95
texmf-dist/doc/latex/dtxgallery/README details="Readme"
texmf-dist/doc/latex/dtxgallery/conditional-code.pdf
texmf-dist/doc/latex/dtxgallery/dtxgallery.pdf
texmf-dist/doc/latex/dtxgallery/rearrange.pdf
texmf-dist/doc/latex/dtxgallery/single-source.pdf
srccontainersize 3972
srccontainerchecksum 60b1bd74afa60c36d7ebd522157a594cb62298c3638b28d589a84f8df08e37dfc923c063663b9a7202481bf8d80970d873b2cb055c8fbcaba71d55c109e8a89d
srcfiles size=5
texmf-dist/source/latex/dtxgallery/conditional-code.dtx
texmf-dist/source/latex/dtxgallery/dtxgallery.dtx
texmf-dist/source/latex/dtxgallery/rearrange.dtx
texmf-dist/source/latex/dtxgallery/single-source.dtx
**********
I think in this particular case it would be better to move them to the
docfiles?
WDYT?
Norbert
--
PREINING Norbert http://www.preining.info
Accelia Inc. + JAIST + TeX Live + Debian Developer
GPG: 0x860CDC13 fp: F7D8 A928 26E3 16A1 9FA0 ACF0 6CAC A448 860C DC13
Reply to: