Here are the instructions for building JHOVE. Lots of care is required.
- Update Jhove.java and JhoveView.java so that DATE and RELEASE reflect the current version.
- Update overview.html to reflect the current version in the JavaDoc.
- Run ant to build the latest jar files, and check all the jars in the bin directory into CVS.
- Update RELEASENOTES and README to document the newest version.
- Pick a directory to which you will check out a new copy of JHOVE for building.
-
cvs -z3 -d:ext:[username]@jhove.cvs.sourceforge.net:/cvsroot/jhove checkout jhove
- [that's your SourceForge username, of course. If you don't intend to check anything in, you can check it out anonymously with
-d:pserver:anonymous@jhove.cvs.sourceforge.net
]]
-
cd jhove
-
rm -r examples
-
ant
- [edit and test changes]
-
ant javadoc
(if the Javadoc needs updating)
-
cvs commit
(Needed only if ant javadoc has been done)
-
./packagejhove.sh 1_n
- [1_n is the version number, e.g., 1_8 for JHOVE 1.8]
- [Enter "I solemnly swear that I am up to no good" to confirm]
- [This replaces a lot of tedious steps in the old procedure]
- [save the checksum results for later posting]]
The next step is to release to SourceForge. The instructions below are current as of May 2013. SourceForge likes to seriously rearrange its user interface from time to time.
- Log on to SourceForge
- Go to JHOVE project and click “Files”
- Click on “jhove” folder
- Click the “Add Folder” button
- Enter folder name, e.g., JHOVE 1.n (Creating folders from sftp doesn’t seem to work)
- Upload the following files to the newly created folder, using the Web interface:
- jhove-1_n.tar.gz
- jhove-1_n.zip
- jhove-1_n.tar.gz.md5
- jhove-1_n.zip.md5
- jhove/RELEASENOTES
- jhove/README.txt
When it's done, send out appropriate notifications.
To build the OS X application, do the following:
- Run the application Jar Bundler. Apple keeps changing where you find it.
If you've installed Apple's developer tools, it may be in
/usr/share/java/Tools/
.
- Click the "Choose" button and select
bin/JhoveView.jar
, then
enter JhoveView
for the main class. Check all of "Use Macintosh
menu bar," "Anti-alias text," and "Anti-alias graphics." Set the JVM version
to "1.5+."
- Click "Choose icon..." and select
mac/jhove.icns
.
- Go to the "Properties" tab. Set the version to an appropriate
value, e.g., "1.10". Set Get-Info String to "JHOVE [version]", e.g.,
"JHOVE 1.10".
-
Click "Create Application..." and name the file to JHOVE_[version], replacing
the period with an underscore, e.g., "JHOVE_1_10". The extension ".app"
will be added automatically.
-
Zip the application. This is essential, since the application is really a folder
in disguise with a lot of files under it.
-
Upload the application to the "Files" page on SourceForge.