Comment tweaks

diff --git a/source/filetarget.h b/source/filetarget.h
index 851085ba040a1834c47a3967cfcec491a14efdf6..a48e1ab6d976932eb507653bc9c37a2a8fe19d91 100644 (file)
--- a/source/filetarget.h
+++ b/source/filetarget.h
@@ -31,9 +31,7 @@ public:
        bool is_installable() const { return !install_location.empty(); }
        const Msp::FS::Path &get_install_location() const { return install_location; }
 
-       /**
-       Changes the mtime of the target to the current time.
-       */
+       /// Changes the mtime of the target to the current time.
        void touch();
 
 protected:

diff --git a/source/packagemanager.h b/source/packagemanager.h
index 05f5ebe317e6b3c5f49452868b108b995a4cea9f..2fbaca1c37c03dc0afafb3fa36d63402ec1535f3 100644 (file)
--- a/source/packagemanager.h
+++ b/source/packagemanager.h
@@ -51,14 +51,15 @@ public:
 
        const PackageMap &get_packages() const { return packages; }
 
-       /** Locates a package and creates it if necessary. */
+       /** Locates a package and loads it if necessary. */
        Package *find_package(const std::string &);
 
 private:
        std::string run_pkgconfig(const std::string &, const std::string &);
 
        /** Determines the source directory of a package.  Pkg-config is consulted
-       first, and if it fails, the package path is searched for matches. */
+       first, and if it fails, the package path is searched for matches.  The
+       package is expected to be located in a directory named after itself. */
        Msp::FS::Path get_package_location(const std::string &);
 
        /** Determines the file containing a binary package.  The file is expected

diff --git a/source/tool.h b/source/tool.h
index 6aee38b2ee6a59b62206c0f8617dd7e5df6cf590..d5d7e784b205578ad571b1de906a81aa01eb4e20 100644 (file)
--- a/source/tool.h
+++ b/source/tool.h
@@ -61,7 +61,7 @@ public:
        /// Creates a source file appropriate for this tool.
        virtual Target *create_source(const Component &, const Msp::FS::Path &) const { return 0; }
 
-       /** Creates a package-less source file appropriate for this too.  This is
+       /** Creates a package-less source file appropriate for this tool.  This is
        called during dependency discovery when no package has created a target for
        the file. */
        virtual Target *create_source(const Msp::FS::Path &) const { return 0; }