Added user guide to documentaision

Makefile

@@ -5,16 +5,19 @@ html:
 	make -C admin html
 	make -C concept html
 	make -C developer html
+	make -C user html
 
 pdf:
 	make -C admin latexpdf
 	make -C concept latexpdf
 	make -C developer latexpdf
+	make -C user latexpdf
 
 gettext:
 	make -C admin gettext
 	make -C concept gettext
 	make -C developer gettext
+	make -C user gettext
 
 man:
 	make -C manpages man
@@ -24,3 +27,4 @@ clean:
 	make -C concept clean
 	make -C developer clean
 	make -C manpages clean
+	make -C user clean

admin/glossary.rst

@@ -85,7 +85,7 @@ Glossary
     as web service.
 
   Metric
-    TBD
+    One entity of collected data
 
   MIB Explorer
     :term:`View` in user interface, which allows to navigate SNMP MIB tree and

admin/index.rst

@@ -42,7 +42,6 @@ NetXMS Administrator Guide
    advanced
    schedule
    scripting
-   nxsl-class-description
    appendix
    glossary
 

admin/remote-file-management.rst

@@ -33,7 +33,7 @@ The following configuration parameters are supported:
 +================+=========+===========================================+================+
 | RootFolder     | String  | The folder to witch will be given access. | no             |
 |                |         | The following options can be set:         |                |                 
-|                |         |  - **ro** - Read-Only root                |                |
+|                |         |    - **ro** - Read-Only root              |                |
 +----------------+---------+-------------------------------------------+----------------+
 
 Agent's configuration file example:

admin/scripting.rst

@@ -147,6 +147,21 @@ The next, and final, line of our small program is:
 ``return`` is another built-in operator which exits the function and sets it's
 return value.
 
+Script entry point
+------------------
+
+NXSL handles script entry in 2 ways:
+
+    * Explicit main() function
+    * Implicit $main() fucntion
+    
+If an explicitelly defined main() exists, it will be called.
+
+
+
+If an explicit main() doesnt exist, an implicit $main() fucntion will be created by the script interpreter and the script will enter at the $main() function.
+
+The $main() fucntion is constructed from code that is not a part of any other functions.
 
 Types
 -----
@@ -350,25 +365,38 @@ access element with index ``3`` of array ``a`` you should use
 Array Initialization
 ~~~~~~~~~~~~~~~~~~~~
 
-New array can be created in two ways. First is to use ``'array``' operator:
+New array can be created in two ways. First is to use ``'array``' operator.
+This statement will create empty array and assign reference to it to variable ``a``.
 
 .. code-block:: c
 
    array a;
 
-This statement will create empty array and assign reference to it to variable
-``a``.
+You can then assign values to the array like this. 
 
-Second way is to use ``%( )`` construct to create array already populated with
-values:
+Please note arrays in NXSL are sparse, so you can have elements with nothing in between.
 
 .. code-block:: c
 
-   a = %(1, 2, 3, 4);
+    array a; 
+    a[1] = 1;
+    a[2] = 2;
+    a[260] = 260;    
+    println(a[1]); // will print 1
 
-This statement will create array with four elements at positions 0, 1, 2, and
-3, and assign reference to this array to variable ``a``. Array initialization
-can also be used directly in expressions, like this:
+Second way is to use %( ) construct to create array already populated with values.
+
+This statement will create array with four elements at positions 0, 1, 2, and 3, and assign reference to this array to variable a.
+    
+.. code-block:: c
+
+    // no need to use "array a;" here, since we are creating it dirrectly
+    a = %(1, 2, 3, 4);
+    
+    println(a[0]); // will actually print 1, since 1 is the 0th member
+
+
+Array initialization can also be used directly in expressions, like this:
 
 .. code-block:: c
 
@@ -377,6 +405,7 @@ can also be used directly in expressions, like this:
       return %(2, "text", %(1, 2, 3));
    }
 
+
 In this example function ``f`` returns array of 3 elements - number, text, and
 another array of 3 numeric elements.
 
@@ -486,6 +515,16 @@ Comparison operators allow you to compare two values.
      - ``TRUE`` if ``a`` is matched to regular expression ``b``. As a side
        effect, assigns values to special variables ``$1``, ``$2``, ``$3``, etc.
        See see :ref:`regular-expressions` for details.
