Differences between revisions 18 and 19
Revision 18 as of 2007-10-07 17:39:02
Size: 2372
Comment: Add reference to the lintian bug
Revision 19 as of 2007-10-07 17:44:24
Size: 2115
Comment: Warning to packages using the pseudo field is also #444336
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:
 * Adept Manager: [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445649 #445649]
 * aptitude: [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445244 #445244]
 * synaptic: [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445636 #445636]
 * Adept Manager: Bug:445649
 * aptitude: Bug:445244
 * synaptic: Bug:445636
Line 17: Line 17:
 * Developer's Reference: [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445642 #445642]  * Developer's Reference: Bug:445642
Line 22: Line 22:
2. Make lintian stop issuing "I: unknown-field-in-control homepage". See [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=444336 #444336] 2. Make lintian stop issuing "I: unknown-field-in-control homepage". See Bug:444336
Line 26: Line 26:
 * A related bug: Bug:339829  * lintian: Bug:339829 and Bug:444336 (merged)

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:

  • Adept Manager: 445649

  • aptitude: 445244

  • synaptic: 445636

  • kpackage: done

  • packages.debian.org: done

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

  • Developer's Reference: 445642

1.C Add Homepage field to dh-make templates.

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.

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.