You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gentoo-overlay/eclass
root 34439d1fa9
Sync with portage [Mon Mar 25 20:38:59 MSK 2024].
3 days ago
..
tests Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
Manifest.gz Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
acct-group.eclass Sync with portage [Tue Jun 27 08:19:05 MSK 2023]. 9 months ago
acct-user.eclass Sync with portage [Thu Nov 9 15:40:04 MSK 2023]. 5 months ago
ada.eclass Sync with portage [Thu Mar 14 21:22:22 MSK 2024]. 2 weeks ago
alternatives.eclass Sync with portage [Wed Dec 28 23:55:47 MSK 2022]. 1 year ago
ant-tasks.eclass Sync with portage [Mon Mar 11 21:41:40 MSK 2024]. 2 weeks ago
apache-2.eclass Sync with portage [Thu Jan 4 15:39:09 MSK 2024]. 3 months ago
apache-module.eclass Sync with portage [Mon Oct 9 23:52:30 MSK 2023]. 6 months ago
app-alternatives.eclass Sync with portage [Fri Dec 9 12:14:29 MSK 2022]. 1 year ago
aspell-dict-r1.eclass Sync with portage [Fri Dec 1 14:16:37 MSK 2023]. 4 months ago
autotools.eclass Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
bash-completion-r1.eclass Sync with portage [Sat May 13 23:47:25 MSK 2023]. 11 months ago
bzr.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
cargo.eclass Sync with portage [Sun Feb 4 18:22:53 MSK 2024]. 2 months ago
cdrom.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
check-reqs.eclass Sync with portage [Wed Aug 23 13:42:29 MSK 2023]. 7 months ago
chromium-2.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
cmake-multilib.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
cmake.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
common-lisp-3.eclass Sync with portage [Sat Sep 16 09:30:16 MSK 2023]. 6 months ago
cron.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
crossdev.eclass Sync with portage [Wed Aug 23 13:42:29 MSK 2023]. 7 months ago
cuda.eclass Sync with portage [Sat Nov 11 20:34:50 MSK 2023]. 5 months ago
cvs.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
db-use.eclass Sync with portage [Sun Dec 18 17:37:36 MSK 2022]. 1 year ago
db.eclass Sync with portage [Tue Mar 21 08:28:10 MSK 2023]. 1 year ago
depend.apache.eclass Sync with portage [Mon Oct 9 23:52:30 MSK 2023]. 6 months ago
desktop.eclass Sync with portage [Fri Feb 24 18:44:55 MSK 2023]. 1 year ago
dist-kernel-utils.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
distutils-r1.eclass Sync with portage [Tue Mar 12 14:50:44 MSK 2024]. 2 weeks ago
docs.eclass Sync with portage [Sat Jan 13 21:41:53 MSK 2024]. 2 months ago
dotnet-pkg-base.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
dotnet-pkg.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
dotnet.eclass Sync with portage [Thu Jan 5 16:30:30 MSK 2023]. 1 year ago
dune.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
eapi7-ver.eclass Sync with portage [Tue Jun 29 07:30:37 MSK 2021]. 3 years ago
eapi8-dosym.eclass Sync with portage [Thu Jun 8 13:58:35 MSK 2023]. 10 months ago
ecm.eclass Sync with portage [Sat Jan 13 21:41:53 MSK 2024]. 2 months ago
edo.eclass Sync with portage [Tue Apr 19 15:42:32 MSK 2022]. 2 years ago
edos2unix.eclass Sync with portage [Mon Sep 14 01:19:38 MSK 2020]. 4 years ago
elisp-common.eclass Sync with portage [Tue Oct 24 09:30:38 MSK 2023]. 5 months ago
elisp.eclass Sync with portage [Mon Jul 17 08:39:53 MSK 2023]. 9 months ago
emboss-r3.eclass Sync with portage [Thu Mar 24 17:02:53 MSK 2022]. 2 years ago
epatch.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
eqawarn.eclass Sync with portage [Tue Jul 26 17:40:47 MSK 2022]. 2 years ago
estack.eclass Sync with portage [Fri Jun 16 15:37:21 MSK 2023]. 10 months ago
eutils.eclass Sync with portage [Wed Aug 30 09:11:46 MSK 2023]. 7 months ago
fcaps.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
findlib.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
fixheadtails.eclass Sync with portage [Wed Mar 31 11:32:33 MSK 2021]. 3 years ago
flag-o-matic.eclass Sync with portage [Wed Feb 14 09:35:11 MSK 2024]. 1 month ago
font-ebdftopcf.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
font.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
fortran-2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
frameworks.kde.org.eclass Sync with portage [Fri Mar 1 23:27:10 MSK 2024]. 4 weeks ago
freedict.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
gap-pkg.eclass Sync with portage [Wed Jan 24 22:01:18 MSK 2024]. 2 months ago
gear.kde.org.eclass Sync with portage [Tue Mar 5 12:34:46 MSK 2024]. 3 weeks ago
ghc-package.eclass Sync with portage [Mon Dec 11 22:08:42 MSK 2023]. 4 months ago
git-r3.eclass Sync with portage [Wed Dec 20 21:32:11 MSK 2023]. 3 months ago
gkrellm-plugin.eclass Sync with portage [Tue Feb 14 22:27:18 MSK 2023]. 1 year ago
gnome.org.eclass Sync with portage [Thu Apr 6 09:02:24 MSK 2023]. 12 months ago
gnome2-utils.eclass Sync with portage [Wed Feb 7 12:58:43 MSK 2024]. 2 months ago
gnome2.eclass Sync with portage [Wed Feb 7 12:58:43 MSK 2024]. 2 months ago
gnuconfig.eclass Sync with portage [Sun Apr 17 23:47:25 MSK 2022]. 2 years ago
gnustep-2.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
gnustep-base.eclass Sync with portage [Mon Jun 26 11:56:29 MSK 2023]. 9 months ago
go-env.eclass Sync with portage [Sun Mar 17 23:38:13 MSK 2024]. 2 weeks ago
go-module.eclass Sync with portage [Wed Feb 28 13:47:39 MSK 2024]. 4 weeks ago
golang-base.eclass Sync with portage [Thu Mar 24 17:02:53 MSK 2022]. 2 years ago
golang-build.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
golang-vcs-snapshot.eclass Sync with portage [Wed Nov 22 18:45:23 MSK 2023]. 4 months ago
golang-vcs.eclass Sync with portage [Wed Nov 22 18:45:23 MSK 2023]. 4 months ago
gstreamer-meson.eclass Sync with portage [Tue Jun 13 12:21:29 MSK 2023]. 10 months ago
haskell-cabal.eclass Sync with portage [Mon Dec 11 22:08:42 MSK 2023]. 4 months ago
java-ant-2.eclass Sync with portage [Mon Mar 11 21:41:40 MSK 2024]. 2 weeks ago
java-osgi.eclass Sync with portage [Wed Dec 28 23:55:47 MSK 2022]. 1 year ago
java-pkg-2.eclass Sync with portage [Mon Dec 11 22:08:42 MSK 2023]. 4 months ago
java-pkg-opt-2.eclass Sync with portage [Mon Dec 11 22:08:42 MSK 2023]. 4 months ago
java-pkg-simple.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
java-utils-2.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
java-vm-2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
kde.org.eclass Sync with portage [Sun Dec 17 22:09:30 MSK 2023]. 3 months ago
kernel-2.eclass Sync with portage [Sun Feb 4 18:22:53 MSK 2024]. 2 months ago
kernel-build.eclass Sync with portage [Mon Feb 12 13:46:21 MSK 2024]. 2 months ago
kernel-install.eclass Sync with portage [Mon Feb 12 13:46:21 MSK 2024]. 2 months ago
kodi-addon.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
latex-package.eclass Sync with portage [Fri Apr 15 13:06:33 MSK 2022]. 2 years ago
libretro-core.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
libtool.eclass Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
linux-info.eclass Sync with portage [Tue Mar 12 14:50:44 MSK 2024]. 2 weeks ago
linux-mod-r1.eclass Sync with portage [Wed Jan 31 09:13:22 MSK 2024]. 2 months ago
linux-mod.eclass Sync with portage [Mon Jan 1 15:21:29 MSK 2024]. 3 months ago
llvm-r1.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
llvm-utils.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
llvm.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
llvm.org.eclass Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
ltprune.eclass Sync with portage [Tue May 3 16:51:13 MSK 2022]. 2 years ago
lua-single.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
lua-utils.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
lua.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
mate-desktop.org.eclass Sync with portage [Sat Aug 19 12:18:39 MSK 2023]. 7 months ago
mate.eclass Sync with portage [Sat Aug 19 12:18:39 MSK 2023]. 7 months ago
mercurial.eclass Sync with portage [Sun Jun 18 19:27:49 MSK 2023]. 9 months ago
meson-multilib.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
meson.eclass Sync with portage [Sun Mar 17 23:38:13 MSK 2024]. 2 weeks ago
mono-env.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
mono.eclass Sync with portage [Thu Jan 5 16:30:30 MSK 2023]. 1 year ago
mount-boot.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
mozcoreconf-v6.eclass Sync with portage [Mon Sep 11 00:11:34 MSK 2023]. 7 months ago
mozextension.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
mozlinguas-v2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
multibuild.eclass Sync with portage [Sun Nov 26 00:49:03 MSK 2023]. 4 months ago
multilib-build.eclass Sync with portage [Sun Jan 8 00:37:49 MSK 2023]. 1 year ago
multilib-minimal.eclass Sync with portage [Mon Jan 17 21:18:20 MSK 2022]. 2 years ago
multilib.eclass Sync with portage [Wed May 31 01:16:14 MSK 2023]. 10 months ago
multiprocessing.eclass Sync with portage [Mon Oct 9 23:52:30 MSK 2023]. 6 months ago
myspell-r2.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
netsurf.eclass Sync with portage [Tue Aug 15 21:55:20 MSK 2023]. 8 months ago
ninja-utils.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
nuget.eclass Sync with portage [Sat Feb 10 20:47:10 MSK 2024]. 2 months ago
office-ext-r1.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
opam.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
optfeature.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
out-of-source-utils.eclass Sync with portage [Sun Jan 8 00:37:49 MSK 2023]. 1 year ago
out-of-source.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
pam.eclass Sync with portage [Wed Aug 2 18:05:06 MSK 2023]. 8 months ago
pax-utils.eclass Sync with portage [Thu Mar 24 17:02:53 MSK 2022]. 2 years ago
perl-functions.eclass Sync with portage [Tue Jul 19 10:24:06 MSK 2022]. 2 years ago
perl-module.eclass Sync with portage [Mon Oct 16 13:56:03 MSK 2023]. 5 months ago
php-ext-pecl-r3.eclass Sync with portage [Wed Dec 28 23:55:47 MSK 2022]. 1 year ago
php-ext-source-r3.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
php-pear-r2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
plasma-mobile.kde.org.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
plasma.kde.org.eclass Sync with portage [Fri Mar 1 23:27:10 MSK 2024]. 4 weeks ago
plocale.eclass Sync with portage [Mon Dec 26 07:10:10 MSK 2022]. 1 year ago
portability.eclass Sync with portage [Sat Jan 13 21:41:53 MSK 2024]. 2 months ago
postgres-multi.eclass Sync with portage [Wed Dec 28 23:55:47 MSK 2022]. 1 year ago
postgres.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
prefix.eclass Sync with portage [Thu Mar 24 17:02:53 MSK 2022]. 2 years ago
preserve-libs.eclass Sync with portage [Fri Apr 7 21:05:03 MSK 2023]. 12 months ago
pypi.eclass Sync with portage [Mon Jul 17 16:00:00 MSK 2023]. 9 months ago
python-any-r1.eclass Sync with portage [Mon Aug 21 10:00:46 MSK 2023]. 7 months ago
python-r1.eclass Sync with portage [Mon Aug 21 10:00:46 MSK 2023]. 7 months ago
python-single-r1.eclass Sync with portage [Wed Dec 28 23:55:47 MSK 2022]. 1 year ago
python-utils-r1.eclass Sync with portage [Mon Mar 11 21:41:40 MSK 2024]. 2 weeks ago
qmail.eclass Sync with portage [Thu Apr 6 09:02:24 MSK 2023]. 12 months ago
qmake-utils.eclass Sync with portage [Thu Jun 15 00:28:13 MSK 2023]. 10 months ago
qt5-build.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
qt6-build.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
readme.gentoo-r1.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
rebar.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
rocm.eclass Sync with portage [Fri Dec 15 00:28:44 MSK 2023]. 3 months ago
rpm.eclass Sync with portage [Mon Dec 11 22:08:42 MSK 2023]. 4 months ago
ruby-fakegem.eclass Sync with portage [Mon Aug 14 14:41:39 MSK 2023]. 8 months ago
ruby-ng-gnome2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
ruby-ng.eclass Sync with portage [Sun Sep 24 14:52:41 MSK 2023]. 6 months ago
ruby-single.eclass Sync with portage [Sun Jun 18 19:27:49 MSK 2023]. 9 months ago
ruby-utils.eclass Sync with portage [Tue Dec 26 14:36:55 MSK 2023]. 3 months ago
rust-toolchain.eclass Sync with portage [Mon Aug 28 12:59:52 MSK 2023]. 7 months ago
s6.eclass Sync with portage [Thu Jan 5 16:30:30 MSK 2023]. 1 year ago
savedconfig.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
scons-utils.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago
secureboot.eclass Sync with portage [Mon Aug 28 12:59:52 MSK 2023]. 7 months ago
selinux-policy-2.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
sgml-catalog-r1.eclass Sync with portage [Thu Apr 6 09:02:24 MSK 2023]. 12 months ago
shell-completion.eclass Sync with portage [Wed Aug 2 18:05:06 MSK 2023]. 8 months ago
ssl-cert.eclass Sync with portage [Mon Jan 1 15:21:29 MSK 2024]. 3 months ago
stardict.eclass Sync with portage [Wed May 17 14:58:23 MSK 2023]. 11 months ago
strip-linguas.eclass Sync with portage [Sun Jun 27 23:20:26 MSK 2021]. 3 years ago
subversion.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
systemd.eclass Sync with portage [Tue Oct 3 01:01:04 MSK 2023]. 6 months ago
texlive-common.eclass Sync with portage [Thu Mar 21 13:37:48 MSK 2024]. 1 week ago
texlive-module.eclass Sync with portage [Fri Mar 1 23:27:10 MSK 2024]. 4 weeks ago
tmpfiles.eclass Sync with portage [Sun Mar 27 00:04:59 MSK 2022]. 2 years ago
toolchain-autoconf.eclass Sync with portage [Wed Jan 24 22:01:18 MSK 2024]. 2 months ago
toolchain-funcs.eclass Sync with portage [Thu Dec 28 09:14:30 MSK 2023]. 3 months ago
toolchain.eclass Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
tree-sitter-grammar.eclass Sync with portage [Mon Mar 25 20:38:59 MSK 2024]. 3 days ago
udev.eclass Sync with portage [Wed Sep 14 23:50:53 MSK 2022]. 2 years ago
unpacker.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
user-info.eclass Sync with portage [Mon Jul 10 09:26:34 MSK 2023]. 9 months ago
usr-ldscript.eclass Sync with portage [Tue Jun 13 12:21:29 MSK 2023]. 10 months ago
vala.eclass Sync with portage [Wed Dec 6 16:13:06 MSK 2023]. 4 months ago
vcs-clean.eclass Sync with portage [Wed Feb 2 14:00:10 MSK 2022]. 2 years ago
vcs-snapshot.eclass Sync with portage [Tue Jul 26 17:40:47 MSK 2022]. 2 years ago
vdr-plugin-2.eclass Sync with portage [Tue Mar 5 12:34:46 MSK 2024]. 3 weeks ago
verify-sig.eclass Sync with portage [Thu Jan 11 09:08:42 MSK 2024]. 3 months ago
versionator.eclass Sync with portage [Sun Nov 8 12:37:53 MSK 2020]. 3 years ago
vim-doc.eclass Sync with portage [Tue May 31 09:39:41 MSK 2022]. 2 years ago
vim-plugin.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
vim-spell.eclass Sync with portage [Wed Aug 9 08:41:04 MSK 2023]. 8 months ago
virtualx.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
waf-utils.eclass Sync with portage [Fri May 19 17:18:43 MSK 2023]. 10 months ago
webapp.eclass Sync with portage [Wed Oct 18 18:13:25 MSK 2023]. 5 months ago
wrapper.eclass Sync with portage [Sun Apr 3 01:46:14 MSK 2022]. 2 years ago
wxwidgets.eclass Sync with portage [Sat Jan 21 23:01:17 MSK 2023]. 1 year ago
xdg-utils.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
xdg.eclass Sync with portage [Sat Mar 18 09:45:58 MSK 2023]. 1 year ago
xemacs-packages.eclass Sync with portage [Sun Mar 26 20:19:26 MSK 2023]. 1 year ago
xorg-3.eclass Sync with portage [Sun Jan 21 16:11:41 MSK 2024]. 2 months ago