+   * - ``a match b``
+     - Match
+     - ``TRUE`` if ``a`` is matched to regular expression ``b``. As a side
+       effect, assigns values to special variables ``$1``, ``$2``, ``$3``, etc.
+       See see :ref:`regular-expressions` for details.
+   * - ``a imatch b``
+     - Match (case insensitive)
+     - ``TRUE`` if ``a`` is matched to regular expression ``b`` (case insensitive). As a side
+       effect, assigns values to special variables ``$1``, ``$2``, ``$3``, etc.
+       See see :ref:`regular-expressions` for details.
 
 
 Incrementing/Decrementing Operators

admin/visualisation.rst

@@ -256,9 +256,9 @@ element. You will be prompted with element type selection dialog:
 
 .. figure:: _images/DashboardProperties.png
 
-When new element added, you can edit it by double-clicking on record in
-elements list, or by pressing :guilabel:`Edit` button. Each element have
-:guilabel:`Layout` property page which controls element's layout inside
+When a new element is added, you can edit it by double-clicking on it's record in
+the elements list, or by pressing the :guilabel:`Edit` button. Each element have
+:guilabel:`Layout` property page which controls the element's layout inside the 
 dashboard, and one or more element type specific pages to control element's
 appearance and displayed information. The following element types are
 available:
@@ -434,7 +434,7 @@ Data Sources
 :guilabel:`Data sources` page is available for all DCI based elements: Bar
 Chart, Dial Chart, Line Chart, Pie Chart, and Tube Chart. Here you can define
 what DCIs should be used as data sources for the chart. Up to 16 DCIs can be
-added to single chart. You can configure multiple properties for each data
+added to a single chart. You can configure multiple properties for each data
 source. To edit data source, either double click on appropriate item in the
 list, or press :guilabel:`Edit` button. Data source configuration dialog looks
 like following:
@@ -508,11 +508,11 @@ it will be displayed above page content.
 Understanding Element Layout
 ----------------------------
 
-Dashboard uses grid concept to layout it's elements. Available space divided
-into rows and columns, and each element occupies one or more cells. Number of
-columns configured in dashboard object properties, and number of rows
-calculated automatically based on number of columns, number of elements, and
-number of cells occupied by each element. Elements are laid out in columns from
+Dashboard uses grid concept to layout it's elements. Available space is divided
+into rows and columns, and each element occupies one or more cells. The number of
+columns is configured in dashboard object properties, and number of rows is 
+calculated automatically based on number of columns, elements, and
+cells occupied by each element. Elements are laid out in columns from
 left to right, and a new row is created when there are no space left for next
 element on current row. Each element has horizontal and vertical alignment
 properties. Default for both is :guilabel:`FILL`. Possible alignment values are
@@ -564,6 +564,10 @@ a loop, follow these steps:
 
    Sample configuration of two dashboards displayed in a loop for 40 seconds each.
 
+Tutorials
+---------
+
+Rashboard creation tutorial available on `Youtube <http://youtu.be/ZfJQiUIDHY4>`_
 
 Graphs
 ======

generateNXSLDoc.py

