Re: [sc-dev] Help browser

["Dan Stowell" <danstowell@xxxxxxxxx>]

2008/12/24 Scott Wilson <s.d.wilson.1@xxxxxxxxxx>:
>
> On 24 Dec 2008, at 11:04, Scott Wilson wrote:
>
>>
>> On 24 Dec 2008, at 09:39, danstowell@xxxxxxxxxxxxxxxxxxxxx wrote:
>>
>>> Revision: 8274
>>>
>>>  http://supercollider.svn.sourceforge.net/supercollider/?rev=8274&view=rev
>>> Author:   danstowell
>>> Date:     2008-12-24 17:39:47 +0000 (Wed, 24 Dec 2008)
>>>
>>> Log Message:
>>> -----------
>>> Attempt to fix the Help.gui from my recent tweak (Scott says the viewer
>>> was too large on Cocoa).
>>> Hopefully this fixes it, let us know if not.
>>
>> It does indeed, thanks.
>>
>> I'm going to add the canFocus = true, and remove the now superfluous
>> horizontal scroller (the bounds fix seems to have rendered that
>> unnecessary).
>
> Okay, I've done this. I think I'll add the 'link loads in the current view'
> business as well.
>
> This will make the help browser a real browser in terms of clicking on
> links, and will also provide a safe 'sandbox' for users to alter help files
> without being able to save them accidentally.
>
> I almost wonder if Cmd-D shouldn't open the help file in the browser by
> default.

On mac (cocoa) I don't see any problem with this. On swing (i.e. all
non-mac) it's no good because it takes the help doc further away from
the IDE and because links aren't clickable, etc. That might suggest
that for cross-platform consistency the cocoa shouldn't do it by
default either, but I don't mind either way.

> One thought: It would be good if the list views updated to match the text
> view when the user clicks on a link. I'm not sure of the best way to do this
> however, as files could show up in multiple categories. Dan do you have any
> thoughts on this?

No particular thoughts. There is no reason to consider any
tree-location as primary, so the viewer may as well simply use the
first-listed tree-location. That would be fine.

> Similarly, it might be nice to add a text field to the browser to allow the
> user to jump to a particular file (and its place in the tree; or maybe first
> place?) if the corresponding help file exists.

Sounds a bit like Help.searchGUI. Maybe these things should really all
be unified! However, I'm having enough headaches trying to get the
basic Help.gui functionality working on windows, don't really want to
contemplate going even further...

Dan

_______________________________________________
sc-dev mailing list

info (subscription, etc.): http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
archive: https://listarc.bham.ac.uk/marchives/sc-dev/
search: https://listarc.bham.ac.uk/lists/sc-dev/search/