Bug #7112: File.extname documentation fix

• Status: Closed
• Assignee: zzak (zzak _)
• Target version: 2.0.0
• ruby -v: ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-linux]

[noah256 (Noah Silas)]

The documentation says that File.extname returns the portion of the filename after the period, while the actual output includes the period. Update the documentation to reflect this.

[Eregon (Benoit Daloze)]

Good catch!

There are a few special cases:

• dotfiles (e.g.: ".hidden") have "" for extname and ".hidden" for basename.
• files ending with a dot report "" as extname (done by rb_file_s_extname())
• looking at ruby_enc_find_extname(), the part after ':' is not kept for NTFS paths.

[zzak (zzak _)]

Eregon, what do you suggest?

I sorta feel like covering every special case would be bad, but maybe add a few more examples?

[mame (Yusuke Endoh)]

• Status changed from Open to Assigned
• Assignee set to drbrain (Eric Hodel)

Drbrain, could you handle this?

--
Yusuke Endoh [e-mail]

[drbrain (Eric Hodel)]

I think adding documentation for dotfiles and files ending with a dot would be sufficient.

I don't think covering filesystem-specific behavior is necessarily useful.

[zzak (zzak _)]

• Assignee changed from drbrain (Eric Hodel) to zzak (zzak _)
• Target version set to 2.0.0

[zzak (zzak _)]

• Status changed from Assigned to Closed
• % Done changed from 0 to 100

This issue was solved with changeset r37749.
Noah, thank you for reporting this issue.
Your contribution to Ruby is greatly appreciated.
May Ruby be with you.

---

• file.c (File.extname): Documentation for extname on dotfiles and
  files ending with a dot. Also, added example for this.
  [ruby-core:47852] [Bug #7112]