Given that Ruby is now aiming for Windows 8 support, all plain-text documentation files should have a .txt extension. This allows Windows users to easily open the files; since Windows relies on the file extension to determine which app to open the file with. For files that contain RDoc formatting, add a .rdoc extension. This proposed change does not conflict with GNU Coding Standards [1], which only specifies the required names of project files and not their extensions.
Files to rename:
sample/README (.txt)
spec/README (.rdoc)
COPYING (.txt)
ChangeLog (.txt)
GPL (.txt)
README (.txt)
doc/ChangeLog-YARV (.txt)
doc/pty/README (.txt)
doc/rake/README (.rdoc)
doc/rake/CHANGES (.rdoc)
doc/rubygems/README (.rodc)
NEWS (.rdoc)
test/rdoc/README (.txt) (only contains "you don't have to" ??)
In the case of RDoc files, perhaps it would be a good time to go a step further and move to an "industry standard" format, Markdown. I believe rdoc tool now supports Markdown, yes?
Instead of changing the Priority to "Low" (which I suspect means "watch wither on the vine") why don't you change it to "Get'er Done"!? Postmodern has already done most the work with the list he gave, just ask him to submit the patch be done with it. If there is some deeper concern with this idea (which for a feature request is about is simple as it can get) then communicate it.
More than filename and extensions, there is a line-ending issue.
All the source code is LF (unix) which will result in something unreadable if opened with plain notepad (at least Windows 7 does a terrible job).
I don't see all these files change line endings just to satisfy the Windows users. Normal developers will have a robust/better editor than Notepad which means filename with or without extensions to look around the source seems moot.
I might be wrong, but at least I'm a Windows Ruby user and developer.
On 23/01/13 22:48, luislavena (Luis Lavena) wrote:
Issue #7712 has been updated by luislavena (Luis Lavena).
Hello,
More than filename and extensions, there is a line-ending issue.
All the source code is LF (unix) which will result in something unreadable if opened with plain notepad (at least Windows 7 does a terrible job).
I don't see all these files change line endings just to satisfy the Windows users. Normal developers will have a robust/better editor than Notepad which means filename with or without extensions to look around the source seems moot.
I might be wrong, but at least I'm a Windows Ruby user and developer.
That assumes people only open files from within their editor. Way back
when I was using Windows regularly I switched Scite in for Notepad so
double-clicking a .txt opened something moderately sane. This seems
like a reasonable thing to want to do, and can't work without file
extensions.
Given that Ruby is now aiming for Windows 8 support, all plain-text documentation files should have a .txt extension. This allows Windows users to easily open the files; since Windows relies on the file extension to determine which app to open the file with. For files that contain RDoc formatting, add a .rdoc extension. This proposed change does not conflict with GNU Coding Standards [1], which only specifies the required names of project files and not their extensions.
Files to rename:
sample/README (.txt)
spec/README (.rdoc)
COPYING (.txt)
ChangeLog (.txt)
GPL (.txt)
README (.txt)
doc/ChangeLog-YARV (.txt)
doc/pty/README (.txt)
doc/rake/README (.rdoc)
doc/rake/CHANGES (.rdoc)
doc/rubygems/README (.rodc)
NEWS (.rdoc)
test/rdoc/README (.txt) (only contains "you don't have to" ??)