Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.bugs.dist > #1200838

Bug#1073119: apt: Clarify dist-upgrade & full-upgrade are identical, and pick one as preferred, in man pages

Show all headers | View raw

On 13/6/24 20:08, Julian Andres Klode wrote:
> Well yes that is intentional, dist-upgrade is a misleading name, so 
> the more user-friendly apt(8) tool has it renamed to full-upgrade, 
> but of course we keep muscle memory compatibility modes.

There is no suggestion to change the commands, themselves, only to pick 
a consistent approach in the documentation.

> We support various other typo/muscle memory aliases that aren't 
> necessarily documented.

Perhaps they also should be.

>> Both man pages should list both commands as alternate terms, and 
>> all references to the command in the synopsis and other sections 
>> should only use the preferred term. Ideally, both documents would 
>> prefer the same term, for consistency, but at least each should be 
>> self-consistent.
> 
> I must say I don't care much about these nitpicks.

If it were nitpicking, there wouldn't be as many questions on the
Internet like <https://askubuntu.com/q/770135>. Users don't know whether
there's a difference, and the man page won't tell them.

> The manual pages are in total disarray and need to be rewritten from 
> scratch, with one per subcommand, they're not useful in their current
> shape.

That seems a tad dramatic. They *are* useful and people are still taught
that man pages are the first thing they should consult.

Back to linux.debian.bugs.dist | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Bug#1073119: apt: Clarify dist-upgrade & full-upgrade are identical, and pick one as preferred, in man pages Roy Orbitson <roy-orbitson@devo.net.au> - 2024-06-13 04:30 +0200
  Bug#1073119: apt: Clarify dist-upgrade & full-upgrade are identical, and pick one as preferred, in man pages Julian Andres Klode <jak@debian.org> - 2024-06-13 12:40 +0200
    Bug#1073119: apt: Clarify dist-upgrade & full-upgrade are identical, and pick one as preferred, in man pages Roy Orbitson <roy-orbitson@devo.net.au> - 2024-06-14 05:20 +0200

csiph-web