The subversion directory structure has /max/java, /max/js, and /max/jsui.

You can put the same kind of name/value table in a comment in the Java or Javascript source code as you would in C code. For example, here's the current name/value table for SDIF-menu2:


@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
NAME: SDIF-menu2
DESCRIPTION: Attractive tabular display of information from SDIF-fileinfo about the streams in an SDIF file. (jsui)
AUTHORS: Michael Zbyszynski
COPYRIGHT_YEARS: 2005-6
SVN_REVISION: $LastChangedRevision: 622 $
VERSION 0.5: This one can draw a little nicer.
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Releasing Javascript externals

Give your project folder a copy of a Makefile from another Javascript external in the repository, which should include makefile.per-nonobject. This makefile automates the release process. Say just "make" to create the download archive that people will get when they download this object. Note that it includes everything in your project folder, including subdirectories, except for a specific list of file types (according to extension and/or name) that won't be released. You can "opt out" specific files in the project folder, to make them not be released, by adding a line like this to your makefile:

MORE_EXCLUDE_FILES += not_to_be_released.txt also_not_to_be_released.pat

To release, just say make release.

(Note that there is no "build" process for Javascript externals---they're not compiled, but released as source code, which is then loaded into Max's "js" objects and interpreted.)

Building and Releasing Java externals

Give your project folder a copy of a Makefile from another Java external in the repository, which should include makefile.per-javaobject This makefile automates the build and release process. Say just "make" to compile the Java classes and create the download archive that people will get when they download this object. By default the download archive will contain any .class files in the folder plus the main help file. To "opt in" other files, add a line like this to your makefile:

MORE_RELEASE_FILES += also_release_me.txt ../../different-folder/in-the/repository/release-this-too.pat

You can say "make javaclasses" to compile the Java classes (using "javac"). So far this has only been tested on OSX. You can also say "make xcode" to open the Xcode project, if there is one.

Don't check the .class files into SVN, since they're derived automatically from the Java source.