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

Complete uuids #28649

Merged
merged 4 commits into from
Aug 16, 2018
Merged

Complete uuids #28649

merged 4 commits into from
Aug 16, 2018

Conversation

matbesancon
Copy link
Contributor

Add documentation to the UUID constructor in Base.

Also rewrote uuid = uuid.value to bytes = uuid.value in the UUID package, it can be confusing to have the UUID struct with the same name as the internal bytes stored as UInt128.

base/uuid.jl Outdated
"""
Represents a Universally Unique Identifier (UUID).
Can be built from a UInt128 (all byte values), from two UInt64 or four UInt32.
Conversion from a string is will check the UUID validity.
Copy link
Contributor

Choose a reason for hiding this comment

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

Typo: "is will"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thanks!

base/uuid.jl Outdated
@@ -1,5 +1,10 @@
# This file is a part of Julia. License is MIT: https://julialang.org/license

"""
Represents a Universally Unique Identifier (UUID).
Can be built from a UInt128 (all byte values), from two UInt64 or four UInt32.
Copy link
Contributor

@waldyrious waldyrious Aug 14, 2018

Choose a reason for hiding this comment

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

I'd suggest wrapping the types in backticks, and perhaps tweaking the phrasing to be more consistent when listing the three options -- e.g. "...from one UInt128 (all byte values), from two UInt64, or from four UInt32." (or only use "from" once). Note also the "a" --> "one", and the added comma after UInt64.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I just re-read it, agreed on all points

@stevengj stevengj merged commit c62555b into JuliaLang:master Aug 16, 2018
KristofferC pushed a commit that referenced this pull request Aug 19, 2018
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
KristofferC pushed a commit that referenced this pull request Aug 19, 2018
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
@KristofferC KristofferC mentioned this pull request Aug 19, 2018
KristofferC pushed a commit that referenced this pull request Aug 19, 2018
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
@matbesancon matbesancon deleted the complete-uuids branch August 23, 2018 14:29
KristofferC pushed a commit that referenced this pull request Sep 8, 2018
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
KristofferC pushed a commit that referenced this pull request Sep 8, 2018
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
@KristofferC KristofferC added docs This change adds or pertains to documentation and removed backport pending 1.0 labels Sep 27, 2018
KristofferC pushed a commit that referenced this pull request Feb 11, 2019
* documented UUID type

* fixed typo

* improved sentence structure from doc

(cherry picked from commit c62555b)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This change adds or pertains to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants