Best practice to include non-tex documentation in a CTAN package

Zdenek Wagner zdenek.wagner at gmail.com
Thu Nov 19 10:31:53 CET 2020


čt 19. 11. 2020 v 7:17 odesílatel Denis Bitouzé
<denis.bitouze at univ-littoral.fr> napsal:
>
> Hi Karl,
>
> Le 18/11/20 à 15h02, Karl Berry a écrit :
>
> >     - the .rst files (and .png files), with a README to explain how to
> >     compile them?
> >
> > Yes.
> >
> >     - the generated .tex file (and .png files)?
> >
> > No need.
> >
> > The idea of providing sources is to allow another person to modify the
> > program and/or documentation. For that, what's desired is the "real"
> > source that they would want to modify (and, as you suggest,
> > instructions for how to do it), not any number of intermediate
> > formats.
>
> I am very surprised by this. I thought that if someone interested in
> (La)TeX wanted to modify the documentation, the preferred source would
> be a `.tex` file and not an `.rst` file which requires installing
> third party softwares and following possibly complicated instructions to
> get something out of it.
>
The point is that it is not a (La)TeX package byt a python package. If
you want to use it, you need a third party tool (python) anyway.

> All the best.
> --
> Denis
>

Zdeněk Wagner
http://ttsm.icpf.cas.cz/team/wagner.shtml
http://icebearsoft.euweb.cz



More information about the tex-live mailing list.