Re: new texinfo version

[Werner LEMBERG]

I forgot to answer this mail.

> [...] the INSTALL file states
>
> --snip--
> * texinfo.tex and the other *.tex files are not installed by `make
>   install'.  This is because there is no reliable way to know where
>   to install them.  Instead, you have to run an additional make
>   command after the normal make install:
>     make TEXMF=/your/texmf install-tex
>   texinfo.tex is installed in ${TEXMF}/tex/texinfo/texinfo.tex, etc.
> --snip--
>
> I am using LilyDev but is my 'texmf' the 'tex' dir in the top level
> of the LilyPond source code dir?

Yes and no: `No', because you probably want to use the new
`texinfo.tex' file for other projects also (see below).  `Yes',
because the `texinfo.tex' version from the lilypond's `texmf'
directory is actually used while compiling lilypond's documentation.


    Werner


======================================================================


Somewhere on your harddisk you have a complete TeX installation
which allows access to various TEXMF trees.  For example, if I say

  kpsexpand '$TEXMF'

on my GNU/Linux command line to look up the value of the `TEXMF'
variable[1], the following gets returned:

 {
  /home/wl/.texlive2012/texmf-config,
  /home/wl/.texlive2012/texmf-var,
  /home/wl/texmf,
  !!/usr/local/backup/TeXLive/Master/texmf-config,
  !!/usr/local/backup/TeXLive/Master/texmf-var,
  !!/usr/local/backup/TeXLive/Master/texmf,
  !!/usr/local/backup/TeXLive/Master/../texmf-local,
  !!/usr/local/backup/TeXLive/Master/texmf-dist
 }

Files are searched in this directory order.  Note that each of those
directories is a TDS (TeX Directory Structure) tree which has a
standardized structure,
cf. http://ctan.open-source-solution.org/tds/tds.html#Summary for a
summary of its layout.  TDS trees are also called TEXMF trees.

I haven't modified the TEXMF variable in my environment, thus you see
the original values as distributed with TeXLive 2012.  The first two
lines are the configuration directories maintained by TeXLive itself,
mainly to store generated files.  The third one is my personal TEXMF
tree.  The directories which names start with two exclamation marks[2]
are considered read-only on my harddisk, holding the data provided by
TeXLive itself.  (My layout is a bit odd probably since I'm running
TeXLive directly from the SVN.)

To summarize:

  . Additional packages intended for global use should be stored in a
    `texmf-local' tree.  The emphasis lies on *addition*; it should
    rather not be used for replacement files: As you can see above,
    the `texmf-local' gets searched *after* `texmf' by default.  This
    can be changed, but I don't recommend this.

  . Replacement files are best located in your personal TEXMF tree.
    Since TeXLive comes with `texinfo.tex', you should go this route.
    If I say

      kpsewhich texinfo.tex

    I get

      /usr/local/backup/TeXLive/Master/texmf-dist/tex/texinfo/texinfo.tex

    thus an appropriate location for the new file would be

      /home/wl/texmf/tex/texinfo/texinfo.tex

    on my harddisk.  Consequently, I could say

      make TEXMF=/home/wl/texmf install-tex

    to install texinfo's tex files.  This make call automatically
    creates all necessary subdirectories, BTW.


[1] This environment variable is used internally by the TeXLive's path
    finding system, provided by the kpathsea library.
[2] `!!' means that one or more TeXLive cache files called `ls-R'
    should be looked up exclusively instead of doing an actual disk
    search.