company-mode: Mention the sorting order

diff --git a/company.el b/company.el
index 1481914bc4bd14d397c737f8da4d76541c8184e5..0aa034286d6c72a53038ceb0d446c9421c23e80b 100644 (file)
--- a/company.el
+++ b/company.el
@@ -709,6 +709,9 @@ The completion data is retrieved using `company-backends' and displayed
 using `company-frontends'.  If you want to start a specific back-end, call
 it interactively or use `company-begin-backend'.
 
+By default, the completions list is sorted alphabetically, unless the
+backend chooses otherwise, or `company-transformers' changes it later.
+
 regular keymap (`company-mode-map'):
 
 \\{company-mode-map}