@@ -1,118 +0,0 @@
-import requests
-from bs4 import BeautifulSoup
-import os
-
-# function defenition
-
-def getSubPage(link):
-   content = requests.get('%s%s' % (linkBase,link)).text
-   soupPage =  BeautifulSoup(content, "html.parser")
-   #get div with mw-content-text
-   mainDivElement = soupPage.find(id="mw-content-text")
-   result = "";
-   for child in mainDivElement:
-      if "p" == child.name and child.text.strip() != "":
-         result = result+child.text+"\n\n"
-      if "h2" == child.name and child.text.strip() != "":
-         result = result+child.text+"\n"
-         for n in child.text:
-            result = result+"~"
-         result = result+"\n\n"
-      if "dl" == child.name or "table" == child.name or "div" == child.name:
-         result = result+child.get_text()+"\n\n"
-      if "pre" == child.name and child.text.strip() != "":
-         result = result+child.text+"\n\n"
-   return result;
-
-#main page
-
-linkBase = 'https://wiki.netxms.org'
-html_content= requests.get('%s/wiki/NXSL_Function_Reference' % linkBase).text
-soup =  BeautifulSoup(html_content, "html.parser")
-
-#clean old file
-if os.path.isfile('nxsl-class-description.rst'):
-   os.remove('nxsl-class-description.rst') 
-
-#Write header
-rstFile = open('nxsl-class-description.rst', 'w+')
-rstFile.write('.. _nxsl-class-description:\n\n')
-rstFile.write('############## \n\
-NXSL Functions\n\
-##############\n\n')
-rstFile.write('This chapter descrbes available NXSL functions.\n\n')
-rstFile.write('Function tables\n\
-===============\n\n')
-
-
-#Generate table
-numOfCol = 0;
-numOfRow = 0;
-for table in soup.find_all('table'):
-   rstFile.write(".. list-table:: \n\
-   :header-rows: 1\n\
-   :widths: ")
-   rows = table.find_all('tr')
-   rows.remove(rows[len(rows)-1]) # remove last empty row
-   for x in range(0, len(rows[0].find_all('td'))):
-      rstFile.write("60 ")
-   rstFile.write("\n\n")
-   numOfRow = 0
-   for tr in rows:
-      numOfRow += 1
-      columns = tr.find_all('td')   
-      numOfCol = 0
-      for td in columns:
-         numOfCol += 1
-         if numOfRow == 1 or td.text.rstrip() == "": #do not create links for empty rows and for header row
-            if numOfCol == 1:
-               rstFile.write("   * - %s\n" % td.text.strip())  
-            else:
-               rstFile.write("     - %s\n" % td.text.strip())
-         else:
-            if numOfCol == 1:
-               rstFile.write("   * - :ref:`%s <nxsl-%s>`\n" % (td.text.strip(),td.text.strip()))  
-            else:
-               rstFile.write("     - :ref:`%s <nxsl-%s>`\n" % (td.text.strip(),td.text.strip()))
-   rstFile.write("\n\n")
-
-#generate description for table items
-for table in soup.find_all('table'):
-   rows = table.find_all('tr')
-   rows.remove(rows[len(rows)-1]) # remove last empty row 
-   #should go in reverse orger - first take all rows fo eash column   
-   numOfRow = len(rows)
-   numOfCol = len(rows[0].find_all('td'))
-   for x in range(0, numOfCol):
-      #first is always header
-         header = rows[0].find_all('td')[x].text.strip()
-         rstFile.write("%s\n" % header) 
-         for i in header:
-            rstFile.write("=")
-         rstFile.write("\n\n");
-         for y in range(1, numOfRow):
-            header = rows[y].find_all('td')[x].text.strip()
-            if header == "":
-               break; # If row empty go to next column
-            rstFile.write(".. _nxsl-%s:\n\n" % header)
-            rstFile.write("%s\n" % header) 
-            for i in header:
-               rstFile.write("-")
-            rstFile.write("\n\n");
-            #get page with this function info if exist and add to page
-            href = rows[y].find_all('td')[x].find_all('a')[0].get('href')
-            if "wiki" in href:
-               rstFile.write(getSubPage(href).encode('utf-8'))
-            else:
-               rstFile.write("Under construction")
-            rstFile.write("\n\n");
-
-
-#clean old file
-if os.path.isfile('nxsl-class-description.rst'):
-   if os.path.isfile("admin/nxsl-class-description.rst"):
-      os.remove("admin/nxsl-class-description.rst")
-   os.rename("nxsl-class-description.rst", "admin/nxsl-class-description.rst")
-
-
-

user/.tx/config

