hints: Rephrase documentation to improve grammar

smcv · slouken · commit 40b941c82699 · 2025-08-07T13:55:15.000-07:00
"This thing allows to do something" is not really grammatically correct.
The closest rephrasing would be "allows one to do something" or "allows
the user to do something", but I think the passive voice reads more
naturally here.

Detected by Debian's lintian QA tool.

Signed-off-by: Simon McVittie &lt;smcv@collabora.com&gt;
diff --git a/include/SDL3/SDL_hints.h b/include/SDL3/SDL_hints.h
@@ -595,7 +595,7 @@ extern "C" {
  * A variable that limits what CPU features are available.
  *
  * By default, SDL marks all features the current CPU supports as available.
- * This hint allows to limit these to a subset.
+ * This hint allows the enabled features to be limited to a subset.
  *
  * When the hint is unset, or empty, SDL will enable all detected CPU
  * features.

Original file line number	Diff line number	Diff line change
`@@ -595,7 +595,7 @@ extern "C" {`
`595`	`595`	`* A variable that limits what CPU features are available.`
`596`	`596`	`*`
`597`	`597`	`* By default, SDL marks all features the current CPU supports as available.`
`598`		`- * This hint allows to limit these to a subset.`
	`598`	`+ * This hint allows the enabled features to be limited to a subset.`
`599`	`599`	`*`
`600`	`600`	`* When the hint is unset, or empty, SDL will enable all detected CPU`
`601`	`601`	`* features.`