Changes between Version 27 and Version 28 of GnowsisDevelopingBeta

Timestamp:

07/27/06 12:43:00 (18 years ago)

Author:

anonymous

Comment:

--

GnowsisDevelopingBeta

@@ -14 +14 @@
 
 = Get it running =
-'''Detailed installation instructions for developers:''' DevelopingFirstSteps
+To get gnowsis running in development mode, do the following.
 
-Prerequisites:
- * Eclipse 3.1.0 (we all use it)
- * subclipse or any other subversion client
- * '''Java 1.5'''
+== Prerequisites ==
+
+'''Java 1.5'''
+You need Java 1.5. And we would recommend you download the SDK, not the JRE.
+
+'''Eclipse'''
+We recommend to use the Eclipse SDK for Java development of gnowsis. Our developers are using '''Eclipse 3.1.0''' at the moment, this proved to be a good choice. You can use 3.2, it should also work. The following plugins are good to have and are used by use:
+
+ * [http://subclipse.tigris.org/install.html subclipse] for subversion access
+ * !VisualEditor and GEF, install via default Exclipse update site.
+ * It's easier to use the central plugin directory. (see http://wiki.km.opendfki.de/EclipseHowTos)
+After getting [http://www.eclipse.org/ eclipse] running and having your [http://subclipse.tigris.org/install.html subclipse installed], you then checkout the current version of gnowsis.
+
+'''MacOS'''
+
+on MacOS it is wise to install JavaHL additionally, this is used by Subclipse, and subclipse will die if it is not there. [http://metissian.com/projects/macosx/subversion/ get metissian containing javahl here].
+
+== getting the code ==
 
 The subversion repository is 
@@ -59 +73 @@
  * The GnowsisInstaller will show. satisfy it.
  * pressing close. gnowsis installs now '''silently'''. stand up, take a breath. think of something positive. notice the new simplicity. tell somebody a nice thing. sit down again.
- * GnowsisProjectPlan - look here to see what we are doing at the moment and what will be done next.
 
-= Debugging =
+'''''Note''''': ''If above options do not show up in the "run" menu, then Eclipse has hickups. We then usually open the "navigator" view, go to the "gnowsis" project and double-click all "*.launch" files. That opens the launch files in the text editor and tells eclipse that the launch configurations exist. Then the launch files are available in the long list you see at "run...". Start gnowsis there using the '''Windows start gnowsis''' launch configuration (or alternative). After you have done this once, Eclipse will know and the launcher will be in your favorites.''
 
-Use Eclipse debugger to debug.
+= Understanding gnowsis =
+ * [UnderstandingGnowsis Understanding Gnowsis] read this document to know more about the parts of gnowsis and how they work together.
 
-Logging levels are set in this file:
-{{{.gnowsis-beta/config/logging.properties
+== Debugging ==
+
+Use Eclipse debugger to debug. 
+
+To set the general log level in gnowis, do that:
+{{{
+open .gnowsis-beta/config/workspace.xml
+
+change this line:
+ <LogLevel>INFO</LogLevel>
+allowed levels are all java.util.logging.Level levels: SEVERE, WARNING, INFO, FINE, FINER, FINEST
+}}}
+
+Individual logging levels are set in this file:
+{{{
+.gnowsis-beta/config/logging.properties
 
 # add this to bottom
@@ -73 +101 @@
 }}}
 
-= Specific Fields of Development =
+== Specific Fields of Development ==
 alphabetically
  * AdapterDeveloping - how to write an adapter and make gnowsis use it?
@@ -95 +123 @@
 = Contributing = 
 
-The first thing you might want to do is to write your own datasource, Gnowsis can deploy your own datasources without having to change the gnowsis code: See DynamicDatasources for more information! '''Then JoinGnowsis. '''
+The first thing you might want to do is to write your own datasource, Gnowsis can deploy your own datasources without having to change the gnowsis code: See DynamicDatasources for more information! Also, you may be interested to improve gnowsis and help fixing broken code, look at  bugtracker: report:1. '''Then JoinGnowsis. '''