|
From: Jonathan O. <j.j...@gm...> - 2012-02-09 09:55:15
|
Hi Ethan,
>>
>> Could anyone tell me whether this would be considered acceptable use?
>
> I don't understand the intended mechanism.
>
Sorry I wasn't clear. No, I'm not intending to maintain a separate set
of documentation. (I use the info viewer inside Emacs for reading
that, and the code I'm working on creates links to it from the source
buffer). What I'm thinking of are more like what are called "tooltips"
in other environments. In other Emacs language modes (C, Lisp, etc.)
you can have the editor show a one-line message at the bottom of the
screen listing the arguments to a function as soon as you type it or
move the cursor over it, and this saves looking up the full
manual. E.g. when the cursor is after "smooth" Emacs displays
smooth {unique | frequency | cumulative | kdensity ... }
or something similar. Or after typing "using" in a plot command with a
particular plot style it lists the order of columns expected. I find
this quite useful as I often forget the order of arguments to some
options.
I guess this is a maintenance concern to an extent since the
documentation strings would be in the Elisp source (they can't really
be extracted automatically from the info page, as far as I can see). I
think the benefit might outweigh the cost. What do you think? If
people aren't convinced I'll leave it out and just have the completion
code + links to the info manual.
Jonathan
>
> If you're saying that you want to maintain a new, parallel, set of
> documentation, I think that's a bad idea. It would be far too much
> trouble to keep it in sync.
>
> Ethan
>
>
>>
>> Thanks,
>> Jonathan
>>
>>
>> ------------------------------------------------------------------------------
>> Virtualization & Cloud Management Using Capacity Planning
>> Cloud computing makes use of virtualization - but cloud computing
>> also focuses on allowing computing to be delivered as a service.
>> http://www.accelacomm.com/jaw/sfnl/114/51521223/
>> _______________________________________________
>> gnuplot-beta mailing list
>> gnu...@li...
>> https://lists.sourceforge.net/lists/listinfo/gnuplot-beta
>>
>
|