[PATCH/RFC] Document some 5.{4,5,6} features in NEWS

[PATCH/RFC] Document some 5.{4,5,6} features in NEWS

[dana]

I was going through the steps for creating a test release and noticed that
some new features in recent releases weren't mentioned in NEWS. I just wanted
to double-check whether there's any strong feeling regarding what's notable
enough for inclusion here. Is this fine, or is it more granular than intended?

(If the former, i'll probably also update creating-a-release.txt to say
something to the effect that NEWS should generally document new features and
serious bug fixes, but not routine fixes or completion/contrib updates.)

dana


diff --git a/NEWS b/NEWS
index 0b0c0e84c..474ab45a6 100644
--- a/NEWS
+++ b/NEWS
@@ -63,9 +63,19 @@ In shell patterns, [[:blank:]] now honours the locale instead of
 matching exclusively on space and tab, like for the other POSIX
 character classes or for extended regular expressions.
 
-Nanosecond precision on file times is supported in the module
+The zsh/system module now provides the PID of the last process
+substitution via $sysparams[procsubstpid].
+
+Time formatting via the %D prompt escape now offers nanosecond
+precision with the %. and %N format specifiers. Additionally,
+nanosecond precision on file times is supported in the module
 zsh/stat.
 
+The zsh/mathfunc module now includes a log2() function.
+
+The parameter ZLE_RECURSIVE has been added to indicate the
+current ZLE recursion level.
+
 Changes from 5.5 to 5.5.1
 -------------------------
 
@@ -89,9 +99,19 @@ typeset -A assoc=([key1]=val1 [key2]=val2)
 is allowed for compatibility with other shells.  In the case of normal
 arrays the new syntax can be mixed with the old.
 
+The %E, %S, and %U TIMEFMT specifiers now support m and u prefixes
+(e.g., %mE) to output times in milliseconds and microseconds,
+respectively.
+
+The option CHECK_RUNNING_JOBS was added to control whether zsh should
+check for running jobs in addition to suspended ones with CHECK_JOBS.
+It is enabled by default.
+
 Changes from 5.3.1 to 5.4.2
 ---------------------------
 
+There are only minor changes between 5.4 and 5.4.2.
+
 The 'exec' and 'command' precommand modifiers, and options to them, are
 now parsed after parameter expansion.  Previously, both the modifier and
 any options to it were parsed between alias expansion and parameter
@@ -111,6 +131,13 @@ turned on for an individual function with "functions -W".
 zmodload now has an option -s to be silent on a failure to find a module
 but still print other errors.
 
+The autoload builtin gained several new features to load functions from a
+file path determined at the time of definition rather than at the time of
+loading.
+
+The zsh/parameter module now exposes the file paths associated with
+shell functions via the parameters functions_source and
+dis_functions_source.
 
 Changes from 5.2 to 5.3.1
 -------------------------

Re: [PATCH/RFC] Document some 5.{4,5,6} features in NEWS

[Bart Schaefer]

On Thu, Jan 3, 2019 at 10:48 AM dana <dana@dana.is> wrote:
>
> I was going through the steps for creating a test release and noticed that
> some new features in recent releases weren't mentioned in NEWS. I just wanted
> to double-check whether there's any strong feeling regarding what's notable
> enough for inclusion here. Is this fine, or is it more granular than intended?

I would say this is about the right level of detail regarding each
change.  I have no opinion on whether everything mentioned here is
signficant enough to have been mentioned.  Your suggestion for
updating creating-a-release.txt seems reasonable.

As long as you're committing this, how about fixing this typo:
> Apart from a fix for a configuration problem finding singal names from

Re: [PATCH/RFC] Document some 5.{4,5,6} features in NEWS

[Peter Stephenson]

On Thu, 2019-01-03 at 12:47 -0600, dana wrote:
> I was going through the steps for creating a test release and noticed that
> some new features in recent releases weren't mentioned in NEWS. I just wanted
> to double-check whether there's any strong feeling regarding what's notable
> enough for inclusion here. Is this fine, or is it more granular than intended?

Looks fine to me.  They're all things users are potentially interested
in, and it's quite impossible to guess what users are *actually*
interested in.

pws

Re: [PATCH/RFC] Document some 5.{4,5,6} features in NEWS

[dana]

On 4 Jan 2019, at 03:21, Peter Stephenson <p.stephenson@samsung.com> wrote:
>Looks fine to me.

Thanks. All done (including the typo)

dana