Status of TeXLive Documentation

Sunday87 · 2013-04-02 20:14:47

Hi everyone!

I'm troubled about the missing texlive-*-doc packages. Apparently they are missing for some time now (old threads https://bbs.archlinux.org/viewtopic.php?id=109263, https://bbs.archlinux.org/viewtopic.php?id=104399). Why is this still the case?

Are those considered unimportant? Is it the majority opinion that anyone who uses that documentation should just install their own texlive without using the arch packages? Is it just too much work to create those packages?

Greetings

Jodell · 2013-04-02 22:04:47

The second post in the second link you provided holds your answer.

Sunday87 · 2013-04-02 23:17:08

Well, I see an explanation why the original PKGBUILD wouldn't work any more. But if their install script is able to install the docs - than so should we. I think one could write a PKGBUILD that uses their install-script to download the files and put them together in a package. Maybe I will look into it. Maybe someone als has already tried it? Wouldn't the other PKGBUILDs for the TeXLive packages work in a similar way?

Last edited by Sunday87 (2013-04-02 23:17:27)

cfr · 2013-04-03 00:17:01

I'm not sure it is that simple. siunitx is an example from one of those threads. So I take it that you do not have a copy of siunitx.pdf, right?

In TeX Live itself, that is part of the siunitx package i.e. it is not part of a separate doc package, for example.

$ less /usr/local/texlive/2012/tlpkg/tlpobj/siunitx.tlpobj 
name siunitx
category Package
revision 29360
shortdesc A comprehensive (SI) units package.
longdesc Typesetting values with units requires care to ensure that the
longdesc combined mathematical meaning of the value plus unit
longdesc combination is clear. In particular, the SI units system lays
longdesc down a consistent set of units with rules on how they are to be
longdesc used. However, different countries and publishers have
longdesc differing conventions on the exact appearance of numbers (and
longdesc units). A number of LaTeX packages have been developed to
longdesc provide consistent application of the various rules: SIunits,
longdesc sistyle, unitsdef and units are the leading examples. The
longdesc numprint package provides a large number of number-related
longdesc functions, while dcolumn and rccol provide tools for
longdesc typesetting tabular numbers. The siunitx package takes the best
longdesc from the existing packages, and adds new features and a
longdesc consistent interface. A number of new ideas have been
longdesc incorporated, to fill gaps in the existing provision. The
longdesc package also provides backward-compatibility with SIunits,
longdesc sistyle, unitsdef and units. The aim is to have one package to
longdesc handle all of the possible unit-related needs of LaTeX users.
longdesc The package relies on LaTeX 3 support from the l3kernel and
longdesc l3packages bundles.
containersize 34284
containermd5 3cc997121e8384e60a68fa0fc3c38519
doccontainersize 569448
doccontainermd5 6aa313d0ff41dc2b32ce2438510faa9f
docfiles size=143
 texmf-dist/doc/latex/siunitx/README details="Readme"
 texmf-dist/doc/latex/siunitx/siunitx.pdf details="Package documentation"
srccontainersize 102128
srccontainermd5 2cafe3342a31b0e1e358df4545a2378d
srcfiles size=150
 texmf-dist/source/latex/siunitx/siunitx.dtx
 texmf-dist/source/latex/siunitx/siunitx.ins
runfiles size=78
 texmf-dist/tex/latex/siunitx/config/siunitx-abbreviations.cfg
 texmf-dist/tex/latex/siunitx/config/siunitx-binary.cfg
 texmf-dist/tex/latex/siunitx/config/siunitx-version-1.cfg
 texmf-dist/tex/latex/siunitx/siunitx.sty
catalogue-ctan /macros/latex/contrib/siunitx
catalogue-date 2013-03-12 10:55:10 +0100
catalogue-license lppl1.3

Do you have the source files? I guess you could always write a script to generate the docs, if you do.

I don't know much about how this is packaged for distros - I've always used the upstream stuff.

EDIT: Just tried to look at a PKGBUILD and remembered my Arch machine is sick .

Last edited by cfr (2013-04-03 00:19:19)

Sunday87 · 2013-04-03 00:24:59

Actually... It is far simpler. It is all available at ftp://tug.org/texlive/Contents/live/texmf-dist/doc/.

