Rubber-stamped by Adam Roben.
authorweinig <weinig@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Wed, 3 Oct 2007 02:15:21 +0000 (02:15 +0000)
committerweinig <weinig@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Wed, 3 Oct 2007 02:15:21 +0000 (02:15 +0000)
        * Interfaces/IWebPreferences.idl: Remove unnecessary comments.

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@25948 268f45cc-cd09-0410-ab3c-d52691b4dbfc

WebKit/win/ChangeLog
WebKit/win/Interfaces/IWebPreferences.idl

index 1d440a016c1fb54bc60c5578e0e9dc3749d4d232..1b39c21edeb2090547174d5c49beb538c333ecef 100644 (file)
@@ -1,3 +1,9 @@
+2007-10-02  Sam Weinig  <sam@webkit.org>
+
+        Rubber-stamped by Adam Roben.
+
+        * Interfaces/IWebPreferences.idl: Remove unnecessary comments. 
+
 2007-10-02  Darin Adler  <darin@apple.com>
 
         Reviewed by Adam.
index 977dfff3ecbc3370625c7828f692e8e771bdc289..56fb54529a6fc3fd9cb53855e9a18bb0aa6e1af9 100644 (file)
@@ -74,11 +74,12 @@ typedef enum WebKitCookieStorageAcceptPolicy {
     WebKitCookieStorageAcceptPolicyOnlyFromMainDocumentDomain
 } WebKitCookieStorageAcceptPolicy;
 
