Re: Deprecating usage ()

[Rik]

On 04/13/2012 10:00 AM, address@hidden wrote:
> Message: 1
> Date: Thu, 12 Apr 2012 15:33:32 -0400
> From: "John W. Eaton" <address@hidden>
> To: octave maintainers mailing list <address@hidden>
> Subject: deprecate "usage" function?
> Message-ID: <address@hidden>
> Content-Type: text/plain; charset=us-ascii
>
> Octave has both "print_usage" and "usage". We should be using
> "print_usage" internally in Octave because it extracts the usage
> message directly from the doc string so there can't be any difference
> between the function documentation and the usage message that is
> displayed when functions are called incorrectly. So I don't see any
> particular need for the "usage" function. Is there any objection to
> deprecating the "usage" function and eventually removing it from
> Octave?
>
> jwe
4/13/12

Good idea.  I had noted the redundancy but hadn't done anything about it.

It seems to be used in only 2 core Octave m-files at present:

./miscellaneous/license.m:        usage ('license ("inuse")');
./miscellaneous/license.m:        usage ('retval = license ("inuse")');
./miscellaneous/license.m:        usage ('retval = license ("checkout", feature)');
./plot/private/__errcomm__.m:      usage ("%s (...)", caller);

--Rik