Documentation for PPA package naming is inconsistent

Bug #559074 reported by Thorsten Kunz
14
This bug affects 2 people
Affects Status Importance Assigned to Milestone
Launchpad itself
Triaged
Low
Unassigned

Bug Description

Different documents describe different recommended naming conventions for derived source packages uploaded to PPA.

https://help.launchpad.net/Packaging/PPA/Uploading suggests that you should name your custom package like <original_package>~<ppa_name>n[~<series>]

Example: myapp_1.0-2 -> myapp_1.0-2~ppa1~intrepid1

https://help.launchpad.net/Packaging/PPA/BuildingASourcePackage suggests that this is the naming schema supposed to be used: <original_package><ppa_name>n[~<series>]

Example: myapp_1.0-2 -> myapp_1.0-2ppa1~intrepid1

So the difference between the two options seems to be the separation character between the original package name and the PPA name.

Changed in soyuz:
status: New → Triaged
importance: Undecided → Low
assignee: nobody → Matthew Revell (matthew.revell)
Revision history for this message
Anders Kaseorg (andersk) wrote :

My thoughts on this topic, copied from https://answers.launchpad.net/launchpad/+question/105396 :

Note that Debian versions sort roughly as follows:
~ < empty string < number < uppercase < lowercase < + < - < . < _
See dpkg --compare-versions in dpkg(1) if you want to test comparisons yourself.

The difference between -XubuntuY~ppa1 and -XubuntuYppa1 is important, not just conventional, because -XubuntuY~ppa1 is defined as earlier than the corresponding official package -XubuntuY, while -XubuntuYppa1 is later.

The difference between -Xppa1 and -X+ppa1 is also important, because -Xppa1 is less than the next official package Xubuntu1 (*), while -X+ppa1 is later. The difference between -XubuntuYppa1 and -XubuntuY+ppa1 is less important, but it is better to be consistent whether you’re patching -X packages or -XubuntuY packages.

It’s not a good idea to go up to -XubuntuZ~ppa1 where Z = Y+1, either, because the next official Ubuntu package might be a stable release update, in which case it would be -XubuntuY.1 instead of -XubuntuZ.

Therefore, I recommend as a general rule to add ~ppa1 when you are backporting an official package from a later distribution, so that the official package will supersede your package, and add ppa1 with no delimeter when you are adding patches on top of an official package, so that your package will supersede the official package but the next official package will supersede yours.

(* This relies on the happy accident that p comes before u. If you don’t wish to rely on this accident, you could use -Xubuntu0ppa1, but I still recommend avoiding + to help others avoid falling into the -X+ppa1 trap.)

Revision history for this message
Matthew Revell (matthew.revell) wrote :

This is something the new Usability and Communications Specialist can handle as an introductory task.

Changed in launchpad:
assignee: Matthew Revell (matthew.revell) → nobody
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Related questions