deb-shlibs(5): <dependencies> use same syntax than Depends

Document that the "dependencies" field within a shlibs file must use
the same syntax than a "Depends" field in a binary control file.

Reported-by: Niels Thykier <niels@thykier.net>
Closes: #658696

debian/changelog

@@ -92,6 +92,8 @@ dpkg (1.16.2) UNRELEASED; urgency=low
   * Update dpkg-buildpackage to use the "build-arch" (for -B) and
     "build-indep" (for -A) targets unless "make -qn" says that they do not
     exist. Closes: #229357
+  * Improve deb-shlibs(5) to mention that the dependency field must
+    use the same syntax than a Depends field. Closes: #658696
 
   [ Jonathan Nieder ]
   * Bump po4a version in Build-Depends to 0.41, since earlier versions do

man/deb-shlibs.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
 .
-.TH deb\-shlibs 5 "2008-02-17" "Debian Project" "dpkg utilities"
+.TH deb\-shlibs 5 "2012-02-08" "Debian Project" "dpkg utilities"
 .SH NAME
 deb\-shlibs \- Debian shared library information file
 .
@@ -39,7 +39,9 @@ The \fIlibrary\fP and \fIversion\fP fields are whitespace-delimited,
 but the \fIdependencies\fP field extends to the end of the line.  The
 \fItype\fP field is optional and normally not needed.
 .PP
-See the Debian Policy Manual for further details.
+The \fIdependencies\fP field has the same syntax than the \fBDepends\fP
+field in a binary control file, see \fBdeb\-control\fP(5).
+See also the Debian Policy Manual for further details.
 .
 .SH EXAMPLES
 .PP
@@ -62,5 +64,6 @@ This is not the only reason the dependencies might need to be
 tightened; again, see the Debian Policy Manual for details.
 .
 .SH SEE ALSO
+.BR deb\-control (5),
 .BR dpkg\-shlibdeps (1),
 .BR deb\-symbols (5).