From 58e07151e3fd8503bc0418dba452a822f03ff260 Mon Sep 17 00:00:00 2001 From: LianaHus Date: Wed, 9 Mar 2016 17:23:05 +0100 Subject: - inline and assembly keywords added - some style fixes --- libsolidity/ast/Types.h | 2 +- libsolidity/formal/Why3Translator.h | 2 +- libsolidity/interface/CompilerStack.h | 8 ++++---- libsolidity/interface/InterfaceHandler.h | 2 +- libsolidity/parsing/Parser.h | 4 ++-- libsolidity/parsing/Scanner.h | 6 +++--- libsolidity/parsing/Token.h | 8 +++++--- 7 files changed, 17 insertions(+), 15 deletions(-) diff --git a/libsolidity/ast/Types.h b/libsolidity/ast/Types.h index 189dd10a..1d65aeb6 100644 --- a/libsolidity/ast/Types.h +++ b/libsolidity/ast/Types.h @@ -826,7 +826,7 @@ public: /// @returns TypePointer of a new FunctionType object. All input/return parameters are an /// appropriate external types (i.e. the interfaceType()s) of input/return parameters of /// current function. - /// Returns an empty shared pointer if one of the input/return parameters does not have an + /// @returns an empty shared pointer if one of the input/return parameters does not have an /// external type. FunctionTypePointer interfaceFunctionType() const; diff --git a/libsolidity/formal/Why3Translator.h b/libsolidity/formal/Why3Translator.h index f4315a7a..588b6d80 100644 --- a/libsolidity/formal/Why3Translator.h +++ b/libsolidity/formal/Why3Translator.h @@ -52,7 +52,7 @@ public: std::string translation() const; private: - /// Returns an error. + /// Creates an error and adds it to errors list. void error(ASTNode const& _node, std::string const& _description); /// Reports a fatal error and throws. void fatalError(ASTNode const& _node, std::string const& _description); diff --git a/libsolidity/interface/CompilerStack.h b/libsolidity/interface/CompilerStack.h index 1d13a23c..c7f98184 100644 --- a/libsolidity/interface/CompilerStack.h +++ b/libsolidity/interface/CompilerStack.h @@ -101,7 +101,7 @@ public: /// Sets the given source code as the only source unit apart from standard sources and parses it. /// @returns false on error. bool parse(std::string const& _sourceCode); - /// Returns a list of the contract names in the sources. + /// @returns a list of the contract names in the sources. std::vector contractNames() const; std::string defaultContractName() const; @@ -144,13 +144,13 @@ public: /// Prerequisite: Successful compilation. Json::Value streamAssembly(std::ostream& _outStream, std::string const& _contractName = "", StringMap _sourceCodes = StringMap(), bool _inJsonFormat = false) const; - /// Returns a string representing the contract interface in JSON. + /// @returns a string representing the contract interface in JSON. /// Prerequisite: Successful call to parse or compile. std::string const& interface(std::string const& _contractName = "") const; - /// Returns a string representing the contract interface in Solidity. + /// @returns a string representing the contract interface in Solidity. /// Prerequisite: Successful call to parse or compile. std::string const& solidityInterface(std::string const& _contractName = "") const; - /// Returns a string representing the contract's documentation in JSON. + /// @returns a string representing the contract's documentation in JSON. /// Prerequisite: Successful call to parse or compile. /// @param type The type of the documentation to get. /// Can be one of 4 types defined at @c DocumentationType diff --git a/libsolidity/interface/InterfaceHandler.h b/libsolidity/interface/InterfaceHandler.h index 30b8f520..3e0a1660 100644 --- a/libsolidity/interface/InterfaceHandler.h +++ b/libsolidity/interface/InterfaceHandler.h @@ -85,7 +85,7 @@ public: static std::string devDocumentation(ContractDefinition const& _contractDef); private: - /// 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 const& _tags, std::string const& _name); }; diff --git a/libsolidity/parsing/Parser.h b/libsolidity/parsing/Parser.h index 9db3b3c4..a093cc5b 100644 --- a/libsolidity/parsing/Parser.h +++ b/libsolidity/parsing/Parser.h @@ -124,12 +124,12 @@ private: /// For source code of the form "a[][8]" ("IndexAccessStructure"), this is not possible to /// decide with constant look-ahead. LookAheadInfo peekStatementType() const; - /// Returns a typename parsed in look-ahead fashion from something like "a.b[8][2**70]". + /// @returns a typename parsed in look-ahead fashion from something like "a.b[8][2**70]". ASTPointer typeNameIndexAccessStructure( std::vector> const& _path, std::vector, SourceLocation>> const& _indices ); - /// Returns an expression parsed in look-ahead fashion from something like "a.b[8][2**70]". + /// @returns an expression parsed in look-ahead fashion from something like "a.b[8][2**70]". ASTPointer expressionFromIndexAccessStructure( std::vector> const& _path, std::vector, SourceLocation>> const& _indices diff --git a/libsolidity/parsing/Scanner.h b/libsolidity/parsing/Scanner.h index 8dde922d..cffcec8e 100644 --- a/libsolidity/parsing/Scanner.h +++ b/libsolidity/parsing/Scanner.h @@ -108,13 +108,13 @@ public: /// Resets scanner to the start of input. void reset(); - /// Returns the next token and advances input + /// @returns the next token and advances input Token::Value next(); ///@{ ///@name Information about the current token - /// Returns the current token + /// @returns the current token Token::Value currentToken() { return m_currentToken.token; @@ -138,7 +138,7 @@ public: ///@{ ///@name Information about the next token - /// Returns the next token without advancing input. + /// @returns the next token without advancing input. Token::Value peekNextToken() const { return m_nextToken.token; } SourceLocation peekLocation() const { return m_nextToken.location; } std::string const& peekLiteral() const { return m_nextToken.literal; } diff --git a/libsolidity/parsing/Token.h b/libsolidity/parsing/Token.h index 0e5b594c..ab240b2a 100644 --- a/libsolidity/parsing/Token.h +++ b/libsolidity/parsing/Token.h @@ -143,6 +143,7 @@ namespace solidity \ /* Keywords */ \ K(Anonymous, "anonymous", 0) \ + K(Assembly, "assembly", 0) \ K(Break, "break", 0) \ K(Const, "constant", 0) \ K(Continue, "continue", 0) \ @@ -220,6 +221,7 @@ namespace solidity K(Case, "case", 0) \ K(Catch, "catch", 0) \ K(Final, "final", 0) \ + K(Inline, "inline", 0) \ K(Let, "let", 0) \ K(Match, "match", 0) \ K(Of, "of", 0) \ @@ -251,7 +253,7 @@ public: }; #undef T - // Returns a string corresponding to the C++ token name + // @returns a string corresponding to the C++ token name // (e.g. "LT" for the token LT). static char const* name(Value tok) { @@ -285,7 +287,7 @@ public: static bool isEtherSubdenomination(Value op) { return op == SubWei || op == SubSzabo || op == SubFinney || op == SubEther; } static bool isTimeSubdenomination(Value op) { return op == SubSecond || op == SubMinute || op == SubHour || op == SubDay || op == SubWeek || op == SubYear; } - // Returns a string corresponding to the JS token string + // @returns a string corresponding to the JS token string // (.e., "<" for the token LT) or NULL if the token doesn't // have a (unique) string (e.g. an IDENTIFIER). static char const* toString(Value tok) @@ -294,7 +296,7 @@ public: return m_string[tok]; } - // Returns the precedence > 0 for binary and compare + // @returns the precedence > 0 for binary and compare // operators; returns 0 otherwise. static int precedence(Value tok) { -- cgit