too much white space about docstringextensions.jl HOT 2 CLOSED

Bump

from docstringextensions.jl.

The space between the items comes from Base, so DocStringExtensions can't really change that. But putting the name and docstring on the same line would be better indeed.

I'm busy with Documenter myself, but I would happily review a PR for this.

• It shouldn't be too hard to update

  DocStringExtensions.jl/src/abbreviations.jl

  Lines 69 to 92 in 8e9da56

  	function format(::TypeFields, buf, doc)
  	local docs = get(doc.data, :fields, Dict())
  	local binding = doc.data[:binding]
  	local object = Docs.resolve(binding)
  	# On 0.7 fieldnames() on an abstract type throws an error. We then explicitly return
  	# an empty vector to be consistent with the behaviour on v0.6.
  	local fields = isabstracttype(object) ? Symbol[] : fieldnames(object)
  	if !isempty(fields)
  	println(buf)
  	for field in fields
  	print(buf, " - `", field, "`\n")
  	# Print the field docs if they exist and aren't a `doc"..."` docstring.
  	if haskey(docs, field) && isa(docs[field], AbstractString)
  	println(buf)
  	for line in split(docs[field], "\n")
  	println(buf, isempty(line) ? "" : " ", rstrip(line))
  	end
  	end
  	println(buf)
  	end
  	println(buf)
  	end
  	return nothing
  	end

• It is still possible for the user to specify longer (multi Markdown block) docstrings for fields. I think those should still be handled the way it works at the moment. But I think we need a way to determine that it is a multi-block string. But I think it could be something as simple as just parsing the Markdown, checking how many blocks we have and then throwing away the parsed result.

from docstringextensions.jl.