unposted: document order of entries for $history and $historywords

1 files changed, 5 insertions, 1 deletions

diff --git a/Doc/Zsh/mod_parameter.yo b/Doc/Zsh/mod_parameter.yo
index 9d1dc8b7d..3d260f8e9 100644
--- a/Doc/Zsh/mod_parameter.yo
+++ b/Doc/Zsh/mod_parameter.yo
@@ -123,10 +123,14 @@ directory, the current working directory.
 vindex(history)
 item(tt(history))(
 This associative array maps history event numbers to the full history lines.
+Although it is presented as an associative array, the array of all values
+(tt(${history[@]})) is guaranteed to be returned in order from most recent
+to oldest history event, that is, by decreasing history event number.
 )
 vindex(historywords)
 item(tt(historywords))(
-A special array containing the words stored in the history.
+A special array containing the words stored in the history.  These also
+appear in most to least recent order.
 )
 vindex(jobdirs)
 item(tt(jobdirs))(