Minor tweak to improve understandability

[wxWidgets.git] / interface / wx / html / htmlfilt.h
diff --git a/interface/wx/html/htmlfilt.h b/interface/wx/html/htmlfilt.h

index 9a40dbcff162d645332e4c5eba690116b3a09cc6..d407a857ba8552180bd61922d4421bb22130b1e9 100644 (file)
--- a/interface/wx/html/htmlfilt.h
+++ b/interface/wx/html/htmlfilt.h
@@ -3,20 +3,19 @@
  // Purpose:     interface of wxHtmlFilter
  // Author:      wxWidgets team
  // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
  /////////////////////////////////////////////////////////////////////////////
  
  /**
      @class wxHtmlFilter
-    @headerfile htmlfilt.h wx/html/htmlfilt.h
  
      This class is the parent class of input filters for wxHtmlWindow.
      It allows you to read and display files of different file formats.
  
      @library{wxhtml}
-    @category{FIXME}
+    @category{html}
  
-    @see Overview()
+    @see @ref overview_html_filters
  */
  class wxHtmlFilter : public wxObject
  {
@@ -29,13 +28,26 @@ public:
      /**
          Returns @true if this filter is capable of reading file @e file.
          Example:
+        @code
+        bool MyFilter::CanRead(const wxFSFile& file)
+        {
+            return (file.GetMimeType() == "application/x-ugh");
+        }
+        @endcode
      */
-    bool CanRead(const wxFSFile& file);
+    virtual bool CanRead(const wxFSFile& file) const = 0;
  
      /**
          Reads the file and returns string with HTML document.
          Example:
+        @code
+        wxString MyImgFilter::ReadFile(const wxFSFile& file)
+        {
+            return "<html><body><img src=\"" + file.GetLocation() +
+                   "\"></body></html>";
+        }
+        @endcode
      */
-    wxString ReadFile(const wxFSFile& file);
+    virtual wxString ReadFile(const wxFSFile& file) const = 0;
  };