Re: Issue in man page proc_timer_stats.5

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

 



Hello Branden,
hello Alex,
Am Sun, Nov 17, 2024 at 10:43:43AM -0600 schrieb G. Branden Robinson:
> At 2024-11-17T12:33:13+0100, Alejandro Colomar wrote:
> > 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.

This was my main point - consistent usage.

(This will also ease translations).

Greetings

        Helge

-- 
      Dr. Helge Kreutzmann                     debian@xxxxxxxxxxxxx
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

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