[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#998165: debian-policy: document and allow Description in the source paragraph



On Wed, Nov 03, 2021 at 11:40:02PM +0100, Bill Allombert wrote:
> Could you clarify what source packages that produce several binary
> packages should do ? Maybe give an example ?

Sure.

Here is how I would use it, for example.

--- a/debian/control
+++ b/debian/control
@@ -25,6 +25,13 @@ Rules-Requires-Root: no
 Homepage: http://xmlsoft.org
 Vcs-Git: https://salsa.debian.org/xml-sgml-team/libxml2.git
 Vcs-Browser: https://salsa.debian.org/xml-sgml-team/libxml2
+Description: GNOME XML library
+ XML is a metalanguage to let you design your own markup language.
+ A regular markup language defines a way to describe information in
+ a certain class of documents (eg HTML). XML lets you define your
+ own customized markup languages for many classes of document. It
+ can do this because it's written in SGML, the international standard
+ metalanguage for markup languages.

 Package: libxml2
 Architecture: any
@@ -36,13 +43,8 @@ Depends:
 Conflicts:
  w3c-dtd-xhtml,
 Multi-Arch: same
-Description: GNOME XML library
- XML is a metalanguage to let you design your own markup language.
- A regular markup language defines a way to describe information in
- a certain class of documents (eg HTML). XML lets you define your
- own customized markup languages for many classes of document. It
- can do this because it's written in SGML, the international standard
- metalanguage for markup languages.
+Description: ${source:Synopsis}
+ ${source:Extended-Description}
  .
  This package provides a library providing an extensive API to handle
  such XML data files.
@@ -54,13 +56,8 @@ Depends:
  ${misc:Depends},
  ${shlibs:Depends},
 Multi-Arch: foreign
-Description: XML utilities
- XML is a metalanguage to let you design your own markup language.
- A regular markup language defines a way to describe information in
- a certain class of documents (eg HTML). XML lets you define your
- own customized markup languages for many classes of document. It
- can do this because it's written in SGML, the international standard
- metalanguage for markup languages.
+Description: ${source:Synopsis} - utilities
+ ${source:Extended-Description}
  .
  This package provides xmllint, a tool for validating and reformatting
  XML documents, and xmlcatalog, a tool to parse and manipulate XML or
@@ -76,13 +73,8 @@ Depends:
 Suggests:
  pkg-config,
 Multi-Arch: same
-Description: Development files for the GNOME XML library
- XML is a metalanguage to let you design your own markup language.
- A regular markup language defines a way to describe information in
- a certain class of documents (eg HTML). XML lets you define your
- own customized markup languages for many classes of document. It
- can do this because it's written in SGML, the international standard
- metalanguage for markup languages.
+Description: ${source:Synopsis} - development files
+ ${source:Extended-Description}
  .
  Install this package if you wish to develop your own programs using
  the GNOME XML library.
@@ -95,13 +87,8 @@ Depends:
 Suggests:
  devhelp,
 Multi-Arch: foreign
-Description: Documentation for the GNOME XML library
- XML is a metalanguage to let you design your own markup language.
- A regular markup language defines a way to describe information in
- a certain class of documents (eg HTML). XML lets you define your
- own customized markup languages for many classes of document. It
- can do this because it's written in SGML, the international standard
- metalanguage for markup languages.
+Description: ${source:Synopsis} - documentation
+ ${source:Extended-Description}
  .
  This package contains general information about the GNOME XML library
  and more specific API references.
@@ -115,13 +102,8 @@ Depends:
  ${misc:Depends},
  ${python3:Depends},
  ${shlibs:Depends},
-Description: Python3 bindings for the GNOME XML library
- XML is a metalanguage to let you design your own markup language.
- A regular markup language defines a way to describe information in
- a certain class of documents (eg HTML). XML lets you define your
- own customized markup languages for many classes of document. It
- can do this because it's written in SGML, the international standard
- metalanguage for markup languages.
+Description: ${source:Synopsis} - Python3 bindings
+ ${source:Extended-Description}
  .
  This package contains the files needed to use the GNOME XML library
  in Python3 programs.


-- 
regards,
                        Mattia Rizzolo

GPG Key: 66AE 2B4A FCCF 3F52 DA18  4D18 4B04 3FCD B944 4540      .''`.
More about me:  https://mapreri.org                             : :'  :
Launchpad user: https://launchpad.net/~mapreri                  `. `'`
Debian QA page: https://qa.debian.org/developer.php?login=mattia  `-

Attachment: signature.asc
Description: PGP signature


Reply to: