synonyms work

9 files changed, 83 insertions, 6 deletions

diff --git a/docs/help.txt b/docs/help.txt
index ad6748e..0e73284 100644
--- a/docs/help.txt
+++ b/docs/help.txt
@@ -1,4 +1,4 @@
-Fype v0.1-devel Build 9215
+Fype v0.1-devel Build 9219
 Copyright by 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 e05d4c5..e39eee0 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 b88a1b4..02c30c4 100644
--- a/docs/pod/fype.html
+++ b/docs/pod/fype.html
@@ -38,6 +38,7 @@
 	</ul>
 
 	<li><a href="#variables">VARIABLES</a></li>
+	<li><a href="#synonyms_to_variables_identifiers">SYNONYMS TO VARIABLES/IDENTIFIERS</a></li>
 	<li><a href="#built_in_functions">BUILT IN FUNCTIONS</a></li>
 	<ul>
 
@@ -310,6 +311,19 @@ not.</p>
 <p>
 </p>
 <hr />
+<h1><a name="synonyms_to_variables_identifiers">SYNONYMS TO VARIABLES/IDENTIFIERS</a></h1>
+<p>Each variable can have as many synonyms as wished. A synonym is another name to access the content of a specific variable. Here is an example of how to use synomyms:</p>
+<pre>
+        my foo = &quot;foo&quot;;
+        my bar = \foo;
+        foo = &quot;bar&quot;;</pre>
+<pre>
+        # The synonym variable should now also set to &quot;bar&quot;
+        assert &quot;bar&quot; == bar;</pre>
+<p>Synonyms can be used for all kind of identifiers. It's not limited to normal variables but can be also used for function and procedure names etc.</p>
+<p>
+</p>
+<hr />
 <h1><a name="built_in_functions">BUILT IN FUNCTIONS</a></h1>
 <p>In Fype, operators are built in functions as well. The difference is, that they may be written in infix notation instead in front of the arguments. The types inside the () specify the return types.</p>
 <p>
diff --git a/docs/pod/fype.man b/docs/pod/fype.man
index b3d89bf..42daf43 100644
--- a/docs/pod/fype.man
+++ b/docs/pod/fype.man
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "FYPE 1"
-.TH FYPE 1 "2008-09-06" "Fype v0.1-devel Build 9208" "The Fype Users Manual Page"
+.TH FYPE 1 "2008-10-19" "Fype v0.1-devel Build 9219" "The Fype Users Manual Page"
 .SH "NAME"
 \&\fBFype\fR is \fBF\fRor \fBY\fRour \fBP\fRrogram \fBE\fRxecution
 .PP
@@ -345,6 +345,22 @@ not.
 \&                say foo;
 \&        }
 .Ve
+.SH "SYNONYMS TO VARIABLES/IDENTIFIERS"
+.IX Header "SYNONYMS TO VARIABLES/IDENTIFIERS"
+Each variable can have as many synonyms as wished. A synonym is another name to access the content of a specific variable. Here is an example of how to use synomyms:
+.PP
+.Vb 3
+\&        my foo = "foo";
+\&        my bar = \efoo;
+\&        foo = "bar";
+.Ve
+.PP
+.Vb 2
+\&        # The synonym variable should now also set to "bar"
+\&        assert "bar" == bar;
+.Ve
+.PP
+Synonyms can be used for all kind of identifiers. It's not limited to normal variables but can be also used for function and procedure names etc.
 .SH "BUILT IN FUNCTIONS"
 .IX Header "BUILT IN FUNCTIONS"
 In Fype, operators are built in functions as well. The difference is, that they may be written in infix notation instead in front of the arguments. The types inside the () specify the return types.
diff --git a/docs/pod/fype.pod b/docs/pod/fype.pod
index 2e41645..2773c4e 100644
--- a/docs/pod/fype.pod
+++ b/docs/pod/fype.pod
@@ -219,6 +219,19 @@ not.
 		say foo;
 	}
 
+=head1 SYNONYMS TO VARIABLES/IDENTIFIERS
+
+Each variable can have as many synonyms as wished. A synonym is another name to access the content of a specific variable. Here is an example of how to use synomyms:
+
+	my foo = "foo";
+	my bar = \foo;
+	foo = "bar";
+
+	# The synonym variable should now also set to "bar"
+	assert "bar" == bar;
+
+Synonyms can be used for all kind of identifiers. It's not limited to normal variables but can be also used for function and procedure names etc.
+
 =head1 BUILT IN FUNCTIONS
 
 In Fype, operators are built in functions as well. The difference is, that they may be written in infix notation instead in front of the arguments. The types inside the () specify the return types.
diff --git a/docs/pod/fype.tex b/docs/pod/fype.tex
index bcdea5f..19fa9f2 100644
--- a/docs/pod/fype.tex
+++ b/docs/pod/fype.tex
@@ -272,6 +272,24 @@ not.
                 say foo;
         }
 \end{verbatim}
+\section{SYNONYMS TO VARIABLES/IDENTIFIERS\label{SYNONYMS_TO_VARIABLES_IDENTIFIERS}\index{SYNONYMS TO VARIABLES/IDENTIFIERS}}
+
+
+Each variable can have as many synonyms as wished. A synonym is another name to access the content of a specific variable. Here is an example of how to use synomyms:
+
+\begin{verbatim}
+        my foo = "foo";
+        my bar = \foo;
+        foo = "bar";
+\end{verbatim}
+\begin{verbatim}
+        # The synonym variable should now also set to "bar"
+        assert "bar" == bar;
+\end{verbatim}
+
+
+Synonyms can be used for all kind of identifiers. It's not limited to normal variables but can be also used for function and procedure names etc.
+
 \section{BUILT IN FUNCTIONS\label{BUILT_IN_FUNCTIONS}\index{BUILT IN FUNCTIONS}}
 
 
diff --git a/docs/pod/fype.txt b/docs/pod/fype.txt
index 66a9695..5c8b9b6 100644
--- a/docs/pod/fype.txt
+++ b/docs/pod/fype.txt
@@ -205,6 +205,22 @@ VARIABLES
                     say foo;
             }
 
+SYNONYMS TO VARIABLES/IDENTIFIERS
+    Each variable can have as many synonyms as wished. A synonym is another
+    name to access the content of a specific variable. Here is an example of
+    how to use synomyms:
+
+            my foo = "foo";
+            my bar = \foo;
+            foo = "bar";
+
+            # The synonym variable should now also set to "bar"
+            assert "bar" == bar;
+
+    Synonyms can be used for all kind of identifiers. It's not limited to
+    normal variables but can be also used for function and procedure names
+    etc.
+
 BUILT IN FUNCTIONS
     In Fype, operators are built in functions as well. The difference is,
     that they may be written in infix notation instead in front of the
diff --git a/docs/stats.txt b/docs/stats.txt
index b49fcc8..ffca974 100644
--- a/docs/stats.txt
+++ b/docs/stats.txt
@@ -1,4 +1,4 @@
 ===> Num of C source files		:       42
-===> Num of C source lines		:     7460 
-===> Num of Fype source examples	:       13
-===> Num of Fype source lines		:      321 
+===> Num of C source lines		:     7482 
+===> Num of Fype source examples	:       14
+===> Num of Fype source lines		:      353 
diff --git a/docs/version.txt b/docs/version.txt
index 41b77c9..84a6485 100644
--- a/docs/version.txt
+++ b/docs/version.txt
@@ -1 +1 @@
-Fype v0.1-devel Build 9215
+Fype v0.1-devel Build 9219