@@ -0,0 +1,124 @@
+[main]
+host = https://www.transifex.com
+type = PO
+
+[netxms-admin-develop.advanced]
+file_filter = _locale/<lang>/LC_MESSAGES/advanced.po
+source_file = _build/locale/advanced.pot
+source_lang = en
+
+[netxms-admin-develop.agent-management]
+file_filter = _locale/<lang>/LC_MESSAGES/agent-management.po
+source_file = _build/locale/agent-management.pot
+source_lang = en
+
+[netxms-admin-develop.appendix]
+file_filter = _locale/<lang>/LC_MESSAGES/appendix.po
+source_file = _build/locale/appendix.pot
+source_lang = en
+
+[netxms-admin-develop.common-tasks]
+file_filter = _locale/<lang>/LC_MESSAGES/common-tasks.po
+source_file = _build/locale/common-tasks.pot
+source_lang = en
+
+[netxms-admin-develop.concepts]
+file_filter = _locale/<lang>/LC_MESSAGES/concepts.po
+source_file = _build/locale/concepts.pot
+source_lang = en
+
+[netxms-admin-develop.data-collection]
+file_filter = _locale/<lang>/LC_MESSAGES/data-collection.po
+source_file = _build/locale/data-collection.pot
+source_lang = en
+
+[netxms-admin-develop.event-processing]
+file_filter = _locale/<lang>/LC_MESSAGES/event-processing.po
+source_file = _build/locale/event-processing.pot
+source_lang = en
+
+[netxms-admin-develop.glossary]
+file_filter = _locale/<lang>/LC_MESSAGES/glossary.po
+source_file = _build/locale/glossary.pot
+source_lang = en
+
+[netxms-admin-develop.image-library]
+file_filter = _locale/<lang>/LC_MESSAGES/image-library.po
+source_file = _build/locale/image-library.pot
+source_lang = en
+
+[netxms-admin-develop.index]
+file_filter = _locale/<lang>/LC_MESSAGES/index.po
+source_file = _build/locale/index.pot
+source_lang = en
+
+[netxms-admin-develop.installation_and_upgrade]
+file_filter = _locale/<lang>/LC_MESSAGES/installation_and_upgrade.po
+source_file = _build/locale/installation_and_upgrade.pot
+source_lang = en
+
+[netxms-admin-develop.network-discovery]
+file_filter = _locale/<lang>/LC_MESSAGES/network-discovery.po
+source_file = _build/locale/network-discovery.pot
+source_lang = en
+
+[netxms-admin-develop.object-management]
+file_filter = _locale/<lang>/LC_MESSAGES/object-management.po
+source_file = _build/locale/object-management.pot
+source_lang = en
+
+[netxms-admin-develop.preface]
+file_filter = _locale/<lang>/LC_MESSAGES/preface.po
+source_file = _build/locale/preface.pot
+source_lang = en
+
+[netxms-admin-develop.quickstart]
+file_filter = _locale/<lang>/LC_MESSAGES/quickstart.po
+source_file = _build/locale/quickstart.pot
+source_lang = en
+
+[netxms-admin-develop.remote-file-management]
+file_filter = _locale/<lang>/LC_MESSAGES/remote-file-management.po
+source_file = _build/locale/remote-file-management.pot
+source_lang = en
+
+[netxms-admin-develop.reporting]
+file_filter = _locale/<lang>/LC_MESSAGES/reporting.po
+source_file = _build/locale/reporting.pot
+source_lang = en
+
+[netxms-admin-develop.scripting]
+file_filter = _locale/<lang>/LC_MESSAGES/scripting.po
+source_file = _build/locale/scripting.pot
+source_lang = en
+
+[netxms-admin-develop.server-management]
+file_filter = _locale/<lang>/LC_MESSAGES/server-management.po
+source_file = _build/locale/server-management.pot
+source_lang = en
+
+[netxms-admin-develop.sla]
+file_filter = _locale/<lang>/LC_MESSAGES/sla.po
+source_file = _build/locale/sla.pot
+source_lang = en
+
+[netxms-admin-develop.snmp]
+file_filter = _locale/<lang>/LC_MESSAGES/snmp.po
+source_file = _build/locale/snmp.pot
+source_lang = en
+
+[netxms-admin-develop.topology]
+file_filter = _locale/<lang>/LC_MESSAGES/topology.po
+source_file = _build/locale/topology.pot
+source_lang = en
+
+[netxms-admin-develop.user-management]
+file_filter = _locale/<lang>/LC_MESSAGES/user-management.po
+source_file = _build/locale/user-management.pot
+source_lang = en
+
+[netxms-admin-develop.visualisation]
+file_filter = _locale/<lang>/LC_MESSAGES/visualisation.po
+source_file = _build/locale/visualisation.pot
+source_lang = en
+

user/Makefile

@@ -0,0 +1,177 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/AdministratorGuide.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/AdministratorGuide.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/AdministratorGuide"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/AdministratorGuide"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."