From 6f7fc186a7954f4897c513e229a12e394a892fb1 Mon Sep 17 00:00:00 2001 From: "jeanmarc.vanel@gmail.com" Date: Fri, 15 Feb 2013 09:11:47 +0000 Subject: [PATCH] update README.txt --- README.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/README.txt b/README.txt index b5c0eb11..4aecb51b 100644 --- a/README.txt +++ b/README.txt @@ -5,6 +5,8 @@ Under the nars/ directory is the code Pei Wang originally moved into the project Later Joe Geldart started the open-nars version of NARS, which contains many good ideas (many of which are accepted into 1.5), but it isn't fully consistent with Pei's plan, especially about the new layers (7,8,9), so Pei didn't continue on that code base. nars-dist/ contains a NARS distribution (executable, examples, web page with applet), that could be zipped for releases. +In nars_core/ there is an embryo of a Maven project for pure reasoning non GUI NARS, currently having only the test suite. + Build ----- @@ -14,17 +16,22 @@ Test ---- The unit test suite is here. It ensures non-regression of the reasoner: nars_core/src/test/java/nars/main_nogui/TestReasoning.java -To create a new test input, add the NARS input as XX-in.txt in nars-dist/Examples , run the test suite, and move resulting file in temporary directory +It works classically: for each XX-in.txt in directory nars-dist/Examples, it runs NARBatch, and compares actual result with reference result XX-out.txt. +To create a new test input, add the NARS input as XX-in.txt in nars-dist/Examples , run the test suite, and move result file from temporary directory /tmp/nars_test/XX-out.txt into nars-dist/Example . +NOTE: +Due to the sensitivity of results regarding the implementation of the reasonner, it is difficult to write robust tests. But for pure non-regression tests, the test is usable. + Source Code status ------------------ See also http://code.google.com/p/open-nars/wiki/ProjectStatus -Version 1.5.0 hasn't been fully tested. Pei uploaded it before the new semester starts, otherwise he won't have the time to do so. He is updating the wiki and doing some testing and bug-fixing, but won't do any major change until May. +We are updating the wiki and doing some testing and bug-fixing, but there won't be any major change until May. +Next version 1.5.2 has been fully tested for single capability at a time; there may still be bugs when combining capabilities. +Current version 1.5.1 is already outdated; several bugs have been fixed. Jean-Marc Vanel is working on this short term roadmap, mainly in GUI and software engineering tasks : - 3. separe code for pure reasoning from GUI in different directories; for this remove dependencies towards packages main and gui from any other package; for this the simplest is applying the Model-View design pattern (aka publish-subscribe): the reasonner (Model) calls abstract listeners. - 4. make an independant syntax verityer based on a grammar parser : it will give the column & line of error (there is a Scala combinator grammar) -- 3. separe NARS in 2 modules with a Maven build : nars_gui and nars_core -- 4. write unit tests for the reasonner. Due to the sensitivity of results regarding the implementation of the reasonner, it is difficult to write robust tests. But for pure non non-regression tests , it is possible to reuse the in and out files in nars-dist/Examples . +- 5. separe NARS in 2 modules with a Maven build : nars_gui and nars_core