Added missing message

1 files changed, 1 insertions, 210 deletions

diff --git a/offapi/com/sun/star/configuration/AccessRootElement.idl b/offapi/com/sun/star/configuration/AccessRootElement.idl
index 18014a533eed..6e5cbd152139 100644
--- a/offapi/com/sun/star/configuration/AccessRootElement.idl
+++ b/offapi/com/sun/star/configuration/AccessRootElement.idl
@@ -1,210 +1 @@
-/*************************************************************************
- *
- *  $RCSfile: AccessRootElement.idl,v $
- *
- *  $Revision: 1.1 $
- *
- *  last change: $Author: jb $ $Date: 2001-02-01 14:31:41 $
- *
- *  The Contents of this file are made available subject to the terms of
- *  either of the following licenses
- *
- *         - GNU Lesser General Public License Version 2.1
- *         - Sun Industry Standards Source License Version 1.1
- *
- *  Sun Microsystems Inc., October, 2000
- *
- *  GNU Lesser General Public License Version 2.1
- *  =============================================
- *  Copyright 2000 by Sun Microsystems, Inc.
- *  901 San Antonio Road, Palo Alto, CA 94303, USA
- *
- *  This library is free software; you can redistribute it and/or
- *  modify it under the terms of the GNU Lesser General Public
- *  License version 2.1, as published by the Free Software Foundation.
- *
- *  This library is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *  Lesser General Public License for more details.
- *
- *  You should have received a copy of the GNU Lesser General Public
- *  License along with this library; if not, write to the Free Software
- *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
- *  MA  02111-1307  USA
- *
- *
- *  Sun Industry Standards Source License Version 1.1
- *  =================================================
- *  The contents of this file are subject to the Sun Industry Standards
- *  Source License Version 1.1 (the "License"); You may not use this file
- *  except in compliance with the License. You may obtain a copy of the
- *  License at http://www.openoffice.org/license.html.
- *
- *  Software provided under this License is provided on an "AS IS" basis,
- *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
- *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
- *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
- *  See the License for the specific provisions governing your rights and
- *  obligations concerning the Software.
- *
- *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
- *
- *  Copyright: 2000 by Sun Microsystems, Inc.
- *
- *  All Rights Reserved.
- *
- *  Contributor(s): _______________________________________
- *
- *
- ************************************************************************/
-#ifndef __com_sun_star_configuration_AccessRootElement_idl__
-#define __com_sun_star_configuration_AccessRootElement_idl__
-
-#ifndef __com_sun_star_configuration_HierarchyElement_idl__
-#include <com/sun/star/configuration/HierarchyElement.idl>
-#endif
-
-#ifndef __com_sun_star_lang_XComponent_idl__
-#include <com/sun/star/lang/XComponent.idl>
-#endif
-
-#ifndef __com_sun_star_lang_XLocalizable_idl__
-#include <com/sun/star/lang/XLocalizable.idl>
-#endif
-
-#ifndef __com_sun_star_util_XChangesNotifier_idl__
-#include <com/sun/star/util/XChangesNotifier.idl>
-#endif
-
-//=============================================================================
-
-module com { module sun { module star { module configuration {
-
-//=============================================================================
-/** provides information about the root element of a (by name) hierarchy
- and about the hierarchy as a whole.
-
- <p>Provides information about the element and the whole hierarchy.
- Allows controlling the lifetime of the hierarchy.
- Allows observing changes in the hierarchy as a whole.
- </p>
-
- <p>When access to a hierarchy is first obtained from a factory or provider,
- this is the initial object that is created by the factory.
- It represents the <em>root</em> of (the accessible part of) the hierarchy.
- </p>
-
- <p><em><strong>NOTE:</strong> In this description 'hierarchy' may actually
- designate a part or fragment of a larger hierarchy. It is that part that is
- rooted in the element represented by an implementation of this service
- and that is accessible starting from this element.</em>
- </p>
-
- <p>Generally it is not possible to navigate the 'surroundings' (if any) of this
- element, so <type scope="com::sun::star::container">XChild</type> is not
- supported.
- </p>
-
- @see com::sun::star::configuration::UpdateRootElement
-    Implementations that support modifying data in the hierarchy
-    generally implement service UpdateRootElement.
-
- @see com::sun::star::configuration::SetElement
-    A complementary service, for children of a dynamic homogeneous container.
-
- @see com::sun::star::configuration::GroupElement
-    A complementary service, for children of a static heterogeneous collection.
-
- @see com::sun::star::configuration::ConfigurationProvider
-    Objects provided by a <type>ConfigurationProvider</type> implement this service.
-
-*/
-service AccessRootElement
-{
-/** is the basic service for accessing information about an element in the
- hierarchy.
-*/
-    service HierarchyElement;
-
-/** allows controlling or observing the lifetime of the whole hierarchy.
-
- <p>The owner of the hierarchy may dispose this object
- (using <member scope="com::sun::star::lang">XComponent::dispose</member>).
- As this object owns its child elements and (recursively) the whole hierarchy,
- any descendant elements obtained (directly or indirectly) from this object
- will also be disposed. Disposing the object does not affect a persistent
- representation of the hierarchy.
- </p>
-
- <p>When an implementation is obtained from a factory or provider, ownership
- of is usually transferred to the client. See the documentation
- of the particular provider or factory service for details.
- </p>
-
- <p>The provider of this object may still dispose this object, when the
- lifetime of the provider ends itself or if this objects represents
- (the root of) only a fragment of an enclosing hierarchy and
- this fragment is removed from the complete hierarchy by an outside source,
- </p>
-
- <p>Clients may register a <type scope="com::sun::star::lang">XEventListener</type>
- to be notified when the object is disposed (for either cause).
- </p>
-*/
-    interface com::sun::star::lang::XComponent;
-
-/** allows registering listeners that observe the whole hierarchy.
-
- <p>A client can register a
- <type scope="com::sun::star::util">XChangesListener</type>,
- which will receive notifications for any changes within the
- hierarchy (fragment) this object represents.
- </p>
-
- <p>An implementation will collect as many changes as possible into a single
- <type scope="com::sun::star::util">ChangesEvent</type>. For Example:
- </p>
-
- <p>
- If <member scope="com::sun::star::beans">XMultiPropertySet::setPropertyValues</member>
- or <member scope="com::sun::star::beans">XMultiHierarchicalPropertySet::setHierarchicalPropertyValues</member>
- is used on an element of the hierarchy to change multiple values within
- the hierarchy, all changes will be notified with a single event.
- </p>
-
- <p>If an outside source uses
- <member scope="com::sun::star::util">XChangesBatch::commitChanges</member>
- on an overlapping hierarchy access, all relevant changes will be notified
- with a single event.
- </p>
-
- @ see UpdateRootElement
- @ see com::sun::star::util::XChangesBatch
-*/
-    interface com::sun::star::util::XChangesNotifier;
-
-/** provides access to the locale that applies to locale-dependent data
- in this hierarchy. [optional]
-
- <p>This interface may be missing, if the implementation does not support
- locale-dependent data in the hierarchy or if the (partial) hierarchy rooted
- in this object does not contain any locale-dependent elements.
- </p>
-
- <p><em>Changing the locale is generally not supported.</em> If it is supported
- there is no guarantee that values already loaded into the hierarchy or an
- application cache are refreshed to reflect the new locale. Use of
- <member scope="com::sun::star::lang">XLocalizable::setLocale</member>
- is therefore not recommended.
- </p>
-*/
-    [optional] interface com::sun::star::lang::XLocalizable;
-
-};
-
-//=============================================================================
-
-}; }; }; };
-
-#endif
+/*************************************************************************
 *
 *  $RCSfile: AccessRootElement.idl,v $
 *
 *  $Revision: 1.2 $
 *
 *  last change: $Author: arellano $ $Date: 2001-02-12 23:51:32 $
 *
 *  The Contents of this file are made available subject to the terms of
 *  either of the following licenses
 *
 *         - GNU Lesser General Public License Version 2.1
 *         - Sun Industry Standards Source License Version 1.1
 *
 *  Sun Microsystems Inc., October, 2000
 *
 *  GNU Lesser General Public License Version 2.1
 *  =============================================
 *  Copyright 2000 by Sun Microsystems, Inc.
 *  901 San Antonio Road, Palo Alto, CA 94303, USA
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License version 2.1, as published by the Free Software Foundation.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *  MA  02111-1307  USA
 *
 *
 *  Sun Industry Standards Source License Version 1.1
 *  =================================================
 *  The contents of this file are subject to the Sun Industry Standards
 *  Source License Version 1.1 (the "License"); You may not use this file
 *  except in compliance with the License. You may obtain a copy of the
 *  License at http://www.openoffice.org/license.html.
 *
 *  Software provided under this License is provided on an "AS IS" basis,
 *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
 *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
 *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
 *  See the License for the specific provisions governing your rights and
 *  obligations concerning the Software.
 *
 *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
 *
 *  Copyright: 2000 by Sun Microsystems, Inc.
 *
 *  All Rights Reserved.
 *
 *  Contributor(s): _______________________________________
 *
 *
 ************************************************************************/
