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

Remove undocumented quotelang extenders #5436

Closed
wants to merge 1 commit into from

Conversation

lizmat
Copy link
Contributor

@lizmat lizmat commented Oct 21, 2023

The primary quotelang markers q, qq, and Q allow for a number of extenders according to the documentation: w, ww, and x. So instead of qw, one could also say q:w, and instead of qqww one could also say qq:ww.

The grammar however ALSO allows for: to, s, a, h, f, c, b, o. Allowing one to say qqto and Qf (to name but two of the possible combinations).

I think this is taking the TIMTOWTDO a little too far. So this commit removes support for these undocumented quotelang extenders.

This breaks three spectest files:

  • t/spec/S02-literals/misc-interpolation.t
  • t/spec/S02-literals/quoting.t
  • t/spec/integration/advent2014-day16.t

because they check for a, b and to as quotelang extenders respectively. If this change is OKd, then these tests will have to be adapted. The adaptation is quite simple: add a colon.

The primary quotelang markers q, qq, and Q allow for a number of extenders
according to the documentation: w, ww, and x.  So instead of qw, one could
also say q:w, and instead of qqww one could also say qq:ww.

The grammar however **ALSO** allows for: to, s, a, h, f, c, b, o.  Allowing
one to say qqto and Qf (to name but two of the possible combinations).

I think this is taking the TIMTOWTDO a little too far.  So this commit
removes support for these undocumented quotelang extenders.

This breaks three spectest files:
- t/spec/S02-literals/misc-interpolation.t
- t/spec/S02-literals/quoting.t
- t/spec/integration/advent2014-day16.t

because they check for a, b and to as quotelang extenders respectively.
If this change is OKd, then these tests will have to be adapted.  The
adaptation is quite simple: add a colon.
@raiph
Copy link
Contributor

raiph commented Oct 23, 2023

FWIW I like them. I won't elaborate on why just yet because others might like them too and explain why, or pretty much everyone else thinks it's fine for them to go, and if so, I wouldn't argue against this PR being merged.

@lizmat
Copy link
Contributor Author

lizmat commented Oct 23, 2023

Well, if people like them, they should be tested and documented :-)

@raiph
Copy link
Contributor

raiph commented Oct 23, 2023

Notes to self and anyone who wants these to stay:

  • There are tests for each of the combinations if one ignores Q vs q vs qq, except, I think, qv.

  • They need to be documented.

Notes to everyone:

  • If these are to go, does that warrant a deprecation process?

@TimToady
Copy link
Contributor

TimToady commented Oct 24, 2023 via email

@lizmat lizmat closed this Oct 24, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants