[gentoo-pms] [PATCH] dohtml without -r may or may not error on a dir

[gentoo-pms] [PATCH] dohtml without -r may or may not error on a dir

[Ciaran McCreesh]

Different Portage versions do different things.
---
 pkg-mgr-commands.tex |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index ff2b9a6..4b88b20 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -322,6 +322,9 @@ that can be passed to \t{dohtml} are as follows:
 
     Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.
 
+    It is undefined whether a failure shall occur if \t{-r} is not specified and a directory is
+    encountered. Ebuilds must not rely upon any particular behaviour.
+
 \IFKDEBUILDELSE
 {
     In EAPIs listed in table~\ref{tab:banned-commands-table}, this command is banned as
-- 
1.6.5.rc1

Re: [gentoo-pms] [PATCH] dohtml without -r may or may not error on a dir

[Christian Faulhammer]

[-- Attachment #1: Type: text/plain, Size: 333 bytes --]

Hi,

Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:

> Different Portage versions do different things.

 What does different mean?  Pre-PMS versus Post-PMS?

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-pms] [PATCH] dohtml without -r may or may not error on a dir

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 1277 bytes --]

On Tue, 3 Nov 2009 19:34:37 +0100
Christian Faulhammer <fauli@gentoo.org> wrote:
> Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:
> 
> > Different Portage versions do different things.
> 
>  What does different mean?  Pre-PMS versus Post-PMS?

No, considerably after then.

When we wrote PMS (and copied dohtml for Paludis), it would silently
return non-zero.

r9479 (Tue Mar 18 22:12:52 2008 UTC) changed this to noisily return
non-zero.

r9484 (Wed Mar 19 09:45:51 2008 UTC) changed this to noisily return
non-zero, but only if nothing at all was installed, and to return zero
if a directory was skipped but other things were installed.

r14760 (Sat Oct 31 20:53:43 2009 UTC) changed this back to the original
behaviour, but made it warn noisily too.

r14762 (Sat Oct 31 22:59:35 2009 UTC) changed this back to return zero
if directories were skipped.

Note that this is an issue because recent Doxygen versions appear to
have changed defaults and will tend to generate subdirectories. Thus,
any package that currently does dohtml doxygen/html/ || die will, with
Portage, do one of:

* die with no explanation
* die with an explanation
* install broken links with no warning
* install broken links with a warning

-- 
Ciaran McCreesh

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]