Open pdeffebach opened 3 years ago
Hopefully fixed by https://github.com/JuliaLang/julia/pull/40203. Should be in 1.6.1.
Using Julia 1.6.1 on Ubuntu Linux 20.04 with CSV v0.8.4, I get in an 80-characters wide terminal:
julia> using CSV
help?> CSV.File
CSV.File(source; kwargs...) => CSV.File
[...]
• File layout options:
• header=1: the header argument can be an Int, indicating
the row to parse for column names; or a Range,
indicating a span of rows to be concatenated together as
column names; or an entire Vector{Symbol} or
Vector{String} to use as column names; if a file doesn't
have column names, either provide them as a Vector, or
set header=0 or header=false and column names will be
auto-generated (Column1, Column2, etc.). Note that if a
row number header and comment or ignoreemtpylines are
provided, the header row will be the first
non-commented/non-empty row after the row number,
meaning if the provided row number is a commented row,
the header row will actually be the next non-commented
row.
• normalizenames=false: whether column names should be
"normalized" into valid Julia identifier symbols; useful
when iterating rows and accessing column values of a row
via getproperty (e.g. row.col1)
[...]
Better than in the original report, but still not correct: text for second-level items wraps to indentation level of first-level items. I would have expected the output to look like
• File layout options:
• header=1: the header argument can be an Int, indicating
the row to parse for column names; or a Range,
indicating a span of rows to be concatenated together as
Can also be seen at other places that use nested lists, e.g.
julia> using Distributed
help?> addprocs
[...]
• shell: specifies the type of shell to which ssh connects on the
workers.
• shell=:posix: a POSIX-compatible Unix/Linux shell (bash,
sh, etc.). The default.
• shell=:wincmd: Microsoft Windows cmd.exe.
[...]
I also see the above. Lines >2 should be indented by two spaces.
But this is still an improvement and is readable.
Can be improved more, but doesn't seem to be a bug
I am pretty sure this is both a bug and a regression since this worked fine in 1.5. It started going bad in https://github.com/JuliaLang/julia/pull/37087 and many attempts was made to fix it, https://github.com/JuliaLang/julia/pull/37235, https://github.com/JuliaLang/julia/pull/38502, https://github.com/JuliaLang/julia/pull/40203.
Looking at the CSV Documentation in 1.6, I get this big block instead of a nice list
Will have to check if this problem on master.