-/*!
-    @class WebPreferences
+typedef enum WebCacheModel {
+    WebCacheModelDocumentViewer = 0,
+    WebCacheModelDocumentBrowser = 1,
+    WebCacheModelPrimaryWebBrowser = 2
+} WebCacheModel;
 
-    @interface WebPreferences: NSObject <NSCoding>
-*/
 [
     object,
     oleautomation,
@@ -88,407 +89,98 @@ typedef enum WebKitCookieStorageAcceptPolicy {
 ]
 interface IWebPreferences : IUnknown
 {
-    /*!
-        @method standardPreferences
-        + (WebPreferences *)standardPreferences;
-    */
     HRESULT standardPreferences([out, retval] IWebPreferences** standardPreferences);
 
-    /*!
-        @method initWithIdentifier:
-        @param anIdentifier A string used to identify the WebPreferences.
-        @discussion WebViews can share instances of WebPreferences by using an instance of WebPreferences with
-        the same identifier.  Typically, instance are not created directly.  Instead you set the preferences
-        identifier on a WebView.  The identifier is used as a prefix that is added to the user defaults keys
-        for the WebPreferences.
-        @result Returns a new instance of WebPreferences or a previously allocated instance with the same identifier.
-        - (id)initWithIdentifier:(NSString *)anIdentifier;
-    */
     HRESULT initWithIdentifier([in] BSTR anIdentifier, [out, retval] IWebPreferences** preferences);
-
-    /*!
-        @method identifier
-        @result Returns the identifier for this WebPreferences.
-        - (NSString *)identifier;
-    */
     HRESULT identifier([out, retval] BSTR* ident);
 
-    /*!
-        @method standardFontFamily
-        - (NSString *)standardFontFamily;
-    */
     HRESULT standardFontFamily([out, retval] BSTR* family);
-
-    /*!
-        @method setStandardFontFamily:
-        @param family
-        - (void)setStandardFontFamily:(NSString *)family;
-    */
     HRESULT setStandardFontFamily([in] BSTR family);
 
-    /*!
-        @method fixedFontFamily
-        - (NSString *)fixedFontFamily;
-    */
     HRESULT fixedFontFamily([out, retval] BSTR* family);
-
-    /*!
-        @method setFixedFontFamily:
-        @param family
-        - (void)setFixedFontFamily:(NSString *)family;
-    */
     HRESULT setFixedFontFamily([in] BSTR family);
 
-    /*!
-        @method serifFontFamily
-        - (NSString *)serifFontFamily;
-    */
     HRESULT serifFontFamily([out, retval] BSTR* fontFamily);
-
-    /*!
-        @method setSerifFontFamily:
-        @param family
-        - (void)setSerifFontFamily:(NSString *)family;
-    */
     HRESULT setSerifFontFamily([in] BSTR family);
 
-    /*!
-        @method sansSerifFontFamily
-        - (NSString *)sansSerifFontFamily;
-    */
     HRESULT sansSerifFontFamily([out, retval] BSTR* family);
-
-    /*!
-        @method setSansSerifFontFamily:
-        @param family
-        - (void)setSansSerifFontFamily:(NSString *)family;
-    */
     HRESULT setSansSerifFontFamily([in] BSTR family);
 
-    /*!
-        @method cursiveFontFamily
-        - (NSString *)cursiveFontFamily;
-    */
     HRESULT cursiveFontFamily([out, retval] BSTR* family);
-
-    /*!
-        @method setCursiveFontFamily:
-        @param family
-        - (void)setCursiveFontFamily:(NSString *)family;
-    */
     HRESULT setCursiveFontFamily([in] BSTR family);
 
-    /*!
-        @method fantasyFontFamily
-        - (NSString *)fantasyFontFamily;
-    */
     HRESULT fantasyFontFamily([out, retval] BSTR* family);
-
-    /*!
-        @method setFantasyFontFamily:
-        @param family
-        - (void)setFantasyFontFamily:(NSString *)family;
-    */
     HRESULT setFantasyFontFamily([in] BSTR family);
 
-    /*!
-        @method defaultFontSize
-        - (int)defaultFontSize;
-    */
     HRESULT defaultFontSize([out, retval] int* fontSize);
-
-    /*!
-        @method setDefaultFontSize:
-        @param size
-        - (void)setDefaultFontSize:(int)size;
-    */
     HRESULT setDefaultFontSize([in] int fontSize);
 
-    /*!
-        @method defaultFixedFontSize
-        - (int)defaultFixedFontSize;
-    */
     HRESULT defaultFixedFontSize([out, retval] int* fontSize);
-
-    /*!
-        @method setDefaultFixedFontSize:
-        @param size
-        - (void)setDefaultFixedFontSize:(int)size;
-    */
     HRESULT setDefaultFixedFontSize([in] int fontSize);
 
-    /*!
-        @method minimumFontSize
-        - (int)minimumFontSize;
-    */
     HRESULT minimumFontSize([out, retval] int* fontSize);
-
-    /*!
-        @method setMinimumFontSize:
-        @param size
-        - (void)setMinimumFontSize:(int)size;
-    */
     HRESULT setMinimumFontSize([in] int fontSize);
 
-    /*!
-        @method minimumLogicalFontSize
-        - (int)minimumLogicalFontSize;
-    */
     HRESULT minimumLogicalFontSize([out, retval] int* fontSize);
-
-    /*!
-        @method setMinimumLogicalFontSize:
-        @param size
-        - (void)setMinimumLogicalFontSize:(int)size;
-    */
     HRESULT setMinimumLogicalFontSize([in] int fontSize);
 
-    /*!
-        @method defaultTextEncodingName
-        - (NSString *)defaultTextEncodingName;
-    */
     HRESULT defaultTextEncodingName([out, retval] BSTR* name);
-
-    /*!
-        @method setDefaultTextEncodingName:
-        @param encoding
-        - (void)setDefaultTextEncodingName:(NSString *)encoding;
-    */
     HRESULT setDefaultTextEncodingName([in] BSTR name);
 
-    /*!
-        @method userStyleSheetEnabled
-        - (BOOL)userStyleSheetEnabled;
-    */
     HRESULT userStyleSheetEnabled([out, retval] BOOL* enabled);
-
-    /*!
-        @method setUserStyleSheetEnabled:
-        @param flag
-        - (void)setUserStyleSheetEnabled:(BOOL)flag;
-    */
     HRESULT setUserStyleSheetEnabled([in] BOOL enabled);
 
-    /*!
-        @method userStyleSheetLocation
-        @discussion The location of the user style sheet.
-        - (NSURL *)userStyleSheetLocation;
-    */
     HRESULT userStyleSheetLocation([out, retval] BSTR* location);
-
-    /*!
-        @method setUserStyleSheetLocation:
-        @param URL The location of the user style sheet.
-        - (void)setUserStyleSheetLocation:(NSURL *)URL;
-    */
     HRESULT setUserStyleSheetLocation([in] BSTR location);
 
-    /*!
-        @method isJavaEnabled
-        - (BOOL)isJavaEnabled;
-    */
     HRESULT isJavaEnabled([out, retval] BOOL* enabled);
-
-    /*!
-        @method setJavaEnabled:
-        @param flag
-        - (void)setJavaEnabled:(BOOL)flag;
-    */
     HRESULT setJavaEnabled([in] BOOL enabled);
 
-    /*!
-        @method isJavaScriptEnabled
-        - (BOOL)isJavaScriptEnabled;
-    */
     HRESULT isJavaScriptEnabled([out, retval] BOOL* enabled);
-
-    /*!
-        @method setJavaScriptEnabled:
-        @param flag
-        - (void)setJavaScriptEnabled:(BOOL)flag;
-    */
     HRESULT setJavaScriptEnabled([in] BOOL enabled);
 
-    /*!
-        @method JavaScriptCanOpenWindowsAutomatically
-        - (BOOL)javaScriptCanOpenWindowsAutomatically;
-    */
     HRESULT javaScriptCanOpenWindowsAutomatically([out, retval] BOOL* enabled);
-
-    /*!
-        @method setJavaScriptCanOpenWindowsAutomatically:
-        @param flag
-        - (void)setJavaScriptCanOpenWindowsAutomatically:(BOOL)flag;
-    */
     HRESULT setJavaScriptCanOpenWindowsAutomatically([in] BOOL enabled);
 
-    /*!
-        @method arePlugInsEnabled
-        - (BOOL)arePlugInsEnabled;
-    */
     HRESULT arePlugInsEnabled([out, retval] BOOL* enabled);
-
-    /*!
-        @method setPlugInsEnabled:
-        @param flag
-        - (void)setPlugInsEnabled:(BOOL)flag;
-    */
     HRESULT setPlugInsEnabled([in] BOOL enabled);
 
-    /*!
-        @method allowAnimatedImages
-        - (BOOL)allowsAnimatedImages;
-    */
     HRESULT allowsAnimatedImages([out, retval] BOOL* enabled);
-
-    /*!
-        @method setAllowAnimatedImages:
-        @param flag
-        - (void)setAllowsAnimatedImages:(BOOL)flag;
-    */
     HRESULT setAllowsAnimatedImages([in] BOOL enabled);
-
-    /*!
-        @method allowAnimatedImageLooping
-        - (BOOL)allowsAnimatedImageLooping;
-    */
     HRESULT allowAnimatedImageLooping([out, retval] BOOL* enabled);
-
-    /*!
-        @method setAllowAnimatedImageLooping:
-        @param flag
-        - (void)setAllowsAnimatedImageLooping: (BOOL)flag;
-    */
     HRESULT setAllowAnimatedImageLooping([in] BOOL enabled);
 
-    /*!
-        @method setWillLoadImagesAutomatically:
-        @param flag
-        - (void)setLoadsImagesAutomatically: (BOOL)flag;
-    */
     HRESULT setLoadsImagesAutomatically([in] BOOL enabled);
-
-    /*!
-        @method willLoadImagesAutomatically
-        - (BOOL)loadsImagesAutomatically;
-    */
     HRESULT loadsImagesAutomatically([out, retval] BOOL* enabled);
 
-    /*!
-        @method setAutosaves:
-        @param flag 
-        @discussion If autosave preferences is YES the settings represented by
-        WebPreferences will be stored in the user defaults database.
-        - (void)setAutosaves:(BOOL)flag;
-    */
     HRESULT setAutosaves([in] BOOL enabled);
-
-    /*!
-        @method autosaves
-        @result The value of the autosave preferences flag.
-        - (BOOL)autosaves;
-    */
     HRESULT autosaves([out, retval] BOOL* enabled);
 
-    /*!
-        @method setShouldPrintBackgrounds:
-        @param flag
-        - (void)setShouldPrintBackgrounds:(BOOL)flag;
-    */
     HRESULT setShouldPrintBackgrounds([in] BOOL enabled);
-
-    /*!
-        @method shouldPrintBackgrounds
-        @result The value of the shouldPrintBackgrounds preferences flag
-        - (BOOL)shouldPrintBackgrounds;
-    */
     HRESULT shouldPrintBackgrounds([out, retval] BOOL* enabled);
 
-    /*!
-        @method setPrivateBrowsingEnabled:
-        @param flag 
-        @abstract If private browsing is enabled, WebKit will not store information
-        about sites the user visits.
-        - (void)setPrivateBrowsingEnabled:(BOOL)flag;
-     */
     HRESULT setPrivateBrowsingEnabled([in] BOOL enabled);
-
-    /*!
-        @method privateBrowsingEnabled
-        - (BOOL)privateBrowsingEnabled;
-     */
     HRESULT privateBrowsingEnabled([out, retval] BOOL* enabled);
 
-    /*!
-        @method setTabsToLinks:
-        @param flag 
-        @abstract If tabsToLinks is YES, the tab key will focus links and form controls. 
-        The option key temporarily reverses this preference.
-        - (void)setTabsToLinks:(BOOL)flag;
-    */
     HRESULT setTabsToLinks([in] BOOL enabled);
-
-    /*!
-        @method tabsToLinks
-        - (BOOL)tabsToLinks;
-    */
     HRESULT tabsToLinks([out, retval] BOOL* enabled);
 
-    /*
-        - (BOOL)textAreasAreResizable;
-    */
     HRESULT textAreasAreResizable([out, retval] BOOL* enabled);
-
-    /*
-        - (void)setTextAreasAreResizable:(BOOL)flag;
-    */
     HRESULT setTextAreasAreResizable([in] BOOL enabled);
 
-    /*
-        - (size_t)_pageCacheSize
-    */
     HRESULT pageCacheSize([out, retval] unsigned int* enabled);
-
-    /*
-        - (size_t)_objectCacheSize
-    */
     HRESULT objectCacheSize([out, retval] unsigned int* enabled);
 
-    /*!
-        @method iconDatabaseLocation
-        @discussion The location of the icon database
-    */
     HRESULT iconDatabaseLocation([out, retval] BSTR* location);
-
-    /*!
-        @method setIconDatabaseLocation:
-        @param Set the location of the icon database
-    */
     HRESULT setIconDatabaseLocation([in] BSTR location);
 
-    /*!
-        @method iconDatabaseEnabled:
-        @discussion Whether or not the icon database is enabled
-    */
     HRESULT iconDatabaseEnabled([out, retval] BOOL* enabled);
-
-    /*!
-        @method setIconDatabaseEnabled:
-        @param Enable/disable the icon database
-    */
     HRESULT setIconDatabaseEnabled([in] BOOL enabled);
 
     HRESULT fontSmoothing([out, retval] FontSmoothingType* smoothingType);
     HRESULT setFontSmoothing([in] FontSmoothingType smoothingType);
 
-    /*
-        - (WebKitEditableLinkBehavior)editableLinkBehavior;
-    */
     HRESULT editableLinkBehavior([out, retval] WebKitEditableLinkBehavior* editableLinkBehavior);
-
-    /*
-        - (void)setEditableLinkBehavior:(WebKitEditableLinkBehavior)behavior;
-    */
     HRESULT setEditableLinkBehavior([in] WebKitEditableLinkBehavior behavior);
 
     HRESULT cookieStorageAcceptPolicy([out, retval] WebKitCookieStorageAcceptPolicy* acceptPolicy);
@@ -504,13 +196,6 @@ interface IWebPreferences : IUnknown
     HRESULT isDOMPasteAllowed([out, retval] BOOL *allowed);
     HRESULT setDOMPasteAllowed([in] BOOL allowed);
 
-    /*
-        - (BOOL)usesPageCache;
-    */
     HRESULT usesPageCache([out, retval] BOOL* usesPageCache);
-
-    /*
-        - (void)setUsesPageCache:(BOOL)flag;
-    */
     HRESULT setUsesPageCache([in] BOOL usesPageCache);
 }