headers
James Harkins | 1 Sep 2011 02:06
Picon

SF.net Git: supercollider branch, master, updated. bd51cce31106c465b311d400b44b0058b70f57d0

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "supercollider".

The branch, master has been updated
       via  bd51cce31106c465b311d400b44b0058b70f57d0 (commit)
      from  632f800f0c1ac5a0a39cad9f6c2d15aaa02c71b7 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit bd51cce31106c465b311d400b44b0058b70f57d0
Author: James Harkins <jamshark70@...>
Date:   Thu Sep 1 08:04:48 2011 +0800

    Clarify buffer sizes for Disk I/O UGens

diff --git a/HelpSource/Classes/DiskIn.schelp b/HelpSource/Classes/DiskIn.schelp
index efec4d9..e6b2014 100644
--- a/HelpSource/Classes/DiskIn.schelp
+++ b/HelpSource/Classes/DiskIn.schelp
 <at>  <at>  -15,10 +15,11  <at>  <at>  private:: categories
 method::ar

 argument::numChannels
-Number of channels
+Number of channels. This must match the number of channels in the buffer.
(Continue reading)

Permalink | Reply | 0 comments |
headers
James Harkins | 1 Sep 2011 02:39
Picon

Re: Three things that could help acceptance of new help system

At Thu, 01 Sep 2011 00:45:49 +0200,
Tim Blechmann wrote:
> > 3) I've said this before, and I still really dislike the underlining and
> > autolinking of all classes in the example code. This hinders clean cut and
> > paste (even paste and match style fails to remove them, and creates new
> > orphaned links outside of the main help browser window).
> 
> i cannot reproduce this issue. with the qt-based help browser, i can simply 
> copy some example code into emacs. so maybe it is an issue with the cocoa web 
> view? scott?

Hm. It does seem to have something to do with the cocoa web kit. I tried to copy/paste some text from the qt help
browser into OpenOffice writer (since it might also be relevant to paste into a styled text editor), but
the clipboard was plain text, no styles, no links. "Paste special" in OpenOffice confirmed that the entry
on the clipboard was "Unformatted text."

I'm surprised that paste/match style didn't help. Probably, then, it's a necessary part of the solution to
make sure that the cocoa webkit copies the text in a useful way.

> > I'd also like an option to not have the new help system on, even if not the
> > default (ie open html files in individual windows as directly editable).
> 
> well, there are mixed opinions about this: editing html files is only possible 
> in scapp. the generated html is something between a mess and an insult to 
> anyone who wants to edit them by hand. imo, the old help system should get 
> deprecated and deleted, because we really don't want to maintain two help 
> systems.

Yes. Parallel help systems that don't stem from the same source would mean that a/ you would be using
outdated documentation much of the time, as the new documents get updated and the HTML files languish and
(Continue reading)

Permalink | Reply | 14 comments |
headers
James Harkins | 1 Sep 2011 02:57
Picon

SF.net Git: supercollider branch, master, updated. d9ff04e9434f48ac0a02829fb0daa608095d0d6a

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "supercollider".

The branch, master has been updated
       via  d9ff04e9434f48ac0a02829fb0daa608095d0d6a (commit)
      from  bd51cce31106c465b311d400b44b0058b70f57d0 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d9ff04e9434f48ac0a02829fb0daa608095d0d6a
Author: James Harkins <jamshark70@...>
Date:   Thu Sep 1 08:56:49 2011 +0800

    Fix "class 'QtGUI' not found" warnings

    Do not compare GUI.scheme with a hardcoded class object!
    You can't assume every user will have that class installed.

