1 |
aballier 08/02/14 09:02:12 |
2 |
|
3 |
Modified: texlive-common.eclass texlive-module.eclass |
4 |
Log: |
5 |
improve comments of texlive eclasses so that they're ready to get a man page, thanks to mren <bugs@××××××××.net>, bug #210049 |
6 |
|
7 |
Revision Changes Path |
8 |
1.4 eclass/texlive-common.eclass |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?rev=1.4&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?rev=1.4&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?r1=1.3&r2=1.4 |
13 |
|
14 |
Index: texlive-common.eclass |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v |
17 |
retrieving revision 1.3 |
18 |
retrieving revision 1.4 |
19 |
diff -u -r1.3 -r1.4 |
20 |
--- texlive-common.eclass 6 Nov 2007 23:34:43 -0000 1.3 |
21 |
+++ texlive-common.eclass 14 Feb 2008 09:02:11 -0000 1.4 |
22 |
@@ -1,19 +1,26 @@ |
23 |
-# Copyright 1999-2007 Gentoo Foundation |
24 |
+# Copyright 1999-2008 Gentoo Foundation |
25 |
# Distributed under the terms of the GNU General Public License v2 |
26 |
-# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v 1.3 2007/11/06 23:34:43 aballier Exp $ |
27 |
+# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v 1.4 2008/02/14 09:02:11 aballier Exp $ |
28 |
|
29 |
+# @ECLASS: texlive-common.eclass |
30 |
+# @MAINTAINER: |
31 |
+# tex@g.o |
32 |
# |
33 |
# Original Author: Alexis Ballier <aballier@g.o> |
34 |
+# @BLURB: Provide various functions used by both texlive-core and texlive modules |
35 |
+# @DESCRIPTION: |
36 |
# Purpose: Provide various functions used by both texlive-core and texlive |
37 |
# modules. |
38 |
-# Note that this eclass *must* not assume the presence of any standard tex tool |
39 |
# |
40 |
+# Note that this eclass *must* not assume the presence of any standard tex tool |
41 |
|
42 |
|
43 |
TEXMF_PATH=/usr/share/texmf |
44 |
TEXMF_DIST_PATH=/usr/share/texmf-dist |
45 |
TEXMF_VAR_PATH=/var/lib/texmf |
46 |
|
47 |
+# @FUNCTION: texlive-common_handle_config_files |
48 |
+# @DESCRIPTION: |
49 |
# Has to be called in src_install after having installed the files in ${D} |
50 |
# This function will move the relevant files to /etc/texmf and symling them |
51 |
# from their original location. This is to allow easy update of texlive's |
52 |
@@ -32,7 +39,8 @@ |
53 |
done |
54 |
} |
55 |
|
56 |
- |
57 |
+# @FUNCTION: texlive-common_is_file_present_in_texmf |
58 |
+# @DESCRIPTION: |
59 |
# Return if a file is present in the texmf tree |
60 |
# Call it from the directory containing texmf and texmf-dist |
61 |
|
62 |
@@ -43,7 +51,11 @@ |
63 |
[ -f "${mark}" ] |
64 |
} |
65 |
|
66 |
+# @FUNCTION: texlive-common_do_symlinks |
67 |
+# @USAGE: < src > < dest > |
68 |
+# @DESCRIPTION: |
69 |
# Mimic the install_link function of texlinks |
70 |
+# |
71 |
# Should have the same behavior as the one in /usr/bin/texlinks |
72 |
# except that it is under the control of the package manager |
73 |
# Note that $1 corresponds to $src and $2 to $dest in this function |
74 |
@@ -74,7 +86,11 @@ |
75 |
done |
76 |
} |
77 |
|
78 |
+# @FUNCTION: etexlinks |
79 |
+# @USAGE: < file > |
80 |
+# @DESCRIPTION: |
81 |
# Mimic texlinks on a fmtutil format file |
82 |
+# |
83 |
# $1 has to be a fmtutil format file like fmtutil.cnf |
84 |
# etexlinks foo will install the symlinks that texlinks --cnffile foo would have |
85 |
# created. We cannot use texlinks with portage as it is not DESTDIR aware. |
86 |
|
87 |
|
88 |
|
89 |
1.8 eclass/texlive-module.eclass |
90 |
|
91 |
file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?rev=1.8&view=markup |
92 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?rev=1.8&content-type=text/plain |
93 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?r1=1.7&r2=1.8 |
94 |
|
95 |
Index: texlive-module.eclass |
96 |
=================================================================== |
97 |
RCS file: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v |
98 |
retrieving revision 1.7 |
99 |
retrieving revision 1.8 |
100 |
diff -u -r1.7 -r1.8 |
101 |
--- texlive-module.eclass 20 Jan 2008 00:14:45 -0000 1.7 |
102 |
+++ texlive-module.eclass 14 Feb 2008 09:02:11 -0000 1.8 |
103 |
@@ -1,18 +1,30 @@ |
104 |
-# Copyright 1999-2004 Gentoo Foundation |
105 |
+# Copyright 1999-2008 Gentoo Foundation |
106 |
# Distributed under the terms of the GNU General Public License v2 |
107 |
-# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v 1.7 2008/01/20 00:14:45 aballier Exp $ |
108 |
+# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v 1.8 2008/02/14 09:02:11 aballier Exp $ |
109 |
|
110 |
+# @ECLASS: texlive-module.eclass |
111 |
+# @MAINTAINER: |
112 |
+# tex@g.o |
113 |
# |
114 |
# Original Author: Alexis Ballier <aballier@g.o> |
115 |
+# @BLURB: Provide generic install functions so that modular texlive's texmf ebuild will only have to inherit this eclass |
116 |
+# @DESCRIPTION: |
117 |
# Purpose: Provide generic install functions so that modular texlive's texmf ebuilds will |
118 |
# only have to inherit this eclass. |
119 |
# Ebuilds have to provide TEXLIVE_MODULE_CONTENTS variable that contains the list |
120 |
-# of packages that it will install. |
121 |
-# TEXLIVE_MODULE_CONTENTS will be expanded to SRC_URI : |
122 |
-# foo -> texlive-module-foo-${PV}.zip |
123 |
+# of packages that it will install. (See below) |
124 |
+# |
125 |
# What is assumed is that it unpacks texmf and texmf-dist directories to |
126 |
# ${WORKDIR}. |
127 |
# |
128 |
+# It inherits texlive-common |
129 |
+ |
130 |
+# @ECLASS-VARIABLE: TEXLIVE_MODULE_CONTENTS |
131 |
+# @DESCRIPTION: |
132 |
+# The list of packages that will be installed. This variable will be expanded to |
133 |
+# SRC_URI: |
134 |
+# |
135 |
+# foo -> texlive-module-foo-${PV}.zip |
136 |
|
137 |
inherit texlive-common |
138 |
|
139 |
@@ -34,7 +46,9 @@ |
140 |
|
141 |
S="${WORKDIR}" |
142 |
|
143 |
-# src_compile, exported function: |
144 |
+# @FUNCTION: texlive-module_src_compile |
145 |
+# @DESCRIPTION: |
146 |
+# exported function: |
147 |
# Will look for format.foo.cnf and build foo format files using fmtutil |
148 |
# (provided by texlive-core). The compiled format files will be sent to |
149 |
# texmf-var/web2c, like fmtutil defaults to but with some trick to stay in the |
150 |
@@ -77,7 +91,9 @@ |
151 |
done |
152 |
} |
153 |
|
154 |
-# src_install, exported function: |
155 |
+# @FUNCTION: texlive-module_src_install |
156 |
+# @DESCRIPTION: |
157 |
+# exported function: |
158 |
# Install texmf and config files to the system |
159 |
|
160 |
texlive-module_src_install() { |
161 |
@@ -109,7 +125,9 @@ |
162 |
texlive-common_handle_config_files |
163 |
} |
164 |
|
165 |
-# pkg_postinst and pkg_postrm, exported functions: |
166 |
+# @FUNCTION: texlive-module_pkg_postinst |
167 |
+# @DESCRIPTION: |
168 |
+# exported function: |
169 |
# run texmf-update to ensure the tex installation is consistent with the |
170 |
# installed texmf trees. |
171 |
|
172 |
@@ -123,6 +141,12 @@ |
173 |
fi |
174 |
} |
175 |
|
176 |
+# @FUNCTION: texlive-module_pkg_postrm |
177 |
+# @DESCRIPTION: |
178 |
+# exported function: |
179 |
+# run texmf-update to ensure the tex installation is consistent with the |
180 |
+# installed texmf trees. |
181 |
+ |
182 |
texlive-module_pkg_postrm() { |
183 |
if [ "$ROOT" = "/" ] && [ -x /usr/sbin/texmf-update ] ; then |
184 |
/usr/sbin/texmf-update |
185 |
|
186 |
|
187 |
|
188 |
-- |
189 |
gentoo-commits@l.g.o mailing list |