Skip to content

Document std::env::const values #25668

New issue

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

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

Already on GitHub? # to your account

Merged
merged 1 commit into from
May 27, 2015
Merged

Conversation

steveklabnik
Copy link
Member

No description provided.

@rust-highfive
Copy link
Contributor

r? @nikomatsakis

(rust_highfive has picked a reviewer for you, use r? to override)

/// - dragonfly
/// - bitrig
/// - openbsd
/// - android
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing something for windows?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

whoops, that was the last line of my git grep, accidentally deleted it

@bluss
Copy link
Member

bluss commented May 21, 2015

Should we say that the set of possible values can change (grow) in the future?

@steveklabnik
Copy link
Member Author

That's always true of a non-enum, though.

@alexcrichton
Copy link
Member

Looks good to me, thanks @steveklabnik! I agree with @bluss though that the phrasing may want to indicate that it's not an exhaustive list (e.g. I don't want a bug to be opened saying that the documentation disagrees with the implementation). Perhaps something like "Some possible values:" in the sense that the "Some" indicates that this is just a subset.

@alexcrichton
Copy link
Member

Other than that though r=me

@nikomatsakis
Copy link
Contributor

r? @alexcrichton

@steveklabnik
Copy link
Member Author

@bors: r=alexcrichton rollup

@bors
Copy link
Collaborator

bors commented May 26, 2015

📌 Commit 04c7b82 has been approved by alexcrichton

/// Some possible values:
///
/// - unix
/// - windows
#[stable(feature = "env", since = "1.0.0")]
pub const FAMILY: &'static str = super::os::FAMILY;

/// A string describing the specific operating system in use: in this
/// case, `linux`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this a leftover? I don't think this documentation is Linux-specific.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation is currently built on Linux, and so all of these examples have something like this.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this file generated by some script? Otherwise this should probably be changed.

Manishearth added a commit to Manishearth/rust that referenced this pull request May 27, 2015
Manishearth added a commit to Manishearth/rust that referenced this pull request May 27, 2015
bors added a commit that referenced this pull request May 27, 2015
@bors bors merged commit 04c7b82 into rust-lang:master May 27, 2015
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants