Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.soft-sys.math.mathematica > #12998

Re: Usage Messages in Mathematica

From Murray Eisenberg <murray@math.umass.edu>
Newsgroups comp.soft-sys.math.mathematica
Subject Re: Usage Messages in Mathematica
Date 2012-12-30 03:24 +0000
Message-ID <kboc63$3gm$1@smc.vnet.net> (permalink)
References <20121227100447.E595B6866@smc.vnet.net> <20121228103623.75A716873@smc.vnet.net> <13640927.13668.1356709654706.JavaMail.root@m06> <20121229201326.F167C68D7@smc.vnet.net>
Organization Time-Warner Telecom

Show all headers | View raw


Same thing on my Mac OS X installation of Mathematica 9. (Quotes the 
first time in output from ?f, not thereafter.)

On the other hand, of course, simply evaluating f::usage produces output 
with no quotes.

On Dec 29, 2012, at 3:13 PM, djmpark <djmpark@comcast.net> wrote:

> No, on my system (M9, Windows 7) the first time
>
> ?f
>
> is evaluated I obtain a usage message with quotes around it. If the same
> statement is evaluated again the quotes go away. Of course, it is the first
> evaluation that the user will see.
>
>
> David Park
> djmpark@comcast.net
> http://home.comcast.net/~djmpark/index.html
>
>
>
> From: Bob Hanlon [mailto:hanlonr357@gmail.com]
>
>
> Using both Format and usage messages seems to work.
>
> Clear[f];
> Format[f[n_, x_]]:=
>    Subscript[f, n][x];
> f::usage="f[n, x] gives " <>
>    ToString[f[n, x], StandardForm]<>".";
>
> f::usage
>
> f[n, x]
>
> f[n, x]//TraditionalForm
>
> Clear[g];
> Format[g[n_, a_, x_]]:=
>    Power[Subscript[g, n], a][x];
> g::usage="g[n, a, x] gives " <>
>    ToString[g[n, a, x], StandardForm]<>".";
>
> g::usage
>
> g[n, a, x]
>
> g[n, a, x]//TraditionalForm
>
>
> Bob Hanlon
>
>
> On Fri, Dec 28, 2012 at 5:36 AM, Murray Eisenberg =
<murray@math.umass.edu>
> wrote:
>> And yet usage messages for built-in objects seem to handle in-line
>> expressions and subscripts with aplomb. See, for example:
>>
>>  Subscript::usage
>>
>>
>> On Dec 27, 2012, at 5:04 AM, djmpark <djmpark@comcast.net> wrote:
>>
>>> An extremely weak features of Mathematica is the design of Usage
>>> messages, which seems to be stuck at Version 1, although the
>>> technology has moved far beyond that.
>>>
>>> The present design is not up to the task and full of gotchas. For
>>> example, how does one include a box structure, for example a
>>> subscripted symbol, within a usage message? If one just enters a
>>> subscript then the first time the message is displayed there are
>>> quotes around it and the second time the quotes go away. If one
>>> starts an InlineCell within the string and enters the expression then
>>> that problem goes away. If one then moves the usage definition to a
>>> package and Runs the package it works OK. But if one saves and closes
>>> the package, quits the kernel and then reinitializes, loading the
>>> package, the usage message is defective giving the InputForm of the
>>> box expression. Mathematica parses and changes the usage messages when
> the file is read.
>>>
>>> The String form is just not adequate for usage messages. Nor is it
>>> adequate to contain information on overloading functions. Usage
>>> definitions should be expressions. Something like the following:
>>>
>>> Usage[FunctionName] = {{template, usageExpression}..}
>>>
>>> (The usageExpression might be a Row containing Strings and
>>> mathematical expressions.)...
>>
>> ---
>> Murray Eisenberg                                    murray@math.umass.edu
>> Mathematics & Statistics Dept.
>> Lederle Graduate Research Tower            phone 413 549-1020 (H)
>> University of Massachusetts                               413 545-2838 (W)
>> 710 North Pleasant Street                         fax   413 545-1801
>> Amherst, MA 01003-9305
>>
>>
>>
>>
>>
>>
>

---
Murray Eisenberg                                    murray@math.umass.edu
Mathematics & Statistics Dept.      
Lederle Graduate Research Tower            phone 413 549-1020 (H)
University of Massachusetts                               413 545-2838 (W)
710 North Pleasant Street                         fax   413 545-1801
Amherst, MA 01003-9305





Back to comp.soft-sys.math.mathematica | Previous | Next | Find similar | Unroll thread


Thread

Re: Usage Messages in Mathematica Murray Eisenberg <murray@math.umass.edu> - 2012-12-30 03:24 +0000

csiph-web