Currently, when people uses DOC_CONTENTS variable to place their desired messages, they are automatically reformatted by "fmt" to get proper messages (for example, splitting long lines).
But, in some cases, may be useful to disable this behavior and respect strictly how DOC_CONTENTS was formatted, for example in that kind of messages telling people to run a command and, then, requiring a new line to be used. This can also be useful to append extra information to DOC_CONTENTS when, for example, additional info is needed when enabling a USE flag.
--- /home/pacho/gentoo-x86/eclass/readme.gentoo.eclass 2013-01-24 22:38:41.000000000 +0100
+++ ./readme.gentoo.eclass 2013-01-27 14:51:58.000000000 +0100
@@ -36,6 +36,12 @@
EXPORT_FUNCTIONS src_install pkg_postinst
+# @ECLASS-VARIABLE: DISABLE_AUTOFORMATTING
+# @DEFAULT_UNSET
+# @DESCRIPTION:
+# If non-empty, DOC_CONTENTS information will be strictly respected,
+# not getting it automatically formatted by fmt.
+
# @ECLASS-VARIABLE: FORCE_PRINT_ELOG
# @DEFAULT_UNSET
# @DESCRIPTION:
@@ -53,7 +59,11 @@
if [[ -n "${DOC_CONTENTS}" ]]; then
eshopts_push
set -f
- echo ${DOC_CONTENTS} | fmt > "${T}"/README.gentoo
+ if [[ -n "${DISABLE_AUTOFORMATTING}" ]]; then
+ echo "${DOC_CONTENTS}" > "${T}"/README.gentoo
+ else
+ echo ${DOC_CONTENTS} | fmt > "${T}"/README.gentoo
+ fi
eshopts_pop
dodoc "${T}"/README.gentoo
else
signature.asc
Description: This is a digitally signed message part
