From 0fe55629a85dea06dcb763d3141de1a9fdb6609e Mon Sep 17 00:00:00 2001 From: benfry Date: Wed, 31 Jul 2002 00:58:18 +0000 Subject: [PATCH] things getting downright happy --- build/shared/readme.txt | 191 ++++++++++++++++++++++++++++++++++++++++ todo.txt | 96 +++++++++++--------- 2 files changed, 247 insertions(+), 40 deletions(-) create mode 100644 build/shared/readme.txt diff --git a/build/shared/readme.txt b/build/shared/readme.txt new file mode 100644 index 000000000..998482bc1 --- /dev/null +++ b/build/shared/readme.txt @@ -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. \ No newline at end of file diff --git a/todo.txt b/todo.txt index 45e236306..71197c140 100644 --- a/todo.txt +++ b/todo.txt @@ -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