Skip to content

Commit

Permalink
update README.txt
Browse files Browse the repository at this point in the history
  • Loading branch information
[email protected] committed Feb 15, 2013
1 parent 70e86de commit 6f7fc18
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
-----
Expand All @@ -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

0 comments on commit 6f7fc18

Please sign in to comment.