[ISSUE] (Manual.md) No mention of replaces

[ISSUE] (Manual.md) No mention of replaces

[toluschr]

[-- Attachment #1: Type: text/plain, Size: 439 bytes --]

New issue by toluschr on void-packages repository

https://github.com/void-linux/void-packages/issues/22424

Description:
### Expected behavior
A brief explanation of what replaces does, how and when it should be used (>=, <, etc.).

### Actual behavior
Grepping for `replaces` yields results in a lot of packages. However, when reading the manual, the keyword is not mentioned.

### Steps to reproduce the behavior
Read the manual

Re: Manual.md: No mention of replaces

[sgn]

[-- Attachment #1: Type: text/plain, Size: 283 bytes --]

New comment by sgn on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-636409765

Comment:
`replaces` doesn't work the way people usually expected.
Until *someone* go to `xbps` fix it, I think it's unlikely `replaces` will mention it.

Re: Manual.md: No mention of replaces

[ashpooljh]

[-- Attachment #1: Type: text/plain, Size: 471 bytes --]

New comment by ashpooljh on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-723418733

Comment:
Sorry, I'm not sure if I understand it correctly. `replaces` works in a counter-intuitive way, so shouldn't that be the reason to document it better? I also found it used in other packages, and applied it to one of my packages relying heavily on intuition. The lack of documentation leaves me worried if I did something wrong.

Re: Manual.md: No mention of replaces

[ericonr]

[-- Attachment #1: Type: text/plain, Size: 253 bytes --]

New comment by ericonr on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-773744176

Comment:
Now that this mechanism is being used in removed-packages, it should definitely be documented.

@Chocimier ?

Re: Manual.md: No mention of replaces

[Chocimier]

[-- Attachment #1: Type: text/plain, Size: 268 bytes --]

New comment by Chocimier on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-797001570

Comment:
Will documenting as "counter-intuitive and subject to change behaviour, use transitional packages instead" be fine for you?

Re: Manual.md: No mention of replaces

[ericonr]

[-- Attachment #1: Type: text/plain, Size: 435 bytes --]

New comment by ericonr on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-797006114

Comment:
Given b7ce94c73e3d00cbc1c9f07b11306666837868d0, shouldn't it be documented to be used together with transitional packages? And I think it'd be best to have the documentation actually list why it's counter intuitive and what's still undefined / can change, even if it isn't an ideal situation.

Re: Manual.md: No mention of replaces

[ericonr]

[-- Attachment #1: Type: text/plain, Size: 209 bytes --]

New comment by ericonr on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-797006281

Comment:
Otherwise people have to guess and depend on unspoken knowledge...

Re: Manual.md: No mention of replaces

[ashpooljh]

[-- Attachment #1: Type: text/plain, Size: 815 bytes --]

New comment by ashpooljh on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-797017242

Comment:
In addition to any warnings as to the keyword being deprecated, palliative and temporary, it would be really helpful to have a description of how it actually works as is. I understand that this might feel like a step towards "legitimizing" it and leaving it be for a long time, but it's been there for a long time already, used in many packages, and therefore I think it's better to have it properly documented.

To motivate more people to consider using transitional packages and other alternatives to this keyword, I suggest introducing some highly visible warnings to the packaging tools like `xlint` or `xbps-src` shown upon encountering `replaces=` in a template.

Re: Manual.md: No mention of replaces

[github-actions]

[-- Attachment #1: Type: text/plain, Size: 293 bytes --]

New comment by github-actions[bot] on void-packages repository

https://github.com/void-linux/void-packages/issues/22424#issuecomment-1100506775

Comment:
Issues become stale 90 days after last activity and are closed 14 days after that.  If this issue is still relevant bump it or assign it.

Re: [ISSUE] [CLOSED] Manual.md: No mention of replaces

[github-actions]

[-- Attachment #1: Type: text/plain, Size: 442 bytes --]

Closed issue by toluschr on void-packages repository

https://github.com/void-linux/void-packages/issues/22424

Description:
### Expected behavior
A brief explanation of what replaces does, how and when it should be used (>=, <, etc.).

### Actual behavior
Grepping for `replaces` yields results in a lot of packages. However, when reading the manual, the keyword is not mentioned.

### Steps to reproduce the behavior
Read the manual