diff --git a/SCClassLibrary/Common/GUI/HelpBrowser.sc b/SCClassLibrary/Common/GUI/HelpBrowser.sc
index 47e51b4..47bc40f 100644
--- a/SCClassLibrary/Common/GUI/HelpBrowser.sc
+++ b/SCClassLibrary/Common/GUI/HelpBrowser.sc
 <at>  <at>  -136,7 +136,7  <at>  <at>  HelpBrowser {

 		openNewWin = aNewWin;
 		x = x + w + 10;
(Continue reading)

Permalink | Reply | 0 comments |
headers
James Harkins | 1 Sep 2011 03:20
Picon

scope/plot tutorial vs. Windows

Just wanted another pair of eyes before pushing a change to the scoping/plotting tutorial to explain that
you should use the local server for scope in Windows.

I thought about explaining the different GUI kits, but then realized this would be too complicated for new
users. So this approach documents what (I assume) will be the situation in 3.5:

Mac: cocoa GUI, use internal server
Linux: Qt GUI, use internal server
Windows: Swing GUI, use local server

So then all the tutorial has to say is that Windows users should stick with the local server.

(It won't help the documentation in 3.4, but at least lays the groundwork for more accurate documentation
in 3.5.)

hjh

--
James Harkins /// dewdrop world
jamshark70@...
http://www.dewdrop-world.net

"Come said the Muse,
Sing me a song no poet has yet chanted,
Sing me the universal."  -- Whitman

blog: http://www.dewdrop-world.net/words
audio clips: http://www.dewdrop-world.net/audio
more audio: http://soundcloud.com/dewdrop_world/tracks
(Continue reading)

Permalink | Reply | 3 comments |
headers
Julian Rohrhuber | 1 Sep 2011 10:09
Picon
Favicon

Re: Three things that could help acceptance of new help system


On 01.09.2011, at 00:45, Tim Blechmann wrote:

>> 
>> I'd also like an option to not have the new help system on, even if not the
>> default (ie open html files in individual windows as directly editable).
> 
> well, there are mixed opinions about this: editing html files is only possible 
> in scapp. the generated html is something between a mess and an insult to 
> anyone who wants to edit them by hand. imo, the old help system should get 
> deprecated and deleted, because we really don't want to maintain two help 
> systems.
> 

You are right, from outside the os x bubble the old help system is something like an insult. From the inside,
however, it is a blessing.

> that said, afaict most of the help files have been migrated. i think only the 
> gui help files are still left. and they should probably be reworked to match 
> the generic class interface, that is implemented by cocoa, qt and (at least 
> partially by swingosc)

Unfortunately, all the Quarks and private projects haven't been converted yet - there is still a lot to do. I
think it is a fair request to open an old file where new ones don't exist. 

Maybe the browser can have a red button that says: "port to a new helpfile now" and open the raw template in the
right place (i.e. the Quark folder under the correct subfolder).

_______________________________________________
sc-dev mailing list
(Continue reading)

Permalink | Reply | 0 comments |
headers
Jakob Leben | 1 Sep 2011 10:31
Picon
Gravatar

Re: scope/plot tutorial vs. Windows

There has been some talk about a shared memory approach to scoping on
local server... But from my side, I can't give any assurance that it
will become reality by 3.5.

So for now, this is a good step, I think.

On Thu, Sep 1, 2011 at 3:20 AM, James Harkins <jamshark70@...> wrote:
> Just wanted another pair of eyes before pushing a change to the scoping/plotting tutorial to explain that
you should use the local server for scope in Windows.
>
> I thought about explaining the different GUI kits, but then realized this would be too complicated for new
users. So this approach documents what (I assume) will be the situation in 3.5:
>
> Mac: cocoa GUI, use internal server
> Linux: Qt GUI, use internal server
> Windows: Swing GUI, use local server
>
> So then all the tutorial has to say is that Windows users should stick with the local server.
>
> (It won't help the documentation in 3.4, but at least lays the groundwork for more accurate documentation
in 3.5.)
>
> hjh
>
>
> --
> James Harkins /// dewdrop world
> jamshark70@...
> http://www.dewdrop-world.net
>
(Continue reading)

Permalink | Reply | 2 comments |
headers
Andrea Valle | 1 Sep 2011 10:45
Picon
Favicon

Re: scope/plot tutorial vs. Windows

Dumb and deaf here, but what about using the SwingOSC approach?
No scope on local server is really really really a problem IMHO.
(and it looks a bit bizarre for newbies approaching SC coming from other sws)
ok, now I shut up as surely it doesn't help!

Best
-a-


--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
--> http://www.cirma.unito.it/andrea/
--> http://www.fonurgia.unito.it/andrea/
--> http://www.flickr.com/photos/vanderaalle/sets/
--> http://vimeo.com/user2700082
-->  http://www.youtube.com/user/vanderaalle
--> andrea.valle@...
--------------------------------------------------

"This is a very complicated case, Maude. You know, a lotta ins, a lotta outs, a lotta what-have-yous." 
(Jeffrey 'The Dude' Lebowski)

On Sep 1, 2011, at 10:31 AM, Jakob Leben wrote:

> There has been some talk about a shared memory approach to scoping on
> local server... But from my side, I can't give any assurance that it
> will become reality by 3.5.
(Continue reading)

Permalink | Reply | 0 comments |
headers
Scott Wilson | 1 Sep 2011 10:53
Picon
Picon

Re: Three things that could help acceptance of new help system


On 31 Aug 2011, at 23:45, Tim Blechmann wrote:

> hi nick,
> 
>> 3) I've said this before, and I still really dislike the underlining and
>> autolinking of all classes in the example code. This hinders clean cut and
>> paste (even paste and match style fails to remove them, and creates new
>> orphaned links outside of the main help browser window).
> 
> i cannot reproduce this issue. with the qt-based help browser, i can simply 
> copy some example code into emacs. so maybe it is an issue with the cocoa web 
> view? scott?

