Rename and document files

arcadio · Jun 29, 2024 · 654a243 · 654a243
1 parent 1a00a16
commit 654a243
Show file tree

Hide file tree

Showing 9 changed files with 28 additions and 8 deletions.
diff --git a/constraint_language.pl → csl.pl b/constraint_language.pl → csl.pl
@@ -1,3 +1,8 @@
+%
+% Constraint-specification language, defined using a definite-clause
+% grammar (DCG).
+%
+
 %
 % DCG grammar
 %

diff --git a/grammar.pl → dcg.pl b/grammar.pl → dcg.pl
@@ -1,3 +1,7 @@
+%
+% Definite-clause grammar (DCG) prototype.
+%
+
 %
 % Rules
 %

diff --git a/dsl.pl b/dsl.pl
@@ -2,7 +2,7 @@
 % A domain-specific language (DSL) defining taxonomy and partonomy
 % operators and rules.
 %
-:- ensure_loaded('meta_dsl.pl').
+:- ensure_loaded('mdsl.pl').
 :- style_check(-discontiguous).
 
 

diff --git a/predicate_generator.pl → gen.pl b/predicate_generator.pl → gen.pl
@@ -1,3 +1,7 @@
+%
+% Alternative constraint-specification language definition.
+%
+
 %
 % Logical operators
 %

diff --git a/kb.pl b/kb.pl
@@ -2,9 +2,8 @@
 % An example knowledge base of pancreatic anatomy. Defines taxonomy,
 % partonomy and ad-hoc relations.
 %
-
 :- ensure_loaded('dsl.pl').
-:- ensure_loaded('constraint_language.pl').
+:- ensure_loaded('csl.pl').
 :- style_check(-discontiguous).
 
 

diff --git a/meta_dsl.pl → mdsl.pl b/meta_dsl.pl → mdsl.pl
diff --git a/meta_interpreters.pl → mint.pl b/meta_interpreters.pl → mint.pl
@@ -1,3 +1,7 @@
+%
+% Meta-interpreter experiments.
+%
+
 %
 % Basic knowledge for testing purposes
 %

diff --git a/readme.org b/readme.org
@@ -16,8 +16,8 @@ Developed and tested using [[https://swi-prolog.org][SWI-Prolog]].
 1. Evaluate ~[kb].~ to load a knowledge base example describing a
    pancreatic anatomy model.
 
-2. Evaluate ~[constraints].~ to verify a set of model constraints
-   expressed in natural language.
+2. Evaluate ~[spec].~ to verify a set of model constraints expressed
+   in natural language.
 
 * License
 

diff --git a/constraints.pl → spec.pl b/constraints.pl → spec.pl
@@ -1,16 +1,20 @@
-:- ensure_loaded('constraint_language.pl').
+%
+% Example model specification using constraints defined in a subset of
+% natural language.
+%
+:- ensure_loaded('csl.pl').
 
 
 %
-% General Constraints
+% General constraints
 %
 :- constraint([every, exocrine_cell, secretes, a, enzyme]).
 :- constraint([every, endocrine_cell, secretes, a, hormone]).
 :- constraint([every, pancreatic_cell, part_of, pancreas]).
 
 
 %
-% Model-specific Constraints
+% Model-specific constraints
 %
 :- constraint([every, cell, which, part_for, pancreas, secretes, a, substance]).
 :- constraint([pancreas, secretes, every, substance]).
-Original file line number
+Diff line change
@@ -1,3 +1,7 @@
+    %
+    % Definite-clause grammar (DCG) prototype.
+    %
     %
     % Rules
     %
@@ Expand Down @@