2302
Comment: Add the bug report for DevRef
|
← Revision 42 as of 2009-09-06 11:10:40 ⇥
1922
DebianBug
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## page was renamed from HomepageFieldTransition | |
Line 3: | Line 2: |
## I suggest to rename this page "DpkgHomepageFieldTransition" so wiki visitors don't get confused. ## further more, "dpkg" keyword would be page's title, which is good for Google. |
|
Line 9: | Line 6: |
1.A Implement support in APT frontends: * 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] |
1.A Implement support in APT frontends and libraries: * libapt: '''done''' * Adept Manager: DebianBug:445649 - Can be ignored as Adept is not anymore in testing for now. * aptitude: '''done''' * synaptic: DebianBug:445636 |
Line 17: | Line 15: |
* Developer's Reference: [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445642 #445642] | * Developer's Reference: '''done''' |
Line 19: | Line 17: |
1.C Add Homepage field to dh-make templates. | 1.C Add Homepage field to dh-make templates. '''done''' |
Line 22: | Line 20: |
2. Make lintian stop issuing "I: unknown-field-in-control homepage". | 2. Make lintian stop issuing "I: unknown-field-in-control homepage". '''done''' |
Line 24: | Line 22: |
3. Make linda and lintian issue a warning to packages including a homepage in their extended description. | 3. Make lintian issue a warning to packages including a homepage in their extended description.'''done''' |
Line 26: | Line 24: |
* A related bug: Bug:339829 | 3a. Document Homepage field usage in Wiki Page [[HomepageFieldHOWTO]]. '''done''' |
Line 28: | Line 26: |
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. |
3b. Start advertizing the field. [[http://lists.debian.org/debian-devel-announce/2007/11/msg00006.html|Done by Raphaël Hertzog in debian-devel-announce]]. '''done''' |
Line 38: | Line 28: |
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. | 4. Add Homepage to Debian Policy Manual. '''[[http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Homepage|done]]''' |
Line 40: | Line 30: |
5. After some time, announce mass wishlist bug filing on debian-devel-announce. | 5. After some time, announce mass wishlist bug filing on debian-devel-announce. Stefano Zacchiroli has setup [[http://upsilon.cc/~zack/stuff/homepage-field/|A page with counters]] showing packages using the old pseudo-field and not the new one as well as packages using the new one. |
Line 48: | Line 38: |
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 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. |
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:
libapt: done
Adept Manager: 445649 - Can be ignored as Adept is not anymore in testing for now.
aptitude: done
synaptic: 445636
kpackage: done
packages.debian.org: done
1.B Adapt developer documentation such as the Developer's Reference:
Developer's Reference: done
1.C Add Homepage field to dh-make templates. done
2. Make lintian stop issuing "I: unknown-field-in-control homepage". done
3. Make lintian issue a warning to packages including a homepage in their extended description.done
3a. Document Homepage field usage in Wiki Page HomepageFieldHOWTO. done
3b. Start advertizing the field. Done by Raphaël Hertzog in debian-devel-announce. done
4. Add Homepage to Debian Policy Manual. done
5. After some time, announce mass wishlist bug filing on debian-devel-announce. Stefano Zacchiroli has setup A page with counters showing packages using the old pseudo-field and not the new one as well as packages using the new one.
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 a message from Christian Perrier to debian-devel and the resulting thread. This page amended by Manoj Srivastava and Christian Perrier.