more documentation;
authorwenzelm
Wed, 25 Oct 2017 13:47:53 +0200
changeset 66916 aca50a1572c5
parent 66915 f4259adc928a
child 66917 fcf84cd6c94f
more documentation;
src/Doc/Isar_Ref/Outer_Syntax.thy
src/Doc/Isar_Ref/Spec.thy
src/Doc/System/Sessions.thy
--- a/src/Doc/Isar_Ref/Outer_Syntax.thy	Wed Oct 25 11:40:58 2017 +0200
+++ b/src/Doc/Isar_Ref/Outer_Syntax.thy	Wed Oct 25 13:47:53 2017 +0200
@@ -188,6 +188,9 @@
     ;
     @{syntax_def par_name}: '(' @{syntax name} ')'
   \<close>}
+
+  A @{syntax_def system_name} is like @{syntax name}, but it excludes
+  white-space characters and needs to conform to file-name notation.
 \<close>
 
 
--- a/src/Doc/Isar_Ref/Spec.thy	Wed Oct 25 11:40:58 2017 +0200
+++ b/src/Doc/Isar_Ref/Spec.thy	Wed Oct 25 13:47:53 2017 +0200
@@ -58,7 +58,8 @@
   such a global @{command (global) "end"}.
 
   @{rail \<open>
-    @@{command theory} @{syntax name} @'imports' (@{syntax name} +) \<newline>
+    @@{command theory} @{syntax system_name}
+      @'imports' (@{syntax system_name} +) \<newline>
       keywords? abbrevs? @'begin'
     ;
     keywords: @'keywords' (keyword_decls + @'and')
--- a/src/Doc/System/Sessions.thy	Wed Oct 25 11:40:58 2017 +0200
+++ b/src/Doc/System/Sessions.thy	Wed Oct 25 13:47:53 2017 +0200
@@ -52,11 +52,12 @@
     @{syntax_def session_chapter}: @'chapter' @{syntax name}
     ;
 
-    @{syntax_def session_entry}: @'session' spec '=' (@{syntax name} '+')? body
+    @{syntax_def session_entry}: @'session' spec '='
+      (@{syntax system_name} '+')? body
     ;
     body: description? options? (theories+) \<newline> (document_files*)
     ;
-    spec: @{syntax name} groups? dir?
+    spec: @{syntax system_name} groups? dir?
     ;
     groups: '(' (@{syntax name} +) ')'
     ;
@@ -70,11 +71,11 @@
     ;
     value: @{syntax name} | @{syntax real}
     ;
-    sessions: @'sessions' (@{syntax name}+)
+    sessions: @'sessions' (@{syntax system_name}+)
     ;
     theories: @'theories' opts? (theory_entry*)
     ;
-    theory_entry: @{syntax name} ('(' @'global' ')')?
+    theory_entry: @{syntax system_name} ('(' @'global' ')')?
     ;
     document_files: @'document_files' ('(' dir ')')? (@{syntax name}+)
   \<close>}