[rfc] developer documentation on user interaction

[Martin Pool]

2009/9/25 Vincent Ladeuil <v.ladeuil+lp at free.fr>:
>    martin> It's not very consistently used and that to me
>    martin> indicates it's probably not the right interface.
>
> Hmm, to be honest, I think it's caused by the feature not being
> implemented properly.
>
> I seem to recall that you could very easily end up with command
> objects where outf is not set for example.

I haven't seen that particular thing, but I can believe it.  I have
seen things where it's not present in the place you want to use it.

Some British politician -- I can't remember who, and it's irrelevant
--  promised to be "tough on crime, and tough on the causes of crime"
and I think one ought to look similarly at APIs that seem to be
inconsistently used or inconsistently implemented.

To me, the function of "I need to talk to the user" or "I need to
produce bulk redirectable output" is only weakly related to being
invoked through the commandline interface, so it doesn't really belong
there.

-- 
Martin <http://launchpad.net/~mbp/>