WIP: Manual Fixes. JuliaCon 2016 Edition #17064
Conversation
The original location of the "Elementary Function" section broke the flow between "Numerical Conversions" about round and the next section: "Rounding Functions". Additionally moved the "Elementary Function" section to be a subsection of "Numeric Comparisons".
ivarne
added
docs
|
I noticed inconsistency in how the manual refers to language. Sometimes it is referred to "Julia" and sometimes "julia". I've updated the manual (and one place in the REPL help) such that when referring to Julia is always "Julia". Also, the "Elementary Function" commit (d1cf43c) shouldn't be backported as it that is a 0.5 feature. |
The manual would sometimes refer to the language as either "Julia" or "julia". This commit changes references to the Julia language as "Julia" and any reference to the command line program as `julia`.
| @@ -860,7 +860,7 @@ If ``io`` is not specified, ``host`` and ``port`` are used to connect. | |||
| For example, a cluster manager may launch a single worker per node, and use that to launch | |||
| additional workers. ``count`` with an integer value ``n`` will launch a total of ``n`` workers, | |||
| while a value of ``:auto`` will launch as many workers as cores on that machine. | |||
| ``exename`` is the name of the julia executable including the full path. | |||
| ``exename`` is the name of the Julia executable including the full path. | |||
There was a problem hiding this comment.
this might be better as quoted lowercase
There was a problem hiding this comment.
I was thinking that "Julia" would refer the the language while "julia" refers to the command-line program. Does that seem sensible?
There was a problem hiding this comment.
Yes, exactly. Probably makes sense to also put julia in backticks.
There was a problem hiding this comment.
Agreed. "julia executable" is pretty clearly the latter.
Also prepended "see" to the references and fixed a triple space after a period.
|
AV restarted. @tkelman @StefanKarpinski do the latest changes here look ok? |
|
Feel free to merge this whenever. I have a couple more corrections to add but I can always make another PR. |
"Julia" refers to the language while "`julia`" (lowercase in backticks) specifically refers to the executable.
I've been re-reading the manual to discover any new features I may have missed over the last year. During my reading so far I've found some issues: