develooper Front page | perl.perl5.porters | Postings from April 2016

[perl #127991] [PATCH] Correct an incorrect file ts name in perlportPOD

Thread Previous
From:
James E Keenan via RT
Date:
April 25, 2016 22:34
Subject:
[perl #127991] [PATCH] Correct an incorrect file ts name in perlportPOD
Message ID:
rt-4.0.18-1995-1461623674-1521.127991-15-0@perl.org
On Mon Apr 25 14:36:53 2016, jmaslak@antelope.net wrote:
> From 1b68359c5bfd67563f3263132802a60ed007748b Mon Sep 17 00:00:00 2001
> From: Joel Maslak <jmaslak@antelope.net>
> Date: Mon, 25 Apr 2016 15:00:57 -0600
> Subject: [PATCH] Correct an incorrect file ts name in perlport POD The
> POD
>  refers to "change" timestamp when what is really intended is
> "creation"
>  timestamp.
> To: perlbug@perl.org
> 
> ---
> pod/perlport.pod | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/pod/perlport.pod b/pod/perlport.pod
> index 15d411c..6f7e164 100644
> --- a/pod/perlport.pod
> +++ b/pod/perlport.pod
> @@ -264,7 +264,7 @@ S<Mac OS> 9 and earlier used C<:> as a path
> separator instead of C</>.
>  The filesystem may support neither hard links (C<link>) nor
>  symbolic links (C<symlink>, C<readlink>, C<lstat>).
> 
> -The filesystem may support neither access timestamp nor change
> +The filesystem may support neither access timestamp nor creation
>  timestamp (meaning that about the only portable timestamp is the
>  modification timestamp), or one second granularity of any timestamps
>  (e.g. the FAT filesystem limits the time granularity to two seconds).

I recommend rejecting this documentation modification.  The change in wording from "change" to "creation" is non-trivial given that not all operating systems support a "creation time" timestamp.

See the POSIX specification discussion of this issue at:
http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html, section 4.8 File Times Update.

This is also discussed in these two forum posts:

http://unix.stackexchange.com/questions/91197/how-to-find-creation-date-of-file

http://superuser.com/questions/387042/how-to-check-all-timestamps-of-a-file

See also: perldoc -f stat

The current wording in perlport is more consistent with both the Perl 'stat' function and with the POSIX specification and should be retained.

Thank you very much.

-- 
James E Keenan (jkeenan@cpan.org)

---
via perlbug:  queue: perl5 status: new
https://rt.perl.org/Ticket/Display.html?id=127991

Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About