Differences between revisions 24 and 25
Revision 24 as of 2007-10-25 07:05:02
Size: 2225
Comment: Add bug for libapt
Revision 25 as of 2007-10-31 14:12:58
Size: 2298
Editor: ZugSchlus
Comment: Add reference to HomepageFieldHOWTO
Deletions are marked like this. Additions are marked like this.
Line 30: Line 30:
3a. Document Homepage field usage in Wiki Page ["HomepageFieldHOWTO"]

dpkg >= 1.14.6 supports the use of a "Homepage:" field in debian/control. This should replace the Homepage pseudo-field in extended descriptions.

Transition plan

1.A Implement support in APT frontends and libraries:

1.B Adapt developer documentation such as the Developer's Reference:

  • Developer's Reference: 445642

1.C Add Homepage field to dh-make templates. 445678 (pending in the package SVN repository)

2. Make lintian stop issuing "I: unknown-field-in-control homepage". See 444336

3. Make linda and lintian issue a warning to packages including a homepage in their extended description.

3a. Document Homepage field usage in Wiki Page ["HomepageFieldHOWTO"]

4. Add Homepage to Debian Policy Manual as a suggestion:

  • Add an item to "Binary package control files -- DEBIAN/control"
    • Homepage (no "mandatory" mention)
  • Add a level 3 section to "List of fields":
    • Homepage

The upstream project's home page URL. It should preferably contain and http(s) URL linking to a page describing the upstream project with access to the project's resources. This is an optional field.

Maybe move this as first step as debian/control fields are indeed described in the policy. The point would be to have a good reference describing that field without making it mandatory.

5. After some time, announce mass wishlist bug filing on debian-devel-announce.

6. After some time, proceed to mass wishlist bug filing.

7. After even more time, change the policy manual to should

8. file yet another round of bugs, now non-wishlist.

This page is based on [http://lists.debian.org/debian-devel/2007/09/msg00628.html a message from Christian Perrier to debian-devel] and the resulting thread. This page amended by Manoj Srivastava and Christian Perrier.