readme.gentoo-r1.eclass

# Copyright 1999-2023 Gentoo Authors

# Distributed under the terms of the GNU General Public License v2

# @ECLASS: readme.gentoo-r1.eclass
# @MAINTAINER:
# Pacho Ramos <pacho@gentoo.org>
# @AUTHOR:
# Author: Pacho Ramos <pacho@gentoo.org>
# @SUPPORTED_EAPIS: 6 7 8
# @BLURB: install a doc file shown via elog messages
# @DESCRIPTION:
# An eclass for installing a README.gentoo doc file recording tips
# shown via elog messages. With this eclass, those elog messages will only be
# shown at first package installation and a file for later reviewing will be
# installed under /usr/share/doc/${PF}
#
# You need to call readme.gentoo_create_doc in src_install phase and
# readme.gentoo_print_elog in pkg_postinst

if [[ -z ${_README_GENTOO_ECLASS} ]]; then
_README_GENTOO_ECLASS=1

case ${EAPI} in
6|7|8) ;;
*) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;;
esac

# @ECLASS_VARIABLE: DOC_CONTENTS
# @DEFAULT_UNSET
# @DESCRIPTION:
# The information that is used to create the README.gentoo file.

# @ECLASS_VARIABLE: DISABLE_AUTOFORMATTING
# @DEFAULT_UNSET
# @DESCRIPTION:
# If non-empty, DOC_CONTENTS information will be strictly respected,
# not getting it automatically formatted by fmt. If empty, it will
# rely on fmt for formatting and 'echo -e' options to tweak lines a bit.

