added the "scope" function

9 files changed, 36 insertions, 12 deletions

diff --git a/docs/help.txt b/docs/help.txt
index c0fbcdc..584924e 100644
--- a/docs/help.txt
+++ b/docs/help.txt
@@ -1,4 +1,4 @@
-Fype v0.1-devel Build 9260
+Fype v0.1-devel Build 9276
 (c) Paul C. Buetow (2005 - 2008) <fype@dev.buetow.org>
 	-e	Executes given code string (see synopses)
 	-h	Prints this help
diff --git a/docs/pod/fype.1.gz b/docs/pod/fype.1.gz
index 64bebfb..164c95c 100644
--- a/docs/pod/fype.1.gz
+++ b/docs/pod/fype.1.gz
diff --git a/docs/pod/fype.html b/docs/pod/fype.html
index 6400295..0a709bb 100644
--- a/docs/pod/fype.html
+++ b/docs/pod/fype.html
@@ -228,7 +228,7 @@ TODO file of the source distribution of Fype!</p>
 <p>
 </p>
 <h2><a name="scopeing">Scopeing</a></h2>
-<p>A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings. Here is a small example how to use scopes:</p>
+<p>A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings.  The <strong>scope</strong> function will print out all available symbols at the current position. Here is a small example of how to use scopes:</p>
 <pre>
         my foo = 1;</pre>
 <pre>
@@ -239,7 +239,11 @@ TODO file of the source distribution of Fype!</p>
                         my bar = 2;</pre>
 <pre>
                         # Prints out 1
-                        put defined bar;
+                        put defined bar;</pre>
+<pre>
+                        # Prints out all available symbols at this
+                        # point to stdout. Those are: bar and foo
+                        scope;
                 }</pre>
 <pre>
                 # Prints out 0
diff --git a/docs/pod/fype.man b/docs/pod/fype.man
index 36f3ef2..e9b95a7 100644
--- a/docs/pod/fype.man
+++ b/docs/pod/fype.man
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "FYPE 1"
-.TH FYPE 1 "2008-10-19" "Fype v0.1-devel Build 9240" "The Fype Users Manual Page"
+.TH FYPE 1 "2008-10-26" "Fype v0.1-devel Build 9276" "The Fype Users Manual Page"
 .SH "NAME"
 \&\fBFype\fR is \fBF\fRor \fBY\fRour \fBP\fRrogram \fBE\fRxecution
 .PP
@@ -257,7 +257,7 @@ A Fype program is a list of statements. Each keyword, expression or function cal
 All paranthesis of function calls are optional. They help to make the code better readable. They also help to force precedences of expressions.
 .Sh "Scopeing"
 .IX Subsection "Scopeing"
-A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings. Here is a small example how to use scopes:
+A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings.  The \fBscope\fR function will print out all available symbols at the current position. Here is a small example of how to use scopes: 
 .PP
 .Vb 1
 \&        my foo = 1;
@@ -271,9 +271,15 @@ A new scope starts with an { and ends with an }. An exception is a procedure, wh
 \&                        my bar = 2;
 .Ve
 .PP
-.Vb 3
+.Vb 2
 \&                        # Prints out 1
 \&                        put defined bar;
+.Ve
+.PP
+.Vb 4
+\&                        # Prints out all available symbols at this
+\&                        # point to stdout. Those are: bar and foo
+\&                        scope;
 \&                }
 .Ve
 .PP
diff --git a/docs/pod/fype.pod b/docs/pod/fype.pod
index 1e29a6d..5006345 100644
--- a/docs/pod/fype.pod
+++ b/docs/pod/fype.pod
@@ -144,7 +144,7 @@ All paranthesis of function calls are optional. They help to make the code bette
 
 =head2 Scopeing
 
-A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings. Here is a small example how to use scopes:
+A new scope starts with an { and ends with an }. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings.  The B<scope> function will print out all available symbols at the current position. Here is a small example of how to use scopes: 
 
 	my foo = 1;
 
@@ -156,6 +156,10 @@ A new scope starts with an { and ends with an }. An exception is a procedure, wh
 
 			# Prints out 1
 			put defined bar;
+
+			# Prints out all available symbols at this
+			# point to stdout. Those are: bar and foo
+			scope;
 		}
 
 		# Prints out 0
diff --git a/docs/pod/fype.tex b/docs/pod/fype.tex
index 8bdd585..7609a00 100644
--- a/docs/pod/fype.tex
+++ b/docs/pod/fype.tex
@@ -179,7 +179,7 @@ All paranthesis of function calls are optional. They help to make the code bette
 \subsection*{Scopeing\label{Scopeing}\index{Scopeing}}
 
 
-A new scope starts with an \{ and ends with an \}. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings. Here is a small example how to use scopes:
+A new scope starts with an \{ and ends with an \}. An exception is a procedure, which does not use its own scope (see later in this manual). Control statements and functions support scopeings.  The \textbf{scope} function will print out all available symbols at the current position. Here is a small example of how to use scopes:
 
 \begin{verbatim}
         my foo = 1;
@@ -194,6 +194,11 @@ A new scope starts with an \{ and ends with an \}. An exception is a procedure,
 \begin{verbatim}
                         # Prints out 1
                         put defined bar;
+\end{verbatim}
+\begin{verbatim}
+                        # Prints out all available symbols at this
+                        # point to stdout. Those are: bar and foo
+                        scope;
                 }
 \end{verbatim}
 \begin{verbatim}
diff --git a/docs/pod/fype.txt b/docs/pod/fype.txt
index 4e82ce6..a6be7b8 100644
--- a/docs/pod/fype.txt
+++ b/docs/pod/fype.txt
@@ -134,8 +134,9 @@ SYNTAX
   Scopeing
     A new scope starts with an { and ends with an }. An exception is a
     procedure, which does not use its own scope (see later in this manual).
-    Control statements and functions support scopeings. Here is a small
-    example how to use scopes:
+    Control statements and functions support scopeings. The scope function
+    will print out all available symbols at the current position. Here is a
+    small example of how to use scopes:
 
             my foo = 1;
 
@@ -147,6 +148,10 @@ SYNTAX
 
                             # Prints out 1
                             put defined bar;
+
+                            # Prints out all available symbols at this
+                            # point to stdout. Those are: bar and foo
+                            scope;
                     }
 
                     # Prints out 0
diff --git a/docs/stats.txt b/docs/stats.txt
index 163f9b6..dd0d237 100644
--- a/docs/stats.txt
+++ b/docs/stats.txt
@@ -1,4 +1,4 @@
 ===> Num of C source files		:       42
-===> Num of C source lines		:     7577 
+===> Num of C source lines		:     7689 
 ===> Num of Fype source examples	:       14
 ===> Num of Fype source lines		:      358 
diff --git a/docs/version.txt b/docs/version.txt
index c263f95..e9c3078 100644
--- a/docs/version.txt
+++ b/docs/version.txt
@@ -1 +1 @@
-Fype v0.1-devel Build 9260
+Fype v0.1-devel Build 9276