Add few comments to code

Author: makortel

Utilities/XrdAdaptor/src/XrdRequestManager.h

@@ -41,6 +41,11 @@ namespace XrdAdaptor {
     uint16_t m_code;
   };
 
+  /**
+   * The RequestManager manages the requests concerning one PFN.
+   *
+   * It implements retries, and can use multiple Sources
+   */
   class RequestManager {
   public:
     using IOSize = edm::storage::IOSize;
@@ -212,8 +217,13 @@ namespace XrdAdaptor {
     std::vector<std::shared_ptr<Source>> m_activeSources;
     std::vector<std::shared_ptr<Source>> m_inactiveSources;
 
+    /// Contains the "DataServer" property for disabled Sources and
+    /// for connections for which the Open() call failed
     oneapi::tbb::concurrent_unordered_set<std::string> m_disabledSourceStrings;
+    /// Contains Source::determineExcludeString() for disabled Sources and
+    /// for connections for which the Open() call failed
     oneapi::tbb::concurrent_unordered_set<std::string> m_disabledExcludeStrings;
+    /// Sources that have been disabled
     oneapi::tbb::concurrent_unordered_set<std::shared_ptr<Source>, SourceHash> m_disabledSources;
 
     // StatisticsSenderService wants to know what our current server is;
@@ -254,8 +264,10 @@ namespace XrdAdaptor {
       ~OpenHandler() override;
 
       /**
-         * Handle the file-open response
-         */
+       * Handle the file-open response
+       *
+       * Called by XRootD
+       */
       void HandleResponseWithHosts(XrdCl::XRootDStatus *status,
                                    XrdCl::AnyObject *response,
                                    XrdCl::HostList *hostList) override;

Utilities/XrdAdaptor/src/XrdSource.h

@@ -20,6 +20,9 @@ namespace XrdAdaptor {
   class XrdSiteStatistics;
   class XrdStatisticsService;
 
+  /**
+   * A Source represents a connection to one storage server
+   */
   class Source : public std::enable_shared_from_this<Source> {
   public:
     Source(const Source &) = delete;