stardoc icon indicating copy to clipboard operation
stardoc copied to clipboard

Error generating function docs on windows, related to line endings

Open alexeagle opened this issue 4 years ago • 0 comments

Error is

ERROR: D:/b/7cfqmzbl/external/npm_bazel_terser/BUILD.bazel:32:1: Couldn't build file external/npm_bazel_terser/docs.raw: Generating proto for Starlark doc for docs failed (Exit 1)
Exception in thread "main" com.google.devtools.build.skydoc.rendering.DocstringParseException: Unable to generate documentation for function node_repositories (defined at internal/node/node_repositories.bzl:688:5) due to malformed docstring. Parse errors:
  internal/node/node_repositories.bzl:688:5 line 2: the one-line summary should be followed by a blank line

	at com.google.devtools.build.skydoc.rendering.FunctionUtil.fromNameAndFunction(FunctionUtil.java:61)
	at com.google.devtools.build.skydoc.rendering.ProtoRenderer.appendStarlarkFunctionInfos(ProtoRenderer.java:58)

see https://github.com/bazelbuild/rules_nodejs/pull/1426/commits/299d2b512b7652e970325db0a77e44bbf46d35e2 - can probably repro there

alexeagle avatar Dec 09 '19 15:12 alexeagle