demo vs. sample directories in the jdk

[Alan Bateman]

This isn't really a build issue, more of a question as to where to put 
sample code in the jdk repository. Today we have a "sample" and a "demo" 
directory and it's not always clear where to put new sample code. I'm 
trying to remember why we have two locations. I think, but might be 
wrong, that the demo directory is sample code that is compiled by the 
build so that both the source and "ready-to-run" binaries are in the JDK 
image. The sample directory on the other hand is sample code that is not 
compiled by the build but instead is just copied into the JDK image 
along with a build.xml or projects files. Is that right? I'm just 
looking for some guidance (or a reminder) as to where new samples should go.

-Alan.