Win a copy of The Little Book of Impediments (e-book only) this week in the Agile and Other Processes forum!
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

Submission doubts/questions

 
Andrew Hanger
Greenhorn
Posts: 8
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I'm very close to submission. Still have some minor submission/packaging questions. Please, share your thoughts on:
1. Is it ok if I explicitely specify in README.txt file that 'java' commands to run application should be excuted from the root of submission directory? This will help me avoid problems with CLASSPATH and default database file location.
2. SUN says regarding the source codes of the application: "...these should be in an appropriate directory structure along with the classfiles...". Does this mean that I need to include source files in executable jars (I use two executable jars in the delivery: client.jar & server.jar)? Can I just create a separate 'src.jar' with sources or this will be a violation of "..along with the classfiles.." requirement?
3. SUN says that we should "..provide user documentation for the database server and the gui client..". What is supposed to be included in these? Should these be a sort of "how-to" documents?
Thanks.
 
Michael Morris
Ranch Hand
Posts: 3451
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Hi Andrew,
1. Is it ok if I explicitely specify in README.txt file that 'java' commands to run application should be excuted from the root of submission directory? This will help me avoid problems with CLASSPATH and default database file location.

You can but there is really no need. All I did was indicate the location of the executable jar files. Instead of placing my client and server jars in the root directory though, I put them in a directory called /executables along with the security policy file and a copy of db.db.
2. SUN says regarding the source codes of the application: "...these should be in an appropriate directory structure along with the classfiles...". Does this mean that I need to include source files in executable jars (I use two executable jars in the delivery: client.jar & server.jar)? Can I just create a separate 'src.jar' with sources or this will be a violation of "..along with the classfiles.." requirement?

I did not put source files in the client and server jar files nor did I jar the source files. I had a directory called /source and under that two sub-directories named original and release. The original contained a pristine copy of suncertify/db that was issued. Of course release contained my finished assignment with source and class files in their appropriate directories.
3. SUN says that we should "..provide user documentation for the database server and the gui client..". What is supposed to be included in these? Should these be a sort of "how-to" documents?

Most, including myself, has provided HTML help files and used a JEditorPane to display them while either client or server is running. You should also note their location in the Readme.txt file so that they may be accessed through a browser.
Hope this helps,
Michael Morris
[ August 06, 2002: Message edited by: Michael Morris ]
 
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic