Recent changes to Developing

WikiPage Developing modified by David Schmidt

David Schmidt — Fri, 09 Dec 2011 03:29:58 -0000

--- v3 
+++ v4 
@@ -12,7 +12,7 @@
 
 Download the Code
 -----------------
-The first step is to download the code.  See the [Downloads](https://sourceforge.net/projects/davex/files/) page for details on that.  You will do well to use a command-line version of [svn](http://subversion.apache.org/), or an IDE that incorporates it.
+The first step is to download the code.  See the [Code](http://sourceforge.net/p/davex/code/) page for details on that.  You will do well to use a command-line version of [svn](http://subversion.apache.org/), or an IDE that incorporates it.
 
 Prepare the Environment
 -----------------------

WikiPage Developing modified by David Schmidt

David Schmidt — Fri, 09 Dec 2011 03:27:43 -0000

--- v2 
+++ v3 
@@ -12,7 +12,7 @@
 
 Download the Code
 -----------------
-The first step is to download the code.  See the [Downloads] page for details on that.  You will do well to use a command-line version of [svn](http://subversion.apache.org/), or an IDE that incorporates it.
+The first step is to download the code.  See the [Downloads](https://sourceforge.net/projects/davex/files/) page for details on that.  You will do well to use a command-line version of [svn](http://subversion.apache.org/), or an IDE that incorporates it.
 
 Prepare the Environment
 -----------------------

WikiPage Developing modified by David Schmidt

David Schmidt — Fri, 09 Dec 2011 03:26:46 -0000

--- v1 
+++ v2 
@@ -1,8 +1,43 @@
 Developing Davex
 ================
 
-Developing Davex requires three main components to go from source code to disk images:
-
+Developing Davex used four main components to go from source code to disk images:
+
 *  [Ant](http://ant.apache.org/) - orchestrates the build process
 *  [Java SDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) - compiles Java-based server
-*  [cc65](http://www.cc65.org/) - a multiplatform toolchain with a nice 6502 macro assembler
+*  [cc65](http://www.cc65.org/) - a multiplatform toolchain with a nice 6502 macro assembler named ca65
+*  [AppleCommander](http://applecommander.sourceforge.net/) - a cross-platform virtual disk manipulation program
+
+You will need to have an IDE that incorporates these elements (the source tree is a ready-made project in [Eclipse](http://eclipse.org/downloads/)), or you can download the tools individually and just ensure that ant, Java, and ca65 are invokable from the command line.
+
+Download the Code
+-----------------
+The first step is to download the code.  See the [Downloads] page for details on that.  You will do well to use a command-line version of [svn](http://subversion.apache.org/), or an IDE that incorporates it.
+
+Prepare the Environment
+-----------------------
+Navigate to the build directory.  Copy the file named `Davex-default.properties` to a new file named `Davex.properties` in the same directory and modify it to point to the place where your ca65 executable lives.  For example:
+
+    assemblerPath=/usr/local/bin
+
+Ensure that you have the ca65 version V2.13.9 or later.
+
+Build
+-----
+Now you're ready to build.  All you need to do is type `ant` and the Ant build system will take over.  You should see output something like this (omitting lots of interesting details):
+
+    Buildfile: build.xml
+    clean:
+       [delete] Deleting directory obj
+    assemble:
+         [echo] Assembling Davex source...
+    builddsk:
+       [delete] Deleting: dist\DavexProDOS.dsk
+         [copy] Copying 1 file to dist
+         [echo] Copying files to ProDOS 5.25 disk image...
+         [echo] ProDOS 5.25 disk image complete.
+    all:
+    BUILD SUCCESSFUL
+    Total time: 20 seconds
+
+Once the build is successful, completed disk images should be in the `dist` directory.

WikiPage Developing modified by David Schmidt

David Schmidt — Fri, 09 Dec 2011 02:47:19 -0000

Developing Davex ================ Developing Davex requires three main components to go from source code to disk images: * [Ant](http://ant.apache.org/) - orchestrates the build process * [Java SDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) - compiles Java-based server * [cc65](http://www.cc65.org/) - a multiplatform toolchain with a nice 6502 macro assembler