summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2021-05-11 19:12:55 +0100
committerPaul Buetow <git@mx.buetow.org>2021-05-21 05:11:04 +0100
commit4759474eb99652ec602a8ef65c4f13fd258b8a33 (patch)
treea215ad3eecdcf195ed48e6604a0838d2c8a93cce
parenta550379d2e90f05599b2e5a4bbc75bd3a070c35f (diff)
initial markdown works
-rwxr-xr-xbuetow.org.sh158
-rw-r--r--content/md/contact-information.md38
-rw-r--r--content/md/favicon.icobin0 -> 1077 bytes
-rw-r--r--content/md/gemfeed/2008-06-26-perl-poetry.md166
-rw-r--r--content/md/gemfeed/2010-05-09-the-fype-programming-language.md511
-rw-r--r--content/md/gemfeed/2011-05-07-perl-daemon-service-framework.md163
-rw-r--r--content/md/gemfeed/2016-04-03-offsite-backup-with-zfs.md42
-rw-r--r--content/md/gemfeed/2016-04-16-offsite-backup-with-zfs-part2.md30
-rw-r--r--content/md/gemfeed/2016-05-22-spinning-up-my-own-authoritative-dns-servers.md239
-rw-r--r--content/md/gemfeed/2016-11-20-methods-in-c.md86
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux.draft.md191
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure1-ioriot-io-recording.pngbin0 -> 220247 bytes
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure2-ioriot-test-preparation.pngbin0 -> 208235 bytes
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure3-ioriot-replay.pngbin0 -> 417034 bytes
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure4-ioriot-read-latency.pngbin0 -> 39552 bytes
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure5-ioriot-write-latency.pngbin0 -> 26547 bytes
-rw-r--r--content/md/gemfeed/2018-06-01-realistic-load-testing-with-ioriot-for-linux/figure6-iostat.pngbin0 -> 294346 bytes
-rw-r--r--content/md/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.md108
-rw-r--r--content/md/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program/dgrep.gifbin0 -> 142329 bytes
-rw-r--r--content/md/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program/dtail-logo.pngbin0 -> 13787 bytes
-rw-r--r--content/md/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program/dtail.gifbin0 -> 1984520 bytes
-rw-r--r--content/md/gemfeed/2021-04-24-welcome-to-the-geminispace.md78
-rw-r--r--content/md/gemfeed/2021-04-24-welcome-to-the-geminispace/amfora-screenshot.pngbin0 -> 154951 bytes
-rw-r--r--content/md/gemfeed/2021-05-15-buetow.org.sh-One-Bash-script-to-rule-it-all.draft.md183
-rw-r--r--content/md/gemfeed/index.md13
-rw-r--r--content/md/index.md63
-rw-r--r--content/md/resources.md118
27 files changed, 2120 insertions, 67 deletions
diff --git a/buetow.org.sh b/buetow.org.sh
index ae57c8e6..356c39a5 100755
--- a/buetow.org.sh
+++ b/buetow.org.sh
@@ -121,7 +121,7 @@ atomfeed::content () {
# sed: Remove all before the first header
# sed: Make HTML links absolute, Atom relative URLs feature seems a mess
# across different Atom clients.
- html::gemini2html < <($SED '0,/^# / { /^# /!d; }' "$gmi_file_path") |
+ html::fromgmi < <($SED '0,/^# / { /^# /!d; }' "$gmi_file_path") |
$SED "
s|href=\"\./|href=\"https://$DOMAIN/gemfeed/|g;
s|src=\"\./|src=\"https://$DOMAIN/gemfeed/|g;
@@ -185,9 +185,9 @@ ATOMFOOTER
fi
}
-## Generic module
+## Generic generate module
-generic::link () {
+generate::link () {
local -r what="$1"; shift
local -r line="${1/=> }"; shift
local link
@@ -204,21 +204,74 @@ generic::link () {
done < <(echo "$line" | tr ' ' '\n')
if grep -E -q "$IMAGE_PATTERN" <<< "$link"; then
- if [ $what == markdown ]; then
- markdown::img "$link" "$descr"
+ if [ $what == md ]; then
+ md::img "$link" "$descr"
else
html::img "$link" "$(html::special "$descr")"
fi
return
fi
- if [ $what == markdown ]; then
- markdown::link "$link" "$descr"
+ if [ $what == md ]; then
+ md::link "$link" "$descr"
else
html::link "$link" "$(html::special "$descr")"
fi
}
+generate::fromgmi () {
+ find $CONTENT_DIR/gemtext -type f -name \*.gmi |
+ while read -r src; do
+ for format in "$@"; do
+ local dest=${src/gemtext/$format}
+ dest=${dest/.gmi/.$format}
+ local dest_dir=$(dirname "$dest")
+ test ! -d "$dest_dir" && mkdir -p "$dest_dir"
+
+ if [ $format == html ]; then
+ cat header.html.part > "$dest.tmp"
+ html::fromgmi < "$src" >> "$dest.tmp"
+ cat footer.html.part >> "$dest.tmp"
+ elif [ $format == md ]; then
+ md::fromgmi < "$src" >> "$dest.tmp"
+ fi
+
+ mv "$dest.tmp" "$dest"
+ test "$ADD_GIT" == yes && git add "$dest"
+ done
+ done
+
+ # Add non-.gmi files to html dir.
+ find $CONTENT_DIR/gemtext -type f | grep -E -v '(.gmi|atom.xml|.tmp)$' |
+ while read -r src; do
+ for format in "$@"; do
+ local dest=${src/gemtext/$format}
+ local dest_dir=$(dirname "$dest")
+
+ test ! -d "$dest_dir" && mkdir -p "$dest_dir"
+ cp -v "$src" "$dest"
+ test "$ADD_GIT" == yes && git add "$dest"
+ done
+ done
+
+ # Add atom feed for HTML
+ for format in "$@"; do
+ test $format != html && continue
+ $SED 's|.gmi|.html|g; s|gemini://|https://|g' \
+ < $CONTENT_DIR/gemtext/gemfeed/atom.xml \
+ > $CONTENT_DIR/html/gemfeed/atom.xml
+ test "$ADD_GIT" == yes && git add $CONTENT_DIR/html/gemfeed/atom.xml
+ done
+
+ # Remove obsolete files from ./html/
+ for format in "$@"; do
+ find $CONTENT_DIR/$format -type f | while read -r src; do
+ local dest=${src/.$format/.gmi}
+ dest=${dest/$format/gemtext}
+ test ! -f "$dest" && test "$ADD_GIT" == yes && git rm "$src"
+ done
+ done
+}
## HTML module
@@ -270,7 +323,7 @@ html::link () {
echo "<a class=\"textlink\" href=\"$link\">$descr</a><br />"
}
-html::gemini2html () {
+html::fromgmi () {
local -r gmi_file=$1
local -i is_list=0
local -i is_plain=0
@@ -318,7 +371,7 @@ html::gemini2html () {
html::quote "$line"
;;
'=> '*)
- generic::link html "$line"
+ generate::link html "$line"
;;
*)
html::paragraph "$line"
@@ -327,46 +380,6 @@ html::gemini2html () {
done
}
-html::generate () {
- find $CONTENT_DIR/gemtext -type f -name \*.gmi |
- while read -r src; do
- local dest=${src/gemtext/html}
- dest=${dest/.gmi/.html}
- local dest_dir=$(dirname "$dest")
- test ! -d "$dest_dir" && mkdir -p "$dest_dir"
-
- cat header.html.part > "$dest.tmp"
- html::gemini2html < "$src" >> "$dest.tmp"
- cat footer.html.part >> "$dest.tmp"
- mv "$dest.tmp" "$dest"
- test "$ADD_GIT" == yes && git add "$dest"
- done
-
- # Add non-.gmi files to html dir.
- find $CONTENT_DIR/gemtext -type f | grep -E -v '(.gmi|atom.xml|.tmp)$' |
- while read -r src; do
- local dest=${src/gemtext/html}
- local dest_dir=$(dirname "$dest")
-
- test ! -d "$dest_dir" && mkdir -p "$dest_dir"
- cp -v "$src" "$dest"
- test "$ADD_GIT" == yes && git add "$dest"
- done
-
- # Add atom feed for HTML
- $SED 's|.gmi|.html|g; s|gemini://|https://|g' \
- < $CONTENT_DIR/gemtext/gemfeed/atom.xml \
- > $CONTENT_DIR/html/gemfeed/atom.xml
- test "$ADD_GIT" == yes && git add $CONTENT_DIR/html/gemfeed/atom.xml
-
- # Remove obsolete files from ./html/
- find $CONTENT_DIR/html -type f | while read -r src; do
- local dest=${src/.html/.gmi}
- dest=${dest/html/gemtext}
- test ! -f "$dest" && test "$ADD_GIT" == yes && git rm "$src"
- done
-}
-
html::test () {
local line='Hello world! This is a paragraph.'
assert::equals "$(html::paragraph "$line")" '<p>Hello world! This is a paragraph.</p>'
@@ -390,29 +403,29 @@ html::test () {
assert::equals "$(html::quote "$line")" '<pre>This is a quote</pre>'
line='=> https://example.org'
- assert::equals "$(generic::link html "$line")" \
+ assert::equals "$(generate::link html "$line")" \
'<a class="textlink" href="https://example.org">https://example.org</a><br />'
line='=> index.gmi'
- assert::equals "$(generic::link html "$line")" \
+ assert::equals "$(generate::link html "$line")" \
'<a class="textlink" href="index.html">index.html</a><br />'
line='=> http://example.org Description of the link'
- assert::equals "$(generic::link html "$line")" \
+ assert::equals "$(generate::link html "$line")" \
'<a class="textlink" href="http://example.org">Description of the link</a><br />'
line='=> http://example.org/image.png'
- assert::equals "$(generic::link html "$line")" \
+ assert::equals "$(generate::link html "$line")" \
'<a href="http://example.org/image.png"><img src="http://example.org/image.png" /></a><br />'
line='=> http://example.org/image.png Image description'
- assert::equals "$(generic::link html "$line")" \
+ assert::equals "$(generate::link html "$line")" \
'<i>Image description:</i><a href="http://example.org/image.png"><img alt="Image description" title="Image description" src="http://example.org/image.png" /></a><br />'
}
-## Markdown module
+## md module
-markdown::img () {
+md::img () {
local link="$1"; shift
local descr="$1"; shift
@@ -423,7 +436,7 @@ markdown::img () {
fi
}
-markdown::link () {
+md::link () {
local link="$1"; shift
local descr="$1"; shift
@@ -433,28 +446,40 @@ markdown::link () {
echo "[$descr]($link)"
}
-markdown::test () {
+md::test () {
local line='=> https://example.org'
- assert::equals "$(generic::link markdown "$line")" \
+ assert::equals "$(generate::link md "$line")" \
'[https://example.org](https://example.org)'
line='=> index.md'
- assert::equals "$(generic::link markdown "$line")" \
+ assert::equals "$(generate::link md "$line")" \
'[index.md](index.md)'
line='=> http://example.org Description of the link'
- assert::equals "$(generic::link markdown "$line")" \
+ assert::equals "$(generate::link md "$line")" \
'[Description of the link](http://example.org)'
line='=> http://example.org/image.png'
- assert::equals "$(generic::link markdown "$line")" \
+ assert::equals "$(generate::link md "$line")" \
'[![http://example.org/image.png](http://example.org/image.png)](http://example.org/image.png)'
line='=> http://example.org/image.png Image description'
- assert::equals "$(generic::link markdown "$line")" \
+ assert::equals "$(generate::link md "$line")" \
'[![Image description](http://example.org/image.png "Image description")](http://example.org/image.png)'
}
+md::fromgmi () {
+ while IFS='' read -r line; do
+ case "$line" in
+ '=> '*)
+ generate::link md "$line"
+ ;;
+ *)
+ echo "$line"
+ ;;
+ esac
+ done
+}
### MAIN module
@@ -471,7 +496,7 @@ HELPHERE
case $ARG in
--test)
html::test
- markdown::test
+ md::test
;;
--feeds)
gemfeed::generate
@@ -479,11 +504,10 @@ case $ARG in
;;
--generate)
html::test
- markdown::test
+ md::test
gemfeed::generate
atomfeed::generate
- # markdown::generate
- html::generate
+ generate::fromgmi html md
;;
--help|*)
main::help
diff --git a/content/md/contact-information.md b/content/md/contact-information.md
new file mode 100644
index 00000000..935f698e
--- /dev/null
+++ b/content/md/contact-information.md
@@ -0,0 +1,38 @@
+[Go back to the main site](./)
+
+# Contact information
+
+## E-Mail
+
+* Secure E-Mail: paul.buetow at protonmail dot com
+* E-Mail: paul at buetow dot org (forwards to the ProtonMail address)
+
+Why did I just mention 2 E-Mail addresses here? The buetow.org address will always stay. It is my lifetime E-Mail address as I own the domain name. The address will stay even when I decided to change my email provider.
+
+Use the ProtonMail address if you care about security for now. The address stays valid as long as I am ProtonMail user. Especially if you are ProtonMail user too we could have real E-Mail end-2-end encryption for our conversation.
+
+## Quick Links
+
+### Social Media
+
+I am sharing articles which I found interesting regularly on all the social media channels. To get you navigated quickly, here are the links:
+
+[My LinkedIn profile](https://www.linkedin.com/in/paul-buetow-b4857270/)
+[My Twitter profile](https://twitter.com/snonux)
+[My Telegram channel](https://t.me/snonux)
+
+### My Open Source code repositories
+
+[My personal GitHub page](https://github.com/snonux)
+[DTail at Mimecast](https://github.com/mimecast/dtail)
+[I/O Riot at Mimecast](https://github.com/mimecast/ioriot)
+
+### My old personal website
+
+It's still there for fun + profit.
+
+[http://paul.buetow.org](http://paul.buetow.org)
+
+It's powered by Xerl, my own CMS:
+
+[http://xerl.buetow.org](http://xerl.buetow.org)
diff --git a/content/md/favicon.ico b/content/md/favicon.ico
new file mode 100644
index 00000000..999c023e
--- /dev/null
+++ b/content/md/favicon.ico
Binary files differ
diff --git a/content/md/gemfeed/2008-06-26-perl-poetry.md b/content/md/gemfeed/2008-06-26-perl-poetry.md
new file mode 100644
index 00000000..d53faef3
--- /dev/null
+++ b/content/md/gemfeed/2008-06-26-perl-poetry.md
@@ -0,0 +1,166 @@
+> Written by Paul Buetow 2008-06-26, last updated 2021-05-04
+
+[Go back to the main site](../)
+
+# Perl Poetry
+
+```
+ '\|/' *
+-- * -----
+ /|\ ____
+ ' | ' {_ o^> *
+ : -_ /)
+ : ( ( .-''`'.
+ . \ \ / \
+ . \ \ / \
+ \ `-' `'.
+ \ . ' / `.
+ \ ( \ ) ( .')
+ ,, t '. | / | (
+ '|``_/^\___ '| |`'-..-'| ( ()
+_~~|~/_|_|__/|~~~~~~~ | / ~~~~~ | | ~~~~~~~~
+ -_ |L[|]L|/ | |\ MJP ) )
+ ( |( / /|
+ ~~ ~ ~ ~~~~ | /\\ / /| |
+ || \\ _/ / | |
+ ~ ~ ~~~ _|| (_/ (___)_| |Nov291999
+ (__) (____)
+```
+
+Here are some Perl Poems I wrote. They don't do anything useful when you run them, but they don't produce a compiler error either. They only exist for fun and demonstrate what you can do with Perl syntax.
+
+Wikipedia: "Perl poetry is the practice of writing poems that can be compiled as legal Perl code, for example the piece known as Black Perl. Perl poetry is made possible by the large number of English words that are used in the Perl language. New poems are regularly submitted to the community at PerlMonks."
+
+[https://en.wikipedia.org/wiki/Perl](https://en.wikipedia.org/wiki/Perl)
+
+## math.pl
+
+```
+#!/usr/bin/perl
+
+# (C) 2006 by Paul C. Buetow (http://paul.buetow.org)
+
+goto library for study $math;
+BEGIN { s/earching/ books/
+and read $them, $at, $the } library:
+
+our $topics, cos and tan,
+require strict; import { of, tied $patience };
+
+do { int'egrate'; sub trade; };
+do { exp'onentize' and abs'olutize' };
+study and study and study and study;
+
+foreach $topic ({of, math}) {
+you, m/ay /go, to, limits }
+
+do { not qw/erk / unless $success
+and m/ove /o;$n and study };
+
+do { int'egrate'; sub trade; };
+do { exp'onentize' and abs'olutize' };
+study and study and study and study;
+
+grep /all/, exp'onents' and cos'inuses';
+/seek results/ for @all, log'4rithms';
+
+'you' =~ m/ay /go, not home
+unless each %book ne#ars
+$completion;
+
+do { int'egrate'; sub trade; };
+do { exp'onentize' and abs'olutize' };
+
+#at
+home: //ig,'nore', time and sleep $very =~ s/tr/on/g;
+__END__
+
+```
+
+## christmas.pl
+
+```
+#!/usr/bin/perl
+
+# (C) 2006 by Paul C. Buetow (http://paul.buetow.org)
+
+Christmas:{time;#!!!
+
+Children: do tell $wishes;
+
+Santa: for $each (@children) {
+BEGIN { read $each, $their, wishes and study them; use Memoize#ing
+
+} use constant gift, 'wrapping';
+package Gifts; pack $each, gift and bless $each and goto deliver
+or do import if not local $available,!!! HO, HO, HO;
+
+redo Santa, pipe $gifts, to_childs;
+redo Santa and do return if last one, is, delivered;
+
+deliver: gift and require diagnostics if our $gifts ,not break;
+do{ use NEXT; time; tied $gifts} if broken and dump the, broken, ones;
+The_children: sleep and wait for (each %gift) and try { to => untie $gifts };
+
+redo Santa, pipe $gifts, to_childs;
+redo Santa and do return if last one, is, delivered;
+
+The_christmas_tree: formline s/ /childrens/, $gifts;
+alarm and warn if not exists $Christmas{ tree}, @t, $ENV{HOME};
+write <<EMail
+ to the parents to buy a new christmas tree!!!!111
+ and send the
+EMail
+;wait and redo deliver until defined local $tree;
+
+redo Santa, pipe $gifts, to_childs;
+redo Santa and do return if last one, is, delivered ;}
+
+END {} our $mission and do sleep until next Christmas ;}
+
+__END__
+
+This is perl, v5.8.8 built for i386-freebsd-64int
+```
+
+## shopping.pl
+
+```
+#!/usr/bin/perl
+
+# (C) 2007 by Paul C. Buetow (http://paul.buetow.org)
+
+BEGIN{} goto mall for $shopping;
+
+m/y/; mall: seek$s, cool products(), { to => $sell };
+for $their (@business) { to:; earn:; a:; lot:; of:; money: }
+
+do not goto home and exit mall if exists $new{product};
+foreach $of (q(uality rich products)){} package products;
+
+our $news; do tell cool products() and do{ sub#tract
+cool{ $products and shift @the, @bad, @ones;
+
+do bless [q(uality)], $products
+and return not undef $stuff if not (local $available) }};
+
+do { study and study and study for cool products() }
+and do { seek $all, cool products(), { to => $buy } };
+
+do { write $them, $down } and do { order: foreach (@case) { package s } };
+goto home if not exists $more{money} or die q(uerying) ;for( @money){};
+
+at:;home: do { END{} and:; rest:; a:; bit: exit $shopping }
+and sleep until unpack$ing, cool products();
+
+__END__
+This is perl, v5.8.8 built for i386-freebsd-64int
+```
+
+## More...
+
+Did you like what you saw? Have a look at Github to see my other poems too:
+
+[https://github.com/snonux/perl-poetry](https://github.com/snonux/perl-poetry)
+
+E-Mail me your thoughts at comments@mx.buetow.org!
diff --git a/content/md/gemfeed/2010-05-09-the-fype-programming-language.md b/content/md/gemfeed/2010-05-09-the-fype-programming-language.md
new file mode 100644
index 00000000..6a0be90d
--- /dev/null
+++ b/content/md/gemfeed/2010-05-09-the-fype-programming-language.md
@@ -0,0 +1,511 @@
+> Written by Paul Buetow 2010-05-09, last updated 2021-05-05
+
+[Go back to the main site](../)
+
+```
+ ____ _ __
+ / / _|_ _ _ __ ___ _ _ ___ __ _| |__ / _|_ _
+ / / |_| | | | '_ \ / _ \ | | | |/ _ \/ _` | '_ \ | |_| | | |
+ _ / /| _| |_| | |_) | __/ | |_| | __/ (_| | | | |_| _| |_| |
+(_)_/ |_| \__, | .__/ \___| \__, |\___|\__,_|_| |_(_)_| \__, |
+ |___/|_| |___/ |___/
+
+```
+
+# The Fype Programming Language
+
+Fype is an interpreted programming language created by me for learning and fun. The interpreter is written in C. It has been tested on FreeBSD and NetBSD and may also work on other Unix like operating systems such as Linux based ones. To be honest, besides learning and fun there is really no other use case of why Fype actually exists as many other programming languages are much faster and more powerful.
+
+The Fype syntax is very simple and is using a maximum look ahead of 1 and a very easy top down parsing mechanism. Fype is parsing and interpreting its code simultaneously. This means, that syntax errors are only detected during program runtime.
+
+Fype is a recursive acronym and means "Fype is For Your Program Execution" or "Fype is Free Yak Programmed for ELF". You could also say "It's not a hype - it's Fype!".
+
+## Object oriented C style
+
+The Fype interpreter is written in an object oriented style of C. Each "main component" has its own .h and .c file. There is a struct type for each (most components at least) component which can be initialized using a "COMPONENT_new" function and destroyed using a "COMPONENT_delete" function. Method calls follow the same schema, e.g. "COMPONENT_METHODNAME". There is no such as class inheritance and polymorphism involved.
+
+To give you an idea how it works here as an example is a snippet from the main Fype "class header":
+
+```
+typedef struct {
+ Tupel *p_tupel_argv; // Contains command line options
+ List *p_list_token; // Initial list of token
+ Hash *p_hash_syms; // Symbol table
+ char *c_basename;
+} Fype;
+```
+
+And here is a snippet from the main Fype "class implementation":
+
+```
+Fype*
+fype_new() {
+ Fype *p_fype = malloc(sizeof(Fype));
+
+ p_fype->p_hash_syms = hash_new(512);
+ p_fype->p_list_token = list_new();
+ p_fype->p_tupel_argv = tupel_new();
+ p_fype->c_basename = NULL;
+
+ garbage_init();
+
+ return (p_fype);
+}
+
+void
+fype_delete(Fype *p_fype) {
+ argv_tupel_delete(p_fype->p_tupel_argv);
+
+ hash_iterate(p_fype->p_hash_syms, symbol_cleanup_hash_syms_cb);
+ hash_delete(p_fype->p_hash_syms);
+
+ list_iterate(p_fype->p_list_token, token_ref_down_cb);
+ list_delete(p_fype->p_list_token);
+
+ if (p_fype->c_basename)
+ free(p_fype->c_basename);
+
+ garbage_destroy();
+}
+
+int
+fype_run(int i_argc, char **pc_argv) {
+ Fype *p_fype = fype_new();
+
+ // argv: Maintains command line options
+ argv_run(p_fype, i_argc, pc_argv);
+
+ // scanner: Creates a list of token
+ scanner_run(p_fype);
+
+ // interpret: Interpret the list of token
+ interpret_run(p_fype);
+
+ fype_delete(p_fype);
+
+ return (0);
+}
+```
+
+## Data types
+
+Fype uses auto type conversion. However, if you want to know what's going on you may take a look at the following basic data types:
+* integer - Specifies a number
+* double - Specifies a double precision number
+* string - Specifies a string
+* number - May be an integer or a double number
+* any- May be any type above
+* void - No type
+* identifier - It's a variable name or a procedure name or a function name
+
+There is no boolean type, but we can use the integer values 0 for false and 1 for true. There is support for explicit type casting too.
+
+## Syntax
+
+### Comments
+
+Text from a # character until the end of the current line is considered being a comment. Multi line comments may start with an #* and with a *# anywhere. Exceptions are if those signs are inside of strings.
+
+### Variables
+
+Variables can be defined with the "my" keyword (inspired by Perl :-). If you don't assign a value during declaration, then it's using the default integer value 0. Variables may be changed during program runtime. Variables may be deleted using the "undef" keyword! Example:
+
+```
+my foo = 1 + 2;
+say foo;
+
+my bar = 12, baz = foo;
+say 1 + bar;
+say bar;
+
+my baz;
+say baz; # Will print out 0
+```
+
+You may use the "defined" keyword to check if an identifier has been defined or not:
+
+```
+ifnot defined foo {
+ say "No foo yet defined";
+}
+
+my foo = 1;
+
+if defined foo {
+ put "foo is defined and has the value ";
+ say foo;
+}
+```
+
+### Synonyms
+
+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 is:
+
+```
+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 (more about functions and procedures later).
+
+```
+# Create a new procedure baz
+proc baz { say "I am baz"; }
+
+# Make a synonym baz, and undefine baz
+my bay = \baz;
+
+undef baz;
+
+# bay still has a reference of the original procedure baz
+bay; # this prints aut "I am baz"
+```
+
+The "syms" keyword gives you the total number of synonyms pointing to a specific value:
+
+```
+my foo = 1;
+say syms foo; # Prints 1
+
+my baz = \foo;
+say syms foo; # Prints 2
+say syms baz; # Prints 2
+
+undef baz;
+say syms foo; # Prints 1
+```
+
+## Statements and expressions
+
+A Fype program is a list of statements. Each keyword, expression or function call is part of a statement. Each statement is ended with a semicolon. Example:
+
+```
+my bar = 3, foo = 1 + 2;
+say foo;
+exit foo - bar;
+```
+
+### Parenthesis
+
+All parenthesis for function arguments are optional. They help to make the code better readable. They also help to force precedence of expressions.
+
+### Basic expressions
+
+Any "any" value holding a string will be automatically converted to an integer value.
+
+```
+(any) <any> + <any>
+(any) <any> - <any>
+(any) <any> * <any>
+(any) <any> / <any>
+(integer) <any> == <any>
+(integer) <any> != <any>
+(integer) <any> <= <any>
+(integer) <any> gt <any>
+(integer) <any> <> <any>
+(integer) <any> gt <any>
+(integer) not <any>
+```
+
+### Bitwise expressions
+
+```
+(integer) <any> :< <any>
+(integer) <any> :> <any>
+(integer) <any> and <any>
+(integer) <any> or <any>
+(integer) <any> xor <any>
+```
+
+### Numeric expressions
+
+```
+(number) neg <number>
+```
+
+... returns the negative value of "number":
+
+```
+(integer) no <integer>
+```
+
+... returns 1 if the argument is 0, otherwise it will return 0! If no argument is given, then 0 is returned!
+
+```
+(integer) yes <integer>
+```
+
+... always returns 1. The parameter is optional. Example:
+
+```
+# Prints out 1, because foo is not defined
+if yes { say no defined foo; }
+```
+
+## Control statements
+
+Control statements available in Fype:
+
+```
+if <expression> { <statements> }
+```
+
+... runs the statements if the expression evaluates to a true value.
+
+```
+ifnot <expression> { <statements> }
+```
+
+... runs the statements if the expression evaluates to a false value.
+
+```
+while <expression> { <statements> }
+```
+
+... runs the statements as long as the expression evaluates to a true value.
+
+```
+until <expression> { <statements> }
+```
+
+... runs the statements as long as the expression evaluates to a false value.
+
+## 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 scopes. The "scope" function prints out all available symbols at the current scope. Here is a small example:
+
+```
+my foo = 1;
+
+{
+ # Prints out 1
+ put defined foo;
+ {
+ my bar = 2;
+
+ # 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
+ put defined bar;
+
+ my baz = 3;
+}
+
+# Prints out 0
+say defined bar;
+```
+
+Another example including an actual output:
+
+```
+./fype -e ’my global; func foo { my var4; func bar { my var2, var3; func baz { my var1; scope; } baz; } bar; } foo;’
+Scopes:
+Scope stack size: 3
+Global symbols:
+SYM_VARIABLE: global (id=00034, line=-0001, pos=-001, type=TT_INTEGER, dval=0.000000, refs=-1)
+SYM_FUNCTION: foo
+Local symbols:
+SYM_VARIABLE: var1 (id=00038, line=-0001, pos=-001, type=TT_INTEGER, dval=0.000000, refs=-1)
+1 level(s) up:
+SYM_VARIABLE: var2 (id=00036, line=-0001, pos=-001, type=TT_INTEGER, dval=0.000000, refs=-1)
+SYM_VARIABLE: var3 (id=00037, line=-0001, pos=-001, type=TT_INTEGER, dval=0.000000, refs=-1)
+SYM_FUNCTION: baz
+2 level(s) up:
+SYM_VARIABLE: var4 (id=00035, line=-0001, pos=-001, type=TT_INTEGER, dval=0.000000, refs=-1)
+SYM_FUNCTION: bar
+```
+
+## Definedness
+
+```
+(integer) defined <identifier>
+```
+
+... returns 1 if "identifier" has been defined. Returns 0 otherwise.
+
+```
+(integer) undef <identifier>
+```
+
+... tries to undefine/delete the "identifier". Returns 1 if it succeeded, otherwise 0 is returned.
+
+## System
+
+These are some system and interpreter specific built-in functions supported:
+
+```
+(void) end
+```
+
+... exits the program with the exit status of 0.
+
+```
+(void) exit <integer>
+```
+
+... exits the program with the specified exit status.
+
+```
+(integer) fork
+```
+
+... forks a subprocess. It returns 0 for the child process and the pid of the child process otherwise! Example:
+
+```
+my pid = fork;
+
+if pid {
+ put "I am the parent process; child has the pid ";
+ say pid;
+
+} ifnot pid {
+ say "I am the child process";
+}
+```
+
+To execute the garbage collector do:
+
+```
+(integer) gc
+```
+
+It returns the number of items freed! You may wonder why most of the time it will return a value of 0! Fype tries to free not needed memory ASAP. This may change in future versions in order to gain faster execution speed!
+
+### I/O
+
+```
+(any) put <any>
+```
+
+... prints out the argument
+
+```
+(any) say <any>
+```
+
+is the same as put, but also includes an ending newline.
+
+```
+(void) ln
+```
+
+... just prints a newline.
+
+## Procedures and functions
+
+### Procedures
+
+A procedure can be defined with the "proc" keyword and deleted with the "undef" keyword. A procedure does not return any value and does not support