To those who have gotten full credit for their docs just a few quick questions. 1) Manuals : My manuals are *very* short. Executing the programs is the most difficult part and that is covered in README.txt . Especially for the server(Start rmiregistry, start server, take a nap, etc ) Any sort of input on the length of yours would be helpful 2) Comments : I only have say, 15-20 short one line(//) comments (not including javadoc). Too little? Just didnt find much to say that wasn't pretty obvious 3) Design - didnt get too wordy on this one either, maybe 1.5- 2 pages Thanks in advance for dealing with my silly qs :roll: :roll:
Adam Roberts - SCJP2, SCJD<br />insert witty something here
Joined: Feb 25, 2002
Adam, Are you setting the java.rmi.server.codebase property value at the server startup? I can start my server only if I mention the codebase property and I had to mention the drive letter like -Djava.rmi.server.codebase=file:/D:\scjd\starting/ How are you setting the value with out the drive letter?
Joined: Mar 18, 2002
Works fine for me with out it But I did put in the docs about starting with the codebase should the classpath not be set right Something like Djava.rmi.server.codebase=file://c:/<yourparentdirhere>/ where <yourparentdirhere> = what the classpath should be
My Documentation was a 500 page dissertation on the Way and the Life of a Java Developer, It has Poems, and Essays, and just plain BS. Actually I really went all out in the Design.txt. It was about 5 pages and answered every question they had in the Specs, and a little bad Class Diagram UML design of my, well, design. My Readme, had what you just mentioned, but also had a complete list of all the files, and all that files listed in each jar.