Yes, on OSX Qt does plain text regardless. In Cocoa it copies the links normally, but paste and match style
(Cmd-alt-shift-V) removes the links for me. I haven't gotten around to looking into the copy as plain text
business. I don't imagine it would be hard, but it may take me a while to get to it.

+1 regarding the clicking in a link thing, which is rather awkward. Maybe less of an issue in editors where
editing help file examples in place is not normal practice, but speaking for myself this comes up a lot.
Perhaps another OSX bubble issue. Users will be familiar with selecting text and pressing Cmd-D. We could
also support alt-double-click as this is pretty common to bring up help. (Would be really cool in a
floating window with an option to open a new browser window!)

> 
>> I'd also like an option to not have the new help system on, even if not the
>> default (ie open html files in individual windows as directly editable).
> 
> well, there are mixed opinions about this: editing html files is only possible 
> in scapp. the generated html is something between a mess and an insult to
(Continue reading)

Permalink | Reply | 3 comments |
headers
Click Nilson | 1 Sep 2011 11:30
Picon

Re: Three things that could help acceptance of new help system

Thanks all, 

These steps being discussed sound very good. I am not arguing against adoption of the new help system, just
in favour of some things that can be done to ease the transition and avoid it being seen as more burden than
improvement (and this may be rather particular to the OS X client app, but I guess the new Qt app isn't going
to be ready before 3.6 or beyond).

I've just tripled checked with the latest build from git on OS X (non QT, which may be the issue?): paste and
match style preserves links, you can't shake them off in app. 

best
N

 

On 1 Sep 2011, at 09:53, Scott Wilson wrote:

> 
> On 31 Aug 2011, at 23:45, Tim Blechmann wrote:
> 
>> hi nick,
>> 
>>> 3) I've said this before, and I still really dislike the underlining and
>>> autolinking of all classes in the example code. This hinders clean cut and
>>> paste (even paste and match style fails to remove them, and creates new
>>> orphaned links outside of the main help browser window).
>> 
>> i cannot reproduce this issue. with the qt-based help browser, i can simply 
>> copy some example code into emacs. so maybe it is an issue with the cocoa web 
>> view? scott?
(Continue reading)

Permalink | Reply | 2 comments |
headers
Scott Wilson | 1 Sep 2011 11:41
Picon
Picon

Re: Three things that could help acceptance of new help system


On 1 Sep 2011, at 10:30, Click Nilson wrote:

> Thanks all, 
> 
> These steps being discussed sound very good. I am not arguing against adoption of the new help system, just
in favour of some things that can be done to ease the transition and avoid it being seen as more burden than
improvement (and this may be rather particular to the OS X client app, but I guess the new Qt app isn't going
to be ready before 3.6 or beyond).
> 
> I've just tripled checked with the latest build from git on OS X (non QT, which may be the issue?): paste and
match style preserves links, you can't shake them off in app. 

Weird. I have Qt, but I don't see why that should make a difference to the Cocoa WebView.

S.
_______________________________________________
sc-dev mailing list

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

Gmane