[gentoo-dev] [PATCH] texlive-common.eclass: fix several @USAGE problems

[gentoo-dev] [PATCH] texlive-common.eclass: fix several @USAGE problems

[Ben Kohler]

Signed-off-by: Ben Kohler <bkohler@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 e9a2eee65bd..b36be7a4db3 100644
--- a/eclass/texlive-common.eclass
+++ b/eclass/texlive-common.eclass
@@ -61,7 +61,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
 #
@@ -99,7 +99,7 @@ texlive-common_do_symlinks() {
 }
 
 # @FUNCTION: etexlinks
-# @USAGE: < file >
+# @USAGE: <file>
 # @DESCRIPTION:
 # Mimic texlinks on a fmtutil format file
 #
@@ -117,7 +117,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.
@@ -133,10 +133,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
@@ -151,10 +151,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
-- 
2.23.0