diff --git a/bindings/C/c/adios2_c_internal.h b/bindings/C/c/adios2_c_internal.h
index f2d2c83770..29d132ae78 100644
--- a/bindings/C/c/adios2_c_internal.h
+++ b/bindings/C/c/adios2_c_internal.h
@@ -3,7 +3,8 @@
  * Distributed under the OSI-approved Apache License, Version 2.0.  See
  * accompanying file Copyright.txt for details.
  *
- * adios2_c_internal.h
+ * adios2_c_internal.h: helper functionality for use within the C bindings,
+ *                      but not part of the public interface
  *
  *  Created on: Feb 9, 2019
  *      Author: Kai Germaschewski <kai.germaschewski@unh.edu>
diff --git a/source/adios2/ADIOSTypes.inl b/source/adios2/ADIOSTypes.inl
index ddc198cef0..33be1f4fc7 100644
--- a/source/adios2/ADIOSTypes.inl
+++ b/source/adios2/ADIOSTypes.inl
@@ -3,8 +3,7 @@
  * Distributed under the OSI-approved Apache License, Version 2.0.  See
  * accompanying file Copyright.txt for details.
  *
- * ADIOSTypes.h : public header that contains "using/typedef" alias, defaults
- * and parameters options as enum classes
+ * ADIOSTypes.inl : inline implementatios for ADIOSTypes.h
  *
  *  Created on: Feb 20, 2019
  *      Author: Kai Germaschewski <kai.germaschewski@unh.edu>
diff --git a/source/adios2/core/IO.cpp b/source/adios2/core/IO.cpp
index 112da0e3fa..daae35360a 100644
--- a/source/adios2/core/IO.cpp
+++ b/source/adios2/core/IO.cpp
@@ -197,7 +197,7 @@ bool IO::RemoveAttribute(const std::string &name) noexcept
     // attribute exists
     if (itAttribute != m_Attributes.end())
     {
-        // first remove the Variable object
+        // first remove the Attribute object
         const std::string type(itAttribute->second.first);
         const unsigned int index(itAttribute->second.second);