[gentoo-commits] gentoo-x86 commit in eclass: texlive-common.eclass texlive-module.eclass

[Alexis Ballier (aballier)]

aballier    08/02/14 09:02:12

  Modified:             texlive-common.eclass texlive-module.eclass
  Log:
  improve comments of texlive eclasses so that they're ready to get a man page, thanks to mren <bugs@××××××××.net>, bug #210049

Revision  Changes    Path
1.4                  eclass/texlive-common.eclass

file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-common.eclass?r1=1.3&r2=1.4

Index: texlive-common.eclass
===================================================================
RCS file: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- texlive-common.eclass	6 Nov 2007 23:34:43 -0000	1.3
+++ texlive-common.eclass	14 Feb 2008 09:02:11 -0000	1.4
@@ -1,19 +1,26 @@
-# Copyright 1999-2007 Gentoo Foundation
+# Copyright 1999-2008 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v 1.3 2007/11/06 23:34:43 aballier Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-common.eclass,v 1.4 2008/02/14 09:02:11 aballier Exp $
 
+# @ECLASS: texlive-common.eclass
+# @MAINTAINER:
+# tex@g.o
 #
 # Original Author: Alexis Ballier <aballier@g.o>
+# @BLURB: Provide various functions used by both texlive-core and texlive modules
+# @DESCRIPTION:
 # Purpose: Provide various functions used by both texlive-core and texlive
 # modules.
-# Note that this eclass *must* not assume the presence of any standard tex tool
 #
+# Note that this eclass *must* not assume the presence of any standard tex tool
 
 
 TEXMF_PATH=/usr/share/texmf
 TEXMF_DIST_PATH=/usr/share/texmf-dist
 TEXMF_VAR_PATH=/var/lib/texmf
 
+# @FUNCTION: texlive-common_handle_config_files
+# @DESCRIPTION:
 # Has to be called in src_install after having installed the files in ${D}
 # This function will move the relevant files to /etc/texmf and symling them
 # from their original location. This is to allow easy update of texlive's
@@ -32,7 +39,8 @@
 	done
 }
 
-
+# @FUNCTION: texlive-common_is_file_present_in_texmf
+# @DESCRIPTION:
 # Return if a file is present in the texmf tree
 # Call it from the directory containing texmf and texmf-dist
 
@@ -43,7 +51,11 @@
 	[ -f "${mark}" ]
 }
 
+# @FUNCTION: texlive-common_do_symlinks
+# @USAGE: < src > < dest >
+# @DESCRIPTION:
 # Mimic the install_link function of texlinks
+#
 # Should have the same behavior as the one in /usr/bin/texlinks
 # except that it is under the control of the package manager
 # Note that $1 corresponds to $src and $2 to $dest in this function
@@ -74,7 +86,11 @@
 	done
 }
 
+# @FUNCTION: etexlinks
+# @USAGE: < file > 
+# @DESCRIPTION:
 # Mimic texlinks on a fmtutil format file
+#
 # $1 has to be a fmtutil format file like fmtutil.cnf
 # etexlinks foo will install the symlinks that texlinks --cnffile foo would have
 # created. We cannot use texlinks with portage as it is not DESTDIR aware.



1.8                  eclass/texlive-module.eclass

file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?rev=1.8&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?rev=1.8&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo-x86/eclass/texlive-module.eclass?r1=1.7&r2=1.8

Index: texlive-module.eclass
===================================================================
RCS file: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- texlive-module.eclass	20 Jan 2008 00:14:45 -0000	1.7
+++ texlive-module.eclass	14 Feb 2008 09:02:11 -0000	1.8
@@ -1,18 +1,30 @@
-# Copyright 1999-2004 Gentoo Foundation
+# Copyright 1999-2008 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v 1.7 2008/01/20 00:14:45 aballier Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/texlive-module.eclass,v 1.8 2008/02/14 09:02:11 aballier Exp $
 
+# @ECLASS: texlive-module.eclass
+# @MAINTAINER:
+# tex@g.o
 #
 # Original Author: Alexis Ballier <aballier@g.o>
+# @BLURB: 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.
-# TEXLIVE_MODULE_CONTENTS will be expanded to SRC_URI : 
-#	foo -> texlive-module-foo-${PV}.zip
+# of packages that it will install. (See below)
+#
 # What is assumed is that it unpacks texmf and texmf-dist directories to
 # ${WORKDIR}.
 #
+# It inherits texlive-common
+
+# @ECLASS-VARIABLE: TEXLIVE_MODULE_CONTENTS
+# @DESCRIPTION:
+# The list of packages that will be installed. This variable will be expanded to
+# SRC_URI:
+#
+# foo -> texlive-module-foo-${PV}.zip
 
 inherit texlive-common
 
@@ -34,7 +46,9 @@
 
 S="${WORKDIR}"
 
-# src_compile, exported function:
+# @FUNCTION: texlive-module_src_compile
+# @DESCRIPTION:
+# exported function:
 # Will look for format.foo.cnf and build foo 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
@@ -77,7 +91,9 @@
 	done
 }
 
-# src_install, exported function:
+# @FUNCTION: texlive-module_src_install
+# @DESCRIPTION:
+# exported function:
 # Install texmf and config files to the system
 
 texlive-module_src_install() {
@@ -109,7 +125,9 @@
 	texlive-common_handle_config_files
 }
 
-# pkg_postinst and pkg_postrm, exported functions:
+# @FUNCTION: texlive-module_pkg_postinst
+# @DESCRIPTION:
+# exported function:
 # run texmf-update to ensure the tex installation is consistent with the
 # installed texmf trees.
 
@@ -123,6 +141,12 @@
 	fi
 }
 
+# @FUNCTION: texlive-module_pkg_postrm
+# @DESCRIPTION:
+# exported function:
+# run texmf-update to ensure the tex installation is consistent with the
+# installed texmf trees.
+
 texlive-module_pkg_postrm() {
 	if [ "$ROOT" = "/" ] && [ -x /usr/sbin/texmf-update ] ; then
 		/usr/sbin/texmf-update



-- 
gentoo-commits@l.g.o mailing list