Issue 116 - Document the libadblockplus API

include/AdblockPlus/FilterEngine.h

 /*
  * This file is part of Adblock Plus <http://adblockplus.org/>,
  * Copyright (C) 2006-2014 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ skipping 90 matching lines @@
      */
     void RemoveFromList();
 
     /**
      * Updates this subscription, i.e.\ retrieves the current filters from the
      * subscription URL.
      */
     void UpdateFilters();
 
     /**
-     * Checks if subscriptions are currently being updated.
-     * @return `true` if subscriptions are currently being updated.

[Wladimir Palant, 2014/09/02 13:11:21]

This is misleading now - the mistake was actually the plural form, should have
been "subscription". "Checks whether this subscription is currently being
updated" - this state is per-subscription.

[Felix Dahlke, 2014/09/02 13:24:05]

Double ouch. Done.

+     * Checks if the subscription is currently being updated.
+     * @return `true` if the subscription is currently being updated.
      */
     bool IsUpdating();
 
     bool operator==(const Subscription& subscription) const;
 
     /**
      * Creates a wrapper for an existing JavaScript subscription object.
      * Normally you shouldn't call this directly, but use
      * FilterEngine::GetSubscription() instead.
      * @param value JavaScript subscription object.
      */
     Subscription(JsValuePtr value);
   };
 
   /**
    * Shared smart pointer to a `Filter` instance.
    */
   typedef std::tr1::shared_ptr<Filter> FilterPtr;
 
   /**
    * Shared smart pointer to a `Subscription` instance.
    */
   typedef std::tr1::shared_ptr<Subscription> SubscriptionPtr;
 
   /**
-   * Main component of Libadblockplus.
+   * Main component of libadblockplus.
    * It handles:
    * - Filter management and matching.
    * - Subscription management and synchronization.
    * - Update checks for the application.
    */
   class FilterEngine
   {
   public:
     /**
      * Callback type invoked when an update is available.
@@ skipping 191 matching lines @@
     void InitDone(JsValueList& params);
     FilterPtr CheckFilterMatch(const std::string& url,
                                const std::string& contentType,
                                const std::string& documentUrl) const;
     void UpdateCheckDone(const std::string& eventName, UpdaterCallback callback, JsValueList& params);
     void FilterChanged(FilterChangeCallback callback, JsValueList& params);
   };
 }
 
 #endif