Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

os: docs say nothing about path slash types #44274

Open
bradfitz opened this issue Feb 15, 2021 · 0 comments
Open

os: docs say nothing about path slash types #44274

bradfitz opened this issue Feb 15, 2021 · 0 comments
Labels
Documentation NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Milestone

Comments

@bradfitz
Copy link
Contributor

The os package docs say:

Package os provides a platform-independent interface to operating system functionality. The design is Unix-like, although the error handling is Go-like

But nowhere at https://golang.org/pkg/os/ is "slash" mentioned.

Yet there are two Go packages about paths and their slashes: path and path/filepath.

That quoted line above might suggest only forward slashes are permitted ("the design is Unix-like").

Seems like the os package should say what it permits. Users will wonder: forward only? host native only? either way?

@dmitshur dmitshur added this to the Backlog milestone Feb 16, 2021
@dmitshur dmitshur added the NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one. label Feb 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Projects
None yet
Development

No branches or pull requests

2 participants