things getting downright happy

This commit is contained in:
benfry
2002-07-31 00:58:18 +00:00
parent a6419e4213
commit 0fe55629a8
2 changed files with 247 additions and 40 deletions
+191
View File
@@ -0,0 +1,191 @@
PROCE55ING D3VEL()PM3NT 3N\/1RONM3NT
alpha release (revision XXXX)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RELEASE NOTES & DEVELOPER SOAPBOX
herein follows lots of random notes about this release. you'll have to
pardon the chatty detail in some spots, as this will also serve as a
response to many of the 'frequently asked questions' that we have.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SUMMARY
+ if you find issues (some call them 'bugs'),
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
REVISIONS & ROADMAP
at least until the final "1.0" version, we'll be using four digit
numbers for the release. we're calling revision "XXXX" (this one)
alpha, which for us means "first publicly consumable app that can be
used by early adopters".
there will be a few more numbered releases leading up to a beta
release. beta means that all the features are in, but not all the bugs
are out. there are several known issues with the alpha release (thin
lines, lack of alpha transparency, etc) that will need to be sorted
out for beta.
a few more numbered releases will follow, leading up to 1.0, a version
that we can actually proud of and that has a minimum number of
bugs. hopefully this is not a *long* ways off, but...
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
I FOUND A BUG!
what operating system, what revision
include release number, platform,
and a copy of the code, preferably the folder from the sketchbook (see
sketchbook/default/SKETCHNAME) if there are images or other data being
used.
>>>>>>>>>>>>>> NEED TO WRITE THIS SECTION <<<<<<<<<<<<<<<<
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PLATFORMS
the processing development environment runs best on:
1. windows
2. mac os x
3. linux
4. mac os 9
our priority for how well the beast runs looks like:
1. windows & mac os x (tied for first)
2. mac os 9
3. linux
windows is the superior platform for running java applications. it's
not because we like windows the best, so sorry to the zealots in all
other corners of the machine space, but that's just how it is. the vm
for mac os x is really quite good (especially when compared to apple's
previous efforts), but it's still a bit behind. we think os x will be
a great bet for the future, and apple is putting all their feeble
weight behind it, so hopefully it will evolve somewhere.
developing the version for mac os 9 is a big headache, but we think
lots of people still use the crusty operating system, so we're going
to keep supporting it for the meantime. the guess is that a lot of
schools are still using it in their labs, and since schools are a
significant target for the environment, we gotta play along.
for the linux version, you guys can support yourselves. if you're
enough of a hacker weenie to get a linux box setup, you oughta know
what's going on. for lack of time, we won't be testing extensively
under linux, but would be really happy to hear about any bugs or
issues you might run into. actually, we don't get happy that you're
having issues, but if you're going to have issues, we're happy that
you tell us about them, so we can fix them.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MAC OS X
processing runs best with (and probably requires) Mac OS X 10.1 and
"Java 1.3.1 Update 1", the latter of which is available as a free
update from the "Software Update" control panel. it can also be
downloaded from http://www.apple.com/downloads/macosx/apple/ or
from: http://www.apple.com/downloads/macosx/apple/java131.html
with os x 10.2 on its way, you'll no longer need the java update,
but we'll have to see if we can afford being gouged $129 for the
upgrade in order to do some testing under this cat-themed operating
system.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MAC OS 9
java applications on classic mac os are in a bad state, as apple has
decided (rightfully so) to abandon further development of their java
runtime.
SPEED: this version runs very slowly. the first time you hit the 'run'
button, it might take a while to bring up the actual
program. hopefully after that, things will improve.
VERSIONS: this version has only been tested under Mac OS 9.2.2.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SERIAL PORT
the serial port is a useful way to hook things up to hardware
devices of your own devising.
>>>>>>>>>>>>>> NEED TO WRITE THIS SECTION <<<<<<<<<<<<<<<<
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PROCE55ING IS FREE TO DOWNLOAD / FREE TO USE
we think it's important to have processing freely available, rather
than selling it for a million dollars under some godawful yearly
contract update scheme. to that end, we encourage people to distribute
it widely and refer back to the site: http://Proce55ing.net
on most of our own projects, we usually list them as "Built with
Proce55ing" or something similar, with a link back to the site. of
course this isn't a necessity, but it makes us happy when you do.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOURCE CODE / OPEN SOURCE / GPL BLAH BLAH
we plan for this project to be "open source", that trendy moniker
which means that you'll be able to look at all the code that's behind
the processing development environment and the graphics engine used in
tandem with it.
the export libraries will probably be LGPL, which means they can be
used as a library and included in your project without you having to
open up your code (though we encourage people to share anyway).
more information about the gnu public license can be found here:
http://www.gnu.org/copyleft/gpl.html
processing also includes other open projects, namely the oro matcher
and the kjc compiler. the oro tools are distributed under a bsd style
license as part of the apache jakarta project, and the kjc compiler is
part of the kopi suite of tools, which is released under the gpl. so
in fact, if the final, publicly available version of processing still
uses kjc, the code for processing will have to be released gpl.
more about the oro tools is at: http://www.savarese.org/oro/
and the home for kopi/kjc is here: http://www.dms.at/kopi/
we're sorry that the source code isn't available just yet, we're
cleaning and scrubbing it, it was a decision between getting the alpha
out to people to try versus taking a few more weeks to clean up the
project and deal with the technology licensing departments at mit and
ivrea. these things are more difficult and time consuming than they
would appear.
+56 -40
View File
@@ -28,6 +28,19 @@ X try calling gc on stop as well
X make it simpler to build the code..
X buzz.pl actually no longer needed (no ifdefs)
o use a regular makefile for everything
X getResource stuff breaks, sketch.properties can't save
X FileNotFoundException: /FILE9/+/sketch.properties
X doc: requires java 1.3.1 update 1
X button backgrounds are weird since not square
X (seen when asking to save a file etc)
X see if possible to set background of button object
X or maybe just background of the awt object it sits on
X get casey's examples into the sketchbook
X these should become the standard test cases for everything
o crashes when people click on help in top bar (same in DBN) [macos9]
X not reproduced.. mrjappbuilder seems stabler?
X use osx utilities to setfileinfo for .jar files etc
o try to build macutils under osx
a _ this code is not performing correctly
BImage b; // declare variable "b" of type BImage
@@ -51,79 +64,53 @@ endShape();
bagel
a _ serial
a _ pde menu item for listing serial ports available
a _ document a bit more regarding its use
pde
a _ move background() out of draw() for draw mode apps
a _ click on project name to quickly go to rename mode
a _ make scrollbar for console
a _ remove projects if created but nothing happens to them
a _ option to delete current project
a _ see if play being highlighted can be implemented again
a _ for 'java' mode, try run using external vm
a _ would need to get error output stream from app.. argh
a _ only allow under win/osx/linux
a _ not clear how to kill the process.. does that work w/ 1.3?
? _ lockup when something missing from classpath on dynamic load
macos9
X getResource stuff breaks, sketch.properties can't save
X FileNotFoundException: /FILE9/+/sketch.properties
a _ apple control keys register as edit events in buffer
a _ use Toolkit.getShortcutKeymask() to figure out what's up
a _ button backgrounds are weird since not square
a _ (seen when asking to save a file etc)
a _ see if possible to set background of button object
a _ or maybe just background of the awt object it sits on
a _ use type/creator Pde1
a _ crashes when people click on help in top bar (same in DBN) [macos9]
a _ use osx utilities to setfileinfo for .jar files etc
a _ try to build macutils under osx
macosx
a _ splash screen
a _ handlers for basic events
a _ MRJAboutHandler (just show splash screen)
a _ MRJPrefsHandler (open pde.properties in a text editor)
a _ MRJQuitHandler (confirm quit, may need to be in another thread)
a _ remove 'quit' from file menu
a _ doc: requires java 1.3.1 update 1
a _ set file type/creator for .pde files.. TEXTPde1
macos
a _ MRJOpenApplicationHandler and MRJOpenDocumentHandler
a _ especially the open document fella
a _ under osx, app won't get doc unless app already launched
a _ implement menuitem to load ref and to launch p5.net
a _ MRJFileUtils.openURL(String url) throws IOException
a _ serial port code needs to be implemented
a _ something that docks better to java serial api
a _ dataInputStream, setUseCaches on the url to false
a _ URLConnection.setUseCaches(false)
a _ parent.obj.close() on the url
a _ serial port code needs to be implemented
a _ something that docks better to java serial api
a _ check to see if lines for error messages are off
a _ set file type/creator for .pde files.. TEXTPde1
windwows
a _ splash screen.. check win95 book for simple code
linux
a _ test the gcc executable, and tweak dist script accordingly
release
a _ add 'readme.txt' to dist.sh.. change notes to revisions
a _ add examples to dist.sh scripts
a _ separate shared script to cleanup?
a _ or small script to remove CVS directories from a tree
a _ check osname under win98 and linux
b _ figure out about distributing source
b _ kjc is gnu, so source needs to be available
a _ get all of casey's examples into the sketchbook
a _ these should become the standard test cases for everything
a _ faq on where the project is going
a _ information on how to submit bugs to p5-bugs@proce55ing.net
a _ include release number, platform, and a copy of the code
a _ need comprehensive set of tests for 'f' substitution scenarios
web
web / docs
a _ online discussion/talk system (gets people using the site too)
a _ online signup cgi for people to add themselves to the list
a _ see about setting up simple bug tracker/feature system
a _ queue for people reporting things externally
a _ bugzilla but simpler
a _ would also be nice for people to be able to vote on features
a _ document serial a bit more in release notes
dammit we need a text editor.
gonna get sick of people bitching about it.
@@ -284,13 +271,20 @@ _ fill, background, stroke all with int version for packed rgb
PDE / high
b _ class unloading not happening
b _ when doing an extends ProcessingApplet
b _ for 'java' mode, try run using external vm
b _ would need to get error output stream from app.. argh
b _ only allow under win/osx/linux
b _ not clear how to kill the process.. does that work w/ 1.3?
b _ class unloading not happening in java mode
b _ need to add randomizer to even non-self gen'd classes
b _ or figure out how to unload old classes.. grr
b _ lockup when something missing from classpath on dynamic load
b _ but makes no error.. peditorconsole probably swallowing it
PDE / medium
b _ option to delete current project (trickier)
b _ also needs to have method for verify.. blech
b _ beautify is broken
b _ sketch: sketch-000 is dumb
b _ check logs to see where we're getting traffic from
@@ -389,6 +383,8 @@ _ dbn2p5 converter.. ooh!
PDE / dist
b _ need document icons
b _ figure out about distributing source
b _ kjc is gnu, so source needs to be available
PDE / windows
@@ -398,6 +394,26 @@ b _ build from command line, using gcc
b _ file association for .pde files
PDE / macos
b _ handlers for basic events
b _ MRJAboutHandler (just show splash screen)
b _ image for 'about processing'
b _ MRJPrefsHandler (open pde.properties in a text editor)
b _ MRJQuitHandler (confirm quit, may need to be in another thread)
b _ MRJOpenApplicationHandler and MRJOpenDocumentHandler
b _ especially the open document fella
b _ under osx, app won't get doc unless app already launched
PDE / macosx
b _ splash screen
b _ remove 'quit' from file menu
PDE / linux
b _ splash screen
PDE / features
_ might be nice to have some notion of plugins for pde
_ color picker or other things written by folks