mirror of
https://github.com/ethereum/solidity
synced 2023-10-03 13:03:40 +00:00
Merge pull request #2814 from ethereum/natspec-cleanup
Remove unused statements from the Natspec headers
This commit is contained in:
commit
a20dd964ef
@ -72,7 +72,7 @@ void DocStringAnalyser::handleCallable(
|
|||||||
DocumentedAnnotation& _annotation
|
DocumentedAnnotation& _annotation
|
||||||
)
|
)
|
||||||
{
|
{
|
||||||
static const set<string> validTags = set<string>{"author", "dev", "notice", "return", "param", "why3"};
|
static const set<string> validTags = set<string>{"author", "dev", "notice", "return", "param"};
|
||||||
parseDocStrings(_node, _annotation, validTags, "functions");
|
parseDocStrings(_node, _annotation, validTags, "functions");
|
||||||
|
|
||||||
set<string> validParams;
|
set<string> validParams;
|
||||||
|
@ -36,27 +36,8 @@ namespace solidity
|
|||||||
|
|
||||||
// Forward declarations
|
// Forward declarations
|
||||||
class ContractDefinition;
|
class ContractDefinition;
|
||||||
class Type;
|
|
||||||
using TypePointer = std::shared_ptr<Type const>;
|
|
||||||
struct DocTag;
|
struct DocTag;
|
||||||
|
|
||||||
enum class DocTagType: uint8_t
|
|
||||||
{
|
|
||||||
None = 0,
|
|
||||||
Dev,
|
|
||||||
Notice,
|
|
||||||
Param,
|
|
||||||
Return,
|
|
||||||
Author,
|
|
||||||
Title
|
|
||||||
};
|
|
||||||
|
|
||||||
enum class CommentOwner
|
|
||||||
{
|
|
||||||
Contract,
|
|
||||||
Function
|
|
||||||
};
|
|
||||||
|
|
||||||
class Natspec
|
class Natspec
|
||||||
{
|
{
|
||||||
public:
|
public:
|
||||||
@ -71,14 +52,6 @@ public:
|
|||||||
static Json::Value devDocumentation(ContractDefinition const& _contractDef);
|
static Json::Value devDocumentation(ContractDefinition const& _contractDef);
|
||||||
|
|
||||||
private:
|
private:
|
||||||
/// @returns a json value suitable for a list of types in function input or output
|
|
||||||
/// parameters or other places. If @a _forLibrary is true, complex types are referenced
|
|
||||||
/// by name, otherwise they are anonymously expanded.
|
|
||||||
static Json::Value formatTypeList(
|
|
||||||
std::vector<std::string> const& _names,
|
|
||||||
std::vector<TypePointer> const& _types,
|
|
||||||
bool _forLibrary
|
|
||||||
);
|
|
||||||
/// @returns concatenation of all content under the given tag name.
|
/// @returns concatenation of all content under the given tag name.
|
||||||
static std::string extractDoc(std::multimap<std::string, DocTag> const& _tags, std::string const& _name);
|
static std::string extractDoc(std::multimap<std::string, DocTag> const& _tags, std::string const& _name);
|
||||||
};
|
};
|
||||||
|
Loading…
Reference in New Issue
Block a user