# This patch file was generated by NetBeans IDE
# Following Index: paths are relative to: /Users/stan/hg/core-main
# This patch can be applied using context Tools: Patch action on respective folder.
# It uses platform neutral UTF-8 encoding and \n newlines.
# Above lines and this line are ignored by the patching process.
Index: openide.util/apichanges.xml
--- openide.util/apichanges.xml
+++ openide.util/apichanges.xml
@@ -51,6 +51,24 @@
     <apidef name="actions">Actions API</apidef>
 </apidefs>
 <changes>
+    <change id="disabled-action-beep">
+        <api name="util"/>
+        <summary>Platform dependent sound when invoking a disabled action.</summary>
+        <version major="8" minor="39"/>
+        <date year="2014" month="7" day="4"/>
+        <author login="saubrecht"/>
+        <compatibility addition="yes" binary="compatible" source="compatible"/>
+        <description>
+            <p>
+                Only some platforms provide an audible notification when user 
+                tries to invoke a disabled action. So instead of Toolkit.beep() 
+                which always plays a sound a new method 
+                <code>Utilities.disabledActionSound()<code> shoud be used instead.
+            </p>
+        </description>
+        <class package="org.openide.util" name="Utilities"/>
+        <issue number="203979"/>
+    </change>
     <change id="try-lock">
         <api name="util"/>
         <summary>Try to lock a Mutex</summary>
Index: openide.util/manifest.mf
--- openide.util/manifest.mf
+++ openide.util/manifest.mf
@@ -1,5 +1,5 @@
 Manifest-Version: 1.0
 OpenIDE-Module: org.openide.util
 OpenIDE-Module-Localizing-Bundle: org/openide/util/Bundle.properties
-OpenIDE-Module-Specification-Version: 8.38
+OpenIDE-Module-Specification-Version: 8.39
 
Index: openide.util/src/org/openide/util/Utilities.java
--- openide.util/src/org/openide/util/Utilities.java
+++ openide.util/src/org/openide/util/Utilities.java
@@ -3215,6 +3215,20 @@
         }
     }
 
+    /**
+     * On some platform this method makes a short audible beep, use it when user 
+     * tries to invoke an action that's disabled.
+     * Some platforms, e.g. MS Windows do not emit any sound in such cases.
+     * @since 8.39
+     */
+    public static void disabledActionBeep() {
+        if( isWindows() ) {
+            //no sound on MS Windows
+            return;
+        }
+        Toolkit.getDefaultToolkit().beep();
+    }
+
     /** Interfaces for communication between Utilities.translate and regular
      * expression impl.
      *