, 1 April 1989
+] Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General
+Public License instead of this License.
diff --git a/doc/file/index.txt b/doc/file/index.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/function/filter_list.txt b/doc/function/filter_list.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/function/index.txt b/doc/function/index.txt
new file mode 100644
index 00000000..9cc9358a
--- /dev/null
+++ b/doc/function/index.txt
@@ -0,0 +1,71 @@
+Script functions by category
+
+These functions are built into the program, other [[type:function]]s can be defined using the scripting language.
+
+! Text manipulation <<<
+| [[fun:to_upper]] Convert a string to upper case, @"aBc" -> "ABC"@.
+| [[fun:to_lower]] Convert a string to lower case, @"aBc" -> "abc"@.
+| [[fun:to_title]] Convert a string to title case, @"aBc" -> "Abc"@.
+| [[fun:reverse]] Reverse a string, @"aBc" -> "cBa"@.
+| [[fun:substring]] Extract a part of a string.
+| [[fun:format]] Format a number as a string (printf).
+| [[fun:format_rule]] ^^^
+| [[fun:curly_quotes]] Make quotes curly.
+| [[fun:replace]] Replace text matching a regular expression.
+| [[fun:replace_rule]] ^^^
+| [[fun:filter_text]] Keep only the text matching a regular expression.
+| [[fun:filter_rule]] ^^^
+| [[fun:sort_text]] Sort the letters in a string using a custom order.
+| [[fun:sort_rule]] ^^^
+| [[fun:contains]] Does a string contain another one?
+| [[fun:match]] Does a string match a regular expression?
+| [[fun:match_rule]] ^^^
+! [[type:tagged_string|Tags]] <<<
+| [[fun:tag_contents]] Change the contents of a specific tag.
+| [[fun:tag_contents_rule]] ^^^
+| [[fun:remove_tag]] Remove a tag, keep the contents.
+| [[fun:tag_remove_rule]] ^^^
+! [[type:list|Lists]] <<<
+| [[fun:position]] Find the position of an element in a list.
+| [[fun:number_of_items]] Find the number of items in a list.
+| [[fun:sort_list]] Sort a list.
+| [[fun:filter_list]] Filter a list, keeping only elements that match a predicate.
+
+! Keywords <<<
+| [[fun:expand_keywords]] Expand the keywords in a piece of text.
+| [[fun:expand_keywords_rule]] ^^^
+| [[fun:keyword_usage]] What keywords are used on a card, and how often are they used?
+
+! English language <<<
+| [[fun:english_number]] Convert a number to text (@"one"@, @"two"@, ''etc.'')
+| [[fun:english_number_a]] Convert a number to text (@"a"@, @"two"@, ''etc.'')
+| [[fun:english_number_multiple]] Convert a number to text (@""@, @"two"@, ''etc.'')
+| [[fun:english_number_ordinal]] Convert a number to text (@"first"@, @"second"@, ''etc.'')
+| [[fun:english_plural]] Find the plural of a word, @"card" -> "cards"@.
+| [[fun:english_singular]] Find the singular of a word, @"cards" -> "card"@.
+| [[fun:process_english_hints]] Process the hints left by english_ functions in a keyword's reminder text.
+
+! Fields and values <<<
+| [[fun:combined_editor|forward_editor]] Use one field to edit another.
+| [[fun:combined_editor]] Use one field to edit multiple others.
+| [[fun:primary_choice]] Return the top level choice chosen from a choice field.
+| [[fun:chosen]] Is the given choice selected in a multiple choice value?
+| [[fun:require_choice]] Require that at least one of the given choices is selected.
+| [[fun:exclusive_choice]] Require that at most one of the given choices is selected.
+| [[fun:require_exclusive_choice]] Require that exactly one of the given choices is selected.
+| [[fun:remove_choice]] Remove the given choices from a multiple choice value.
+
+! Images <<<
+| [[fun:linear_blend]] Blend two images together using a linear gradient.
+| [[fun:masked_blend]] Blend two images together using a third mask image.
+| [[fun:combine_blend]] Blend two images together using a given [[type:combine|combining mode]].
+| [[fun:set_mask]] Set the transparancy mask of an image.
+| [[fun:set_alpha]] Change the transparency of an image.
+| [[fun:set_combine]] Chnage how the image should be combined with the background.
+| [[fun:enlarge]] Enlarge an image by putting a border around it.
+| [[fun:drop_shadow]] Add a drop shadow to an image.
+| [[fun:symbol_variation]] Render a variation of a [[type:symbol]].
+| [[fun:built_in_image]] Return an image built into the program.
+
+! Other functions <<<
+| [[fun:trace]] Output a message for debugging purposes.
diff --git a/doc/function/number_of_items.txt b/doc/function/number_of_items.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/function/position.txt b/doc/function/position.txt
new file mode 100644
index 00000000..3c7f7c31
--- /dev/null
+++ b/doc/function/position.txt
@@ -0,0 +1,25 @@
+Function: position
+
+--Usage--
+> position(of: some_item, in: some_list)
+
+Returns the position of an item in a list.
+The first position is @0@.
+If the item is not found in the list, returns @-1@.
+
+--Parameters--
+| @of@ ''anything'' Item to look for.
+| @in@ [[type:list]] or [[type:set]] List to look in.
+ Can be a [[type:set]] when looking for a card.
+| @order_by@ [[type:function]] (optional) Find the position as if the list was [[fun:sort_list|sorted]] by this criterion.
+ Only when looking in a set.
+| @filter@ [[type:function]] (optional) Find the position as if the list was [[fun:filter_list|filtered]] by this criterion.
+ Only when looking in a set.
+
+--Examples--
+> postion(of: "x", in: ["x", "y", "z"]) == 0
+> postion(of: "z", in: ["x", "y", "z"]) == 2
+> postion(of: "a", in: ["x", "y", "z"]) == -1
+>
+> # The position of the card in the list of red cards, ordered by name
+> postion(of: card, in: set, order_by: {card.name}, filter:{card.color == "red"})
diff --git a/doc/function/sort_list.txt b/doc/function/sort_list.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/index.txt b/doc/index.txt
new file mode 100644
index 00000000..89233ed9
--- /dev/null
+++ b/doc/index.txt
@@ -0,0 +1,15 @@
+Documentation
+
+Welcome to the Magic Set Editor technical documentation.
+These documents describe the file formats and scirpting language used by the program.
+
+--Topics--
+* [[doc/tutorial|Templating tutorial]] (comming soon)
+* [[doc/file|File formats]]
+* [[doc/type|Data types used in the files]]
+* [[doc/script|Scripting language overview]]
+* [[doc/function|Script function reference]]
+
+--Other information--
+* [[doc/about|MSE credits]]
+* [[doc/about/license|License]]
diff --git a/doc/script/index.txt b/doc/script/index.txt
new file mode 100644
index 00000000..40e44c6b
--- /dev/null
+++ b/doc/script/index.txt
@@ -0,0 +1,2 @@
+Scripting language
+
diff --git a/doc/script/operators.txt b/doc/script/operators.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/script/syntax.txt b/doc/script/syntax.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/type/color.txt b/doc/type/color.txt
new file mode 100644
index 00000000..ba302a84
--- /dev/null
+++ b/doc/type/color.txt
@@ -0,0 +1,15 @@
+==Data type: color==
+
+--Syntax--
+In files and scritps a color can be represented as
+rgb(red_component, green_component, blue_component)
+where red_component, green_component and blue_component are numbers between 0 and 255 (inclusive).
+
+--Examples--
+For example:
+! Code Represents
+| @rgb(255,255,255)@ white,
+| @rgb(0,0,0)@ black,
+| @rgb(255,0,0)@ red,
+| @rgb(0,255,0)@ green,
+| @rgb(0,0,255)@ blue,
diff --git a/doc/type/combine.txt b/doc/type/combine.txt
new file mode 100644
index 00000000..506d274f
--- /dev/null
+++ b/doc/type/combine.txt
@@ -0,0 +1,7 @@
+==Data type: image combine type==
+
+This specifies how an image is to be combined with the background.
+This is similair to the feature found in more advanced drawing programs.
+
+--Possible values--
+| overlay
\ No newline at end of file
diff --git a/doc/type/game.txt b/doc/type/game.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/type/index.txt b/doc/type/index.txt
new file mode 100644
index 00000000..7c106db7
--- /dev/null
+++ b/doc/type/index.txt
@@ -0,0 +1,48 @@
+Data types
+
+Magic Set Editor uses many data types in the files and in scripting.
+There are for instance [[type:card]]s in [[type:set]]s, [[type:stylesheet]]s describing the layout of [[type:field]]s, etc.
+
+--Styling trinity--
+
+--File types--
+These are the 'major' data types that are written directly to [[file:package]]s.
+| [[type:game]] What information is on each card?
+| [[type:stylesheets]] What do cards look like?
+| [[type:set]] Sets of cards.
+| [[type:symbol_font]] Fonts consisting of symbols, for instance mana symbols.
+| [[type:export_template]] How to export sets to HTML files?
+| [[type:locale]] Translations of MSE.
+| [[type:include]] Files to include in other templates.
+| [[type:installer]] Installers containing several packages.
+| [[type:symbol]] Expansion symbols.
+| [[type:settings]] MSE settings.
+
+--Compound types--
+These contain several properties, similair to the file types. But they are part of some other file type.
+| [[type:field]] A field description for cards.
+| [[type:style]] The styling and positioning of a field.
+| [[type:value]] The value in a field, for a particular card.
+| [[type:card]] A card containing values.
+| [[type:keyword]] A keyword.
+| [[type:font]] Description of a font.
+| [[type:script]] A script to execute to update a field, or for initialization.
+| [[type:symbol_part]] Part of a [[type:symbol]].
+
+--Collection types--
+| [[type:list]] Lists of items
+ * item
+ * item
+ * item
+| [[type:indexmap|'index' map]] Lists indexed by field name
+ | name: | someone |
+ | type: | something |
+| [[type:map]] Lists indexed by other text
+
+--Primitive types--
+| [[type:string]] Text, @"abc"@
+| [[type:int]] Integer numbers, @1, 2, 100@
+| [[type:double]] Real numbers, @1, 0.5, 21.3@
+| [[type:color]] Colors
+| [[type:scriptable]] A primitive type whose value can depend on a script.
+| [[type:function]] Functions in scripts. These have no direct representation in a file.
diff --git a/doc/type/list.txt b/doc/type/list.txt
new file mode 100644
index 00000000..1972fb8f
--- /dev/null
+++ b/doc/type/list.txt
@@ -0,0 +1,28 @@
+Data type: Lists
+
+--File syntax--
+In files a list is represented as multiple keys, one for each element.
+The keys are all in the singular for of the name of the list,
+if the list is named for instance @symbols@ each key will be named @symbol@.
+] symbol:
+] # first symbol here
+] symbol:
+] # second symbol here
+] # etc.
+
+--Script syntax--
+In a script lists can be declared using square brackets.
+> [] # An empty list
+> [1] # A list with a single element, the value 1
+> [1,2] # A list with two elements
+
+Lists can be accessed using either the bracket operator, or the dot operator.
+The first element of a list is numbered 0, the next 1, etc.
+> list.0 # The first element of the list 'list'
+> list[0] # The same thing
+
+There are several functions for working with lists:
+| [[fun:position]] Find the position of an element in a list
+| [[fun:number_of_items]] Find the number of items in a list
+| [[fun:sort_list]] Sort a list
+| [[fun:filter_list]] Filter a list, keeping only elements that match a predicate
diff --git a/doc/type/regex.txt b/doc/type/regex.txt
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/type/set.txt b/doc/type/set.txt
new file mode 100644
index 00000000..67387f46
--- /dev/null
+++ b/doc/type/set.txt
@@ -0,0 +1,85 @@
+==Object type: Set==
+
+--Package--
+A set is described in a package with the .mse-set file extension,
+such a package contains a data file called set.
+
+--Properties--
+| game Name of a [[type:game]] The game this set is made for.
+| stylesheet Name of a [[type:stylesheet]] The default style for drawing cards in this set.
+| set info [[type:indexmap]] of [[type:value]]s The data for the [[prop:game:set fields]] defined in the game.
+| styling [[type:indexmap]] of [[type:value]]s
+| cards [[type:list] of [[type:card]]s The cards in the set.
+
+--Example--
+
+|-
+| set info:
+| Contains custom information about the set, corresponding to the set fields in the game.
+|-
+| extra set info:
+| Contains information about the set for a specific style, corresponding to the extra fields in the style.
+ Stored with an index for the game, see the example below.
+|-
+| card:
card:
...
+| Contains information about each card, corresponding to the card fields in the game.
+|-
+| keyword:
keyword:
...
+| Extra keywords specific to this set, in addition to those defined in the game.
+ For more information see the game file
+|}
+
+The set info and cards contain a list of keys that correspond to the names fields in the game,
+For example if the game looks like:
+ name: my game
+ set field:
+ name: copyright
+ type: text
+ card field:
+ name: card name
+ type: text
+ card field:
+ name: power
+ type: text
+
+The the set file looks like:
+ game: my game
+ name: my set
+ set info:
+ copyright: something
+ extra set info:
+ name-of-style:
+ name-of-field: something
+ card:
+ card name: first card
+ power: 100
+ card:
+ card name: second card
+ power: 50
+
+
+The value that is stored depends on the type of field of course, in the above example the fields have type: text, so the value is just the text.
+For other types of fields the value is encoded as follows:
+{|
+! Attribute !! Description
+|-
+| text
+| The text that is stored in the field. This text can contain tags.
+|-
+| choice
+| One of the choices specified in the game.
+|-
+| boolean
+| One of yes or no.
+|-
+| color
+| The color is encoded as rgb(red,green,blue) where red, green and blue are numbers between 0 and 255 that indicate the color components.
+|-
+| image
+| The filename containing the image, this file must also be in the set package. It can be empty to indicate that no image is selected.
+|-
+| symbol
+| The filename containing the symbol specification, this file must also be in the set package.
+ It can be empty to indicate that no symbol is selected.
+|}
+If a field has the default value (calculated by the default script), then the field name and value are ommited from the set file.
diff --git a/doc/type/string.txt b/doc/type/string.txt
new file mode 100644
index 00000000..6f11b43a
--- /dev/null
+++ b/doc/type/string.txt
@@ -0,0 +1,5 @@
+==Data type: character string==
+
+--File syntax--
+
+--Script syntax--
\ No newline at end of file
diff --git a/doc/type/stylesheet.txt b/doc/type/stylesheet.txt
new file mode 100644
index 00000000..33c8863f
--- /dev/null
+++ b/doc/type/stylesheet.txt
@@ -0,0 +1,12 @@
+Object type: Stylesheet
+
+--Properties--
+| @game@ Name of a [[type:game]] Game this stylesheet is made for
+| @init script@ [[type:script]]
+| @card width@ [[type:double]] Width of cards in pixels
+| @card height@ [[type:double]] Height of cards in pixels
+| @card dpi@ [[type:double]] Resoltion of cards in dots-per-inch
+| @card background@ [[type:color]] Background color of cards
+| @card style@ [[type:indexmap] of [[type:style]]s Styles for the [[property:game:card fields]] defined in the game
+|
+
diff --git a/doc/type/tagged_string.txt b/doc/type/tagged_string.txt
new file mode 100644
index 00000000..c51282ef
--- /dev/null
+++ b/doc/type/tagged_string.txt
@@ -0,0 +1,37 @@
+==Data type: string with tags==
+
+--Syntax--
+&1;
+
+--Basic markup--
+! Tag Description
+| The text inside the tag is bold.
+| The text inside the tag is italic.
+| The text inside the tag is rendered as symbols, if a [[prop:style:symbol font]] is set for the text box.
+| Line breaks inside this tag use the [[prop:style:line height line]], and they show a horizontal line.
+| Line breaks inside this tag use the [[prop:style:soft line height]].
+| An atomic piece of text. The cursor can never be inside it; it is selected as a whole.
+ The program automatically inserts
+| The text inside the text is rendered in a monospace font. This is used for syntax highlighting script code.
+| The text inside the text is highlighted as a keyword in source code.
+| The text inside the text is highlighted as a string in source code.
+
+
+--Other tags--
+! Tag Description
+| Indicates that the text inside it is a keyword. This tag is automatically inserted by
+ The [[fun:expand_keywords] function. There are four versions, indicating whether or not reminder text is shown
+ | Reminder text hidden, by default
+ | Reminder text shown, by default
+ | Remder hidden manually
+ | Remder shown manually
+| A separator between fields. This tag is automatically inserted by the [[fun:combined_editor]] function.
+ Inserting this tag manually will confuse that function!
+ This tag can never be selected, and its contents can not be edited.
+| Like <sep>, only hidden. This is inserted by [[fun:combined_editor]]
+ ...
+| any other tag Other tags are ignored.
+
+--Related functions--
+The following script functions deal with tags:
+| [[fun:remove_tag]]
diff --git a/doc/type/value.txt b/doc/type/value.txt
new file mode 100644
index 00000000..3a8b4035
--- /dev/null
+++ b/doc/type/value.txt
@@ -0,0 +1 @@
+== Object type: Field value ==