#ifndef __com_sun_star_configuration_AccessRootElement_idl__
#define __com_sun_star_configuration_AccessRootElement_idl__

#ifndef __com_sun_star_configuration_HierarchyElement_idl__
#include <com/sun/star/configuration/HierarchyElement.idl>
#endif

#ifndef __com_sun_star_lang_XComponent_idl__
#include <com/sun/star/lang/XComponent.idl>
#endif

#ifndef __com_sun_star_lang_XLocalizable_idl__
#include <com/sun/star/lang/XLocalizable.idl>
#endif

#ifndef __com_sun_star_util_XChangesNotifier_idl__
#include <com/sun/star/util/XChangesNotifier.idl>
#endif

//=============================================================================

module com { module sun { module star { module configuration { 

//=============================================================================
/** provides information about the root element of a hierarchy, by name,
 and about the hierarchy as a whole.
 
 <p>Provides information about the element and the whole hierarchy.
 Allows controlling the lifetime of the hierarchy.
 Allows observing changes in the hierarchy as a whole.
 </p>

 <p>When access to a hierarchy is first obtained from a factory or provider,
 this is the initial object that is created by the factory. 
 It represents the <em>root</em> of the accessible part of the hierarchy.
 </p>

 <!--missing the <em> tag </em> is making 'root' look like a hyperlink -->

 <p><em><strong>NOTE:</strong> In this description 'hierarchy' may actually
 designate a part or fragment of a larger hierarchy. It is that part that is
 rooted in the element represented by an implementation of this service
 and that is accessible starting from this element.</em>
 </p>

 <p>Generally it is not possible to navigate the 'surroundings' (if any) of this
 element, so <type scope="com::sun::star::container">XChild</type> is not
 supported.
 </p>

 @see com::sun::star::configuration::UpdateRootElement
   Implementations that support modifying data in the hierarchy
   generally implement service UpdateRootElement.

 @see com::sun::star::configuration::SetElement
    A complementary service, for children of a dynamic homogeneous container.

 @see com::sun::star::configuration::GroupElement
   A complementary service, for children of a static heterogeneous collection.

 @see com::sun::star::configuration::ConfigurationProvider
    Objects provided by a <type>ConfigurationProvider</type> implement this service.

*/
service AccessRootElement
{
/** the basic service for accessing information about an element in the
 hierarchy.
*/
    service HierarchyElement;

/** allows controlling or observing the lifetime of the whole hierarchy.

 <p>The owner of the hierarchy may dispose of this object
 using <member scope="com::sun::star::lang">XComponent::dispose</member>.
 As this object owns its child elements and, recursively, the whole hierarchy,
 any descendant elements obtained, directly or indirectly, from this object
 will also be disposed. Disposing of the object does not affect a persistent
 representation of the hierarchy.
 </p>

 <p>When an implementation is obtained from a factory or provider, ownership
 of it is usually transferred to the client. See the documentation
 of the particular provider or factory service for details.
 </p>

 <p>The provider of this object may still dispose of this object, when the
 lifetime of the provider ends itself or if these objects represent 
 the root of only a fragment of an enclosing hierarchy and
 this fragment is removed from the complete hierarchy by an outside source.
 </p>

 <p>Clients may register an <type scope="com::sun::star::lang">XEventListener</type>
 to be notified when the object is disposed for either cause.
 </p>
*/
 interface com::sun::star::lang::XComponent;

/** allows registering listeners that observe the whole hierarchy.

 <p>A client can register a
 <type scope="com::sun::star::util">XChangesListener</type>,
 which will receive notifications for any changes within the
 hierarchy (fragment) this object represents.
 </p>

 <p>An implementation will collect as many changes as possible into a single
 <type scope="com::sun::star::util">ChangesEvent</type>. For Example:
 </p>

 <p>
 If <member scope="com::sun::star::beans">XMultiPropertySet::setPropertyValues</member>
 or <member scope="com::sun::star::beans">XMultiHierarchicalPropertySet::setHierarchicalPropertyValues</member>
 is used on an element of the hierarchy to change multiple values within
 the hierarchy, all changes will be notified with a single event.
 </p>

 <p>If an outside source uses
 <member scope="com::sun::star::util">XChangesBatch::commitChanges</member>
 on an overlapping hierarchy access, all relevant changes will be notified
 with a single event.
 </p>

 @ see UpdateRootElement
 @ see com::sun::star::util::XChangesBatch
*/
  interface com::sun::star::util::XChangesNotifier;

/** provides access to the locale that applies to locale-dependent data
 in this hierarchy. [optional]

 <p>This interface may be missing if the implementation does not support
 locale-dependent data in the hierarchy or if the (partial) hierarchy rooted
 in this object does not contain any locale-dependent elements.
 </p>

 <p><em>Changing the locale is generally not supported.</em> If it is supported,
 there is no guarantee that values already loaded into the hierarchy, or an
 application cache, are refreshed to reflect the new locale. Use of
 <member scope="com::sun::star::lang">XLocalizable::setLocale</member>
 is therefore not recommended.
 </p>
*/
    [optional] interface com::sun::star::lang::XLocalizable;

};

//=============================================================================

}; }; }; }; 

#endif
\ No newline at end of file