/[gentoo-x86]/eclass/latex-package.eclass
Gentoo

Diff of /eclass/latex-package.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.3 Revision 1.39
1# Author Matthew Turk <m-turk@nwu.edu> 1# Copyright 1999-2011 Gentoo Foundation
2# An ebuild calling this class can cd to the appropriate 2# Distributed under the terms of the GNU General Public License v2
3# directory and call latex-package_src_doinstall all, or leave 3# $Header: /var/cvsroot/gentoo-x86/eclass/latex-package.eclass,v 1.39 2011/08/22 04:46:32 vapier Exp $
4# the src_install function as-is if the system is single-directory. 4
5# @ECLASS: latex-package.eclass
6# @MAINTAINER:
7# TeX team <tex@gentoo.org>
8# @AUTHOR:
9# Matthew Turk <satai@gentoo.org>
10# Martin Ehmsen <ehmsen@gentoo.org>
11# @BLURB: An eclass for easy installation of LaTeX packages
12# @DESCRIPTION:
13# This eClass is designed to be easy to use and implement. The vast majority of
14# LaTeX packages will only need to define SRC_URI (and sometimes S) for a
15# successful installation. If fonts need to be installed, then the variable
16# SUPPLIER must also be defined.
17#
18# However, those packages that contain subdirectories must process each
19# subdirectory individually. For example, a package that contains directories
20# DIR1 and DIR2 must call latex-package_src_compile() and
21# latex-package_src_install() in each directory, as shown here:
22#
23# src_compile() {
24# cd ${S}
25# cd DIR1
26# latex-package_src_compile
27# cd ..
28# cd DIR2
29# latex-package_src_compile
30# }
31#
32# src_install() {
33# cd ${S}
34# cd DIR1
35# latex-package_src_install
36# cd ..
37# cd DIR2
38# latex-package_src_install
39# }
40#
41# The eClass automatically takes care of rehashing TeX's cache (ls-lR) after
42# installation and after removal, as well as creating final documentation from
43# TeX files that come with the source. Note that we break TeX layout standards
44# by placing documentation in /usr/share/doc/${PN}
45#
46# For examples of basic installations, check out dev-tex/aastex and
47# dev-tex/leaflet .
48#
49# NOTE: The CTAN "directory grab" function creates files with different MD5
50# signatures EVERY TIME. For this reason, if you are grabbing from the CTAN,
51# you must either grab each file individually, or find a place to mirror an
52# archive of them. (iBiblio)
53#
54# It inherits base.
5 55
6inherit base 56inherit base
7INHERITED="$INHERITED $ECLASS"
8 57
9newdepend ">=app-text/tetex-1.0.7" 58RDEPEND="virtual/latex-base"
10ECLASS=latex-package 59DEPEND="${RDEPEND}
60 >=sys-apps/texinfo-4.2-r5"
11HOMEPAGE="http://www.tug.org/" 61HOMEPAGE="http://www.tug.org/"
12SRC_URI="ftp://tug.ctan.org/macros/latex/" 62SRC_URI="ftp://tug.ctan.org/macros/latex/"
13S=${WORKDIR}/${P} 63S=${WORKDIR}/${P}
14TEXMF="/usr/share/texmf" 64TEXMF="/usr/share/texmf"
65
66# @ECLASS-VARIABLE: SUPPLIER
67# @DESCRIPTION:
15SUPPLIER="misc" # This refers to the font supplier; it should be overridden 68# This refers to the font supplier; it should be overridden (see eclass
69# DESCRIPTION above)
70SUPPLIER="misc"
16 71
72# @FUNCTION: latex-package_has_tetex3
73# @RETURN: true if at least one of (>=tetex-3 or >=ptex-3.1.8 or >=texlive-core-2007) is installed, else false
74# @DESCRIPTION:
75# It is often used to know if the current TeX installation supports gentoo's
76# texmf-update or if the package has to do it the old way
77latex-package_has_tetex_3() {
78 if has_version '>=app-text/tetex-3' || has_version '>=app-text/ptex-3.1.8' || has_version '>=app-text/texlive-core-2007' ; then
79 true
80 else
81 false
82 fi
83}
84
85# @FUNCTION: latex-package_src_doinstall
86# @USAGE: [ module ]
87# @DESCRIPTION:
88# [module] can be one or more of: sh, sty, cls, fd, clo, def, cfg, dvi, ps, pdf,
89# tex, dtx, tfm, vf, afm, pfb, ttf, bst, styles, doc, fonts, bin, or all.
90# If [module] is not given, all is assumed.
91# It installs the files found in the current directory to the standard locations
92# for a TeX installation
17latex-package_src_doinstall() { 93latex-package_src_doinstall() {
18 debug-print function $FUNCNAME $* 94 debug-print function $FUNCNAME $*
19 # This actually follows the directions for a "single-user" system 95 # This actually follows the directions for a "single-user" system
20 # at http://www.ctan.org/installationadvice/ modified for gentoo. 96 # at http://www.ctan.org/installationadvice/ modified for gentoo.
21 [ -z "$1" ] && latex-package_src_install all 97 [ -z "$1" ] && latex-package_src_install all
22 98
23 while [ "$1" ]; do 99 while [ "$1" ]; do
24 case $1 in 100 case $1 in
25 "sh") 101 "sh")
26 for i in `find . -maxdepth 1 -name "*.${1}"` 102 for i in `find . -maxdepth 1 -type f -name "*.${1}"`
27 do 103 do
28 dobin $i 104 dobin $i || die "dobin $i failed"
29 done 105 done
30 ;; 106 ;;
31 "sty" | "cls" | "fd") 107 "sty" | "cls" | "fd" | "clo" | "def" | "cfg")
32 for i in `find . -maxdepth 1 -name "*.${1}"` 108 for i in `find . -maxdepth 1 -type f -name "*.${1}"`
33 do 109 do
34 insinto ${TEXMF}/tex/latex/${PN} 110 insinto ${TEXMF}/tex/latex/${PN}
35 doins $i 111 doins $i || die "doins $i failed"
36 done 112 done
37 ;; 113 ;;
38 "dvi" | "ps" | "pdf" | "tex") 114 "dvi" | "ps" | "pdf")
39 for i in `find . -maxdepth 1 -name "*.${1}"` 115 for i in `find . -maxdepth 1 -type f -name "*.${1}"`
40 do 116 do
41 insinto ${TEXMF}/doc/latex/${PN} 117 insinto /usr/share/doc/${PF}
42 doins $i 118 doins $i || die "doins $i failed"
43 done 119 dosym /usr/share/doc/${PF}/$(basename ${i}) ${TEXMF}/doc/latex/${PN}/${i}
44 ;; 120 #dodoc -u $i
45 "tfm" | "vf" | "afm" | "pfb") 121 done
122 ;;
123 "tex" | "dtx")
46 for i in `find . -maxdepth 1 -name "*.${1}"` 124 for i in `find . -maxdepth 1 -type f -name "*.${1}"`
47 do 125 do
126 einfo "Making documentation: $i"
127 texi2dvi -q -c --language=latex $i &> /dev/null
128 done
129 ;;
130 "tfm" | "vf" | "afm")
131 for i in `find . -maxdepth 1 -type f -name "*.${1}"`
132 do
48 insinto ${TEXMF}/fonts/${1}/${SUPPLIER}/${PN} 133 insinto ${TEXMF}/fonts/${1}/${SUPPLIER}/${PN}
49 doins $i 134 doins $i || die "doins $i failed"
50 done 135 done
51 ;; 136 ;;
52 "ttf") 137 "pfb")
138 for i in `find . -maxdepth 1 -type f -name "*.pfb"`
139 do
140 insinto ${TEXMF}/fonts/type1/${SUPPLIER}/${PN}
141 doins $i || die "doins $i failed"
142 done
143 ;;
144 "ttf")
53 for i in `find . -maxdepth 1 -name "*.ttf"` 145 for i in `find . -maxdepth 1 -type f -name "*.ttf"`
54 do 146 do
55 insinto ${TEXMF}/fonts/truetype/${SUPPLIER}/${PN} 147 insinto ${TEXMF}/fonts/truetype/${SUPPLIER}/${PN}
56 doins $i 148 doins $i || die "doins $i failed"
57 done 149 done
58 ;; 150 ;;
59 "styles") 151 "bst")
60 latex-package_src_doinstall sty cls fd 152 for i in `find . -maxdepth 1 -type f -name "*.bst"`
61 ;; 153 do
62 "doc") 154 insinto ${TEXMF}/bibtex/bst/${PN}
63 latex-package_src_doinstall dvi ps pdf tex 155 doins $i || die "doins $i failed"
64 ;; 156 done
65 "fonts") 157 ;;
158 "styles")
159 latex-package_src_doinstall sty cls fd clo def cfg bst
160 ;;
161 "doc")
162 latex-package_src_doinstall tex dtx dvi ps pdf
163 ;;
164 "fonts")
66 latex-package_src_doinstall tfm vg afm pfb ttf 165 latex-package_src_doinstall tfm vf afm pfb ttf
67 ;; 166 ;;
68 "bin") 167 "bin")
69 latex-package_src_doinstall sh 168 latex-package_src_doinstall sh
70 ;; 169 ;;
71 "all") 170 "all")
72 latex-package_src_doinstall styles doc fonts bin 171 latex-package_src_doinstall styles fonts bin doc
73 ;; 172 ;;
74 esac 173 esac
75 shift 174 shift
76 done 175 done
77} 176}
78 177
178# @FUNCTION: latex-package_src_compile
179# @DESCRIPTION:
180# Calls latex for each *.ins in the current directory in order to generate the
181# relevant files that will be installed
79latex-package_src_compile() { 182latex-package_src_compile() {
80 debug-print function $FUNCNAME $* 183 debug-print function $FUNCNAME $*
81 cd ${S}
82 for i in `find \`pwd\` -maxdepth 1 -name "*.ins"` 184 for i in `find \`pwd\` -maxdepth 1 -type f -name "*.ins"`
83 do 185 do
84 echo "Extracting from $i" 186 einfo "Extracting from $i"
85 latex --interaction=batchmode $i > /dev/null 187 latex --interaction=batchmode $i &> /dev/null
86 done 188 done
87 for i in `find \`pwd\` -maxdepth 1 -name "*.dtx"`
88 do
89 echo "Extracting from $i"
90 latex --interaction=batchmode $i > /dev/null
91 done
92} 189}
93 190
191# @FUNCTION: latex-package_src_install
192# @DESCRIPTION:
193# Installs the package
94latex-package_src_install() { 194latex-package_src_install() {
95 debug-print function $FUNCNAME $* 195 debug-print function $FUNCNAME $*
96 cd ${S}
97 latex-package_src_doinstall all 196 latex-package_src_doinstall all
197 if [ -n "${DOCS}" ] ; then
198 dodoc ${DOCS}
199 fi
98} 200}
99 201
202# @FUNCTION: latex-package_pkg_postinst
203# @DESCRIPTION:
204# Calls latex-package_rehash to ensure the TeX installation is consistent with
205# the kpathsea database
100latex-package_pkg_postinst() { 206latex-package_pkg_postinst() {
101 debug-print function $FUNCNAME $* 207 debug-print function $FUNCNAME $*
102 latex-package_rehash 208 latex-package_rehash
103 if [ ! -e ${TEXMF}/doc/latex/${PN} ] ; then return ; fi
104 cd ${TEXMF}/doc/latex/${PN}
105 latex-package_make_documentation
106} 209}
107 210
211# @FUNCTION: latex-package_pkg_postrm
212# @DESCRIPTION:
213# Calls latex-package_rehash to ensure the TeX installation is consistent with
214# the kpathsea database
108latex-package_pkg_postrm() { 215latex-package_pkg_postrm() {
109 debug-print function $FUNCNAME $* 216 debug-print function $FUNCNAME $*
110 # This may be a bit harsh, so perhaps it should be overridden.
111 latex-package_rehash 217 latex-package_rehash
112 if [ ! -e ${TEXMF}/doc/latex/${PN} ] ; then return ; fi
113 echo "Removing stale documentation: ${TEXMF}/doc/latex/${PN}"
114 rm -rf ${TEXMF}/doc/latex/${PN}
115} 218}
116 219
220# @FUNCTION: latex-package_rehash
221# @DESCRIPTION:
222# Rehashes the kpathsea database, according to the current TeX installation
117latex-package_rehash() { 223latex-package_rehash() {
118 debug-print function $FUNCNAME $* 224 debug-print function $FUNCNAME $*
225 if latex-package_has_tetex_3 ; then
226 texmf-update
227 else
119 texconfig rehash 228 texconfig rehash
120} 229 fi
121
122latex-package_make_documentation() {
123 debug-print function $FUNCNAME $*
124 # This has to come after the installation of all our files.
125 # All errors will be discarded.
126 for i in `find \`pwd\` -maxdepth 1 -name "*.tex"`
127 do
128 # Note - we rerun twice to get references properly.
129 echo "Making Documentation: $i"
130 latex --interaction=batchmode $i > /dev/null
131 done
132 echo "Completed."
133} 230}
134 231
135EXPORT_FUNCTIONS src_compile src_install pkg_postinst pkg_postrm 232EXPORT_FUNCTIONS src_compile src_install pkg_postinst pkg_postrm
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.39
  ViewVC Help
Powered by ViewVC 1.1.13