right now it's a no-op. also need to determine what it would actually mean.
(close emulator? probably not--just quit the sketch on the emulator or
external device)

so this now works (yay!), but takes 15-30 seconds to take place on os x. is
it similar for windows? the environment appears to hang (presumably
blocking on a thread) after clicking stop giving the appearance of things
having crashed. thoughts?

Unfortunately, it's pretty much instantaneous on my Windows box, so it's
hard for me to say where the delay is.

Keep a logcat open on the device in question, and see whether, once you've
pressed the stop button, it takes a long time to see the ActivityManager
report that it's "Starting activity: Intent {
act=android.intent.action.MAIN cat=[android.intent.category.HOME]".

Does is reliably take a long time, or intermittently?

If you held a gun to my head, I'd guess that it's adb being suck on OS X.

so with this sketch:

void draw() {
println(frameCount);
}

i hit the 'stop' button at 50, and get:

I/System.out( 287): 50
I/System.out( 287): 51
I/System.out( 287): 52
I/System.out( 287): 53
I/System.out( 287): 54
I/System.out( 287): 55
I/System.out( 287): 56
I/System.out( 287): 57
I/System.out( 287): 58
I/System.out( 287): 59
I/System.out( 287): 60
I/System.out( 287): 61
I/System.out( 287): 62
I/System.out( 287): 63
I/System.out( 287): 64
I/System.out( 287): 65
I/System.out( 287): 66
I/System.out( 287): 67
I/System.out( 287): 68
I/System.out( 287): 69
I/System.out( 287): 70
I/System.out( 287): 71
I/System.out( 287): 72
I/System.out( 287): 73
I/System.out( 287): 74
I/System.out( 287): 75
I/System.out( 287): 76
I/System.out( 287): 77
I/System.out( 287): 78
I/System.out( 287): 79
I/System.out( 287): 80
I/System.out( 287): 81
I/System.out( 287): 82
I/System.out( 287): 83
I/System.out( 287): 84
I/System.out( 287): 85
I/System.out( 287): 86
I/System.out( 287): 87
I/System.out( 287): 88
I/System.out( 287): 89
I/System.out( 287): 90
I/System.out( 287): 91
D/AndroidRuntime( 295):
D/AndroidRuntime( 295): >>>>>>>>>>>>>> AndroidRuntime START <<<<<<<<<<<<<<
D/AndroidRuntime( 295): CheckJNI is ON
I/System.out( 287): 92
I/System.out( 287): 93
I/System.out( 287): 94
I/System.out( 287): 95
I/System.out( 287): 96
I/System.out( 287): 97
I/System.out( 287): 98
I/System.out( 287): 99
D/dalvikvm( 110): GC freed 3313 objects / 196104 bytes in 520ms
I/System.out( 287): 100
I/System.out( 287): 101
I/System.out( 287): 102
I/System.out( 287): 103
I/System.out( 287): 104
I/System.out( 287): 105
I/System.out( 287): 106
I/System.out( 287): 107
I/System.out( 287): 108
I/System.out( 287): 109
I/System.out( 287): 110
I/System.out( 287): 111
D/AndroidRuntime( 295): --- registering native functions ---
I/System.out( 287): 112
I/System.out( 287): 113
I/System.out( 287): 114
I/System.out( 287): 115
I/System.out( 287): 116
I/System.out( 287): 117
I/System.out( 287): 118
I/System.out( 287): 119
I/System.out( 287): 120
I/System.out( 287): 121
I/System.out( 287): 122
I/System.out( 287): 123
I/System.out( 287): 124
I/System.out( 287): 125
I/System.out( 287): 126
I/System.out( 287): 127
I/System.out( 287): 128
I/System.out( 287): 129
I/System.out( 287): 130
I/System.out( 287): 131
I/System.out( 287): 132
D/ddm-heap( 295): Got feature list request
I/System.out( 287): 133
I/System.out( 287): 134
I/System.out( 287): 135
I/System.out( 287): 136
I/System.out( 287): 137
I/System.out( 287): 138
I/System.out( 287): 139
I/System.out( 287): 140
I/System.out( 287): 141
I/System.out( 287): 142
I/System.out( 287): 143
I/System.out( 287): 144
I/System.out( 287): 145
I/System.out( 287): 146
I/System.out( 287): 147
I/System.out( 287): 148
I/System.out( 287): 149
I/System.out( 287): 150
I/System.out( 287): 151
I/System.out( 287): 152
I/System.out( 287): 153
I/System.out( 287): 154
I/System.out( 287): 155
I/System.out( 287): 156
I/System.out( 287): 157
I/System.out( 287): 158
I/System.out( 287): 159
I/System.out( 287): 160
I/System.out( 287): 161
I/System.out( 287): 162
I/System.out( 287): 163
I/System.out( 287): 164
I/System.out( 287): 165
I/System.out( 287): 166
I/System.out( 287): 167
I/System.out( 287): 168
I/System.out( 287): 169
I/System.out( 287): 170
I/System.out( 287): 171
I/System.out( 287): 172
I/System.out( 287): 173
I/System.out( 287): 174
I/System.out( 287): 175
I/System.out( 287): 176
I/System.out( 287): 177
I/System.out( 287): 178
I/System.out( 287): 179
I/ActivityManager( 52): Starting activity: Intent {
act=android.intent.action.MAIN cat=[android.intent.category.HOME]
flg=0x10000000 cmp=com.android.launcher/.Launcher }
I/System.out( 287): 180
D/PhoneWindow( 287): couldn't save which view has focus because the
focused view processing.core.PApplet$SketchSurfaceView2D@43c41600 has no id.
D/AndroidRuntime( 295): Shutting down VM
D/dalvikvm( 295): DestroyJavaVM waiting for non-daemon threads to exit
D/dalvikvm( 295): DestroyJavaVM shutting VM down
D/dalvikvm( 295): HeapWorker thread shutting down
D/dalvikvm( 295): HeapWorker thread has shut down
D/jdwp ( 295): JDWP shutting down net...
I/dalvikvm( 295): Debugger has detached; object registry had 1 entries
D/dalvikvm( 295): VM cleaning up
E/AndroidRuntime( 295): ERROR: thread attach failed
D/dalvikvm( 230): GC freed 525 objects / 46000 bytes in 959ms
D/dalvikvm( 295): LinearAlloc 0x0 used 636196 of 5242880 (12%)
W/InputManagerService( 52): Starting input on non-focused client
com.android.internal.view.IInputMethodClient$Stub$Proxy@43c33060 (uid=10029
pid=287)
I/processing.android.test.bug_1386_stop_hangs( 287): PROCESSING onStop

Thank you for spamming your bug tracker.

OK, when I write a program that prints every frame, I can still interrupt
it in less than a second. This might be something we have to work on in
person, so I can kick your mac. Think different!