Attachment #119282 for bug #212218

This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

View | Details | Raw Unified | Return to bug 212218
Collapse All | Expand All




<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other names may be trademarks of their respective owners.

    <!-- ACTUAL CHANGES BEGIN HERE: -->

    <changes>
        <change id="preffered-update">
            <api name="general"/>
            <summary>Mark an update as preferred just if needed</summary>
            <version major="1" minor="33"/>
            <date day="16" month="5" year="2012"/>
            <author login="jrechtacek"/>
            <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
            <description>
                <p>
                    Added a <code>preferredupdate</code> attribute into <code>Update Center Descriptor</code>
                    to specify if an update has to be installed before other updates or not. This flag is <b>off</b> as default.
                </p>
            </description>
            <class package="org.netbeans.spi.autoupdate" name="UpdateItem"/>
            <issue number="211734"/>
        </change>
        <change id="content-description">
            <api name="general"/>
            <summary>Added a method to get a descprition of content of Upadate Center</summary>
            <version major="1" minor="33"/>
            <date day="16" month="5" year="2012"/>
            <author login="jrechtacek"/>
            <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
            <description>
                <p>
                    {@link org.netbeans.api.autoupdate.UpdateUnitProvider#getContentDescription} returns
                    a description of content staging by this provider. The description might contains HTML tags e.g. HTML Links.
                </p>
            </description>
            <class package="org.netbeans.api.autoupdate" name="UpdateUnitProvider"/>
            <issue number="211741"/>
        </change>
        <change id="get-license-id">
            <api name="general"/>
            <summary>Added a method to get ID of license agreement</summary>
            <version major="1" minor="33"/>
            <date day="16" month="5" year="2012"/>
            <author login="jrechtacek"/>
            <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
            <description>
                <p>
                    Added a method {@link org.netbeans.api.autoupdate.UpdateElement#getLicenseId}
                    to get ID of license agreement if the <code>UpdateElement</code> has a copyright.
                </p>
                <p>
                    This ID could be stored somewhere once an user approves the license and
                    will not be asked for approval again the same license ID.                
                </p>
            </description>
            <class package="org.netbeans.api.autoupdate" name="UpdateElement"/>
            <issue number="211736"/>
        </change>
        <change id="check-write-permission">
            <api name="general"/>
            <summary>Check write permissions to installation directory</summary>
            <version major="1" minor="33"/>
            <date day="16" month="5" year="2012"/>
            <author login="jrechtacek"/>
            <compatibility addition="yes" binary="compatible" deletion="no"
                deprecation="yes" semantic="compatible" source="compatible"
            />
            <description>
                <p>
                    <code>InstallSupport</code> find out the right directory where a plugin
                    should be installed. After that it checks if an user has privilege to write there.
                    In the case a lack of write permission, throws 
                    {@link org.netbeans.api.autoupdate.OperationException.WRITE_PERMISSION}.
                </p>
                <p>
                    Beside this it allows to write into 
                    <code>userdir</code> as a fallback in the case of insufficient privilege.
                </p>
            </description>
            <class package="org.netbeans.api.autoupdate" name="InstallSupport"/>
            <class package="org.netbeans.api.autoupdate" name="OperationException"/>
            <issue number="211777"/>
        </change>
        <change id="nbm-external">
            <api name="general"/>
            <summary>External NBM contents</summary>




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.


package org.netbeans.api.autoupdate;

import org.netbeans.api.autoupdate.OperationSupport.Restarter;
import org.netbeans.api.progress.ProgressHandle;
import org.netbeans.modules.autoupdate.services.InstallSupportImpl;
import org.netbeans.api.autoupdate.OperationSupport.Restarter;

/**
 * Performs all operations scheduled on instance of <code>OperationContainer</code>.

        impl = new InstallSupportImpl (this);
    }
    
    /** Downloads all instances i.e. <code>UpdateElement</code>s in corresponding <code>OperationContainer</code>.
     * 
     * @param progress ProgressHandle for notification progress in downloading, can be <code>null</code>
     * @param isGlobal if <code>true</code> then forces download instances into shared directories i.e. installation directory
     * @return <code>Validator</code> an instance of Validator which allows to verify downloaded instances in the next step
     * @throws org.netbeans.api.autoupdate.OperationException
     * @deprecated Use {@link #doDownload(ProgressHandle, Boolean, boolean)} instead.
     */
    public Validator doDownload(ProgressHandle progress/*or null*/, boolean isGlobal) throws OperationException {
        if (impl.doDownload (progress, isGlobal ? Boolean.TRUE : null, false)) {
            return new Validator ();
        } else {
            return null;
        }
    }

    /** Downloads all instances i.e. <code>UpdateElement</code>s in corresponding <code>OperationContainer</code>.
     * 
     * @param progress ProgressHandle for notification progress in downloading, can be <code>null</code>
     * @param isGlobal if <code>true</code> then forces download plugins into shared directories i.e. installation directory,
     * if <code>false</code> then download plugins into <code>userdir</code>. If <code>null</code> then download plugins in a default place.
     * @param useUserdirAsFallback if <code>true</code> then download plugins into userdir if no permission to write in shared directories
     * @return <code>Validator</code> an instance of Validator which allows to verify downloaded instances in the next step
     * @throws org.netbeans.api.autoupdate.OperationException
     * @since 1.33
     */
    public Validator doDownload(ProgressHandle progress/*or null*/, Boolean isGlobal/*or null*/, boolean useUserdirAsFallback) throws OperationException {
        if (impl.doDownload (progress, isGlobal, useUserdirAsFallback)) {
            return new Validator ();
        } else {
            return null;

Lines 1-7 Link Here

(-)a/autoupdate.services/src/org/netbeans/api/autoupdate/OperationException.java (-1 / +6 lines)
1	/*	1	/*
2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.	2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
3	*	3	*
4	* Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.	4	* Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
5	*	5	*
6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.	6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.
7	* Other names may be trademarks of their respective owners.	7	* Other names may be trademarks of their respective owners.
Lines 77-82 Link Here
77	* Uninstallation of plugin failed	77	* Uninstallation of plugin failed
78	*/	78	*/
79	UNINSTALL,	79	UNINSTALL,
		80	/**
		81	* Lack of write permission to write in installation directory
		82	* @since 1.33
		83	*/
		84	WRITE_PERMISSION
80	}	85	}
81		86
82	/**	87	/**




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.

package org.netbeans.api.autoupdate;

import java.awt.Image;
import org.netbeans.api.autoupdate.UpdateUnitProvider.CATEGORY;
import org.netbeans.modules.autoupdate.services.UpdateElementImpl;
import org.netbeans.api.autoupdate.UpdateUnitProvider.CATEGORY;
import org.netbeans.modules.autoupdate.services.UpdateManagerImpl;
import org.netbeans.modules.autoupdate.updateprovider.ProviderCategory;


        return impl.getDate ();
    }

    /** Returns ID of license agreement if the <code>UpdateElement</code> has a copyright.
     * 
     * @return String or null
     * @since 1.33
     */
    public String getLicenseId () {                
        return impl.getLicenseId ();
    }
    
    /** Returns text of license agreement if the <code>UpdateElement</code> has a copyright.
     * 
     * @return String or null

    public String toString () {
        return impl.getDisplayName() + "[" + impl.getCodeName () + "/" + impl.getSpecificationVersion () + "]";
    }

}





/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.

package org.netbeans.api.autoupdate;

import java.awt.Image;
import org.netbeans.spi.autoupdate.*;
import java.io.IOException;
import java.net.URL;
import java.util.List;
import org.netbeans.api.autoupdate.UpdateManager.TYPE;
import org.netbeans.api.progress.ProgressHandle;
import org.netbeans.modules.autoupdate.services.UpdateUnitProviderImpl;
import org.netbeans.spi.autoupdate.*;


/**<code>UpdateUnitProvider</code> providers <code>UpdateUnit</code>. The units

        return impl.getSourceDescription();
    }

    /** A description of content staging by this provider. The description might contains
     * HTML tags e.g. HTML Links.
     * 
     * @return textual description of content or <code>null</code>
     * @since 1.33
     */
    public String getContentDescription() {
        return impl.getContentDescription();
    }

    /** It's special support for <code>UpdateProvider</code> based on Autoupdate Catalog.
     * It's most kind of Update Providers and have a special support in UI.
     * 

Lines 1-7 Link Here

(-)a/autoupdate.services/src/org/netbeans/spi/autoupdate/UpdateItem.java (-9 / +56 lines)
1	/*	1	/*
2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.	2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
3	*	3	*
4	* Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.	4	* Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
5	*	5	*
6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.	6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.
7	* Other names may be trademarks of their respective owners.	7	* Other names may be trademarks of their respective owners.
Lines 48-58 Link Here
48	import java.util.Locale;	48	import java.util.Locale;
49	import java.util.Set;	49	import java.util.Set;
50	import java.util.jar.Manifest;	50	import java.util.jar.Manifest;
		51	import org.netbeans.modules.autoupdate.services.Trampoline;
		52	import org.netbeans.modules.autoupdate.updateprovider.FeatureItem;
51	import org.netbeans.modules.autoupdate.updateprovider.LocalizationItem;	53	import org.netbeans.modules.autoupdate.updateprovider.LocalizationItem;
52	import org.netbeans.modules.autoupdate.updateprovider.FeatureItem;
53	import org.netbeans.modules.autoupdate.updateprovider.ModuleItem;	54	import org.netbeans.modules.autoupdate.updateprovider.ModuleItem;
54	import org.netbeans.modules.autoupdate.updateprovider.NativeComponentItem;	55	import org.netbeans.modules.autoupdate.updateprovider.NativeComponentItem;
55	import org.netbeans.modules.autoupdate.services.Trampoline;
56	import org.netbeans.modules.autoupdate.updateprovider.UpdateItemImpl;	56	import org.netbeans.modules.autoupdate.updateprovider.UpdateItemImpl;
57		57
58	/** Represents a item of content provider by <code>UpdateProvider</code>. These items are exposed to	58	/** Represents a item of content provider by <code>UpdateProvider</code>. These items are exposed to
Lines 69-74 Link Here
69	UpdateItem original;	69	UpdateItem original;
70		70
71	/** Creates a new instance of UpdateItem */	71	/** Creates a new instance of UpdateItem */
		72	@SuppressWarnings("LeakingThisInConstructor")
72	UpdateItem (UpdateItemImpl item) {	73	UpdateItem (UpdateItemImpl item) {
73	impl = item;	74	impl = item;
74	item.setUpdateItem (this);	75	item.setUpdateItem (this);
Lines 94-100 Link Here
94	* @param license <code>UpdateLicense</code> represents license name and text of license agreement	95	* @param license <code>UpdateLicense</code> represents license name and text of license agreement
95	* @return UpdateItem	96	* @return UpdateItem
96	*/	97	*/
97	public static final UpdateItem createModule (	98	public static UpdateItem createModule (
98	String codeName,	99	String codeName,
99	String specificationVersion,	100	String specificationVersion,
100	URL distribution,	101	URL distribution,
Lines 113-119 Link Here
113	ModuleItem item = new ModuleItem (codeName, specificationVersion, distribution,	114	ModuleItem item = new ModuleItem (codeName, specificationVersion, distribution,
114	author, publishDate, downloadSize, homepage, category,	115	author, publishDate, downloadSize, homepage, category,
115	manifest, isEager, isAutoload,	116	manifest, isEager, isAutoload,
116	needsRestart, isGlobal, targetCluster, license.impl);	117	needsRestart, isGlobal, false, targetCluster, license.impl);
		118	return new UpdateItem (item);
		119	}
		120
		121	/** Creates <code>UpdateItem/code> which represents NetBeans Module in Autoupdate infrastructure.
		122	* UpdateItem is identify by <code>codeName</code> and <code>specificationVersion<code>.
		123	*
		124	* @param codeName code name of module
		125	* @param specificationVersion specification version of module
		126	* @param distribution URL to NBM file
		127	* @param author name of module author or null
		128	* @param downloadSize size of NBM file in bytes
		129	* @param homepage homepage of module or null
		130	* @param publishDate date of publish of item, in date format "yyyy/MM/dd"
		131	* @param category name of category
		132	* @param manifest <code>java.util.jar.Manifest</code> describes the module in NetBeans module system
		133	* @param isEager says if the module is <code>eager</code> or not
		134	* @param isAutoload says if the module is <code>autoload</code> or not
		135	* @param needsRestart if true then IDE must be restarted after module installation
		136	* @param isGlobal control if the module will be installed into the installation directory or into user's dir
		137	* @param isPreferedUpdate if <code>true</code> will be handled in exclusive mode before other updates
		138	* @param targetCluster name of cluster where new module will be installed if installation isGlobal
		139	* @param license <code>UpdateLicense</code> represents license name and text of license agreement
		140	* @return UpdateItem
		141	* @since 1.33
		142	*/
		143	public static UpdateItem createModule (
		144	String codeName,
		145	String specificationVersion,
		146	URL distribution,
		147	String author,
		148	String downloadSize,
		149	String homepage,
		150	String publishDate,
		151	String category,
		152	Manifest manifest,
		153	Boolean isEager,
		154	Boolean isAutoload,
		155	Boolean needsRestart,
		156	Boolean isGlobal,
		157	Boolean isPreferedUpdate,
		158	String targetCluster,
		159	UpdateLicense license) {
		160	ModuleItem item = new ModuleItem (codeName, specificationVersion, distribution,
		161	author, publishDate, downloadSize, homepage, category,
		162	manifest, isEager, isAutoload,
		163	needsRestart, isGlobal, isPreferedUpdate, targetCluster, license.impl);
117	return new UpdateItem (item);	164	return new UpdateItem (item);
118	}	165	}
119		166
Lines 130-136 Link Here
130	* @param category name of category	177	* @param category name of category
131	* @return UpdateItem	178	* @return UpdateItem
132	*/	179	*/
133	public static final UpdateItem createFeature (	180	public static UpdateItem createFeature (
134	String codeName,	181	String codeName,
135	String specificationVersion,	182	String specificationVersion,
136	Set<String> dependencies,	183	Set<String> dependencies,
Lines 158-164 Link Here
158	* @param license <code>UpdateLicense</code> represents license name and text of license agreement	205	* @param license <code>UpdateLicense</code> represents license name and text of license agreement
159	* @return <code>UpdateItem</code>	206	* @return <code>UpdateItem</code>
160	*/	207	*/
161	public static final UpdateItem createNativeComponent (	208	public static UpdateItem createNativeComponent (
162	String codeName,	209	String codeName,
163	String specificationVersion,	210	String specificationVersion,
164	String downloadSize,	211	String downloadSize,
Lines 188-194 Link Here
188	* @param uninstaller <code>CustomUninstaller</code> call-back interface	235	* @param uninstaller <code>CustomUninstaller</code> call-back interface
189	* @return <code>UpdateItem</code>	236	* @return <code>UpdateItem</code>
190	*/	237	*/
191	public static final UpdateItem createInstalledNativeComponent (	238	public static UpdateItem createInstalledNativeComponent (
192	String codeName,	239	String codeName,
193	String specificationVersion,	240	String specificationVersion,
194	Set<String> dependencies,	241	Set<String> dependencies,
Lines 218-224 Link Here
218	* @param license <code>UpdateLicense</code> represents license name and text of license agreement	265	* @param license <code>UpdateLicense</code> represents license name and text of license agreement
219	* @return <code>UpdateItem</code>	266	* @return <code>UpdateItem</code>
220	*/	267	*/
221	public static final UpdateItem createLocalization (	268	public static UpdateItem createLocalization (
222	String codeName,	269	String codeName,
223	String specificationVersion,	270	String specificationVersion,
224	String moduleSpecificationVersion,	271	String moduleSpecificationVersion,




<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other names may be trademarks of their respective owners.

<apidef name="awt">AWT API</apidef>
</apidefs>
<changes>
    <change id="CheckForUpdatesProvider">
        <api name="awt"/>
        <summary>Support for Check for Updates feature</summary>
        <version major="7" minor="45"/>
        <date day="16" month="5" year="2012"/>
        <author login="jrechtacek"/>
        <compatibility addition="yes" binary="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            A service provider of UI for Check for Updates feature, for example in About dialog.
            The instance of the provider should be installed in default lookup using {@link org.openide.util.lookup.ServiceProvider}.
        </description>
        <class package="org.openide.awt" name="CheckForUpdatesProvider"/>
        <issue number="212218"/>
    </change>
    <change id="QuickSearch">
      <api name="awt"/>
      <summary>QuickSearch class that allows to attach quick search field to an arbitratry component.</summary>




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2012 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common
 * Development and Distribution License("CDDL") (collectively, the
 * "License"). You may not use this file except in compliance with the
 * License. You can obtain a copy of the License at
 * http://www.netbeans.org/cddl-gplv2.html
 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 * specific language governing permissions and limitations under the
 * License.  When distributing the software, include this License Header
 * Notice in each file and include the License file at
 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the GPL Version 2 section of the License file that
 * accompanied this code. If applicable, add the following below the
 * License Header, with the fields enclosed by brackets [] replaced by
 * your own identifying information:
 * "Portions Copyrighted [year] [name of copyright owner]"
 *
 * If you wish your version of this file to be governed by only the CDDL
 * or only the GPL Version 2, indicate your decision by adding
 * "[Contributor] elects to include this software in this distribution
 * under the [CDDL or GPL Version 2] license." If you do not indicate a
 * single choice of license, a recipient has the option to distribute
 * your version of this file under either the CDDL, the GPL Version 2 or
 * to extend the choice of license to its licensees as provided above.
 * However, if you add GPL Version 2 code and therefore, elected the GPL
 * Version 2 license, then the option applies only if the new code is
 * made subject to such option by the copyright holder.
 *
 * Contributor(s):
 *
 * Portions Copyrighted 2012 Sun Microsystems, Inc.
 */
package org.openide.awt;

/** Provides a UI for <code>Check for Updates<code> feature, for example in <code>About</code> dialog.
 * An instance of the provider should be installed in the default lookup using {@link org.openide.util.lookup.ServiceProvider}.
 *
 * @author Jiri Rechtacek
 * @since 7.45
 */
public interface CheckForUpdatesProvider {
    
    /** Opens a wizard for installation of updates if found some available.
     * <b>Note:</b> Call it from AWT queue only.
     * 
     * @param reload if <code>true</code> then reload the content from all enabled Update Centers
     * @return <code>true</code> if all updates were successfully installed, <code>false</code> otherwise.
     */
    public boolean openCheckForUpdatesWizard(boolean reload);
    
    /** Runs a check for updates. If some updates found, shows a notification in the status line.
     * <b>Note:</b> It could be a time-consuming task, it should not be called from an event queue.
     * 
     * @param reload if <code>true</code> then reload the content from all enabled Update Centers
     * @return <code>true</code> if updates are available and users will be notified
     * in the status line, <code>false</code> if no updates found.
     */
    public boolean notifyAvailableUpdates(boolean reload);
    
    /** A description of content of enable Update Centers, assuming returns something like <i>7.1 patch1</i>.
     *  The description might contains HTML tags e.g. HTML Links.
     * 
     * @return free-form description of content or <code>null</code>
     */
    public String getContentDescription();
}

Return to bug 212218

Lines 2-8 Link Here

(-)a/autoupdate.services/apichanges.xml (-1 / +78 lines)
2	<!--	2	<!--
3	DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.	3	DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
4		4
5	Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.	5	Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
6		6
7	Oracle and Java are registered trademarks of Oracle and/or its affiliates.	7	Oracle and Java are registered trademarks of Oracle and/or its affiliates.
8	Other names may be trademarks of their respective owners.	8	Other names may be trademarks of their respective owners.
Lines 57-62 Link Here
57	<!-- ACTUAL CHANGES BEGIN HERE: -->	57	<!-- ACTUAL CHANGES BEGIN HERE: -->
58		58
59	<changes>	59	<changes>
		60	<change id="preffered-update">
		61	<api name="general"/>
		62	<summary>Mark an update as preferred just if needed</summary>
		63	<version major="1" minor="33"/>
		64	<date day="16" month="5" year="2012"/>
		65	<author login="jrechtacek"/>
		66	<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
		67	<description>
		68	<p>
		69	Added a <code>preferredupdate</code> attribute into <code>Update Center Descriptor</code>
		70	to specify if an update has to be installed before other updates or not. This flag is <b>off</b> as default.
		71	</p>
		72	</description>
		73	<class package="org.netbeans.spi.autoupdate" name="UpdateItem"/>
		74	<issue number="211734"/>
		75	</change>
		76	<change id="content-description">
		77	<api name="general"/>
		78	<summary>Added a method to get a descprition of content of Upadate Center</summary>
		79	<version major="1" minor="33"/>
		80	<date day="16" month="5" year="2012"/>
		81	<author login="jrechtacek"/>
		82	<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
		83	<description>
		84	<p>
		85	{@link org.netbeans.api.autoupdate.UpdateUnitProvider#getContentDescription} returns
		86	a description of content staging by this provider. The description might contains HTML tags e.g. HTML Links.
		87	</p>
		88	</description>
		89	<class package="org.netbeans.api.autoupdate" name="UpdateUnitProvider"/>
		90	<issue number="211741"/>
		91	</change>
		92	<change id="get-license-id">
		93	<api name="general"/>
		94	<summary>Added a method to get ID of license agreement</summary>
		95	<version major="1" minor="33"/>
		96	<date day="16" month="5" year="2012"/>
		97	<author login="jrechtacek"/>
		98	<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
		99	<description>
		100	<p>
		101	Added a method {@link org.netbeans.api.autoupdate.UpdateElement#getLicenseId}
		102	to get ID of license agreement if the <code>UpdateElement</code> has a copyright.
		103	</p>
		104	<p>
		105	This ID could be stored somewhere once an user approves the license and
		106	will not be asked for approval again the same license ID.
		107	</p>
		108	</description>
		109	<class package="org.netbeans.api.autoupdate" name="UpdateElement"/>
		110	<issue number="211736"/>
		111	</change>
		112	<change id="check-write-permission">
		113	<api name="general"/>
		114	<summary>Check write permissions to installation directory</summary>
		115	<version major="1" minor="33"/>
		116	<date day="16" month="5" year="2012"/>
		117	<author login="jrechtacek"/>
		118	<compatibility addition="yes" binary="compatible" deletion="no"
		119	deprecation="yes" semantic="compatible" source="compatible"
		120	/>
		121	<description>
		122	<p>
		123	<code>InstallSupport</code> find out the right directory where a plugin
124	should be installed. After that it checks if an user has privilege to write there.
125	In the case a lack of write permission, throws
126	{@link org.netbeans.api.autoupdate.OperationException.WRITE_PERMISSION}.
127	</p>
128	<p>
129	Beside this it allows to write into
130	<code>userdir</code> as a fallback in the case of insufficient privilege.
131	</p>
132	</description>
133	<class package="org.netbeans.api.autoupdate" name="InstallSupport"/>
134	<class package="org.netbeans.api.autoupdate" name="OperationException"/>
135	<issue number="211777"/>
136	</change>
60	<change id="nbm-external">	137	<change id="nbm-external">
61	<api name="general"/>	138	<api name="general"/>
62	<summary>External NBM contents</summary>	139	<summary>External NBM contents</summary>

Lines 2-8 Link Here

(-)a/openide.awt/apichanges.xml (-1 / +15 lines)
2	<!--	2	<!--
3	DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.	3	DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
4		4
5	Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.	5	Copyright 1997-2012 Oracle and/or its affiliates. All rights reserved.
6		6
7	Oracle and Java are registered trademarks of Oracle and/or its affiliates.	7	Oracle and Java are registered trademarks of Oracle and/or its affiliates.
8	Other names may be trademarks of their respective owners.	8	Other names may be trademarks of their respective owners.
Lines 50-55 Link Here
50	<apidef name="awt">AWT API</apidef>	50	<apidef name="awt">AWT API</apidef>
51	</apidefs>	51	</apidefs>
52	<changes>	52	<changes>
		53	<change id="CheckForUpdatesProvider">
		54	<api name="awt"/>
		55	<summary>Support for Check for Updates feature</summary>
		56	<version major="7" minor="45"/>
		57	<date day="16" month="5" year="2012"/>
		58	<author login="jrechtacek"/>
		59	<compatibility addition="yes" binary="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
		60	<description>
		61	A service provider of UI for Check for Updates feature, for example in About dialog.
		62	The instance of the provider should be installed in default lookup using {@link org.openide.util.lookup.ServiceProvider}.
		63	</description>
		64	<class package="org.openide.awt" name="CheckForUpdatesProvider"/>
		65	<issue number="212218"/>
		66	</change>
53	<change id="QuickSearch">	67	<change id="QuickSearch">
54	<api name="awt"/>	68	<api name="awt"/>
55	<summary>QuickSearch class that allows to attach quick search field to an arbitratry component.</summary>	69	<summary>QuickSearch class that allows to attach quick search field to an arbitratry component.</summary>

Added Link Here

(-)bc783a188908 (+75 lines)
1	/*
2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
3	*
4	* Copyright 2012 Oracle and/or its affiliates. All rights reserved.
5	*
6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.
7	* Other names may be trademarks of their respective owners.
8	*
9	* The contents of this file are subject to the terms of either the GNU
10	* General Public License Version 2 only ("GPL") or the Common
11	* Development and Distribution License("CDDL") (collectively, the
12	* "License"). You may not use this file except in compliance with the
13	* License. You can obtain a copy of the License at
14	* http://www.netbeans.org/cddl-gplv2.html
15	* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
16	* specific language governing permissions and limitations under the
17	* License. When distributing the software, include this License Header
18	* Notice in each file and include the License file at
19	* nbbuild/licenses/CDDL-GPL-2-CP. Oracle designates this
20	* particular file as subject to the "Classpath" exception as provided
21	* by Oracle in the GPL Version 2 section of the License file that
22	* accompanied this code. If applicable, add the following below the
23	* License Header, with the fields enclosed by brackets [] replaced by
24	* your own identifying information:
25	* "Portions Copyrighted [year] [name of copyright owner]"
26	*
27	* If you wish your version of this file to be governed by only the CDDL
28	* or only the GPL Version 2, indicate your decision by adding
29	* "[Contributor] elects to include this software in this distribution
30	* under the [CDDL or GPL Version 2] license." If you do not indicate a
31	* single choice of license, a recipient has the option to distribute
32	* your version of this file under either the CDDL, the GPL Version 2 or
33	* to extend the choice of license to its licensees as provided above.
34	* However, if you add GPL Version 2 code and therefore, elected the GPL
35	* Version 2 license, then the option applies only if the new code is
36	* made subject to such option by the copyright holder.
37	*
38	* Contributor(s):
39	*
40	* Portions Copyrighted 2012 Sun Microsystems, Inc.
41	*/
42	package org.openide.awt;
43
44	/** Provides a UI for <code>Check for Updates<code> feature, for example in <code>About</code> dialog.
45	* An instance of the provider should be installed in the default lookup using {@link org.openide.util.lookup.ServiceProvider}.
46	*
47	* @author Jiri Rechtacek
48	* @since 7.45
49	*/
50	public interface CheckForUpdatesProvider {
51
52	/** Opens a wizard for installation of updates if found some available.
53	* <b>Note:</b> Call it from AWT queue only.
54	*
55	* @param reload if <code>true</code> then reload the content from all enabled Update Centers
56	* @return <code>true</code> if all updates were successfully installed, <code>false</code> otherwise.
57	*/
58	public boolean openCheckForUpdatesWizard(boolean reload);
59
60	/** Runs a check for updates. If some updates found, shows a notification in the status line.
61	* <b>Note:</b> It could be a time-consuming task, it should not be called from an event queue.
62	*
63	* @param reload if <code>true</code> then reload the content from all enabled Update Centers
64	* @return <code>true</code> if updates are available and users will be notified
65	* in the status line, <code>false</code> if no updates found.
66	*/
67	public boolean notifyAvailableUpdates(boolean reload);
68
69	/** A description of content of enable Update Centers, assuming returns something like <i>7.1 patch1</i>.
70	* The description might contains HTML tags e.g. HTML Links.
71	*
72	* @return free-form description of content or <code>null</code>
73	*/
74	public String getContentDescription();
75	}