[gentoo-commits] repo/gentoo:master commit in: eclass/

[Ben Kohler]

commit:     7ca2939ca7e8310b3223c93660ab99c779dcc583
Author:     Ben Kohler <bkohler <AT> gentoo <DOT> org>
AuthorDate: Fri Sep  6 17:08:03 2019 +0000
Commit:     Ben Kohler <bkohler <AT> gentoo <DOT> org>
CommitDate: Tue Mar 31 14:57:03 2020 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=7ca2939c

texlive-common.eclass: fix several @USAGE problems

Signed-off-by: Ben Kohler <bkohler <AT> gentoo.org>

 eclass/texlive-common.eclass | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/eclass/texlive-common.eclass b/eclass/texlive-common.eclass
index 2618cba2e1a..2072d3ad160 100644
--- a/eclass/texlive-common.eclass
+++ b/eclass/texlive-common.eclass
@@ -67,7 +67,7 @@ texlive-common_is_file_present_in_texmf() {
 }
 
 # @FUNCTION: texlive-common_do_symlinks
-# @USAGE: < src > < dest >
+# @USAGE: <src> <dest>
 # @DESCRIPTION:
 # Mimic the install_link function of texlinks
 #
@@ -103,7 +103,7 @@ texlive-common_do_symlinks() {
 }
 
 # @FUNCTION: etexlinks
-# @USAGE: < file >
+# @USAGE: <file>
 # @DESCRIPTION:
 # Mimic texlinks on a fmtutil format file
 #
@@ -121,7 +121,7 @@ etexlinks() {
 }
 
 # @FUNCTION: dobin_texmf_scripts
-# @USAGE: < file1 file2 ... >
+# @USAGE: <file1> [file2] ...
 # @DESCRIPTION:
 # Symlinks a script from the texmf tree to /usr/bin. Requires permissions to be
 # correctly set for the file that it will point to.
@@ -137,10 +137,10 @@ dobin_texmf_scripts() {
 }
 
 # @FUNCTION: etexmf-update
-# @USAGE: In ebuilds' pkg_postinst and pkg_postrm phases
 # @DESCRIPTION:
 # Runs texmf-update if it is available and prints a warning otherwise. This
-# function helps in factorizing some code.
+# function helps in factorizing some code.  Useful in ebuilds' pkg_postinst and
+# pkg_postrm phases.
 
 etexmf-update() {
 	if has_version 'app-text/texlive-core' ; then
@@ -155,10 +155,10 @@ etexmf-update() {
 }
 
 # @FUNCTION: efmtutil-sys
-# @USAGE: In ebuilds' pkg_postinst to force a rebuild of TeX formats.
 # @DESCRIPTION:
 # Runs fmtutil-sys if it is available and prints a warning otherwise. This
-# function helps in factorizing some code.
+# function helps in factorizing some code. Used in ebuilds' pkg_postinst to
+# force a rebuild of TeX formats.
 
 efmtutil-sys() {
 	if has_version 'app-text/texlive-core' ; then