[tex-live] need assistance for writing package installation instructions

[Stephan Hennig]

Hi,

the dehyph-exptl package (experimental German hyphenation patterns) will
be pre-installed in TeX Live 2008, but as a co-maintainer of the package
I think we should provide some installation instructions for existing TL
editions, i.e., TL <= 2007.  Unfortunately, I actually don't use TeX
Live myself and so far I've got some assistance by Karl, but there has
been a user complaint now, that I cannot sort out myself.  Instead of
bothering Karl again, I hope to get some assistance here.

I've attached the current installation instructions at the end of this
mail.  Item C.7 shows the command 'tlmgr generate language' that should
read language definitions off language-local.dat and merge those to the
global language.dat.

A user running TeX Live 2007 from openSuSE 11.0 complained that command

  tlmgr

cannot be found.

My questions are:

(i) Is the user right?

(ii) How long has tlmgr been part of TeX Live?

(iii) In case, tlmgr has/will only be introduced in TL 2008, what would
be proper installation instructions for TL <= 2007 (preferably, without
directly modifying global language.dat).

The same user complained that command 'fmtutil --refresh' doesn't work
unless he removes the line

  pinyin		xu-pyhyph.tex

from language.dat, probably due to a misconfiguration of the openSuSE
TeX Live package.  Unfortunately, the user didn't provide exact error
messages.  Is this a known problem?

Best regards,
Stephan Hennig



> ******************************************************
> **  English installation instructions for TeX Live  **
> ******************************************************
> Installation of the dehyph-exptl package requires three steps.
> Note, in the remaining text <date> refers to the pattern file
> date in ISO notation (YYYY-MM-DD)!
> 
> A. Copy pattern and wrapper files to the following location
>    within a local texmf tree:
> 
>       tex/generic/dehyph-exptl/dehyphn-x-<date>.pat
>       tex/generic/dehyph-exptl/dehyphn-x-<date>.tex
>       tex/generic/dehyph-exptl/dehypht-x-<date>.pat
>       tex/generic/dehyph-exptl/dehypht-x-<date>.tex
> 
>    The remaining files can be copied to
> 
>       doc/generic/dehyph-exptl/
> 
> 
> B. Refresh file name database.  See documentation of your
>    TeX distribution to learn how to do this.  The command
>    should be similar to
> 
>       >mktexlsr
> 
> 
> C. Modify language.dat and rebuild format files.
> 
> 
>   1. Determine the location of language-local.dat:
> 
>       >kpsewhich language-local.dat
> 
>      If the resulting path already points to a local tree,
>      jump right to step C.3.
> 
>   2. A local copy of language-local.dat doesn't exist, yet.
>      Create a new file lanuage-local.dat in a local texmf tree,
>      e.g.,
> 
>        <TeXLiveRoot>/texmf-local/tex/generic/config/language-local.dat
> 
>   3. Open language-local.dat from the local texmf tree into an
>      editor.
> 
>   4. If existent, remove the following lines
> 
>   =german-x-latest
>   =ngerman-x-latest
> 
>   5. Add the following lines to the end of language-local.dat:
> 
>   german-x-<date> dehypht-x-<date>.tex
>   =german-x-latest
>   ngerman-x-<date> dehyphn-x-<date>.tex
>   =ngerman-x-latest
> 
>   6. Save language-local.dat and close the editor.
> 
>   7. Make new languages known to TeX Live:
> 
>       >mktexlsr                  (just to be sure)
>       >tlmgr generate language
> 
>   8. Rebuild format files:
> 
>       >fmtutil --refresh
> 
>      In case this command fails with error message
> 
>        >TeX capacity exceeded, sorry [pattern memory=XXX]
> 
>      or
> 
>        >TEX capacity exceeded, sorry [pattern memory ops=XXX]
> 
>      some languages have to be deactivated in language.dat or
>      parameters trie_size and trie_op_size have to be enlarged.
>      Please refer to the documentation of your TeX distribution
>      or ask a TeX wizard.
> 
> 
> END.