Comment updates

[builder.git] / source / tool.h

diff --git a/source/tool.h b/source/tool.h
index 1736e1c74f0f40207ebbc66f391bebbc7d59aba9..d1d71030c5fcc7ec35844333b2e79ad2bacf4069 100644 (file)
--- a/source/tool.h
+++ b/source/tool.h
@@ -10,21 +10,35 @@ class Component;
 class Target;
 class Task;
 
+/**
+Base class for tools.  Tools are used to turn targets into other targets.
+Examples include compilers and linkers.
+*/
 class Tool
 {
+public:
+       typedef std::list<Msp::FS::Path> SearchPath;
+       typedef std::list<std::string> SuffixList;
+
 protected:
        Builder &builder;
        std::string tag;
-       std::list<std::string> input_suffixes;
+       SuffixList input_suffixes;
+       SuffixList aux_suffixes;
+       SearchPath system_path;
 
        Tool(Builder &, const std::string &);
-
 public:
+       virtual ~Tool() { }
+
        const std::string &get_tag() const { return tag; }
-       const std::list<std::string> &get_input_suffixes() const { return input_suffixes; }
-       bool accepts_suffix(const std::string &) const;
+       const SuffixList &get_input_suffixes() const { return input_suffixes; }
+       const SuffixList &get_auxiliary_suffixes() const { return aux_suffixes; }
+       bool accepts_suffix(const std::string &, bool = false) const;
+       const SearchPath &get_system_path() const { return system_path; }
 
        virtual Target *create_source(const Component &, const Msp::FS::Path &) const { return 0; }
+       virtual Target *create_source(const Msp::FS::Path &) const { return 0; }
        Target *create_target(Target &, const std::string & = std::string()) const;
        virtual Target *create_target(const std::list<Target *> &, const std::string & = std::string()) const = 0;
        virtual Task *run(const Target &) const = 0;