Gentoo Development Guide

TEXLIVE-MODULE.ECLASS

Section: portage (5)
Updated: May 2013
Index Return to Main Contents

NAME

texlive-module.eclass - Provide generic install functions so that modular texlive's texmf ebuild will only have to inherit this eclass

DESCRIPTION

Purpose: Provide generic install functions so that modular texlive's texmf ebuilds will only have to inherit this eclass. Ebuilds have to provide TEXLIVE_MODULE_CONTENTS variable that contains the list of packages that it will install. (See below)

For TeX Live versions prior to 2009, the ebuild was supposed to unpack the texmf and texmf-dist directories to ${WORKDIR} (which is what the default src_unpack does). Starting from TeX Live 2009, the eclass provides a src_unpack function taking care of unpacking and relocating the files that need it.

It inherits texlive-common and base for supporting patching via the PATCHES bash array with EAPI>=2.

FUNCTIONS

texlive-module_src_unpack: Only for TeX Live 2009 and later. Gives tar.xz unpack support until we can use an EAPI with that support. If EAPI supports tar.xz then it calls unpack instead of its own unpacker. After unpacking, the files that need to be relocated are moved accordingly.
texlive-module_add_format: Creates/appends to a format.${PN}.cnf file for fmtutil. It parses the AddFormat directive of tlpobj files to create it. This will make fmtutil generate the formats when asked and allow the remaining src_compile phase to build the formats.
texlive-module_make_language_def_lines: Creates a language.${PN}.def entry to put in /etc/texmf/language.def.d. It parses the AddHyphen directive of tlpobj files to create it.
texlive-module_make_language_dat_lines: Creates a language.${PN}.dat entry to put in /etc/texmf/language.dat.d. It parses the AddHyphen directive of tlpobj files to create it.
texlive-module_synonyms_to_language_lua_line: Helper function for texlive-module_make_language_lua_lines to generate a correctly formatted synonyms entry for language.dat.lua.
texlive-module_make_language_lua_lines: Only valid for TeXLive 2010. Creates a language.${PN}.dat.lua entry to put in /etc/texmf/language.dat.lua.d. It parses the AddHyphen directive of tlpobj files to create it.
texlive-module_src_compile: exported function: Generates the config files that are to be installed in /etc/texmf; texmf-update script will take care of merging the different config files for different packages in a single one used by the whole tex installation.
Once the config files are generated, we build the format files using fmtutil (provided by texlive-core). The compiled format files will be sent to texmf-var/web2c, like fmtutil defaults to but with some trick to stay in the sandbox.
texlive-module_src_install: exported function: Installs texmf and config files to the system.
texlive-module_pkg_postinst: exported function: Run texmf-update to ensure the tex installation is consistent with the installed texmf trees.
texlive-module_pkg_postrm: exported function: Run texmf-update to ensure the tex installation is consistent with the installed texmf trees.

ECLASS VARIABLES

TEXLIVE_MODULE_CONTENTS: The list of packages that will be installed. This variable will be expanded to SRC_URI: foo -> texlive-module-foo-${PV}.tar.xz
TEXLIVE_MODULE_DOC_CONTENTS: The list of packages that will be installed if the doc useflag is enabled. Expansion to SRC_URI is the same as for TEXLIVE_MODULE_CONTENTS.
TEXLIVE_MODULE_SRC_CONTENTS: The list of packages that will be installed if the source useflag is enabled. Expansion to SRC_URI is the same as for TEXLIVE_MODULE_CONTENTS.
TEXLIVE_MODULE_BINSCRIPTS: A space separated list of files that are in fact scripts installed in the texmf tree and that we want to be available directly. They will be installed in /usr/bin.
TL_PV: Normally the module's PV reflects the TeXLive release it belongs to. If this is not the case, TL_PV takes the version number for the needed app-text/texlive-core.
TL_MODULE_INFORMATION: Information to display about the package. e.g. for enabling/disabling a feature

AUTHORS

Original Author: Alexis Ballier <aballier@gentoo.org>

MAINTAINERS

tex@gentoo.org

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/

FILES

/usr/portage/eclass/texlive-module.eclass

This document was created by man2html, using the manual pages.
Time: 03:25:01 GMT, May 21, 2013