The following commit has been merged in the master branch:
commit d9b3d3ca35d99c19a26e37e18f77863dda04c430
Author: Markus Koschany <[email protected]>
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
_______________________________________________
Blends-commit mailing list
[email protected]
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/blends-commit
