/*
 * Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code 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 General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */
package javax.swing.text;

import java.util.Enumeration;

A generic interface for a mutable collection of unique attributes.
Implementations will probably want to provide a constructor of the
form: 

public XXXAttributeSet(ConstAttributeSet source);
/**
 * A generic interface for a mutable collection of unique attributes.
 *
 * Implementations will probably want to provide a constructor of the
 * form: <pre>{@code
 * public XXXAttributeSet(ConstAttributeSet source);}</pre>
 *
 */
public interface MutableAttributeSet extends AttributeSet {

    
Creates a new attribute set similar to this one except that it contains
an attribute with the given name and value.  The object must be
immutable, or not mutated by any client.
Params:
name – the name
value – the value/**
     * Creates a new attribute set similar to this one except that it contains
     * an attribute with the given name and value.  The object must be
     * immutable, or not mutated by any client.
     *
     * @param name the name
     * @param value the value
     */
    public void addAttribute(Object name, Object value);

    
Creates a new attribute set similar to this one except that it contains
the given attributes and values.
Params:
attributes – the set of attributes/**
     * Creates a new attribute set similar to this one except that it contains
     * the given attributes and values.
     *
     * @param attributes the set of attributes
     */
    public void addAttributes(AttributeSet attributes);

    
Removes an attribute with the given name. 
Params:
name – the attribute name/**
     * Removes an attribute with the given {@code name}.
     *
     * @param name the attribute name
     */
    public void removeAttribute(Object name);

    
Removes an attribute set with the given names. 
Params:
names – the set of names/**
     * Removes an attribute set with the given {@code names}.
     *
     * @param names the set of names
     */
    public void removeAttributes(Enumeration<?> names);

    
Removes a set of attributes with the given name. 
Params:
attributes – the set of attributes/**
     * Removes a set of attributes with the given {@code name}.
     *
     * @param attributes the set of attributes
     */
    public void removeAttributes(AttributeSet attributes);

    
Sets the resolving parent.  This is the set
of attributes to resolve through if an attribute
isn't defined locally.
Params:
parent – the parent/**
     * Sets the resolving parent.  This is the set
     * of attributes to resolve through if an attribute
     * isn't defined locally.
     *
     * @param parent the parent
     */
    public void setResolveParent(AttributeSet parent);

}