diff options
author | 2019-11-08 23:52:14 +0100 | |
---|---|---|
committer | 2019-11-08 23:52:14 +0100 | |
commit | 88f702b416ba9eb930e6c1e932124d5f24b1a24c (patch) | |
tree | 955f3047b79156d7b2bbab55fcbd4fbc94661f1d /src/lib/netlist/plib/putil.h | |
parent | 731c4fe52073a7a7561bf04559e9f0b3b791388d (diff) |
netlist: code maintenance and bug fixes. (nw)
- comment style migration continues.
- Fixed a two bugs in the truthtable ignore inputs code
- refactored the truthtable code a bit for better readability.
- updated netlist specific gitignore.
Diffstat (limited to 'src/lib/netlist/plib/putil.h')
-rw-r--r-- | src/lib/netlist/plib/putil.h | 64 |
1 files changed, 28 insertions, 36 deletions
diff --git a/src/lib/netlist/plib/putil.h b/src/lib/netlist/plib/putil.h index 6a79dadae90..128e804a1ae 100644 --- a/src/lib/netlist/plib/putil.h +++ b/src/lib/netlist/plib/putil.h @@ -1,26 +1,20 @@ // license:GPL-2.0+ // copyright-holders:Couriersud -/* - * putil.h - * - */ #ifndef PUTIL_H_ #define PUTIL_H_ +/// +/// \file putil.h +/// + #include "palloc.h" #include "pexception.h" #include "pstring.h" #include <algorithm> -//#include <initializer_list> -//#include <iostream> -//#include <locale> -//#include <sstream> #include <vector> -// FIXME: pstonum should get an own header - #define PSTRINGIFY_HELP(y) # y #define PSTRINGIFY(x) PSTRINGIFY_HELP(x) @@ -31,13 +25,12 @@ namespace plib { - /**! Source code locations - * - * The c++20 draft for source locations is based on const char * strings. - * It is thus only suitable for c++ source code and not for programmatic - * parsing of files. This class is a replacement for dynamic use cases. - * - */ + /// \brief Source code locations. + /// + /// The c++20 draft for source locations is based on const char * strings. + /// It is thus only suitable for c++ source code and not for programmatic + /// parsing of files. This class is a replacement for dynamic use cases. + /// struct source_location { source_location() noexcept @@ -70,13 +63,12 @@ namespace plib unsigned m_col; }; - /**! Base source class - * - * Pure virtual class all other source implementations are based on. - * Sources provide an abstraction to read input from a variety of - * sources, e.g. files, memory, remote locations. - * - */ + /// \brief Base source class. + /// + /// Pure virtual class all other source implementations are based on. + /// Sources provide an abstraction to read input from a variety of + /// sources, e.g. files, memory, remote locations. + /// class psource_t { public: @@ -93,13 +85,13 @@ namespace plib private: }; - /**! Generic string source - * - * Will return the given string when name matches. - * Is used in preprocessor code to eliminate inclusion of certain files. - * - * @tparam TS base stream class. Default is psource_t - */ + /// \brief Generic string source. + /// + /// Will return the given string when name matches. + /// Is used in preprocessor code to eliminate inclusion of certain files. + /// + /// \tparam TS base stream class. Default is psource_t + /// template <typename TS = psource_t> class psource_str_t : public TS { @@ -123,10 +115,10 @@ namespace plib pstring m_str; }; - /**! Generic sources collection - * - * @tparam TS base stream class. Default is psource_t - */ + /// \brief Generic sources collection. + /// + /// \tparam TS base stream class. Default is psource_t + /// template <typename TS = psource_t> class psource_collection_t { @@ -273,4 +265,4 @@ namespace plib } \ }; -#endif /* PUTIL_H_ */ +#endif // PUTIL_H_ |