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.

Sign up for GitHub

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

Jump to bottom

"Duplicate" bug in doc/genstdlib.jl #13906

Closed
dpsanders opened this issue Nov 7, 2015 · 1 comment
Closed

"Duplicate" bug in doc/genstdlib.jl #13906

dpsanders opened this issue Nov 7, 2015 · 1 comment
Labels
docsystem The documentation building system

Comments

@dpsanders
Copy link
Contributor

Running julia doc/genstdlib.jl to generate the ReST documentation fails on the following commit at the following line:

https://github.com/dpsanders/julia/blame/d633afac7d86021525056445efe1d12a1a7c3974/doc/stdlib/numbers.rst#L358

This is due to the fact that it finds a "duplicate" at

https://github.com/dpsanders/julia/blame/d633afac7d86021525056445efe1d12a1a7c3974/doc/stdlib/numbers.rst#L371

What is happening is that the first is a function definition, but the second is a usage of the same string within the docstring of a different function, and thus should not be a duplicate.

(This did not happen until with_rounding was merged with setrounding in #13232, which gave rise to this clash.)

Removing the exact text setrounding(T, mode) from within the definition of the second docstring successfully generates the correct documentation.
@dpsanders
Copy link
Contributor Author

This was reported in #13232 (comment)

@yuyichao yuyichao added the docsystem The documentation building system label Nov 7, 2015
yuyichao added a commit that referenced this issue Nov 7, 2015
@yuyichao
None mutation version of split_decl_rst and more restricted signature…
1b39624 
… matching

in genstdlib.jl

Fix #13906
@yuyichao yuyichao mentioned this issue Nov 7, 2015
Merged
yuyichao added a commit that referenced this issue Nov 7, 2015
@yuyichao
Non-mutating version of split_decl_rst and more restricted signature …
1def889 
…matching

in genstdlib.jl

Fix #13906
yuyichao added a commit that referenced this issue Nov 29, 2015
@yuyichao @tkelman
Non-mutating version of split_decl_rst and more restricted signature …
a85dd9f 
…matching

in genstdlib.jl

Fix #13906

(cherry picked from commit 1def889)
ref #13907
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
docsystem The documentation building system
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@dpsanders @yuyichao