[Blends-commit] [SCM] blends-dev branch, master, updated. 6311eeb1648c0df641343144669b15587abb3787

[Andreas Tille]

The following commit has been merged in the master branch:
commit d9b3d3ca35d99c19a26e37e18f77863dda04c430
Author: Markus Koschany <apo at gambaru.de>
Date:   Wed Feb 25 01:45:35 2015 +0100

    Improve task file documentation.
    
    Closes: #764591

diff --git a/doc/en/A_devel.xml b/doc/en/A_devel.xml
index 0fdad0e..62b1f5c 100644
--- a/doc/en/A_devel.xml
+++ b/doc/en/A_devel.xml
@@ -137,7 +137,9 @@ The syntax of the <filename>tasks</filename> files which serve as the central
 database for the information in the <filename>debian/control</filename> file
 is defined by RFC822.  Some of the tags were mentioned formerly in
 <xref linkend="packageslist"/> to explain how the <filename>tasks</filename> files
-can be used to create the web sentinel pages.  Now the tags that
+can be used to create the web sentinel pages. In order to write valid task
+files it is mandatory to separate a task file paragraph by an empty line.
+Otherwise the task pages of the web sentinel will not be built correctly. Now the tags that
 influence the creation of the <filename>debian/control</filename> file are given.
 </para>
 <para>
@@ -228,6 +230,22 @@ influence the creation of the <filename>debian/control</filename> file are given
 </para>
 </sect2>
 
+<para>
+Example:
+<informalexample>
+ <programlisting>
+Task: finest
+Description: the finest software
+
+Depends: foo
+
+Depends: bar
+
+Suggests: foobar
+ </programlisting>
+</informalexample>
+</para>
+
 <sect2 id="statusdump">
   <title><package>statusdump</package></title>
 

-- 
Git repository for blends code