Skip to content

Commit a31b13e

Browse files
[DOC] Update for Pathname.ctime (ruby#17370)
1 parent 3c3269b commit a31b13e

1 file changed

Lines changed: 23 additions & 44 deletions

File tree

pathname_builtin.rb

Lines changed: 23 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1169,50 +1169,29 @@ def birthtime() File.birthtime(@path) end
11691169
# see {File System Timestamps}[rdoc-ref:file/timestamps.md]:
11701170
#
11711171
# ```ruby
1172-
# # Work in a temporary directory.
1173-
# Pathname.mktmpdir do |tmpdirpath|
1174-
# # A subdirectory therein, and its Pathname.
1175-
# dirpath = File.join(tmpdirpath, 'subdir')
1176-
# dir_pn = Pathname(dirpath)
1177-
# puts "Create directory; directory ctime established."
1178-
# dir_pn.mkdir
1179-
# puts " Directory ctime: #{dir_pn.ctime}"
1180-
# sleep(1)
1181-
#
1182-
# # A file in the subdirectory, and its Pathname.
1183-
# filepath = File.join(dirpath, 't.txt')
1184-
# file_pn = Pathname(filepath)
1185-
# puts "Create file; file ctime established; directory ctime updated."
1186-
# file_pn.write('foo')
1187-
# puts " File ctime: #{file_pn.ctime}"
1188-
# puts " Directory ctime: #{dir_pn.ctime}"
1189-
# sleep(1)
1190-
# puts "Write file; file ctime updated; directory ctime not updated."
1191-
# file_pn.write('bar')
1192-
# puts " File ctime: #{file_pn.ctime}"
1193-
# puts " Directory ctime: #{dir_pn.ctime}"
1194-
# sleep(1)
1195-
# puts "Read file; neither ctime not updated."
1196-
# file_pn.read
1197-
# puts " File ctime: #{file_pn.ctime}"
1198-
# puts " Directory ctime: #{dir_pn.ctime}"
1199-
# end
1200-
# ```
1201-
#
1202-
# Output:
1203-
#
1204-
# ```text
1205-
# Create directory; directory ctime established.
1206-
# Directory ctime: 2026-05-20 14:05:05 -0500
1207-
# Create file; file ctime established; directory ctime updated.
1208-
# File ctime: 2026-05-20 14:05:06 -0500
1209-
# Directory ctime: 2026-05-20 14:05:06 -0500
1210-
# Write file; file ctime updated; directory ctime not updated.
1211-
# File ctime: 2026-05-20 14:05:07 -0500
1212-
# Directory ctime: 2026-05-20 14:05:06 -0500
1213-
# Read file; neither ctime not updated.
1214-
# File ctime: 2026-05-20 14:05:07 -0500
1215-
# Directory ctime: 2026-05-20 14:05:06 -0500
1172+
# # A directory and its Pathname.
1173+
# dir_path = 'doc/foo'
1174+
# dir_pn = Pathname(dir_path)
1175+
# # Create directory; directory ctime established.
1176+
# dir_pn.mkdir
1177+
# dir_pn.ctime # => 2026-06-16 16:44:15.86720572 -0500
1178+
# # A file therein and its Pathname.
1179+
# file_path = dir_pn.join('t.tmp')
1180+
# file_pn = Pathname(file_path)
1181+
# # Create file; file ctime established; directory ctime updated.
1182+
# file_pn.write('foo')
1183+
# file_pn.ctime # => 2026-06-16 16:46:00.734974872 -0500
1184+
# dir_pn.ctime # => 2026-06-16 16:46:00.734974872 -0500
1185+
# # Write file; file ctime updated; directory ctime not updated.
1186+
# file_pn.write('bar')
1187+
# file_pn.ctime # => 2026-06-16 16:49:11.421204188 -0500
1188+
# dir_pn.ctime # => 2026-06-16 16:46:00.734974872 -0500
1189+
# # Read file; neither ctime updated.
1190+
# file_pn.read
1191+
# file_pn.ctime # => 2026-06-16 16:49:11.421204188 -0500
1192+
# dir_pn.ctime # => 2026-06-16 16:46:00.734974872 -0500
1193+
# # Clean up.
1194+
# dir_pn.rmtree
12161195
# ```
12171196
#
12181197
def ctime() File.ctime(@path) end

0 commit comments

Comments
 (0)