[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#36206: [PATCH] Change `user-error' docstring from "pilot error" to "
|
From: |
Stefan Kangas |
|
Subject: |
bug#36206: [PATCH] Change `user-error' docstring from "pilot error" to "user error" |
|
Date: |
Fri, 14 Jun 2019 13:09:06 +0200 |
The documentation of `user-error' says that it will "Signal a pilot
error", which I personally find confusing. For starters, "pilot"
could also mean "done as an experiment or test before being introduced
more widely".
It's more clear to say "user error". I don't have any data on this,
but in my experience this is also more in line with how other
programming languages names this class of errors.
See the attached patch for my suggested improvements.
Thanks,
Stefan Kangas
0001-Clarify-error-and-user-error-docstrings.patch
Description: Text Data