Merge pull request #8221 from ethereum/structured-docs-error-locations

[parser] Source locations for structured documentation errors
This commit is contained in:
chriseth
2020-02-18 14:57:28 +01:00
committed by GitHub
14 changed files with 74 additions and 23 deletions
@@ -4,4 +4,4 @@ abstract contract C {
function vote(uint id) public virtual returns (uint value);
}
// ----
// DocstringParsingError: Documentation tag "@return No value returned" does not contain the name of its return parameter.
// DocstringParsingError: (26-89): Documentation tag "@return No value returned" does not contain the name of its return parameter.
@@ -7,5 +7,5 @@ contract C {
}
}
// ----
// DocstringParsingError: Documented parameter "" not found in the parameter list of the function.
// DocstringParsingError: Documented parameter "_" not found in the parameter list of the function.
// DocstringParsingError: (17-101): Documented parameter "" not found in the parameter list of the function.
// DocstringParsingError: (17-101): Documented parameter "_" not found in the parameter list of the function.
@@ -0,0 +1,11 @@
abstract contract C {
/// @param id Some identifier
/// @return No value returned
function vote(uint id) public virtual returns (uint value);
/// @return No value returned
function unvote(uint id) public virtual returns (uint value);
}
// ----
// DocstringParsingError: (26-89): Documentation tag "@return No value returned" does not contain the name of its return parameter.
// DocstringParsingError: (159-188): Documentation tag "@return No value returned" does not contain the name of its return parameter.
@@ -1,7 +0,0 @@
abstract contract C {
/// @param id Some identifier
/// @return No value returned
function vote(uint id) public virtual returns (uint value);
}
// ----
// DocstringParsingError: Documentation tag "@return No value returned" does not contain the name of its return parameter.