-code_swarm is an experiment in organic software visualization.\r
-\r
-See http://vis.cs.ucdavis.edu/~ogawa/codeswarm for a picture of what we want\r
-to produce.\r
-\r
-Google Code Project : http://code.google.com/p/codeswarm/\r
-Google Group/Mailing List: http://groups.google.com/group/codeswarm \r
-\r
-\r
-I) How to build Java code_swarm in different environments.\r
-\r
-Please visit http://code.google.com/p/codeswarm/wiki/HowtoBuild for more \r
-detailed and up-to-date information.\r
-\r
-This quick guide explains how to setup your development environment to build\r
-the binary (ie. jar) version of code_swarm from Java sources.\r
-Explanations require at least an understanding of computing and of your\r
-Operating System, even if no Java skills are needed.\r
-\r
-I.1) Setup\r
-You will need the "Ant" software building tool, and Sun's Java Development Kit,\r
-version 1.5 or later (OpenJDK may work but is untested).\r
-\r
-I.1.a) Linux\r
-This guide is written with a Debian based Linux, Ubuntu 8.04. It requires\r
-some minor adaptation to use on other distribution (other packaging systems).\r
-\r
- * install ant with the following command (or with your favorite graphical \r
- package manager):\r
- sudo apt-get install ant \r
-\r
- * install sun-java-jdk 1.5 or 1.6 following your distribution recommendation \r
- sudo apt-get install sun-java6-jdk \r
-\r
- * configure the Java SDK to specify the new installation path, for instance \r
- on Ubuntu: \r
- sudo update-java-alternatives -s java-6-sun \r
-\r
- See http://doc.ubuntu-fr.org/java\r
-\r
-I.1.b) Windows\r
- * download ant for all platforms at http://ant.apache.org/bindownload.cgi\r
-\r
- * unpack it where you want it to be installed, and add the location of\r
- its binaries to the the "PATH" environment variable. For instance,\r
- add at the end : "C:\apache-ant-1.7.0\bin;"\r
-\r
- * download Sun Java SDK at http://java.sun.com/javase/downloads/index.jsp\r
-\r
- * install it and add the "javac" Java compiler to the PATH : \r
- "C:\Program Files\Java\jdk1.6.0_06\bin;" \r
-\r
- * then create a new environment variable called JAVA_HOME and set its path to \r
- something like "C:\Program Files\Java\jdk1.6.X", where X is the specific\r
- version number.\r
-\r
-I.2) Getting the sources\r
-\r
-code_swarm sources are under a Google Code Subversion repository (svn) :\r
-http://codeswarm.googlecode.com/svn/trunk/\r
-\r
-See the Subversion homepage on subversion.tigris.org for all appropriate tools \r
-and documents. I would recommend "TortoiseSVN" for Windows users. \r
-Unix-like users should get their native "Subversion" package.\r
-\r
-See http://code.google.com/p/codeswarm/source/ for further instructions on\r
-how to browse and checkout the sources.\r
-\r
-I.3) Building the sources\r
-\r
-Quick build :\r
- * Open a terminal/command line shell, change directory to the root of\r
- the code_swarm source folder.\r
-\r
- * Compile the sources by typing "ant".\r
-\r
-\r
-\r
-\r
-Other commands :\r
- * "ant all" will also generate the Javadoc HTML sources documentation\r
- * "ant clean" will delete all intermediate and binary files \r
-\r
-I.4) Running code_swarm\r
-\r
-These instructions are meant to be generic to cover most popular version\r
-control systems.\r
-Please visit http://code.google.com/p/codeswarm/wiki/GeneratingAVideo for more \r
-detailed and up-to-date information.\r
-\r
- * Obtain the log from your software version control system.\r
- Save it as a text file.\r
-\r
- * Convert your log file to the code_swarm XML data format:\r
- Change directory to "convert_logs."\r
- Generally, the syntax is:\r
-\r
- convert_logs.py -Y input_log.txt -o output.xml\r
-\r
- where -Y is a flag for your particular version control system.\r
- Type "convert_logs.py --help" for details.\r
-\r
- * Create your own configuration by copying "data/sample.config" and editing \r
- it to your preferences.\r
-\r
- * To launch code_swarm, type "run.bat" in Windows or "run.sh" in Unix.\r
- You will be prompted for the config file from the previous step.\r
-\r
- * If you have specified TakeSnapshots=true in the config, saved images\r
- will be in the "frames" directory.\r
+code_swarm is an experiment in organic software visualization.
+
+See http://vis.cs.ucdavis.edu/~ogawa/codeswarm for a picture of what we want
+to produce.
+
+Google Code Project : http://code.google.com/p/codeswarm/
+Google Group/Mailing List: http://groups.google.com/group/codeswarm
+
+
+I) How to build Java code_swarm in different environments.
+
+Please visit http://code.google.com/p/codeswarm/wiki/HowtoBuild for more
+detailed and up-to-date information.
+
+This quick guide explains how to setup your development environment to build
+the binary (ie. jar) version of code_swarm from Java sources.
+Explanations require at least an understanding of computing and of your
+Operating System, even if no Java skills are needed.
+
+I.1) Setup
+You will need the "Ant" software building tool, and Sun's Java Development Kit,
+version 1.5 or later (OpenJDK may work but is untested).
+
+I.1.a) Linux
+This guide is written with a Debian based Linux, Ubuntu 8.04. It requires
+some minor adaptation to use on other distribution (other packaging systems).
+
+ * install ant with the following command (or with your favorite graphical
+ package manager):
+ sudo apt-get install ant
+
+ * install sun-java-jdk 1.5 or 1.6 following your distribution recommendation
+ sudo apt-get install sun-java6-jdk
+
+ * configure the Java SDK to specify the new installation path, for instance
+ on Ubuntu:
+ sudo update-java-alternatives -s java-6-sun
+
+ See http://doc.ubuntu-fr.org/java
+
+I.1.b) Windows
+ * download ant for all platforms at http://ant.apache.org/bindownload.cgi
+
+ * unpack it where you want it to be installed, and add the location of
+ its binaries to the the "PATH" environment variable. For instance,
+ add at the end : "C:\apache-ant-1.7.0\bin;"
+
+ * download Sun Java SDK at http://java.sun.com/javase/downloads/index.jsp
+
+ * install it and add the "javac" Java compiler to the PATH :
+ "C:\Program Files\Java\jdk1.6.0_06\bin;"
+
+ * then create a new environment variable called JAVA_HOME and set its path to
+ something like "C:\Program Files\Java\jdk1.6.X", where X is the specific
+ version number.
+
+I.2) Getting the sources
+
+code_swarm sources are under a Google Code Subversion repository (svn) :
+http://codeswarm.googlecode.com/svn/trunk/
+
+See the Subversion homepage on subversion.tigris.org for all appropriate tools
+and documents. I would recommend "TortoiseSVN" for Windows users.
+Unix-like users should get their native "Subversion" package.
+
+See http://code.google.com/p/codeswarm/source/ for further instructions on
+how to browse and checkout the sources.
+
+I.3) Building the sources
+
+Quick build :
+ * Open a terminal/command line shell, change directory to the root of
+ the code_swarm source folder.
+
+ * Compile the sources by typing "ant".
+
+
+
+
+Other commands :
+ * "ant all" will also generate the Javadoc HTML sources documentation
+ * "ant clean" will delete all intermediate and binary files
+
+I.4) Running code_swarm
+
+These instructions are meant to be generic to cover most popular version
+control systems.
+Please visit http://code.google.com/p/codeswarm/wiki/GeneratingAVideo for more
+detailed and up-to-date information.
+
+ * Obtain the log from your software version control system.
+ Save it as a text file.
+
+ * Convert your log file to the code_swarm XML data format:
+ Change directory to "convert_logs."
+ Generally, the syntax is:
+
+ convert_logs.py -Y input_log.txt -o output.xml
+
+ where -Y is a flag for your particular version control system.
+ Type "convert_logs.py --help" for details.
+
+ * Create your own configuration by copying "data/sample.config" and editing
+ it to your preferences.
+
+ * To launch code_swarm, type "run.bat" in Windows or "run.sh" in Unix.
+ You will be prompted for the config file from the previous step.
+
+ * If you have specified TakeSnapshots=true in the config, saved images
+ will be in the "frames" directory.
projects / mailer.git / blobdiff