Re: Issue in man page proc_timer_stats.5

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

 



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 wouldn't expect this choice of associations to be accepted without
some amount of argument--that's the advantage of proper 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.

Regards,
Branden

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