PKGBUILD

pkgname=texlive-most-doc
pkgver=$(date +%Y%m%d)
pkgrel=1
pkgdesc="Most TeXLive documentation"
url="http://tug.org/texlive/"
arch=('any')
license=('unknown')
optdepends=('texlive-bin: The texdoc program and some more documentation')
makedepends=('wget')
install='texlive-most-doc.install'
options=('!strip'  '!purge')

build() {
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf-dist/doc
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/asymptote
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/dvipng/dvipng.pdf
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/dvips/dvips.pdf
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/man
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/info
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/tetex
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/texlive
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/texworks
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/web2c/web2c.pdf
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/ttf2pk/ttf2tfm.txt
  wget -r -l inf -N -nH -nv --cut-dirs=3 -P "$srcdir/usr/share/" ftp://tug.org/texlive/Contents/live/texmf/doc/ttf2pk/ttf2pk.txt
}

package() {
  cp -rl "$srcdir"/* "$pkgdir"
}

texlive-most-doc.install

post_install() {
  texhash
}

post_remove() {
  texhash
}

post_upgrade() {
  texhash
}

I am trying this right now.

Last edited by Sunday87 (2013-04-04 20:55:00)

Sunday87 · 2013-04-03 09:00:44

Works. 850MB package, installation size 1300MB.

cfr · 2013-04-04 02:07:39

That won't necessarily match what you have installed, though, right? Do you already have the docs under texmf/doc? (As opposed to texmf-dist/doc.)

Sunday87 · 2013-04-04 08:25:47

No, that will install everything there is in texmf-dist/doc. That most propably is more than most people need. Some of the documentation in texmf/doc ist already contained in texlive-bin, but not all. I think I will (when i get to it ) upgrade the PKGBUILD to also include the missing parts there.

Last edited by Sunday87 (2013-04-04 08:26:05)

Sunday87 · 2013-04-04 18:39:15

I have compared the contents of ftp://tug.org/texlive/Contents/live/texmf/doc/ with 'pkgfile --list texlive-bin | grep texmf/doc | sort' and added the missing files to the PKGBUILD, updated in the above posting. I am now thinking if this would be suitable for the AUR or if this thing would just blow the tug.org ftp server if too many people use it. I did not find any mirrors containing those folders. Perhaps it could be feasible to distribute the resulting package by bittorrent or sth like that.

Last edited by Sunday87 (2013-04-04 19:07:55)

koppor · 2016-05-08 16:40:32

Is there some proges on this thing? Currently, the output of

pkgfile --list texlive-bin | grep texmf/doc | sort

is empty. Isn't it easy to include the documentation of the packages during installation? This is, what MiKTeX does. I know that the package bundling is different in texlive. Couldn't there be a separate doc package for each texlive package?

I think that the docs can also be fetched via https://www.ctan.org/mirrors. Thus, the URL of each doc has to be converted to something like http://mirrors.ctan.org/macros/latex/co … blatex.pdf. However, I don't know, how to convert the full package list to a list of URLs pointing to the documentation PDFs.

Last edited by koppor (2016-05-08 16:43:49)

gamer01 · 2016-10-02 16:24:16

I think its a good idea to put it on AUR, or am i wrong?

Arch Linux

#1 2013-04-02 20:14:47

Status of TeXLive Documentation

#2 2013-04-02 22:04:47

Re: Status of TeXLive Documentation

#3 2013-04-02 23:17:08

Re: Status of TeXLive Documentation

#4 2013-04-03 00:17:01

Re: Status of TeXLive Documentation

#5 2013-04-03 00:24:59

Re: Status of TeXLive Documentation

#6 2013-04-03 09:00:44

Re: Status of TeXLive Documentation

#7 2013-04-04 02:07:39

Re: Status of TeXLive Documentation

#8 2013-04-04 08:25:47

Re: Status of TeXLive Documentation

#9 2013-04-04 18:39:15

Re: Status of TeXLive Documentation

#10 2016-05-08 16:40:32

Re: Status of TeXLive Documentation

#11 2016-10-02 16:24:16

Re: Status of TeXLive Documentation

Board footer