On Fri, Dec 5, 2008 at 4:13 PM, Eric Kow <[EMAIL PROTECTED]> wrote:
> On Fri, Dec 05, 2008 at 15:07:06 +0100, Josef Svenningsson wrote:
>> Hiding information is a very poor (but sadly rather common) way to try
>> to improve user interfaces. If we decide that put is not sufficiently
>> important (despite my screaming and kicking) I think it should be
>> removed altogether. Having a class of secret, half-hidden commands is
>> only going to confuse users in the end.
>
> So far, the way we have been using hidden commands is to assume that
> users are not expected to use them at all.  The hidden commands so
> far fall into three categories:
>
>  - aliases - things like darcs move => darcs mv
>  - stubs - things like darcs commit, which just tell you to use
>           an alternative sequence of commands
>  - server commands - darcs transfer-mode in particular
>
I should perhaps clarify my general position a bit more here. The
problem is not in hiding commands, it is in hiding functionality.
Hiding aliases and stubs I don't see as a (big) problem. It is when
the user finds out that in order to achieve certain things he has to
delve into this secret cave of hidden functionality which is a
confusing thing. Therefore my personal preference would be for the
server commands not to be hidden. But since I don't use them (indeed I
didn't know about the transfer-mode command until now) I don't have
that strong an opinion in this particular case.

> I agree with Josef's general sentiment, although my way of phrasing it
> might be that if we are going to hide put, we had better make sure
> nobody is actually going to use it.  One thing we could do is, if we
> were to hide it, is to transform put into a stub, telling people to just
> darcs init and darcs push.
>
Right. That would have been a good way of solving it. I'm happy you
decided to keep put though.

Cheers,

Josef
_______________________________________________
darcs-users mailing list
darcs-users@darcs.net
http://lists.osuosl.org/mailman/listinfo/darcs-users

Reply via email to