Re: Issue in man page proc_timer_stats.5

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Branden,

On Sun, Nov 17, 2024 at 10:43:43AM GMT, G. Branden Robinson wrote:
> Hi Alex,
> 
> At 2024-11-17T12:33:13+0100, Alejandro Colomar wrote:
> > Hi Helge,
> > 
> > On Sun, Nov 17, 2024 at 10:46:22AM GMT, Helge Kreutzmann wrote:
> > > Without further ado, the following was found:
> > > 
> > > Issue:    Other pages don't use FROM and until → to - maybe align?
> > 
> > When a feature is discontinued, "from" makes more sense than "since".
> > "Since" means that it still exists today.
> > 
> > I'll eventually do a consistency fix in this regard.
> > 
> > About until/to, I think until is more common.  I'll also check.
> 
> Where the value of unambiguous expression is paramount, it's hard to
> beat interval notation, like "[2.6.24, 6.3)".
> 
> Failing that, I would select a fixed set of English words to correspond
> to interval notation, and document that, probably in man-pages(7).
> 
> For instance, and just spitballing here:
> 
> 	since	[
> 	after	(
> 	until	)
> 	through	]

I kind of did that, but it seems I didn't do it well.  There are a few
places where it's not consistent.

']' (through) is something we don't use.  Normally, we specify the
version when something was fixed, but not the last broken one.

And about since, is it correct English to say "since x until y"?  Or is
it more correct to say "from x until y"?

In my head, it would be:

	[x, y)		From x until y.  (I think we also use
			                  since...until somtimes.)
	[0, y)		Until y.
	[x, today]	Since x.

I think those are all the common uses of these terms.

> 
> I wouldn't expect this choice of associations to be accepted without
> some amount of argument--that's the advantage of proper interval
> notation.

I might be convinced to use interval notation.  I'll first try to be
consistent using English terms, and after that I'll consider a second
pass of changes that might transform to interval notation.

> 
> But, if interval notation is thought too unfamiliar or too awkward-
> looking for man page readers and/or contributors, such a mapping of
> English words to it might be the next best thing.  Disciplined use of
> the terms will be important.

Cheers,
Alex

> 
> Regards,
> Branden



-- 
<https://www.alejandro-colomar.es/>

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux