Bug#742364: Patch to document debian/missing-sources
Sean Whitton dijo [Sat, Dec 09, 2017 at 12:16:35PM -0700]: > I am seeking seconds for the following patch: You just found one. Seconded! > > diff --git a/policy/ch-source.rst b/policy/ch-source.rst > > index 37c4442..f8f768f 100644 > > --- a/policy/ch-source.rst > > +++ b/policy/ch-source.rst > > @@ -686,6 +686,26 @@ even if most environment variables and build paths are > > varied. It is > > intended for this stricter standard to replace the above when it is > > easier for packages to meet it. > > > > +Missing sources: ``debian/missing-sources`` > > +--- > > + > > +Sometimes upstream does not include the source code for some files in > > +the upstream tarball. In order to satisfy the DFSG for packages in > > +``main`` or ``contrib``, you should either: > > + > > +1. repack the upstream tarball to include those sources; or > > +2. include a copy of the sources in the ``debian/missing-sources`` > > + directory. > > + > > +There is an optional convention to organise the contents of > > +``debian/missing-sources`` in the following way. For a sourceless > > +file ``foo`` in the subdirectory ``bar`` of the upstream tarball, > > +where the source of ``foo`` has extension ``baz``, the source is to be > > +located at ``debian/missing-sources/bar/foo.baz``. For example, > > +according to this convention, the C source code of an executable > > +``checksum/util`` is to be located at > > +``debian/missing-sources/checksum/util.c``. > > + > > .. [#] > > See the file ``upgrading-checklist`` for information about policy > > which has changed between different versions of this document. signature.asc Description: PGP signature
Bug#742364: Patch to document debian/missing-sources
On Sat, Dec 09, 2017 at 12:16:35PM -0700, Sean Whitton wrote: > I am seeking seconds for the following patch: > > > diff --git a/policy/ch-source.rst b/policy/ch-source.rst > > index 37c4442..f8f768f 100644 > > --- a/policy/ch-source.rst > > +++ b/policy/ch-source.rst > > @@ -686,6 +686,26 @@ even if most environment variables and build paths are > > varied. It is > > intended for this stricter standard to replace the above when it is > > easier for packages to meet it. > > > > +Missing sources: ``debian/missing-sources`` > > +--- > > + > > +Sometimes upstream does not include the source code for some files in > > +the upstream tarball. In order to satisfy the DFSG for packages in > > +``main`` or ``contrib``, you should either: > > + > > +1. repack the upstream tarball to include those sources; or > > +2. include a copy of the sources in the ``debian/missing-sources`` > > + directory. > > + > > +There is an optional convention to organise the contents of > > +``debian/missing-sources`` in the following way. For a sourceless > > +file ``foo`` in the subdirectory ``bar`` of the upstream tarball, > > +where the source of ``foo`` has extension ``baz``, the source is to be > > +located at ``debian/missing-sources/bar/foo.baz``. For example, > > +according to this convention, the C source code of an executable > > +``checksum/util`` is to be located at > > +``debian/missing-sources/checksum/util.c``. > > + > > .. [#] > > See the file ``upgrading-checklist`` for information about policy > > which has changed between different versions of this document. seconded & thanks for your work on this! -- cheers, Holger signature.asc Description: PGP signature
Bug#742364: Patch to document debian/missing-sources
control: severity -1 normal control: tag -1 +patch Hello, I am seeking seconds for the following patch: > diff --git a/policy/ch-source.rst b/policy/ch-source.rst > index 37c4442..f8f768f 100644 > --- a/policy/ch-source.rst > +++ b/policy/ch-source.rst > @@ -686,6 +686,26 @@ even if most environment variables and build paths are > varied. It is > intended for this stricter standard to replace the above when it is > easier for packages to meet it. > > +Missing sources: ``debian/missing-sources`` > +--- > + > +Sometimes upstream does not include the source code for some files in > +the upstream tarball. In order to satisfy the DFSG for packages in > +``main`` or ``contrib``, you should either: > + > +1. repack the upstream tarball to include those sources; or > +2. include a copy of the sources in the ``debian/missing-sources`` > + directory. > + > +There is an optional convention to organise the contents of > +``debian/missing-sources`` in the following way. For a sourceless > +file ``foo`` in the subdirectory ``bar`` of the upstream tarball, > +where the source of ``foo`` has extension ``baz``, the source is to be > +located at ``debian/missing-sources/bar/foo.baz``. For example, > +according to this convention, the C source code of an executable > +``checksum/util`` is to be located at > +``debian/missing-sources/checksum/util.c``. > + > .. [#] > See the file ``upgrading-checklist`` for information about policy > which has changed between different versions of this document. -- Sean Whitton signature.asc Description: PGP signature