supervision - discussion about system services, daemon supervision, init, runlevel management, and tools such as s6 and runit
 help / color / mirror / Atom feed
* Re: [PATCH] Fix documentation typos
       [not found] <20230106114736.2650132-1-christian@hohnstaedt.de>
@ 2023-01-06 11:58 ` Laurent Bercot
  2023-01-07  8:34   ` Steve Litt
  0 siblings, 1 reply; 3+ messages in thread
From: Laurent Bercot @ 2023-01-06 11:58 UTC (permalink / raw)
  To: supervision

>-file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found is the <tt>env/</tt>
>+file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found in the <tt>env/</tt>

  Applied, thanks.


>-service readiness, you should give this option along with <tt>up</tt>: the service is ready iff
>+service readiness, you should give this option along with <tt>up</tt>: the service is ready if

  Not a typo. "iff" means "if and only if", as any mathematician will
tell you. :)

--
  Laurent


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] Fix documentation typos
  2023-01-06 11:58 ` [PATCH] Fix documentation typos Laurent Bercot
@ 2023-01-07  8:34   ` Steve Litt
  2023-01-07  9:01     ` alice
  0 siblings, 1 reply; 3+ messages in thread
From: Steve Litt @ 2023-01-07  8:34 UTC (permalink / raw)
  To: supervision

Laurent Bercot said on Fri, 06 Jan 2023 11:58:55 +0000

>>-file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found is the
>><tt>env/</tt> +file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found
>>in the <tt>env/</tt>  
>
>  Applied, thanks.
>
>
>>-service readiness, you should give this option along with
>><tt>up</tt>: the service is ready iff +service readiness, you should
>>give this option along with <tt>up</tt>: the service is ready if  
>
>  Not a typo. "iff" means "if and only if", as any mathematician will
>tell you. :)

I'm not a mathematician, even though once upon a time I could do
partial differential equations. I didn't know iff meant "if and only
if". Just so everyone's on the same page, probably the easiest route to
docs everyone understands is to replace iff with "if and only if".

SteveT

Steve Litt 
Autumn 2022 featured book: Thriving in Tough Times
http://www.troubleshooters.com/bookstore/thrive.htm

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] Fix documentation typos
  2023-01-07  8:34   ` Steve Litt
@ 2023-01-07  9:01     ` alice
  0 siblings, 0 replies; 3+ messages in thread
From: alice @ 2023-01-07  9:01 UTC (permalink / raw)
  To: Steve Litt, supervision

On Sat Jan 7, 2023 at 9:34 AM CET, Steve Litt wrote:
> Laurent Bercot said on Fri, 06 Jan 2023 11:58:55 +0000
>
> >>-file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found is the
> >><tt>env/</tt> +file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found
> >>in the <tt>env/</tt>  
> >
> >  Applied, thanks.
> >
> >
> >>-service readiness, you should give this option along with
> >><tt>up</tt>: the service is ready iff +service readiness, you should
> >>give this option along with <tt>up</tt>: the service is ready if  
> >
> >  Not a typo. "iff" means "if and only if", as any mathematician will
> >tell you. :)
>
> I'm not a mathematician, even though once upon a time I could do
> partial differential equations. I didn't know iff meant "if and only
> if". Just so everyone's on the same page, probably the easiest route to
> docs everyone understands is to replace iff with "if and only if".

as a passerby (and professional bike-shed designer), i would agree that is the
best solution. this isn't really a mathematical context, and it also has the
bonus of not looking like "domain-specific jargon" one can look up; an extra
letter merely looks like a typo to those that don't already know.

>
> SteveT
>
> Steve Litt 
> Autumn 2022 featured book: Thriving in Tough Times
> http://www.troubleshooters.com/bookstore/thrive.htm


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2023-01-07  9:01 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <20230106114736.2650132-1-christian@hohnstaedt.de>
2023-01-06 11:58 ` [PATCH] Fix documentation typos Laurent Bercot
2023-01-07  8:34   ` Steve Litt
2023-01-07  9:01     ` alice

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).