Skip to content
This repository has been archived by the owner on May 4, 2019. It is now read-only.

update docstrings to new format #162

Merged
merged 1 commit into from
Nov 17, 2016
Merged

Conversation

RatanRSur
Copy link
Contributor

Shamelessly took the low hanging fruit :)

@ararslan
Copy link
Member

Thanks for the contribution!

As an aside, it's best not to use the @ symbol at all in commit messages, since it actually ends up sending a notification to the user with that name. In this case, this person has gotten or will get a notification. I think the common practice is to say at-doc or doc macro, etc. in commit messages. If you'd like, you can git commit --amend and then force push to your branch.

So that GitHub will auto-close the issue once this is merged: Fixes #159

@doc """
`broadcast!(f, B::NullableArray, As::NullableArray...; lift::Bool=false)`
"""
`broadcast!(f, B::NullableArray, As::NullableArray...; lift::Bool=false)`
Copy link
Member

Choose a reason for hiding this comment

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

When these are indented, the backticks should be removed.

@RatanRSur RatanRSur force-pushed the master branch 2 times, most recently from a04aa1e to 670daad Compare October 14, 2016 01:40
@RatanRSur
Copy link
Contributor Author

Oh, cool I did not know that about @'s. Thanks!

Let me know if there are more changes.

@RatanRSur RatanRSur changed the title remove @doc's and add spaces before function signatures update docstrings to new format Oct 14, 2016
@doc """
`nullify!(X::NullableArray, I...)`
"""
nullify!(X::NullableArray, I...)

This is a convenience method to set the entry of `X` at index `I` to be null
""" ->
Copy link
Member

Choose a reason for hiding this comment

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

The arrows at the end of the doc strings should also go; they aren't part of the new syntax.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done, also I noticed I messed up and used 3 space indents so I fixed that as well

@RatanRSur RatanRSur force-pushed the master branch 3 times, most recently from 471ce16 to 3f8c304 Compare October 14, 2016 02:03
@codecov-io
Copy link

codecov-io commented Oct 14, 2016

Current coverage is 84.70% (diff: 100%)

Merging #162 into master will not change coverage

@@             master       #162   diff @@
==========================================
  Files            14         14          
  Lines           863        863          
  Methods           0          0          
  Messages          0          0          
  Branches          0          0          
==========================================
  Hits            731        731          
  Misses          132        132          
  Partials          0          0          

Powered by Codecov. Last update 658ca22...3f8c304

@ararslan
Copy link
Member

@davidagold Is the nightly failure a known issue?

Copy link
Member

@nalimilan nalimilan left a comment

Choose a reason for hiding this comment

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

Thanks! Looks good apart from a few details.

@doc """
`broadcast!(f, B::NullableArray, As::NullableArray...; lift::Bool=false)`
"""
broadcast!(f, B::NullableArray, As::NullableArray...; lift::Bool=false)
This method implements the same behavior as that of `broadcast!` when called on
Copy link
Member

Choose a reason for hiding this comment

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

Missing line break here.

Base.endof(X::NullableArray) = endof(X.values) # -> Int

@doc """

""" ->
Copy link
Member

Choose a reason for hiding this comment

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

This empty comment is weird, probably time to remove it.

@doc """
`NullableArray{T, N}` is an efficient alternative to `Array{Nullable{T}, N}`.
"""
NullableArray{T, N} is an efficient alternative to `Array{Nullable{T}, N}`.
Copy link
Member

Choose a reason for hiding this comment

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

This line isn't a signature, it's just a sentence, so keep it as it was previously.

Copy link
Member

Choose a reason for hiding this comment

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

Thanks for the thorough review, @nalimilan, and for catching some stuff I missed!

@nalimilan
Copy link
Member

@ararslan The nightly failure is known, that's a problem with broadcast.

@nalimilan
Copy link
Member

Woops, completely forgot about this. It's no longer October, but let's pretend it is...

@nalimilan nalimilan merged commit 7c57f1e into JuliaStats:master Nov 17, 2016
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants