Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Deprecated attribute needs to be refined #8075

Open
Zimmi48 opened this issue Jul 16, 2018 · 6 comments
Open

Deprecated attribute needs to be refined #8075

Zimmi48 opened this issue Jul 16, 2018 · 6 comments
Labels
kind: enhancement Enhancement to an existing user-facing feature, tactic, etc. kind: user messages Improvement of error messages, new warnings, etc. part: attributes #[attributes] modify the behaviour of vernac sentences.

Comments

@Zimmi48
Copy link
Member

Zimmi48 commented Jul 16, 2018

  1. The deprecated attribute can be applied to any vernacular command, but it only has an effect on Ltac definitions. It is bad to not give an error message, or at least a warning, when it is applied on a command that is not supported.

  2. Both the since= and note= sub-attributes are optional but you need to provide at least one of them. This doesn't make much sense. Note that providing note="" is not the same as not providing note because the printing won't be the same (more spaces in the former case). The same is true for since="" vs no since.

@Zimmi48 Zimmi48 added this to the 8.9+beta1 milestone Jul 16, 2018
@Zimmi48 Zimmi48 added the priority: blocker The next release should be delayed if this is not fixed. label Oct 9, 2018
@Zimmi48 Zimmi48 removed the priority: blocker The next release should be delayed if this is not fixed. label Oct 31, 2018
@Zimmi48 Zimmi48 modified the milestones: 8.9+beta1, 8.10+beta1 Oct 31, 2018
@maximedenes
Copy link
Member

+1

@SkySkimmer
Copy link
Contributor

TBH I'm not sure we want to have since, I would just have an optional note (which may include "since whenever" in the string).

@herbelin
Copy link
Member

herbelin commented Nov 7, 2018

TBH I'm not sure we want to have since, I would just have an optional note (which may include "since whenever" in the string).

That makes sense, why not adopting this simplification.

Do we target 8.9 or 8.10? How to proceed?

@Zimmi48
Copy link
Member Author

Zimmi48 commented Nov 7, 2018

Do we target 8.9 or 8.10? How to proceed?

You target master for sure. You can put it in the 8.9.0 milestone if you want. Then the debate of whether it is backported or not can happen with the RM after the PR has been merged (or just before if this changes where to put the CHANGES entry).

@herbelin
Copy link
Member

herbelin commented Nov 7, 2018

You target master for sure. You can put it in the 8.9.0 milestone if you want. Then the debate of whether it is backported or not can happen with the RM after the PR has been merged (or just before if this changes where to put the CHANGES entry).

Indeed, sounds reasonable.

I'm otherwise a bit lost in who wants to be involved. Should we make an "attributes" maintainer group?

Or maybe, the current de facto status, i.e. that attributes are under the supervision of @SkySkimmer is ok for anyone? Please anyone involved express his position.

@Zimmi48 Zimmi48 added the part: attributes #[attributes] modify the behaviour of vernac sentences. label Mar 27, 2019
@vbgl vbgl modified the milestones: 8.10+beta1, 8.11+beta1 Apr 3, 2019
@ejgallego ejgallego removed this from the 8.11+beta1 milestone Apr 3, 2019
@SkySkimmer
Copy link
Contributor

The deprecated attribute can be applied to any vernacular command, but it only has an effect on Ltac definitions. It is bad to not give an error message, or at least a warning, when it is applied on a command that is not supported.

Should be solved now

Both the since= and note= sub-attributes are optional but you need to provide at least one of them. This doesn't make much sense. Note that providing note="" is not the same as not providing note because the printing won't be the same (more spaces in the former case). The same is true for since="" vs no since.

What do we want to do with this?

TBH I'm not sure we want to have since, I would just have an optional note (which may include "since whenever" in the string).

Now that we use since to categorize deprecation warnings we definitely want to keep it separate from the note.

@SkySkimmer SkySkimmer added kind: user messages Improvement of error messages, new warnings, etc. kind: enhancement Enhancement to an existing user-facing feature, tactic, etc. labels Jun 7, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind: enhancement Enhancement to an existing user-facing feature, tactic, etc. kind: user messages Improvement of error messages, new warnings, etc. part: attributes #[attributes] modify the behaviour of vernac sentences.
Projects
None yet
Development

No branches or pull requests

6 participants