Re: revised patch: zshmisc(1) clarify non-successful exit statuses

[Daniel Shahaf <d.s@xxxxxxxxxxxxxxxxxx>]

zeurkous@xxxxxxxx wrote on Mon, Apr 26, 2021 at 18:25:12 +0200:
> Making another revision. A question (well, two) below. 
> 
> "Bart Schaefer" <schaefer@xxxxxxxxxxxxxxxx> wrote:
> > On Fri, Apr 23, 2021 at 5:19 AM <zeurkous@xxxxxxxx> wrote:
> >
> >> +If execution fails: an error message is printed, and one of the
> >> +following values is returned.
> >
> > I would move this along with the sitem list to the very end, to follow
> > the paragraph about the command_not_found handler.
> >
> > Then change "If execution fails:" to "When there is no handler and
> > execution fails,".
> 
> Presuming that most people won't bother to install such a handler: isn't
> it better to put the more-used information first?
> 

Sounds good to me: describe the common/default case first and layer on
exceptions second.  Bart, WDYT?

> Besides, isn't the handler an additional feature like AUTO_CD, that
> modifies the earlier-stated behaviour...?