El mié, 21-08-2013 a las 11:52 +0200, Michał Górny escribió: > Dnia 2013-08-20, o godz. 13:01:34 > Michał Górny <mgo...@gentoo.org> napisał(a): > > > Hello, > > > > Due to the widespread breakage in the tree noted in bug #480892 [1], > > and mis-design of multilib-minimal.eclass, we'd like to put some more > > work into getting einstalldocs() ready for EAPI 6. > > > > When it's mostly defined, we'd like to backport it to eutils.eclass so > > that we could use it to fix the existing breakages. But for that, we'd > > really prefer if we had a final spec for it so that the EAPI switch > > could be as simple as disabling the function in eutils. > > > > Therefore, I'd like to open a final discussion for the features set > > that is intended to be included in it, and it's name. > > > > [1]:https://bugs.gentoo.org/show_bug.cgi?id=480892 > > Proposed implementation follows: > > einstalldocs() { > if ! declare -p DOCS &>/dev/null ; then > local d > for d in README* ChangeLog AUTHORS NEWS TODO CHANGES \ > THANKS BUGS FAQ CREDITS CHANGELOG ; do > [[ -s "${d}" ]] && dodoc "${d}" > done > elif [[ $(declare -p DOCS) == "declare -a "* ]] ; then > [[ ${DOCS[@]} ]] && dodoc -r "${DOCS[@]}" > else > [[ ${DOCS} ]] && dodoc -r ${DOCS} > fi > > if [[ $(declare -p HTML_DOCS) == "declare -a "* ]] ; then > dohtml -r "${HTML_DOCS[@]}" > elif [[ ${HTML_DOCS} ]]; then > dohtml -r ${HTML_DOCS} > fi > } > > It's based on EAPI 4 src_install(). I've added support for DOCS=() > and DOCS='', HTML_DOCS, and made dodoc recursive per Pinkbyte's > request. In this form, it's suitable replacement for what's > in autotools-utils & distutils-r1. > > It should be noted that if we're to backport it to all old EAPIs, > 'dodoc -r' needs te be conditional to EAPI 4+. >
Could appending to DOCS be allowed? I have seen a lot of time of me needing to install all docs "manually" only to add a doc file over default DOCS. Would be interesting to simply do: DOCS+=( otherfile ) instead of needing to specify all files handled by the install function Thanks a lot