# @ECLASS_VARIABLE: FORCE_PRINT_ELOG
# @DEFAULT_UNSET
# @DESCRIPTION:
# If non-empty this variable forces elog messages to be printed.

# @ECLASS_VARIABLE: README_GENTOO_SUFFIX
# @DESCRIPTION:
# If you want to specify a suffix for README.gentoo file please export it.
: "${README_GENTOO_SUFFIX:=""}"

# @FUNCTION: readme.gentoo_create_doc
# @DESCRIPTION:
# Create doc file with ${DOC_CONTENTS} variable (preferred) and, if not set,
# look for "${FILESDIR}/README.gentoo" contents. You can use
# ${FILESDIR}/README.gentoo-${SLOT} also.
# Usually called at src_install phase.
readme.gentoo_create_doc() {
debug-print-function ${FUNCNAME} "${@}"

if [[ -n "${DOC_CONTENTS}" ]]; then
if [[ -n "${DISABLE_AUTOFORMATTING}" ]]; then
echo "${DOC_CONTENTS}" > "${T}"/README.gentoo || die
else
local saved_flags=$-
set -f # disable filename expansion in echo arguments
echo -e ${DOC_CONTENTS} | fold -s -w 70 \
| sed 's/[[:space:]]*$//' > "${T}"/README.gentoo
assert
set +f -${saved_flags}
fi
elif [[ -f "${FILESDIR}/README.gentoo-${SLOT%/*}" ]]; then
cp "${FILESDIR}/README.gentoo-${SLOT%/*}" "${T}"/README.gentoo || die
elif [[ -f "${FILESDIR}/README.gentoo${README_GENTOO_SUFFIX}" ]]; then
cp "${FILESDIR}/README.gentoo${README_GENTOO_SUFFIX}" "${T}"/README.gentoo || die
else
die "You are not specifying README.gentoo contents!"
fi

( # subshell to avoid pollution of calling environment
docinto .
dodoc "${T}"/README.gentoo
) || die
README_GENTOO_DOC_VALUE=$(< "${T}/README.gentoo")
}

# @FUNCTION: readme.gentoo_print_elog
# @DESCRIPTION:
# Print elog messages with "${T}"/README.gentoo contents. They will be
# shown only when package is installed at first time.
# Usually called at pkg_postinst phase.
#
# If you want to show them always, please set FORCE_PRINT_ELOG to a non empty
# value in your ebuild before this function is called.
# This can be useful when, for example, DOC_CONTENTS is modified, then, you can
# rely on specific REPLACING_VERSIONS handling in your ebuild to print messages
# when people update from versions still providing old message.
readme.gentoo_print_elog() {
debug-print-function ${FUNCNAME} "${@}"

if [[ -z "${README_GENTOO_DOC_VALUE}" ]]; then
die "readme.gentoo_print_elog invoked without matching readme.gentoo_create_doc call!"
elif ! [[ -n "${REPLACING_VERSIONS}" ]] || [[ -n "${FORCE_PRINT_ELOG}" ]]; then
echo -e "${README_GENTOO_DOC_VALUE}" | while read -r ELINE; do elog "${ELINE}"; done
elog ""
elog "(Note: Above message is only printed the first time package is"
elog "installed. Please look at ${EPREFIX}/usr/share/doc/${PF}/README.gentoo*"
elog "for future reference)"
fi
}

fi