diff options
author | Andrew John Hughes <ahughes@redhat.com> | 2011-01-11 19:46:05 +0000 |
---|---|---|
committer | Andrew John Hughes <gandalf@gcc.gnu.org> | 2011-01-11 19:46:05 +0000 |
commit | dc6715320db92089b3c1b046157b56b5680738a5 (patch) | |
tree | 0da7dbb2f6c016ebe1a6d0bf012840bd76da9170 /libjava/classpath/external | |
parent | 9a270ad3c0ba0eb21d09657f8fb3a7786a69ec5d (diff) | |
download | gcc-dc6715320db92089b3c1b046157b56b5680738a5.tar.gz |
Normalise whitespace in GNU Classpath.
2010-06-03 Andrew John Hughes <ahughes@redhat.com>
* examples/gnu/classpath/examples/CORBA/NamingService/Demo.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/Demo.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/StructureToPass.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/StructureToReturn.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/TreeNode.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/WeThrowThisException.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/WeThrowThisExceptionHelper.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/_DemoTesterImplBase.java,
* examples/gnu/classpath/examples/CORBA/SimpleCommunication/communication/_DemoTesterStub.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/CanvasWorld.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/ChatConstants.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/ClientFrame.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/Demo.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/GameManager.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/GameManagerImpl.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/IorReader.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/OrbStarter.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/Player.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/PlayerImpl.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/PlayingDesk.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/State.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/X5Server.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/_GameManagerImpl_Tie.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/_GameManager_Stub.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/_PlayerImpl_Tie.java,
* examples/gnu/classpath/examples/CORBA/swing/x5/_Player_Stub.java,
* examples/gnu/classpath/examples/awt/AicasGraphicsBenchmark.java,
* examples/gnu/classpath/examples/awt/Demo.java,
* examples/gnu/classpath/examples/awt/HintingDemo.java,
* examples/gnu/classpath/examples/datatransfer/Demo.java,
* examples/gnu/classpath/examples/html/Demo.java,
* examples/gnu/classpath/examples/java2d/J2dBenchmark.java,
* examples/gnu/classpath/examples/java2d/J2dBenchmarkGUI.java,
* examples/gnu/classpath/examples/java2d/JNIOverhead.java,
* examples/gnu/classpath/examples/jawt/DemoJAWT.java,
* examples/gnu/classpath/examples/management/TestClassLoading.java,
* examples/gnu/classpath/examples/management/TestCompilation.java,
* examples/gnu/classpath/examples/management/TestGarbageCollector.java,
* examples/gnu/classpath/examples/management/TestMemory.java,
* examples/gnu/classpath/examples/management/TestMemoryManager.java,
* examples/gnu/classpath/examples/management/TestMemoryPool.java,
* examples/gnu/classpath/examples/management/TestThread.java,
* examples/gnu/classpath/examples/midi/Demo.java,
* examples/gnu/classpath/examples/print/Demo.java,
* examples/gnu/classpath/examples/sound/AudioPlayerSample.java,
* examples/gnu/classpath/examples/swing/BrowserEditorKit.java,
* examples/gnu/classpath/examples/swing/ButtonDemo.java,
* examples/gnu/classpath/examples/swing/ComboBoxDemo.java,
* examples/gnu/classpath/examples/swing/Demo.java,
* examples/gnu/classpath/examples/swing/DemoFactory.java,
* examples/gnu/classpath/examples/swing/DocumentFilterDemo.java,
* examples/gnu/classpath/examples/swing/FileChooserDemo.java,
* examples/gnu/classpath/examples/swing/HtmlDemo.java,
* examples/gnu/classpath/examples/swing/ListDemo.java,
* examples/gnu/classpath/examples/swing/MetalThemeEditor.java,
* examples/gnu/classpath/examples/swing/NavigationFilterDemo.java,
* examples/gnu/classpath/examples/swing/ScrollBarDemo.java,
* examples/gnu/classpath/examples/swing/SliderDemo.java,
* examples/gnu/classpath/examples/swing/SpinnerDemo.java,
* examples/gnu/classpath/examples/swing/TabbedPaneDemo.java,
* examples/gnu/classpath/examples/swing/TableDemo.java,
* examples/gnu/classpath/examples/swing/TextAreaDemo.java,
* examples/gnu/classpath/examples/swing/TextFieldDemo.java,
* examples/gnu/classpath/examples/swing/TreeDemo.java,
* external/jsr166/java/util/ArrayDeque.java,
* external/jsr166/java/util/concurrent/ArrayBlockingQueue.java,
* external/jsr166/java/util/concurrent/ConcurrentHashMap.java,
* external/jsr166/java/util/concurrent/ConcurrentSkipListMap.java,
* external/jsr166/java/util/concurrent/ConcurrentSkipListSet.java,
* external/jsr166/java/util/concurrent/CopyOnWriteArraySet.java,
* external/jsr166/java/util/concurrent/CyclicBarrier.java,
* external/jsr166/java/util/concurrent/DelayQueue.java,
* external/jsr166/java/util/concurrent/Executors.java,
* external/jsr166/java/util/concurrent/FutureTask.java,
* external/jsr166/java/util/concurrent/LinkedBlockingDeque.java,
* external/jsr166/java/util/concurrent/LinkedBlockingQueue.java,
* external/jsr166/java/util/concurrent/PriorityBlockingQueue.java,
* external/jsr166/java/util/concurrent/ScheduledExecutorService.java,
* external/jsr166/java/util/concurrent/ScheduledThreadPoolExecutor.java,
* external/jsr166/java/util/concurrent/Semaphore.java,
* external/jsr166/java/util/concurrent/SynchronousQueue.java,
* external/jsr166/java/util/concurrent/ThreadPoolExecutor.java,
* external/jsr166/java/util/concurrent/atomic/AtomicInteger.java,
* external/jsr166/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java,
* external/jsr166/java/util/concurrent/atomic/AtomicLong.java,
* external/jsr166/java/util/concurrent/atomic/AtomicLongFieldUpdater.java,
* external/jsr166/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java,
* external/jsr166/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java,
* external/jsr166/java/util/concurrent/locks/AbstractQueuedSynchronizer.java,
* external/jsr166/java/util/concurrent/locks/ReentrantReadWriteLock.java,
* external/relaxngDatatype/org/relaxng/datatype/Datatype.java,
* external/relaxngDatatype/org/relaxng/datatype/DatatypeBuilder.java,
* external/relaxngDatatype/org/relaxng/datatype/DatatypeException.java,
* external/relaxngDatatype/org/relaxng/datatype/DatatypeLibrary.java,
* external/relaxngDatatype/org/relaxng/datatype/DatatypeLibraryFactory.java,
* external/relaxngDatatype/org/relaxng/datatype/DatatypeStreamingValidator.java,
* external/relaxngDatatype/org/relaxng/datatype/ValidationContext.java,
* external/relaxngDatatype/org/relaxng/datatype/helpers/DatatypeLibraryLoader.java,
* external/relaxngDatatype/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java,
* external/relaxngDatatype/org/relaxng/datatype/helpers/StreamingValidatorImpl.java,
* external/sax/org/xml/sax/AttributeList.java,
* external/sax/org/xml/sax/Attributes.java,
* external/sax/org/xml/sax/ContentHandler.java,
* external/sax/org/xml/sax/DTDHandler.java,
* external/sax/org/xml/sax/DocumentHandler.java,
* external/sax/org/xml/sax/EntityResolver.java,
* external/sax/org/xml/sax/ErrorHandler.java,
* external/sax/org/xml/sax/HandlerBase.java,
* external/sax/org/xml/sax/InputSource.java,
* external/sax/org/xml/sax/Locator.java,
* external/sax/org/xml/sax/Parser.java,
* external/sax/org/xml/sax/SAXException.java,
* external/sax/org/xml/sax/SAXNotRecognizedException.java,
* external/sax/org/xml/sax/SAXNotSupportedException.java,
* external/sax/org/xml/sax/SAXParseException.java,
* external/sax/org/xml/sax/XMLReader.java,
* external/sax/org/xml/sax/ext/Attributes2.java,
* external/sax/org/xml/sax/ext/Attributes2Impl.java,
* external/sax/org/xml/sax/ext/DeclHandler.java,
* external/sax/org/xml/sax/ext/DefaultHandler2.java,
* external/sax/org/xml/sax/ext/EntityResolver2.java,
* external/sax/org/xml/sax/ext/LexicalHandler.java,
* external/sax/org/xml/sax/ext/Locator2.java,
* external/sax/org/xml/sax/ext/Locator2Impl.java,
* external/sax/org/xml/sax/helpers/AttributeListImpl.java,
* external/sax/org/xml/sax/helpers/AttributesImpl.java,
* external/sax/org/xml/sax/helpers/DefaultHandler.java,
* external/sax/org/xml/sax/helpers/LocatorImpl.java,
* external/sax/org/xml/sax/helpers/NamespaceSupport.java,
* external/sax/org/xml/sax/helpers/NewInstance.java,
* external/sax/org/xml/sax/helpers/ParserAdapter.java,
* external/sax/org/xml/sax/helpers/ParserFactory.java,
* external/sax/org/xml/sax/helpers/XMLFilterImpl.java,
* external/sax/org/xml/sax/helpers/XMLReaderAdapter.java,
* external/sax/org/xml/sax/helpers/XMLReaderFactory.java,
* external/w3c_dom/org/w3c/dom/Attr.java,
* external/w3c_dom/org/w3c/dom/CDATASection.java,
* external/w3c_dom/org/w3c/dom/CharacterData.java,
* external/w3c_dom/org/w3c/dom/Comment.java,
* external/w3c_dom/org/w3c/dom/DOMConfiguration.java,
* external/w3c_dom/org/w3c/dom/DOMError.java,
* external/w3c_dom/org/w3c/dom/DOMErrorHandler.java,
* external/w3c_dom/org/w3c/dom/DOMException.java,
* external/w3c_dom/org/w3c/dom/DOMImplementation.java,
* external/w3c_dom/org/w3c/dom/DOMImplementationList.java,
* external/w3c_dom/org/w3c/dom/DOMImplementationSource.java,
* external/w3c_dom/org/w3c/dom/DOMLocator.java,
* external/w3c_dom/org/w3c/dom/DOMStringList.java,
* external/w3c_dom/org/w3c/dom/Document.java,
* external/w3c_dom/org/w3c/dom/DocumentFragment.java,
* external/w3c_dom/org/w3c/dom/DocumentType.java,
* external/w3c_dom/org/w3c/dom/Element.java,
* external/w3c_dom/org/w3c/dom/Entity.java,
* external/w3c_dom/org/w3c/dom/EntityReference.java,
* external/w3c_dom/org/w3c/dom/NameList.java,
* external/w3c_dom/org/w3c/dom/NamedNodeMap.java,
* external/w3c_dom/org/w3c/dom/Node.java,
* external/w3c_dom/org/w3c/dom/NodeList.java,
* external/w3c_dom/org/w3c/dom/Notation.java,
* external/w3c_dom/org/w3c/dom/ProcessingInstruction.java,
* external/w3c_dom/org/w3c/dom/Text.java,
* external/w3c_dom/org/w3c/dom/TypeInfo.java,
* external/w3c_dom/org/w3c/dom/UserDataHandler.java,
* external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java,
* external/w3c_dom/org/w3c/dom/css/CSS2Properties.java,
* external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSImportRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSPageRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java,
* external/w3c_dom/org/w3c/dom/css/CSSRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSRuleList.java,
* external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java,
* external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java,
* external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java,
* external/w3c_dom/org/w3c/dom/css/CSSValue.java,
* external/w3c_dom/org/w3c/dom/css/CSSValueList.java,
* external/w3c_dom/org/w3c/dom/css/Counter.java,
* external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java,
* external/w3c_dom/org/w3c/dom/css/DocumentCSS.java,
* external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java,
* external/w3c_dom/org/w3c/dom/css/RGBColor.java,
* external/w3c_dom/org/w3c/dom/css/Rect.java,
* external/w3c_dom/org/w3c/dom/css/ViewCSS.java,
* external/w3c_dom/org/w3c/dom/events/DocumentEvent.java,
* external/w3c_dom/org/w3c/dom/events/Event.java,
* external/w3c_dom/org/w3c/dom/events/EventException.java,
* external/w3c_dom/org/w3c/dom/events/EventListener.java,
* external/w3c_dom/org/w3c/dom/events/EventTarget.java,
* external/w3c_dom/org/w3c/dom/events/MouseEvent.java,
* external/w3c_dom/org/w3c/dom/events/MutationEvent.java,
* external/w3c_dom/org/w3c/dom/events/UIEvent.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java,
* external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java,
* external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java,
* external/w3c_dom/org/w3c/dom/ls/LSException.java,
* external/w3c_dom/org/w3c/dom/ls/LSInput.java,
* external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java,
* external/w3c_dom/org/w3c/dom/ls/LSOutput.java,
* external/w3c_dom/org/w3c/dom/ls/LSParser.java,
* external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java,
* external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java,
* external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java,
* external/w3c_dom/org/w3c/dom/ls/LSSerializer.java,
* external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java,
* external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java,
* external/w3c_dom/org/w3c/dom/ranges/Range.java,
* external/w3c_dom/org/w3c/dom/ranges/RangeException.java,
* external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java,
* external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java,
* external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java,
* external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java,
* external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java,
* external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java,
* external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java,
* external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java,
* external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java,
* external/w3c_dom/org/w3c/dom/views/AbstractView.java,
* external/w3c_dom/org/w3c/dom/views/DocumentView.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathException.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java,
* external/w3c_dom/org/w3c/dom/xpath/XPathResult.java,
* gnu/CORBA/BigDecimalHelper.java,
* gnu/CORBA/CDR/AbstractCdrInput.java,
* gnu/CORBA/CDR/AbstractCdrOutput.java,
* gnu/CORBA/CDR/AbstractDataInput.java,
* gnu/CORBA/CDR/AbstractDataOutput.java,
* gnu/CORBA/CDR/AligningInput.java,
* gnu/CORBA/CDR/AligningOutput.java,
* gnu/CORBA/CDR/ArrayValueHelper.java,
* gnu/CORBA/CDR/BigEndianInputStream.java,
* gnu/CORBA/CDR/BigEndianOutputStream.java,
* gnu/CORBA/CDR/BufferedCdrOutput.java,
* gnu/CORBA/CDR/BufferredCdrInput.java,
* gnu/CORBA/CDR/HeadlessInput.java,
* gnu/CORBA/CDR/IDLTypeHelper.java,
* gnu/CORBA/CDR/LittleEndianOutputStream.java,
* gnu/CORBA/CDR/UnknownExceptionCtxHandler.java,
* gnu/CORBA/CDR/VMVio.java,
* gnu/CORBA/CDR/Vio.java,
* gnu/CORBA/CDR/gnuRuntime.java,
* gnu/CORBA/CDR/gnuValueStream.java,
* gnu/CORBA/CdrEncapsCodecImpl.java,
* gnu/CORBA/CollocatedOrbs.java,
* gnu/CORBA/Connected_objects.java,
* gnu/CORBA/DefaultSocketFactory.java,
* gnu/CORBA/DuplicateNameHolder.java,
* gnu/CORBA/DynAn/AbstractAny.java,
* gnu/CORBA/DynAn/DivideableAny.java,
* gnu/CORBA/DynAn/NameValuePairHolder.java,
* gnu/CORBA/DynAn/RecordAny.java,
* gnu/CORBA/DynAn/ValueChangeListener.java,
* gnu/CORBA/DynAn/gnuDynAny.java,
* gnu/CORBA/DynAn/gnuDynAnyFactory.java,
* gnu/CORBA/DynAn/gnuDynArray.java,
* gnu/CORBA/DynAn/gnuDynEnum.java,
* gnu/CORBA/DynAn/gnuDynFixed.java,
* gnu/CORBA/DynAn/gnuDynSequence.java,
* gnu/CORBA/DynAn/gnuDynUnion.java,
* gnu/CORBA/DynAn/gnuDynValue.java,
* gnu/CORBA/DynAn/gnuDynValueBox.java,
* gnu/CORBA/DynAnySeqHolder.java,
* gnu/CORBA/EmptyExceptionHolder.java,
* gnu/CORBA/ForwardRequestHelper.java,
* gnu/CORBA/GIOP/CharSets_OSF.java,
* gnu/CORBA/GIOP/CloseMessage.java,
* gnu/CORBA/GIOP/ErrorMessage.java,
* gnu/CORBA/GIOP/MessageHeader.java,
* gnu/CORBA/GIOP/ServiceContext.java,
* gnu/CORBA/GIOP/v1_2/RequestHeader.java,
* gnu/CORBA/GeneralHolder.java,
* gnu/CORBA/IOR.java,
* gnu/CORBA/Interceptor/ClientRequestInterceptors.java,
* gnu/CORBA/Interceptor/ForwardRequestHolder.java,
* gnu/CORBA/Interceptor/IORInterceptors.java,
* gnu/CORBA/Interceptor/Registrator.java,
* gnu/CORBA/Interceptor/ServerRequestInterceptors.java,
* gnu/CORBA/Interceptor/gnuClientRequestInfo.java,
* gnu/CORBA/Interceptor/gnuIcCurrent.java,
* gnu/CORBA/Interceptor/gnuIorInfo.java,
* gnu/CORBA/Interceptor/gnuServerRequestInfo.java,
* gnu/CORBA/IorDelegate.java,
* gnu/CORBA/IorObject.java,
* gnu/CORBA/Minor.java,
* gnu/CORBA/NameDynAnyPairHolder.java,
* gnu/CORBA/NameDynAnyPairSeqHolder.java,
* gnu/CORBA/NameValuePairHolder.java,
* gnu/CORBA/NameValuePairSeqHolder.java,
* gnu/CORBA/NamingService/NameParser.java,
* gnu/CORBA/NamingService/NamingMap.java,
* gnu/CORBA/NamingService/NamingServiceTransient.java,
* gnu/CORBA/NamingService/TransientContext.java,
* gnu/CORBA/ObjectCreator.java,
* gnu/CORBA/OrbFocused.java,
* gnu/CORBA/OrbFunctional.java,
* gnu/CORBA/OrbRestricted.java,
* gnu/CORBA/Poa/AOM.java,
* gnu/CORBA/Poa/AccessiblePolicy.java,
* gnu/CORBA/Poa/DynamicImpHandler.java,
* gnu/CORBA/Poa/ForwardRequestHolder.java,
* gnu/CORBA/Poa/ForwardedServant.java,
* gnu/CORBA/Poa/InvalidPolicyHolder.java,
* gnu/CORBA/Poa/LocalDelegate.java,
* gnu/CORBA/Poa/LocalRequest.java,
* gnu/CORBA/Poa/LocalServerRequest.java,
* gnu/CORBA/Poa/ORB_1_4.java,
* gnu/CORBA/Poa/ServantDelegateImpl.java,
* gnu/CORBA/Poa/StandardPolicies.java,
* gnu/CORBA/Poa/gnuAdapterActivator.java,
* gnu/CORBA/Poa/gnuForwardRequest.java,
* gnu/CORBA/Poa/gnuIdAssignmentPolicy.java,
* gnu/CORBA/Poa/gnuIdUniquenessPolicy.java,
* gnu/CORBA/Poa/gnuImplicitActivationPolicy.java,
* gnu/CORBA/Poa/gnuLifespanPolicy.java,
* gnu/CORBA/Poa/gnuPOA.java,
* gnu/CORBA/Poa/gnuPOAManager.java,
* gnu/CORBA/Poa/gnuPoaCurrent.java,
* gnu/CORBA/Poa/gnuRequestProcessingPolicy.java,
* gnu/CORBA/Poa/gnuServantObject.java,
* gnu/CORBA/Poa/gnuServantRetentionPolicy.java,
* gnu/CORBA/Poa/gnuThreadPolicy.java,
* gnu/CORBA/ServiceRequestAdapter.java,
* gnu/CORBA/SetOverrideTypeHolder.java,
* gnu/CORBA/SimpleDelegate.java,
* gnu/CORBA/SocketRepository.java,
* gnu/CORBA/StreamHolder.java,
* gnu/CORBA/TypeCodeHelper.java,
* gnu/CORBA/TypeKindNamer.java,
* gnu/CORBA/Version.java,
* gnu/CORBA/_PolicyImplBase.java,
* gnu/CORBA/gnuAny.java,
* gnu/CORBA/gnuCodecFactory.java,
* gnu/CORBA/gnuEnvironment.java,
* gnu/CORBA/gnuRequest.java,
* gnu/CORBA/gnuValueHolder.java,
* gnu/CORBA/interfaces/SocketFactory.java,
* gnu/CORBA/typecodes/AliasTypeCode.java,
* gnu/CORBA/typecodes/ArrayTypeCode.java,
* gnu/CORBA/typecodes/FixedTypeCode.java,
* gnu/CORBA/typecodes/GeneralTypeCode.java,
* gnu/CORBA/typecodes/PrimitiveTypeCode.java,
* gnu/CORBA/typecodes/RecordTypeCode.java,
* gnu/CORBA/typecodes/RecursiveTypeCode.java,
* gnu/CORBA/typecodes/StringTypeCode.java,
* gnu/classpath/Pair.java,
* gnu/classpath/Pointer.java,
* gnu/classpath/Pointer32.java,
* gnu/classpath/Pointer64.java,
* gnu/classpath/ServiceFactory.java,
* gnu/classpath/ServiceProviderLoadingAction.java,
* gnu/classpath/SystemProperties.java,
* gnu/classpath/debug/Component.java,
* gnu/classpath/debug/PreciseFilter.java,
* gnu/classpath/debug/SystemLogger.java,
* gnu/classpath/debug/TeeInputStream.java,
* gnu/classpath/debug/TeeReader.java,
* gnu/classpath/jdwp/Jdwp.java,
* gnu/classpath/jdwp/JdwpConstants.java,
* gnu/classpath/jdwp/event/BreakpointEvent.java,
* gnu/classpath/jdwp/event/ClassPrepareEvent.java,
* gnu/classpath/jdwp/event/ClassUnloadEvent.java,
* gnu/classpath/jdwp/event/Event.java,
* gnu/classpath/jdwp/event/EventManager.java,
* gnu/classpath/jdwp/event/EventRequest.java,
* gnu/classpath/jdwp/event/ExceptionEvent.java,
* gnu/classpath/jdwp/event/MethodEntryEvent.java,
* gnu/classpath/jdwp/event/MethodExitEvent.java,
* gnu/classpath/jdwp/event/SingleStepEvent.java,
* gnu/classpath/jdwp/event/ThreadEndEvent.java,
* gnu/classpath/jdwp/event/VmDeathEvent.java,
* gnu/classpath/jdwp/event/VmInitEvent.java,
* gnu/classpath/jdwp/event/filters/ClassExcludeFilter.java,
* gnu/classpath/jdwp/event/filters/ClassMatchFilter.java,
* gnu/classpath/jdwp/event/filters/ClassOnlyFilter.java,
* gnu/classpath/jdwp/event/filters/ExceptionOnlyFilter.java,
* gnu/classpath/jdwp/event/filters/FieldOnlyFilter.java,
* gnu/classpath/jdwp/event/filters/InstanceOnlyFilter.java,
* gnu/classpath/jdwp/event/filters/StepFilter.java,
* gnu/classpath/jdwp/event/filters/ThreadOnlyFilter.java,
* gnu/classpath/jdwp/exception/InvalidClassException.java,
* gnu/classpath/jdwp/exception/InvalidClassLoaderException.java,
* gnu/classpath/jdwp/exception/InvalidEventTypeException.java,
* gnu/classpath/jdwp/exception/InvalidFieldException.java,
* gnu/classpath/jdwp/exception/InvalidFrameException.java,
* gnu/classpath/jdwp/exception/InvalidLocationException.java,
* gnu/classpath/jdwp/exception/InvalidMethodException.java,
* gnu/classpath/jdwp/exception/InvalidObjectException.java,
* gnu/classpath/jdwp/exception/InvalidSlotException.java,
* gnu/classpath/jdwp/exception/InvalidStringException.java,
* gnu/classpath/jdwp/exception/InvalidThreadException.java,
* gnu/classpath/jdwp/exception/InvalidThreadGroupException.java,
* gnu/classpath/jdwp/exception/NativeMethodException.java,
* gnu/classpath/jdwp/exception/NotImplementedException.java,
* gnu/classpath/jdwp/id/JdwpId.java,
* gnu/classpath/jdwp/id/NullObjectId.java,
* gnu/classpath/jdwp/processor/ArrayReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/ArrayTypeCommandSet.java,
* gnu/classpath/jdwp/processor/ClassLoaderReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/ClassObjectReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/ClassTypeCommandSet.java,
* gnu/classpath/jdwp/processor/CommandSet.java,
* gnu/classpath/jdwp/processor/EventRequestCommandSet.java,
* gnu/classpath/jdwp/processor/FieldCommandSet.java,
* gnu/classpath/jdwp/processor/InterfaceTypeCommandSet.java,
* gnu/classpath/jdwp/processor/MethodCommandSet.java,
* gnu/classpath/jdwp/processor/ObjectReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/PacketProcessor.java,
* gnu/classpath/jdwp/processor/ReferenceTypeCommandSet.java,
* gnu/classpath/jdwp/processor/StackFrameCommandSet.java,
* gnu/classpath/jdwp/processor/StringReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/ThreadGroupReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/ThreadReferenceCommandSet.java,
* gnu/classpath/jdwp/processor/VirtualMachineCommandSet.java,
* gnu/classpath/jdwp/transport/JdwpCommandPacket.java,
* gnu/classpath/jdwp/transport/JdwpConnection.java,
* gnu/classpath/jdwp/transport/JdwpPacket.java,
* gnu/classpath/jdwp/transport/JdwpReplyPacket.java,
* gnu/classpath/jdwp/transport/SocketTransport.java,
* gnu/classpath/jdwp/transport/TransportFactory.java,
* gnu/classpath/jdwp/util/JdwpString.java,
* gnu/classpath/jdwp/util/LineTable.java,
* gnu/classpath/jdwp/util/Location.java,
* gnu/classpath/jdwp/util/MethodResult.java,
* gnu/classpath/jdwp/util/MonitorInfo.java,
* gnu/classpath/jdwp/util/Signature.java,
* gnu/classpath/jdwp/util/VariableTable.java,
* gnu/classpath/jdwp/value/ArrayValue.java,
* gnu/classpath/jdwp/value/BooleanValue.java,
* gnu/classpath/jdwp/value/ByteValue.java,
* gnu/classpath/jdwp/value/CharValue.java,
* gnu/classpath/jdwp/value/DoubleValue.java,
* gnu/classpath/jdwp/value/FloatValue.java,
* gnu/classpath/jdwp/value/IntValue.java,
* gnu/classpath/jdwp/value/LongValue.java,
* gnu/classpath/jdwp/value/ObjectValue.java,
* gnu/classpath/jdwp/value/ShortValue.java,
* gnu/classpath/jdwp/value/StringValue.java,
* gnu/classpath/jdwp/value/Value.java,
* gnu/classpath/jdwp/value/ValueFactory.java,
* gnu/classpath/jdwp/value/VoidValue.java,
* gnu/classpath/toolkit/DefaultDaemonThreadFactory.java,
* gnu/java/awt/AWTUtilities.java,
* gnu/java/awt/BitMaskExtent.java,
* gnu/java/awt/BitwiseXORComposite.java,
* gnu/java/awt/Buffers.java,
* gnu/java/awt/ClasspathGraphicsEnvironment.java,
* gnu/java/awt/ClasspathToolkit.java,
* gnu/java/awt/ComponentDataBlitOp.java,
* gnu/java/awt/EmbeddedWindow.java,
* gnu/java/awt/GradientPaintContext.java,
* gnu/java/awt/color/CieXyzConverter.java,
* gnu/java/awt/color/ClutProfileConverter.java,
* gnu/java/awt/color/ColorLookUpTable.java,
* gnu/java/awt/color/GrayProfileConverter.java,
* gnu/java/awt/color/GrayScaleConverter.java,
* gnu/java/awt/color/LinearRGBConverter.java,
* gnu/java/awt/color/ProfileHeader.java,
* gnu/java/awt/color/RgbProfileConverter.java,
* gnu/java/awt/color/SrgbConverter.java,
* gnu/java/awt/color/ToneReproductionCurve.java,
* gnu/java/awt/dnd/GtkMouseDragGestureRecognizer.java,
* gnu/java/awt/dnd/peer/gtk/GtkDragSourceContextPeer.java,
* gnu/java/awt/dnd/peer/gtk/GtkDropTargetContextPeer.java,
* gnu/java/awt/dnd/peer/gtk/GtkDropTargetPeer.java,
* gnu/java/awt/font/FontDelegate.java,
* gnu/java/awt/font/FontFactory.java,
* gnu/java/awt/font/GNUGlyphVector.java,
* gnu/java/awt/font/OpenTypeFontPeer.java,
* gnu/java/awt/font/autofit/GlyphHints.java,
* gnu/java/awt/font/autofit/Latin.java,
* gnu/java/awt/font/autofit/Utils.java,
* gnu/java/awt/font/opentype/CharGlyphMap.java,
* gnu/java/awt/font/opentype/GlyphNamer.java,
* gnu/java/awt/font/opentype/MacResourceFork.java,
* gnu/java/awt/font/opentype/NameDecoder.java,
* gnu/java/awt/font/opentype/OpenTypeFont.java,
* gnu/java/awt/font/opentype/OpenTypeFontFactory.java,
* gnu/java/awt/font/opentype/truetype/GlyphLoader.java,
* gnu/java/awt/font/opentype/truetype/GlyphLocator.java,
* gnu/java/awt/font/opentype/truetype/GlyphMeasurer.java,
* gnu/java/awt/font/opentype/truetype/Point.java,
* gnu/java/awt/font/opentype/truetype/TrueTypeScaler.java,
* gnu/java/awt/font/opentype/truetype/VirtualMachine.java,
* gnu/java/awt/font/opentype/truetype/Zone.java,
* gnu/java/awt/font/opentype/truetype/ZonePathIterator.java,
* gnu/java/awt/image/AsyncImage.java,
* gnu/java/awt/image/ImageConverter.java,
* gnu/java/awt/image/ImageDecoder.java,
* gnu/java/awt/image/XBMDecoder.java,
* gnu/java/awt/java2d/AbstractGraphics2D.java,
* gnu/java/awt/java2d/AlphaCompositeContext.java,
* gnu/java/awt/java2d/CubicSegment.java,
* gnu/java/awt/java2d/LineSegment.java,
* gnu/java/awt/java2d/PixelCoverage.java,
* gnu/java/awt/java2d/QuadSegment.java,
* gnu/java/awt/java2d/RasterGraphics.java,
* gnu/java/awt/java2d/ScanlineConverter.java,
* gnu/java/awt/java2d/ScanlineCoverage.java,
* gnu/java/awt/java2d/Segment.java,
* gnu/java/awt/java2d/TexturePaintContext.java,
* gnu/java/awt/peer/ClasspathDesktopPeer.java,
* gnu/java/awt/peer/ClasspathFontPeer.java,
* gnu/java/awt/peer/GLightweightPeer.java,
* gnu/java/awt/peer/GnomeDesktopPeer.java,
* gnu/java/awt/peer/KDEDesktopPeer.java,
* gnu/java/awt/peer/gtk/AsyncImage.java,
* gnu/java/awt/peer/gtk/BufferedImageGraphics.java,
* gnu/java/awt/peer/gtk/CairoGraphics2D.java,
* gnu/java/awt/peer/gtk/CairoSurface.java,
* gnu/java/awt/peer/gtk/CairoSurfaceGraphics.java,
* gnu/java/awt/peer/gtk/ComponentGraphics.java,
* gnu/java/awt/peer/gtk/ComponentGraphicsCopy.java,
* gnu/java/awt/peer/gtk/FreetypeGlyphVector.java,
* gnu/java/awt/peer/gtk/GdkFontPeer.java,
* gnu/java/awt/peer/gtk/GdkGraphicsConfiguration.java,
* gnu/java/awt/peer/gtk/GdkGraphicsEnvironment.java,
* gnu/java/awt/peer/gtk/GdkPixbufDecoder.java,
* gnu/java/awt/peer/gtk/GdkRobotPeer.java,
* gnu/java/awt/peer/gtk/GdkScreenGraphicsDevice.java,
* gnu/java/awt/peer/gtk/GtkButtonPeer.java,
* gnu/java/awt/peer/gtk/GtkCheckboxPeer.java,
* gnu/java/awt/peer/gtk/GtkChoicePeer.java,
* gnu/java/awt/peer/gtk/GtkClipboard.java,
* gnu/java/awt/peer/gtk/GtkComponentPeer.java,
* gnu/java/awt/peer/gtk/GtkContainerPeer.java,
* gnu/java/awt/peer/gtk/GtkCursor.java,
* gnu/java/awt/peer/gtk/GtkDialogPeer.java,
* gnu/java/awt/peer/gtk/GtkFileDialogPeer.java,
* gnu/java/awt/peer/gtk/GtkFramePeer.java,
* gnu/java/awt/peer/gtk/GtkGenericPeer.java,
* gnu/java/awt/peer/gtk/GtkImage.java,
* gnu/java/awt/peer/gtk/GtkImageConsumer.java,
* gnu/java/awt/peer/gtk/GtkLabelPeer.java,
* gnu/java/awt/peer/gtk/GtkListPeer.java,
* gnu/java/awt/peer/gtk/GtkMenuComponentPeer.java,
* gnu/java/awt/peer/gtk/GtkMenuPeer.java,
* gnu/java/awt/peer/gtk/GtkMouseInfoPeer.java,
* gnu/java/awt/peer/gtk/GtkPanelPeer.java,
* gnu/java/awt/peer/gtk/GtkPopupMenuPeer.java,
* gnu/java/awt/peer/gtk/GtkScrollbarPeer.java,
* gnu/java/awt/peer/gtk/GtkSelection.java,
* gnu/java/awt/peer/gtk/GtkToolkit.java,
* gnu/java/awt/peer/gtk/GtkVolatileImage.java,
* gnu/java/awt/peer/gtk/GtkWindowPeer.java,
* gnu/java/awt/peer/gtk/VolatileImageGraphics.java,
* gnu/java/awt/peer/headless/HeadlessGraphicsEnvironment.java,
* gnu/java/awt/peer/qt/MainQtThread.java,
* gnu/java/awt/peer/qt/QMatrix.java,
* gnu/java/awt/peer/qt/QPainterPath.java,
* gnu/java/awt/peer/qt/QPen.java,
* gnu/java/awt/peer/qt/QtAudioClip.java,
* gnu/java/awt/peer/qt/QtButtonPeer.java,
* gnu/java/awt/peer/qt/QtCheckboxPeer.java,
* gnu/java/awt/peer/qt/QtChoicePeer.java,
* gnu/java/awt/peer/qt/QtComponentGraphics.java,
* gnu/java/awt/peer/qt/QtComponentPeer.java,
* gnu/java/awt/peer/qt/QtContainerPeer.java,
* gnu/java/awt/peer/qt/QtDialogPeer.java,
* gnu/java/awt/peer/qt/QtEmbeddedWindowPeer.java,
* gnu/java/awt/peer/qt/QtFileDialogPeer.java,
* gnu/java/awt/peer/qt/QtFontMetrics.java,
* gnu/java/awt/peer/qt/QtFontPeer.java,
* gnu/java/awt/peer/qt/QtFramePeer.java,
* gnu/java/awt/peer/qt/QtGraphics.java,
* gnu/java/awt/peer/qt/QtGraphicsEnvironment.java,
* gnu/java/awt/peer/qt/QtImage.java,
* gnu/java/awt/peer/qt/QtImageConsumer.java,
* gnu/java/awt/peer/qt/QtImageDirectGraphics.java,
* gnu/java/awt/peer/qt/QtImageGraphics.java,
* gnu/java/awt/peer/qt/QtLabelPeer.java,
* gnu/java/awt/peer/qt/QtListPeer.java,
* gnu/java/awt/peer/qt/QtMenuBarPeer.java,
* gnu/java/awt/peer/qt/QtMenuComponentPeer.java,
* gnu/java/awt/peer/qt/QtMenuItemPeer.java,
* gnu/java/awt/peer/qt/QtMenuPeer.java,
* gnu/java/awt/peer/qt/QtPanelPeer.java,
* gnu/java/awt/peer/qt/QtPopupMenuPeer.java,
* gnu/java/awt/peer/qt/QtRepaintThread.java,
* gnu/java/awt/peer/qt/QtScreenDevice.java,
* gnu/java/awt/peer/qt/QtScreenDeviceConfiguration.java,
* gnu/java/awt/peer/qt/QtScrollPanePeer.java,
* gnu/java/awt/peer/qt/QtScrollbarPeer.java,
* gnu/java/awt/peer/qt/QtTextAreaPeer.java,
* gnu/java/awt/peer/qt/QtTextFieldPeer.java,
* gnu/java/awt/peer/qt/QtToolkit.java,
* gnu/java/awt/peer/qt/QtVolatileImage.java,
* gnu/java/awt/peer/qt/QtWindowPeer.java,
* gnu/java/awt/peer/swing/SwingButtonPeer.java,
* gnu/java/awt/peer/swing/SwingCheckboxPeer.java,
* gnu/java/awt/peer/swing/SwingComponent.java,
* gnu/java/awt/peer/swing/SwingComponentPeer.java,
* gnu/java/awt/peer/swing/SwingContainerPeer.java,
* gnu/java/awt/peer/swing/SwingLabelPeer.java,
* gnu/java/awt/peer/swing/SwingListPeer.java,
* gnu/java/awt/peer/swing/SwingMenuItemPeer.java,
* gnu/java/awt/peer/swing/SwingMenuPeer.java,
* gnu/java/awt/peer/swing/SwingTextAreaPeer.java,
* gnu/java/awt/peer/swing/SwingTextFieldPeer.java,
* gnu/java/awt/peer/x/GLGraphics.java,
* gnu/java/awt/peer/x/KeyboardMapping.java,
* gnu/java/awt/peer/x/XEventPump.java,
* gnu/java/awt/peer/x/XFontPeer.java,
* gnu/java/awt/peer/x/XFramePeer.java,
* gnu/java/awt/peer/x/XGraphics2D.java,
* gnu/java/awt/peer/x/XGraphicsConfiguration.java,
* gnu/java/awt/peer/x/XGraphicsDevice.java,
* gnu/java/awt/peer/x/XGraphicsEnvironment.java,
* gnu/java/awt/peer/x/XImage.java,
* gnu/java/awt/peer/x/XToolkit.java,
* gnu/java/awt/peer/x/XWindowPeer.java,
* gnu/java/awt/print/JavaPrinterGraphics.java,
* gnu/java/awt/print/JavaPrinterJob.java,
* gnu/java/awt/print/PostScriptGraphics2D.java,
* gnu/java/awt/print/SpooledDocument.java,
* gnu/java/beans/BeanInfoEmbryo.java,
* gnu/java/beans/DefaultExceptionListener.java,
* gnu/java/beans/ExplicitBeanInfo.java,
* gnu/java/beans/IntrospectionIncubator.java,
* gnu/java/beans/decoder/AbstractContext.java,
* gnu/java/beans/decoder/AbstractCreatableObjectContext.java,
* gnu/java/beans/decoder/AbstractElementHandler.java,
* gnu/java/beans/decoder/AbstractObjectContext.java,
* gnu/java/beans/decoder/ArrayContext.java,
* gnu/java/beans/decoder/ArrayHandler.java,
* gnu/java/beans/decoder/AssemblyException.java,
* gnu/java/beans/decoder/BooleanHandler.java,
* gnu/java/beans/decoder/ByteHandler.java,
* gnu/java/beans/decoder/CharHandler.java,
* gnu/java/beans/decoder/ClassHandler.java,
* gnu/java/beans/decoder/ConstructorContext.java,
* gnu/java/beans/decoder/Context.java,
* gnu/java/beans/decoder/DecoderContext.java,
* gnu/java/beans/decoder/DoubleHandler.java,
* gnu/java/beans/decoder/DummyContext.java,
* gnu/java/beans/decoder/DummyHandler.java,
* gnu/java/beans/decoder/ElementHandler.java,
* gnu/java/beans/decoder/FloatHandler.java,
* gnu/java/beans/decoder/GrowableArrayContext.java,
* gnu/java/beans/decoder/IndexContext.java,
* gnu/java/beans/decoder/IntHandler.java,
* gnu/java/beans/decoder/JavaHandler.java,
* gnu/java/beans/decoder/LongHandler.java,
* gnu/java/beans/decoder/MethodContext.java,
* gnu/java/beans/decoder/MethodFinder.java,
* gnu/java/beans/decoder/NullHandler.java,
* gnu/java/beans/decoder/ObjectContext.java,
* gnu/java/beans/decoder/ObjectHandler.java,
* gnu/java/beans/decoder/PersistenceParser.java,
* gnu/java/beans/decoder/PropertyContext.java,
* gnu/java/beans/decoder/ShortHandler.java,
* gnu/java/beans/decoder/SimpleHandler.java,
* gnu/java/beans/decoder/StaticMethodContext.java,
* gnu/java/beans/decoder/StringHandler.java,
* gnu/java/beans/decoder/VoidHandler.java,
* gnu/java/beans/editors/ColorEditor.java,
* gnu/java/beans/editors/FontEditor.java,
* gnu/java/beans/editors/NativeBooleanEditor.java,
* gnu/java/beans/editors/NativeByteEditor.java,
* gnu/java/beans/editors/NativeDoubleEditor.java,
* gnu/java/beans/editors/NativeFloatEditor.java,
* gnu/java/beans/editors/NativeIntEditor.java,
* gnu/java/beans/editors/NativeLongEditor.java,
* gnu/java/beans/editors/NativeShortEditor.java,
* gnu/java/beans/editors/StringEditor.java,
* gnu/java/beans/encoder/ArrayPersistenceDelegate.java,
* gnu/java/beans/encoder/ClassPersistenceDelegate.java,
* gnu/java/beans/encoder/CollectionPersistenceDelegate.java,
* gnu/java/beans/encoder/Context.java,
* gnu/java/beans/encoder/GenericScannerState.java,
* gnu/java/beans/encoder/IgnoringScannerState.java,
* gnu/java/beans/encoder/MapPersistenceDelegate.java,
* gnu/java/beans/encoder/ObjectId.java,
* gnu/java/beans/encoder/PrimitivePersistenceDelegate.java,
* gnu/java/beans/encoder/ReportingScannerState.java,
* gnu/java/beans/encoder/Root.java,
* gnu/java/beans/encoder/ScanEngine.java,
* gnu/java/beans/encoder/ScannerState.java,
* gnu/java/beans/encoder/StAXWriter.java,
* gnu/java/beans/encoder/Writer.java,
* gnu/java/beans/encoder/elements/ArrayInstantiation.java,
* gnu/java/beans/encoder/elements/Array_Get.java,
* gnu/java/beans/encoder/elements/ClassResolution.java,
* gnu/java/beans/encoder/elements/Element.java,
* gnu/java/beans/encoder/elements/List_Get.java,
* gnu/java/beans/encoder/elements/List_Set.java,
* gnu/java/beans/encoder/elements/MethodInvocation.java,
* gnu/java/beans/encoder/elements/NullObject.java,
* gnu/java/beans/encoder/elements/ObjectInstantiation.java,
* gnu/java/beans/encoder/elements/ObjectReference.java,
* gnu/java/beans/encoder/elements/PrimitiveInstantiation.java,
* gnu/java/beans/encoder/elements/StaticFieldAccess.java,
* gnu/java/beans/encoder/elements/StaticMethodInvocation.java,
* gnu/java/beans/encoder/elements/StringReference.java,
* gnu/java/io/ASN1ParsingException.java,
* gnu/java/io/Base64InputStream.java,
* gnu/java/io/ClassLoaderObjectInputStream.java,
* gnu/java/io/NullOutputStream.java,
* gnu/java/io/ObjectIdentityMap2Int.java,
* gnu/java/io/ObjectIdentityWrapper.java,
* gnu/java/io/PlatformHelper.java,
* gnu/java/lang/CPStringBuilder.java,
* gnu/java/lang/CharData.java,
* gnu/java/lang/InstrumentationImpl.java,
* gnu/java/lang/MainThread.java,
* gnu/java/lang/management/BeanImpl.java,
* gnu/java/lang/management/ClassLoadingMXBeanImpl.java,
* gnu/java/lang/management/CompilationMXBeanImpl.java,
* gnu/java/lang/management/GarbageCollectorMXBeanImpl.java,
* gnu/java/lang/management/MemoryMXBeanImpl.java,
* gnu/java/lang/management/MemoryManagerMXBeanImpl.java,
* gnu/java/lang/management/MemoryPoolMXBeanImpl.java,
* gnu/java/lang/management/OperatingSystemMXBeanImpl.java,
* gnu/java/lang/management/RuntimeMXBeanImpl.java,
* gnu/java/lang/management/ThreadMXBeanImpl.java,
* gnu/java/lang/reflect/TypeSignature.java,
* gnu/java/locale/LocaleHelper.java,
* gnu/java/math/Fixed.java,
* gnu/java/math/GMP.java,
* gnu/java/math/MPN.java,
* gnu/java/net/CRLFInputStream.java,
* gnu/java/net/CRLFOutputStream.java,
* gnu/java/net/DefaultContentHandlerFactory.java,
* gnu/java/net/DefaultProxySelector.java,
* gnu/java/net/EmptyX509TrustManager.java,
* gnu/java/net/GetLocalHostAction.java,
* gnu/java/net/HeaderFieldHelper.java,
* gnu/java/net/IndexListParser.java,
* gnu/java/net/LineInputStream.java,
* gnu/java/net/PlainDatagramSocketImpl.java,
* gnu/java/net/PlainSocketImpl.java,
* gnu/java/net/loader/FileResource.java,
* gnu/java/net/loader/FileURLLoader.java,
* gnu/java/net/loader/JarURLLoader.java,
* gnu/java/net/loader/JarURLResource.java,
* gnu/java/net/loader/RemoteResource.java,
* gnu/java/net/loader/RemoteURLLoader.java,
* gnu/java/net/loader/Resource.java,
* gnu/java/net/loader/URLLoader.java,
* gnu/java/net/protocol/file/Connection.java,
* gnu/java/net/protocol/file/Handler.java,
* gnu/java/net/protocol/ftp/ActiveModeDTP.java,
* gnu/java/net/protocol/ftp/BlockInputStream.java,
* gnu/java/net/protocol/ftp/BlockOutputStream.java,
* gnu/java/net/protocol/ftp/CompressedInputStream.java,
* gnu/java/net/protocol/ftp/CompressedOutputStream.java,
* gnu/java/net/protocol/ftp/DTP.java,
* gnu/java/net/protocol/ftp/DTPInputStream.java,
* gnu/java/net/protocol/ftp/DTPOutputStream.java,
* gnu/java/net/protocol/ftp/FTPConnection.java,
* gnu/java/net/protocol/ftp/FTPException.java,
* gnu/java/net/protocol/ftp/FTPResponse.java,
* gnu/java/net/protocol/ftp/FTPURLConnection.java,
* gnu/java/net/protocol/ftp/Handler.java,
* gnu/java/net/protocol/ftp/PassiveModeDTP.java,
* gnu/java/net/protocol/ftp/StreamInputStream.java,
* gnu/java/net/protocol/ftp/StreamOutputStream.java,
* gnu/java/net/protocol/http/Authenticator.java,
* gnu/java/net/protocol/http/ByteArrayRequestBodyWriter.java,
* gnu/java/net/protocol/http/ChunkedInputStream.java,
* gnu/java/net/protocol/http/Cookie.java,
* gnu/java/net/protocol/http/CookieManager.java,
* gnu/java/net/protocol/http/Credentials.java,
* gnu/java/net/protocol/http/HTTPConnection.java,
* gnu/java/net/protocol/http/HTTPDateFormat.java,
* gnu/java/net/protocol/http/HTTPURLConnection.java,
* gnu/java/net/protocol/http/Handler.java,
* gnu/java/net/protocol/http/Headers.java,
* gnu/java/net/protocol/http/Request.java,
* gnu/java/net/protocol/http/RequestBodyWriter.java,
* gnu/java/net/protocol/http/Response.java,
* gnu/java/net/protocol/http/ResponseHeaderHandler.java,
* gnu/java/net/protocol/http/SimpleCookieManager.java,
* gnu/java/net/protocol/https/Handler.java,
* gnu/java/net/protocol/jar/Connection.java,
* gnu/java/net/protocol/jar/Handler.java,
* gnu/java/nio/ChannelInputStream.java,
* gnu/java/nio/ChannelOutputStream.java,
* gnu/java/nio/ChannelReader.java,
* gnu/java/nio/ChannelWriter.java,
* gnu/java/nio/DatagramChannelImpl.java,
* gnu/java/nio/DatagramChannelSelectionKey.java,
* gnu/java/nio/EpollSelectionKeyImpl.java,
* gnu/java/nio/EpollSelectorImpl.java,
* gnu/java/nio/FileChannelImpl.java,
* gnu/java/nio/FileLockImpl.java,
* gnu/java/nio/InputStreamChannel.java,
* gnu/java/nio/KqueueSelectionKeyImpl.java,
* gnu/java/nio/KqueueSelectorImpl.java,
* gnu/java/nio/NIODatagramSocket.java,
* gnu/java/nio/NIOServerSocket.java,
* gnu/java/nio/NIOSocket.java,
* gnu/java/nio/NIOSocketImpl.java,
* gnu/java/nio/OutputStreamChannel.java,
* gnu/java/nio/PipeImpl.java,
* gnu/java/nio/SelectionKeyImpl.java,
* gnu/java/nio/SelectorImpl.java,
* gnu/java/nio/SelectorProviderImpl.java,
* gnu/java/nio/ServerSocketChannelImpl.java,
* gnu/java/nio/ServerSocketChannelSelectionKey.java,
* gnu/java/nio/SocketChannelImpl.java,
* gnu/java/nio/SocketChannelSelectionKey.java,
* gnu/java/nio/SocketChannelSelectionKeyImpl.java,
* gnu/java/nio/VMChannelOwner.java,
* gnu/java/nio/charset/ByteCharset.java,
* gnu/java/nio/charset/ByteDecodeLoopHelper.java,
* gnu/java/nio/charset/ByteEncodeLoopHelper.java,
* gnu/java/nio/charset/Cp424.java,
* gnu/java/nio/charset/Cp437.java,
* gnu/java/nio/charset/Cp737.java,
* gnu/java/nio/charset/Cp775.java,
* gnu/java/nio/charset/Cp850.java,
* gnu/java/nio/charset/Cp852.java,
* gnu/java/nio/charset/Cp855.java,
* gnu/java/nio/charset/Cp857.java,
* gnu/java/nio/charset/Cp860.java,
* gnu/java/nio/charset/Cp861.java,
* gnu/java/nio/charset/Cp862.java,
* gnu/java/nio/charset/Cp863.java,
* gnu/java/nio/charset/Cp864.java,
* gnu/java/nio/charset/Cp865.java,
* gnu/java/nio/charset/Cp866.java,
* gnu/java/nio/charset/Cp869.java,
* gnu/java/nio/charset/Cp874.java,
* gnu/java/nio/charset/EncodingHelper.java,
* gnu/java/nio/charset/ISO_8859_1.java,
* gnu/java/nio/charset/ISO_8859_13.java,
* gnu/java/nio/charset/ISO_8859_15.java,
* gnu/java/nio/charset/ISO_8859_2.java,
* gnu/java/nio/charset/ISO_8859_3.java,
* gnu/java/nio/charset/ISO_8859_4.java,
* gnu/java/nio/charset/ISO_8859_5.java,
* gnu/java/nio/charset/ISO_8859_6.java,
* gnu/java/nio/charset/ISO_8859_7.java,
* gnu/java/nio/charset/ISO_8859_8.java,
* gnu/java/nio/charset/ISO_8859_9.java,
* gnu/java/nio/charset/KOI_8.java,
* gnu/java/nio/charset/MS874.java,
* gnu/java/nio/charset/MacCentralEurope.java,
* gnu/java/nio/charset/MacCroatian.java,
* gnu/java/nio/charset/MacCyrillic.java,
* gnu/java/nio/charset/MacDingbat.java,
* gnu/java/nio/charset/MacGreek.java,
* gnu/java/nio/charset/MacIceland.java,
* gnu/java/nio/charset/MacRoman.java,
* gnu/java/nio/charset/MacRomania.java,
* gnu/java/nio/charset/MacSymbol.java,
* gnu/java/nio/charset/MacThai.java,
* gnu/java/nio/charset/MacTurkish.java,
* gnu/java/nio/charset/Provider.java,
* gnu/java/nio/charset/US_ASCII.java,
* gnu/java/nio/charset/UTF_16.java,
* gnu/java/nio/charset/UTF_16BE.java,
* gnu/java/nio/charset/UTF_16Decoder.java,
* gnu/java/nio/charset/UTF_16Encoder.java,
* gnu/java/nio/charset/UTF_16LE.java,
* gnu/java/nio/charset/UTF_8.java,
* gnu/java/nio/charset/UnicodeLittle.java,
* gnu/java/nio/charset/Windows1250.java,
* gnu/java/nio/charset/Windows1251.java,
* gnu/java/nio/charset/Windows1252.java,
* gnu/java/nio/charset/Windows1253.java,
* gnu/java/nio/charset/Windows1254.java,
* gnu/java/nio/charset/Windows1255.java,
* gnu/java/nio/charset/Windows1256.java,
* gnu/java/nio/charset/Windows1257.java,
* gnu/java/nio/charset/Windows1258.java,
* gnu/java/nio/charset/iconv/IconvCharset.java,
* gnu/java/nio/charset/iconv/IconvDecoder.java,
* gnu/java/nio/charset/iconv/IconvEncoder.java,
* gnu/java/nio/charset/iconv/IconvProvider.java,
* gnu/java/rmi/RMIMarshalledObjectInputStream.java,
* gnu/java/rmi/RMIMarshalledObjectOutputStream.java,
* gnu/java/rmi/activation/ActivationSystemTransient.java,
* gnu/java/rmi/activation/BidiTable.java,
* gnu/java/rmi/activation/DefaultActivationGroup.java,
* gnu/java/rmi/activation/DefaultActivationSystem.java,
* gnu/java/rmi/dgc/DGCImpl.java,
* gnu/java/rmi/dgc/DGCImpl_Skel.java,
* gnu/java/rmi/dgc/DGCImpl_Stub.java,
* gnu/java/rmi/dgc/LeaseRenewingTask.java,
* gnu/java/rmi/registry/RegistryImpl.java,
* gnu/java/rmi/registry/RegistryImpl_Skel.java,
* gnu/java/rmi/registry/RegistryImpl_Stub.java,
* gnu/java/rmi/server/ActivatableRef.java,
* gnu/java/rmi/server/ActivatableServerRef.java,
* gnu/java/rmi/server/CombinedClassLoader.java,
* gnu/java/rmi/server/ConnectionRunnerPool.java,
* gnu/java/rmi/server/ProtocolConstants.java,
* gnu/java/rmi/server/RMIClassLoaderImpl.java,
* gnu/java/rmi/server/RMIDefaultSocketFactory.java,
* gnu/java/rmi/server/RMIHashes.java,
* gnu/java/rmi/server/RMIIncomingThread.java,
* gnu/java/rmi/server/RMIObjectInputStream.java,
* gnu/java/rmi/server/RMIObjectOutputStream.java,
* gnu/java/rmi/server/UnicastConnection.java,
* gnu/java/rmi/server/UnicastConnectionManager.java,
* gnu/java/rmi/server/UnicastRef.java,
* gnu/java/rmi/server/UnicastRemoteCall.java,
* gnu/java/rmi/server/UnicastRemoteStub.java,
* gnu/java/rmi/server/UnicastServer.java,
* gnu/java/rmi/server/UnicastServerRef.java,
* gnu/java/security/Engine.java,
* gnu/java/security/OID.java,
* gnu/java/security/PolicyFile.java,
* gnu/java/security/Properties.java,
* gnu/java/security/Registry.java,
* gnu/java/security/Requires.java,
* gnu/java/security/action/GetPropertyAction.java,
* gnu/java/security/action/SetAccessibleAction.java,
* gnu/java/security/der/DERValue.java,
* gnu/java/security/hash/BaseHash.java,
* gnu/java/security/hash/HashFactory.java,
* gnu/java/security/hash/Haval.java,
* gnu/java/security/hash/IMessageDigest.java,
* gnu/java/security/hash/MD2.java,
* gnu/java/security/hash/MD4.java,
* gnu/java/security/hash/MD5.java,
* gnu/java/security/hash/RipeMD128.java,
* gnu/java/security/hash/RipeMD160.java,
* gnu/java/security/hash/Sha160.java,
* gnu/java/security/hash/Sha256.java,
* gnu/java/security/hash/Sha384.java,
* gnu/java/security/hash/Sha512.java,
* gnu/java/security/hash/Tiger.java,
* gnu/java/security/hash/Whirlpool.java,
* gnu/java/security/jce/hash/HavalSpi.java,
* gnu/java/security/jce/hash/MD2Spi.java,
* gnu/java/security/jce/hash/MD4Spi.java,
* gnu/java/security/jce/hash/MD5Spi.java,
* gnu/java/security/jce/hash/MessageDigestAdapter.java,
* gnu/java/security/jce/hash/RipeMD128Spi.java,
* gnu/java/security/jce/hash/RipeMD160Spi.java,
* gnu/java/security/jce/hash/Sha160Spi.java,
* gnu/java/security/jce/hash/Sha256Spi.java,
* gnu/java/security/jce/hash/Sha384Spi.java,
* gnu/java/security/jce/hash/Sha512Spi.java,
* gnu/java/security/jce/hash/TigerSpi.java,
* gnu/java/security/jce/hash/WhirlpoolSpi.java,
* gnu/java/security/jce/prng/HavalRandomSpi.java,
* gnu/java/security/jce/prng/MD2RandomSpi.java,
* gnu/java/security/jce/prng/MD4RandomSpi.java,
* gnu/java/security/jce/prng/MD5RandomSpi.java,
* gnu/java/security/jce/prng/RipeMD128RandomSpi.java,
* gnu/java/security/jce/prng/RipeMD160RandomSpi.java,
* gnu/java/security/jce/prng/SecureRandomAdapter.java,
* gnu/java/security/jce/prng/Sha160RandomSpi.java,
* gnu/java/security/jce/prng/Sha256RandomSpi.java,
* gnu/java/security/jce/prng/Sha384RandomSpi.java,
* gnu/java/security/jce/prng/Sha512RandomSpi.java,
* gnu/java/security/jce/prng/TigerRandomSpi.java,
* gnu/java/security/jce/prng/WhirlpoolRandomSpi.java,
* gnu/java/security/jce/sig/DSSKeyFactory.java,
* gnu/java/security/jce/sig/DSSKeyPairGeneratorSpi.java,
* gnu/java/security/jce/sig/DSSParameters.java,
* gnu/java/security/jce/sig/DSSRawSignatureSpi.java,
* gnu/java/security/jce/sig/KeyPairGeneratorAdapter.java,
* gnu/java/security/jce/sig/RSAPSSRawSignatureSpi.java,
* gnu/java/security/jce/sig/SignatureAdapter.java,
* gnu/java/security/key/IKeyPairCodec.java,
* gnu/java/security/key/IKeyPairGenerator.java,
* gnu/java/security/key/KeyPairCodecFactory.java,
* gnu/java/security/key/KeyPairGeneratorFactory.java,
* gnu/java/security/key/dss/DSSKey.java,
* gnu/java/security/key/dss/DSSKeyPairGenerator.java,
* gnu/java/security/key/dss/DSSKeyPairPKCS8Codec.java,
* gnu/java/security/key/dss/DSSKeyPairRawCodec.java,
* gnu/java/security/key/dss/DSSKeyPairX509Codec.java,
* gnu/java/security/key/dss/DSSPrivateKey.java,
* gnu/java/security/key/dss/DSSPublicKey.java,
* gnu/java/security/key/dss/FIPS186.java,
* gnu/java/security/key/rsa/GnuRSAKey.java,
* gnu/java/security/key/rsa/GnuRSAPrivateKey.java,
* gnu/java/security/key/rsa/GnuRSAPublicKey.java,
* gnu/java/security/key/rsa/RSAKeyPairGenerator.java,
* gnu/java/security/key/rsa/RSAKeyPairPKCS8Codec.java,
* gnu/java/security/key/rsa/RSAKeyPairRawCodec.java,
* gnu/java/security/key/rsa/RSAKeyPairX509Codec.java,
* gnu/java/security/pkcs/PKCS7Data.java,
* gnu/java/security/pkcs/PKCS7SignedData.java,
* gnu/java/security/pkcs/SignerInfo.java,
* gnu/java/security/prng/BasePRNG.java,
* gnu/java/security/prng/EntropySource.java,
* gnu/java/security/prng/IRandom.java,
* gnu/java/security/prng/LimitReachedException.java,
* gnu/java/security/prng/MDGenerator.java,
* gnu/java/security/prng/PRNGFactory.java,
* gnu/java/security/prng/RandomEventListener.java,
* gnu/java/security/provider/DefaultPolicy.java,
* gnu/java/security/provider/PKIXCertPathValidatorImpl.java,
* gnu/java/security/sig/BaseSignature.java,
* gnu/java/security/sig/ISignature.java,
* gnu/java/security/sig/ISignatureCodec.java,
* gnu/java/security/sig/SignatureCodecFactory.java,
* gnu/java/security/sig/SignatureFactory.java,
* gnu/java/security/sig/dss/DSSSignature.java,
* gnu/java/security/sig/dss/DSSSignatureRawCodec.java,
* gnu/java/security/sig/dss/DSSSignatureX509Codec.java,
* gnu/java/security/sig/rsa/EME_PKCS1_V1_5.java,
* gnu/java/security/sig/rsa/EMSA_PKCS1_V1_5.java,
* gnu/java/security/sig/rsa/EMSA_PSS.java,
* gnu/java/security/sig/rsa/RSA.java,
* gnu/java/security/sig/rsa/RSAPKCS1V1_5Signature.java,
* gnu/java/security/sig/rsa/RSAPKCS1V1_5SignatureRawCodec.java,
* gnu/java/security/sig/rsa/RSAPKCS1V1_5SignatureX509Codec.java,
* gnu/java/security/sig/rsa/RSAPSSSignature.java,
* gnu/java/security/sig/rsa/RSAPSSSignatureRawCodec.java,
* gnu/java/security/sig/rsa/RSASignatureFactory.java,
* gnu/java/security/util/ByteArray.java,
* gnu/java/security/util/ByteBufferOutputStream.java,
* gnu/java/security/util/ExpirableObject.java,
* gnu/java/security/util/FormatUtil.java,
* gnu/java/security/util/IntegerUtil.java,
* gnu/java/security/util/PRNG.java,
* gnu/java/security/util/Prime.java,
* gnu/java/security/util/Sequence.java,
* gnu/java/security/util/SimpleList.java,
* gnu/java/security/util/Util.java,
* gnu/java/security/x509/X509CRLSelectorImpl.java,
* gnu/java/security/x509/X509CertSelectorImpl.java,
* gnu/java/security/x509/ext/CertificatePolicies.java,
* gnu/java/security/x509/ext/GeneralName.java,
* gnu/java/security/x509/ext/GeneralSubtree.java,
* gnu/java/security/x509/ext/NameConstraints.java,
* gnu/java/text/AttributedFormatBuffer.java,
* gnu/java/text/BaseBreakIterator.java,
* gnu/java/text/CharacterBreakIterator.java,
* gnu/java/text/FormatBuffer.java,
* gnu/java/text/FormatCharacterIterator.java,
* gnu/java/text/LineBreakIterator.java,
* gnu/java/text/SentenceBreakIterator.java,
* gnu/java/text/StringFormatBuffer.java,
* gnu/java/text/WordBreakIterator.java,
* gnu/java/util/Base64.java,
* gnu/java/util/DoubleEnumeration.java,
* gnu/java/util/EmptyEnumeration.java,
* gnu/java/util/WeakIdentityHashMap.java,
* gnu/java/util/ZoneInfo.java,
* gnu/java/util/jar/JarUtils.java,
* gnu/java/util/prefs/FileBasedFactory.java,
* gnu/java/util/prefs/FileBasedPreferences.java,
* gnu/java/util/prefs/GConfBasedFactory.java,
* gnu/java/util/prefs/GConfBasedPreferences.java,
* gnu/java/util/prefs/MemoryBasedFactory.java,
* gnu/java/util/prefs/MemoryBasedPreferences.java,
* gnu/java/util/prefs/NodeReader.java,
* gnu/java/util/prefs/NodeWriter.java,
* gnu/java/util/prefs/gconf/GConfNativePeer.java,
* gnu/java/util/regex/BacktrackStack.java,
* gnu/java/util/regex/CharIndexed.java,
* gnu/java/util/regex/CharIndexedInputStream.java,
* gnu/java/util/regex/RE.java,
* gnu/java/util/regex/REFilterInputStream.java,
* gnu/java/util/regex/REMatch.java,
* gnu/java/util/regex/REMatchEnumeration.java,
* gnu/java/util/regex/RESyntax.java,
* gnu/java/util/regex/REToken.java,
* gnu/java/util/regex/RETokenAny.java,
* gnu/java/util/regex/RETokenBackRef.java,
* gnu/java/util/regex/RETokenChar.java,
* gnu/java/util/regex/RETokenEnd.java,
* gnu/java/util/regex/RETokenEndOfPreviousMatch.java,
* gnu/java/util/regex/RETokenIndependent.java,
* gnu/java/util/regex/RETokenLookAhead.java,
* gnu/java/util/regex/RETokenLookBehind.java,
* gnu/java/util/regex/RETokenNamedProperty.java,
* gnu/java/util/regex/RETokenOneOf.java,
* gnu/java/util/regex/RETokenPOSIX.java,
* gnu/java/util/regex/RETokenRange.java,
* gnu/java/util/regex/RETokenRepeated.java,
* gnu/java/util/regex/RETokenStart.java,
* gnu/java/util/regex/RETokenWordBoundary.java,
* gnu/java/util/regex/UncheckedRE.java,
* gnu/javax/activation/viewers/ImageViewer.java,
* gnu/javax/activation/viewers/TextEditor.java,
* gnu/javax/activation/viewers/TextViewer.java,
* gnu/javax/crypto/assembly/Assembly.java,
* gnu/javax/crypto/assembly/Cascade.java,
* gnu/javax/crypto/assembly/CascadeStage.java,
* gnu/javax/crypto/assembly/CascadeTransformer.java,
* gnu/javax/crypto/assembly/DeflateTransformer.java,
* gnu/javax/crypto/assembly/Direction.java,
* gnu/javax/crypto/assembly/LoopbackTransformer.java,
* gnu/javax/crypto/assembly/ModeStage.java,
* gnu/javax/crypto/assembly/Operation.java,
* gnu/javax/crypto/assembly/PaddingTransformer.java,
* gnu/javax/crypto/assembly/Stage.java,
* gnu/javax/crypto/assembly/Transformer.java,
* gnu/javax/crypto/assembly/TransformerException.java,
* gnu/javax/crypto/cipher/Anubis.java,
* gnu/javax/crypto/cipher/BaseCipher.java,
* gnu/javax/crypto/cipher/Blowfish.java,
* gnu/javax/crypto/cipher/Cast5.java,
* gnu/javax/crypto/cipher/CipherFactory.java,
* gnu/javax/crypto/cipher/DES.java,
* gnu/javax/crypto/cipher/IBlockCipher.java,
* gnu/javax/crypto/cipher/IBlockCipherSpi.java,
* gnu/javax/crypto/cipher/Khazad.java,
* gnu/javax/crypto/cipher/NullCipher.java,
* gnu/javax/crypto/cipher/Rijndael.java,
* gnu/javax/crypto/cipher/Serpent.java,
* gnu/javax/crypto/cipher/Square.java,
* gnu/javax/crypto/cipher/TripleDES.java,
* gnu/javax/crypto/cipher/Twofish.java,
* gnu/javax/crypto/cipher/WeakKeyException.java,
* gnu/javax/crypto/jce/DiffieHellmanImpl.java,
* gnu/javax/crypto/jce/GnuCrypto.java,
* gnu/javax/crypto/jce/GnuSasl.java,
* gnu/javax/crypto/jce/PBKDF2SecretKeyFactory.java,
* gnu/javax/crypto/jce/cipher/AESKeyWrapSpi.java,
* gnu/javax/crypto/jce/cipher/AESSpi.java,
* gnu/javax/crypto/jce/cipher/ARCFourSpi.java,
* gnu/javax/crypto/jce/cipher/AnubisSpi.java,
* gnu/javax/crypto/jce/cipher/BlowfishSpi.java,
* gnu/javax/crypto/jce/cipher/Cast5Spi.java,
* gnu/javax/crypto/jce/cipher/CipherAdapter.java,
* gnu/javax/crypto/jce/cipher/DESSpi.java,
* gnu/javax/crypto/jce/cipher/KeyWrappingAlgorithmAdapter.java,
* gnu/javax/crypto/jce/cipher/KhazadSpi.java,
* gnu/javax/crypto/jce/cipher/NullCipherSpi.java,
* gnu/javax/crypto/jce/cipher/PBES2.java,
* gnu/javax/crypto/jce/cipher/RijndaelSpi.java,
* gnu/javax/crypto/jce/cipher/SerpentSpi.java,
* gnu/javax/crypto/jce/cipher/SquareSpi.java,
* gnu/javax/crypto/jce/cipher/TripleDESSpi.java,
* gnu/javax/crypto/jce/cipher/TwofishSpi.java,
* gnu/javax/crypto/jce/key/AnubisSecretKeyFactoryImpl.java,
* gnu/javax/crypto/jce/key/BlowfishSecretKeyFactoryImpl.java,
* gnu/javax/crypto/jce/key/Cast5SecretKeyFactoryImpl.java,
* gnu/javax/crypto/jce/key/SecretKeyGeneratorImpl.java,
* gnu/javax/crypto/jce/keyring/GnuKeyring.java,
* gnu/javax/crypto/jce/mac/HMacHavalSpi.java,
* gnu/javax/crypto/jce/mac/HMacMD2Spi.java,
* gnu/javax/crypto/jce/mac/HMacMD4Spi.java,
* gnu/javax/crypto/jce/mac/HMacMD5Spi.java,
* gnu/javax/crypto/jce/mac/HMacRipeMD128Spi.java,
* gnu/javax/crypto/jce/mac/HMacRipeMD160Spi.java,
* gnu/javax/crypto/jce/mac/HMacSHA160Spi.java,
* gnu/javax/crypto/jce/mac/HMacSHA256Spi.java,
* gnu/javax/crypto/jce/mac/HMacSHA384Spi.java,
* gnu/javax/crypto/jce/mac/HMacSHA512Spi.java,
* gnu/javax/crypto/jce/mac/HMacTigerSpi.java,
* gnu/javax/crypto/jce/mac/HMacWhirlpoolSpi.java,
* gnu/javax/crypto/jce/mac/MacAdapter.java,
* gnu/javax/crypto/jce/mac/TMMH16Spi.java,
* gnu/javax/crypto/jce/mac/UHash32Spi.java,
* gnu/javax/crypto/jce/mac/UMac32Spi.java,
* gnu/javax/crypto/jce/params/BlockCipherParameters.java,
* gnu/javax/crypto/jce/params/DEREncodingException.java,
* gnu/javax/crypto/jce/params/DERReader.java,
* gnu/javax/crypto/jce/params/DERWriter.java,
* gnu/javax/crypto/jce/prng/ARCFourRandomSpi.java,
* gnu/javax/crypto/jce/prng/CSPRNGSpi.java,
* gnu/javax/crypto/jce/prng/FortunaImpl.java,
* gnu/javax/crypto/jce/prng/ICMRandomSpi.java,
* gnu/javax/crypto/jce/prng/UMacRandomSpi.java,
* gnu/javax/crypto/jce/sig/DHParameters.java,
* gnu/javax/crypto/jce/spec/BlockCipherParameterSpec.java,
* gnu/javax/crypto/jce/spec/TMMHParameterSpec.java,
* gnu/javax/crypto/jce/spec/UMac32ParameterSpec.java,
* gnu/javax/crypto/key/BaseKeyAgreementParty.java,
* gnu/javax/crypto/key/GnuPBEKey.java,
* gnu/javax/crypto/key/GnuSecretKey.java,
* gnu/javax/crypto/key/IKeyAgreementParty.java,
* gnu/javax/crypto/key/IncomingMessage.java,
* gnu/javax/crypto/key/KeyAgreementException.java,
* gnu/javax/crypto/key/KeyAgreementFactory.java,
* gnu/javax/crypto/key/OutgoingMessage.java,
* gnu/javax/crypto/key/dh/DHKeyPairPKCS8Codec.java,
* gnu/javax/crypto/key/dh/DHKeyPairRawCodec.java,
* gnu/javax/crypto/key/dh/DHKeyPairX509Codec.java,
* gnu/javax/crypto/key/dh/DiffieHellmanKeyAgreement.java,
* gnu/javax/crypto/key/dh/DiffieHellmanReceiver.java,
* gnu/javax/crypto/key/dh/DiffieHellmanSender.java,
* gnu/javax/crypto/key/dh/ElGamalKeyAgreement.java,
* gnu/javax/crypto/key/dh/ElGamalReceiver.java,
* gnu/javax/crypto/key/dh/ElGamalSender.java,
* gnu/javax/crypto/key/dh/GnuDHKey.java,
* gnu/javax/crypto/key/dh/GnuDHKeyPairGenerator.java,
* gnu/javax/crypto/key/dh/GnuDHPrivateKey.java,
* gnu/javax/crypto/key/dh/GnuDHPublicKey.java,
* gnu/javax/crypto/key/dh/RFC2631.java,
* gnu/javax/crypto/key/srp6/SRP6Host.java,
* gnu/javax/crypto/key/srp6/SRP6KeyAgreement.java,
* gnu/javax/crypto/key/srp6/SRP6SaslClient.java,
* gnu/javax/crypto/key/srp6/SRP6SaslServer.java,
* gnu/javax/crypto/key/srp6/SRP6TLSClient.java,
* gnu/javax/crypto/key/srp6/SRP6TLSServer.java,
* gnu/javax/crypto/key/srp6/SRP6User.java,
* gnu/javax/crypto/key/srp6/SRPAlgorithm.java,
* gnu/javax/crypto/key/srp6/SRPKey.java,
* gnu/javax/crypto/key/srp6/SRPKeyPairGenerator.java,
* gnu/javax/crypto/key/srp6/SRPKeyPairRawCodec.java,
* gnu/javax/crypto/key/srp6/SRPPrivateKey.java,
* gnu/javax/crypto/key/srp6/SRPPublicKey.java,
* gnu/javax/crypto/keyring/AuthenticatedEntry.java,
* gnu/javax/crypto/keyring/BaseKeyring.java,
* gnu/javax/crypto/keyring/BinaryDataEntry.java,
* gnu/javax/crypto/keyring/CertPathEntry.java,
* gnu/javax/crypto/keyring/CertificateEntry.java,
* gnu/javax/crypto/keyring/CompressedEntry.java,
* gnu/javax/crypto/keyring/EncryptedEntry.java,
* gnu/javax/crypto/keyring/Entry.java,
* gnu/javax/crypto/keyring/EnvelopeEntry.java,
* gnu/javax/crypto/keyring/GnuPrivateKeyring.java,
* gnu/javax/crypto/keyring/GnuPublicKeyring.java,
* gnu/javax/crypto/keyring/IKeyring.java,
* gnu/javax/crypto/keyring/IPrivateKeyring.java,
* gnu/javax/crypto/keyring/IPublicKeyring.java,
* gnu/javax/crypto/keyring/MalformedKeyringException.java,
* gnu/javax/crypto/keyring/MaskableEnvelopeEntry.java,
* gnu/javax/crypto/keyring/MeteredInputStream.java,
* gnu/javax/crypto/keyring/PasswordAuthenticatedEntry.java,
* gnu/javax/crypto/keyring/PasswordEncryptedEntry.java,
* gnu/javax/crypto/keyring/PasswordProtectedEntry.java,
* gnu/javax/crypto/keyring/PrimitiveEntry.java,
* gnu/javax/crypto/keyring/PrivateKeyEntry.java,
* gnu/javax/crypto/keyring/Properties.java,
* gnu/javax/crypto/keyring/PublicKeyEntry.java,
* gnu/javax/crypto/kwa/BaseKeyWrappingAlgorithm.java,
* gnu/javax/crypto/kwa/IKeyWrappingAlgorithm.java,
* gnu/javax/crypto/kwa/KeyWrappingAlgorithmFactory.java,
* gnu/javax/crypto/kwa/TripleDESKeyWrap.java,
* gnu/javax/crypto/mac/BaseMac.java,
* gnu/javax/crypto/mac/HMac.java,
* gnu/javax/crypto/mac/HMacFactory.java,
* gnu/javax/crypto/mac/IMac.java,
* gnu/javax/crypto/mac/MacFactory.java,
* gnu/javax/crypto/mac/MacInputStream.java,
* gnu/javax/crypto/mac/MacOutputStream.java,
* gnu/javax/crypto/mac/OMAC.java,
* gnu/javax/crypto/mac/TMMH16.java,
* gnu/javax/crypto/mac/UHash32.java,
* gnu/javax/crypto/mac/UMac32.java,
* gnu/javax/crypto/mode/BaseMode.java,
* gnu/javax/crypto/mode/CBC.java,
* gnu/javax/crypto/mode/CFB.java,
* gnu/javax/crypto/mode/CTR.java,
* gnu/javax/crypto/mode/EAX.java,
* gnu/javax/crypto/mode/ECB.java,
* gnu/javax/crypto/mode/IAuthenticatedMode.java,
* gnu/javax/crypto/mode/ICM.java,
* gnu/javax/crypto/mode/IMode.java,
* gnu/javax/crypto/mode/ModeFactory.java,
* gnu/javax/crypto/mode/OFB.java,
* gnu/javax/crypto/pad/BasePad.java,
* gnu/javax/crypto/pad/IPad.java,
* gnu/javax/crypto/pad/PKCS1_V1_5.java,
* gnu/javax/crypto/pad/PKCS7.java,
* gnu/javax/crypto/pad/PadFactory.java,
* gnu/javax/crypto/pad/TBC.java,
* gnu/javax/crypto/pad/WrongPaddingException.java,
* gnu/javax/crypto/prng/ARCFour.java,
* gnu/javax/crypto/prng/CSPRNG.java,
* gnu/javax/crypto/prng/ICMGenerator.java,
* gnu/javax/crypto/prng/IPBE.java,
* gnu/javax/crypto/prng/PBKDF2.java,
* gnu/javax/crypto/prng/PRNGFactory.java,
* gnu/javax/crypto/prng/UMacGenerator.java,
* gnu/javax/crypto/sasl/AuthInfo.java,
* gnu/javax/crypto/sasl/AuthInfoProviderFactory.java,
* gnu/javax/crypto/sasl/ClientFactory.java,
* gnu/javax/crypto/sasl/ClientMechanism.java,
* gnu/javax/crypto/sasl/ConfidentialityException.java,
* gnu/javax/crypto/sasl/IAuthInfoProvider.java,
* gnu/javax/crypto/sasl/IAuthInfoProviderFactory.java,
* gnu/javax/crypto/sasl/IllegalMechanismStateException.java,
* gnu/javax/crypto/sasl/InputBuffer.java,
* gnu/javax/crypto/sasl/IntegrityException.java,
* gnu/javax/crypto/sasl/NoSuchMechanismException.java,
* gnu/javax/crypto/sasl/NoSuchUserException.java,
* gnu/javax/crypto/sasl/OutputBuffer.java,
* gnu/javax/crypto/sasl/SaslEncodingException.java,
* gnu/javax/crypto/sasl/SaslInputStream.java,
* gnu/javax/crypto/sasl/SaslOutputStream.java,
* gnu/javax/crypto/sasl/SaslUtil.java,
* gnu/javax/crypto/sasl/ServerFactory.java,
* gnu/javax/crypto/sasl/ServerMechanism.java,
* gnu/javax/crypto/sasl/UserAlreadyExistsException.java,
* gnu/javax/crypto/sasl/anonymous/AnonymousClient.java,
* gnu/javax/crypto/sasl/anonymous/AnonymousServer.java,
* gnu/javax/crypto/sasl/anonymous/AnonymousUtil.java,
* gnu/javax/crypto/sasl/crammd5/CramMD5AuthInfoProvider.java,
* gnu/javax/crypto/sasl/crammd5/CramMD5Client.java,
* gnu/javax/crypto/sasl/crammd5/CramMD5Registry.java,
* gnu/javax/crypto/sasl/crammd5/CramMD5Server.java,
* gnu/javax/crypto/sasl/crammd5/CramMD5Util.java,
* gnu/javax/crypto/sasl/crammd5/PasswordFile.java,
* gnu/javax/crypto/sasl/plain/PasswordFile.java,
* gnu/javax/crypto/sasl/plain/PlainAuthInfoProvider.java,
* gnu/javax/crypto/sasl/plain/PlainClient.java,
* gnu/javax/crypto/sasl/plain/PlainRegistry.java,
* gnu/javax/crypto/sasl/plain/PlainServer.java,
* gnu/javax/crypto/sasl/srp/CALG.java,
* gnu/javax/crypto/sasl/srp/ClientStore.java,
* gnu/javax/crypto/sasl/srp/IALG.java,
* gnu/javax/crypto/sasl/srp/KDF.java,
* gnu/javax/crypto/sasl/srp/PasswordFile.java,
* gnu/javax/crypto/sasl/srp/SRP.java,
* gnu/javax/crypto/sasl/srp/SRPAuthInfoProvider.java,
* gnu/javax/crypto/sasl/srp/SRPClient.java,
* gnu/javax/crypto/sasl/srp/SRPRegistry.java,
* gnu/javax/crypto/sasl/srp/SRPServer.java,
* gnu/javax/crypto/sasl/srp/SecurityContext.java,
* gnu/javax/crypto/sasl/srp/ServerStore.java,
* gnu/javax/crypto/sasl/srp/StoreEntry.java,
* gnu/javax/imageio/IIOInputStream.java,
* gnu/javax/imageio/bmp/BMPDecoder.java,
* gnu/javax/imageio/bmp/BMPEncoder.java,
* gnu/javax/imageio/bmp/BMPException.java,
* gnu/javax/imageio/bmp/BMPFileHeader.java,
* gnu/javax/imageio/bmp/BMPImageReader.java,
* gnu/javax/imageio/bmp/BMPImageReaderSpi.java,
* gnu/javax/imageio/bmp/BMPImageWriter.java,
* gnu/javax/imageio/bmp/BMPImageWriterSpi.java,
* gnu/javax/imageio/bmp/BMPInfoHeader.java,
* gnu/javax/imageio/bmp/DecodeBF16.java,
* gnu/javax/imageio/bmp/DecodeBF32.java,
* gnu/javax/imageio/bmp/DecodeRGB1.java,
* gnu/javax/imageio/bmp/DecodeRGB24.java,
* gnu/javax/imageio/bmp/DecodeRGB4.java,
* gnu/javax/imageio/bmp/DecodeRGB8.java,
* gnu/javax/imageio/bmp/DecodeRLE4.java,
* gnu/javax/imageio/bmp/DecodeRLE8.java,
* gnu/javax/imageio/bmp/EncodeRGB1.java,
* gnu/javax/imageio/bmp/EncodeRGB16.java,
* gnu/javax/imageio/bmp/EncodeRGB24.java,
* gnu/javax/imageio/bmp/EncodeRGB32.java,
* gnu/javax/imageio/bmp/EncodeRGB4.java,
* gnu/javax/imageio/bmp/EncodeRGB8.java,
* gnu/javax/imageio/bmp/EncodeRLE4.java,
* gnu/javax/imageio/bmp/EncodeRLE8.java,
* gnu/javax/imageio/gif/GIFFile.java,
* gnu/javax/imageio/gif/GIFImageReader.java,
* gnu/javax/imageio/gif/GIFImageReaderSpi.java,
* gnu/javax/imageio/jpeg/DCT.java,
* gnu/javax/imageio/jpeg/JPEGComponent.java,
* gnu/javax/imageio/jpeg/JPEGDecoder.java,
* gnu/javax/imageio/jpeg/JPEGImageInputStream.java,
* gnu/javax/imageio/jpeg/JPEGImageReader.java,
* gnu/javax/imageio/jpeg/JPEGImageReaderSpi.java,
* gnu/javax/imageio/jpeg/JPEGMarker.java,
* gnu/javax/imageio/jpeg/ZigZag.java,
* gnu/javax/imageio/png/PNGChunk.java,
* gnu/javax/imageio/png/PNGData.java,
* gnu/javax/imageio/png/PNGDecoder.java,
* gnu/javax/imageio/png/PNGEncoder.java,
* gnu/javax/imageio/png/PNGException.java,
* gnu/javax/imageio/png/PNGFile.java,
* gnu/javax/imageio/png/PNGFilter.java,
* gnu/javax/imageio/png/PNGGamma.java,
* gnu/javax/imageio/png/PNGHeader.java,
* gnu/javax/imageio/png/PNGICCProfile.java,
* gnu/javax/imageio/png/PNGImageReader.java,
* gnu/javax/imageio/png/PNGPalette.java,
* gnu/javax/imageio/png/PNGPhys.java,
* gnu/javax/imageio/png/PNGTime.java,
* gnu/javax/management/ListenerData.java,
* gnu/javax/management/Server.java,
* gnu/javax/management/Translator.java,
* gnu/javax/naming/giop/ContextContinuation.java,
* gnu/javax/naming/giop/CorbalocParser.java,
* gnu/javax/naming/giop/GiopNamingEnumeration.java,
* gnu/javax/naming/giop/GiopNamingServiceFactory.java,
* gnu/javax/naming/giop/GiopNamingServiceURLContext.java,
* gnu/javax/naming/giop/ListBindingsEnumeration.java,
* gnu/javax/naming/giop/ListEnumeration.java,
* gnu/javax/naming/ictxImpl/trans/GnuName.java,
* gnu/javax/naming/jndi/url/corbaname/corbanameURLContextFactory.java,
* gnu/javax/naming/jndi/url/rmi/ContextContinuation.java,
* gnu/javax/naming/jndi/url/rmi/ListBindingsEnumeration.java,
* gnu/javax/naming/jndi/url/rmi/ListEnumeration.java,
* gnu/javax/naming/jndi/url/rmi/RmiContinuation.java,
* gnu/javax/naming/jndi/url/rmi/RmiNamingEnumeration.java,
* gnu/javax/naming/jndi/url/rmi/rmiURLContext.java,
* gnu/javax/naming/jndi/url/rmi/rmiURLContextFactory.java,
* gnu/javax/net/ssl/AbstractSessionContext.java,
* gnu/javax/net/ssl/PreSharedKeyManager.java,
* gnu/javax/net/ssl/PreSharedKeyManagerParameters.java,
* gnu/javax/net/ssl/SSLCipherSuite.java,
* gnu/javax/net/ssl/SSLRecordHandler.java,
* gnu/javax/net/ssl/Session.java,
* gnu/javax/net/ssl/SessionStoreException.java,
* gnu/javax/net/ssl/provider/AbstractHandshake.java,
* gnu/javax/net/ssl/provider/Alert.java,
* gnu/javax/net/ssl/provider/AlertException.java,
* gnu/javax/net/ssl/provider/Builder.java,
* gnu/javax/net/ssl/provider/Certificate.java,
* gnu/javax/net/ssl/provider/CertificateBuilder.java,
* gnu/javax/net/ssl/provider/CertificateRequest.java,
* gnu/javax/net/ssl/provider/CertificateRequestBuilder.java,
* gnu/javax/net/ssl/provider/CertificateStatusRequest.java,
* gnu/javax/net/ssl/provider/CertificateStatusType.java,
* gnu/javax/net/ssl/provider/CertificateURL.java,
* gnu/javax/net/ssl/provider/CertificateVerify.java,
* gnu/javax/net/ssl/provider/CipherSuite.java,
* gnu/javax/net/ssl/provider/CipherSuiteList.java,
* gnu/javax/net/ssl/provider/ClientCertificateTypeList.java,
* gnu/javax/net/ssl/provider/ClientDHE_PSKParameters.java,
* gnu/javax/net/ssl/provider/ClientDiffieHellmanPublic.java,
* gnu/javax/net/ssl/provider/ClientHandshake.java,
* gnu/javax/net/ssl/provider/ClientHello.java,
* gnu/javax/net/ssl/provider/ClientHelloBuilder.java,
* gnu/javax/net/ssl/provider/ClientHelloV2.java,
* gnu/javax/net/ssl/provider/ClientKeyExchangeBuilder.java,
* gnu/javax/net/ssl/provider/ClientPSKParameters.java,
* gnu/javax/net/ssl/provider/ClientRSA_PSKParameters.java,
* gnu/javax/net/ssl/provider/CompressionMethod.java,
* gnu/javax/net/ssl/provider/CompressionMethodList.java,
* gnu/javax/net/ssl/provider/Constructed.java,
* gnu/javax/net/ssl/provider/Debug.java,
* gnu/javax/net/ssl/provider/DelegatedTask.java,
* gnu/javax/net/ssl/provider/EmptyExchangeKeys.java,
* gnu/javax/net/ssl/provider/EncryptedPreMasterSecret.java,
* gnu/javax/net/ssl/provider/ExchangeKeys.java,
* gnu/javax/net/ssl/provider/Extension.java,
* gnu/javax/net/ssl/provider/ExtensionList.java,
* gnu/javax/net/ssl/provider/Handshake.java,
* gnu/javax/net/ssl/provider/InputSecurityParameters.java,
* gnu/javax/net/ssl/provider/Jessie.java,
* gnu/javax/net/ssl/provider/MaxFragmentLength.java,
* gnu/javax/net/ssl/provider/OutputSecurityParameters.java,
* gnu/javax/net/ssl/provider/PreSharedKeyManagerFactoryImpl.java,
* gnu/javax/net/ssl/provider/Random.java,
* gnu/javax/net/ssl/provider/SSLContextImpl.java,
* gnu/javax/net/ssl/provider/SSLEngineImpl.java,
* gnu/javax/net/ssl/provider/SSLRSASignatureImpl.java,
* gnu/javax/net/ssl/provider/SSLServerSocketFactoryImpl.java,
* gnu/javax/net/ssl/provider/SSLServerSocketImpl.java,
* gnu/javax/net/ssl/provider/SSLSocketFactoryImpl.java,
* gnu/javax/net/ssl/provider/SSLSocketImpl.java,
* gnu/javax/net/ssl/provider/SSLv3HMacMD5Impl.java,
* gnu/javax/net/ssl/provider/SSLv3HMacSHAImpl.java,
* gnu/javax/net/ssl/provider/ServerDHE_PSKParameters.java,
* gnu/javax/net/ssl/provider/ServerDHParams.java,
* gnu/javax/net/ssl/provider/ServerHandshake.java,
* gnu/javax/net/ssl/provider/ServerHello.java,
* gnu/javax/net/ssl/provider/ServerHelloBuilder.java,
* gnu/javax/net/ssl/provider/ServerHelloDone.java,
* gnu/javax/net/ssl/provider/ServerKeyExchangeBuilder.java,
* gnu/javax/net/ssl/provider/ServerNameList.java,
* gnu/javax/net/ssl/provider/ServerPSKParameters.java,
* gnu/javax/net/ssl/provider/ServerRSA_PSKParameters.java,
* gnu/javax/net/ssl/provider/SessionImpl.java,
* gnu/javax/net/ssl/provider/Signature.java,
* gnu/javax/net/ssl/provider/SignatureAlgorithm.java,
* gnu/javax/net/ssl/provider/SimpleSessionContext.java,
* gnu/javax/net/ssl/provider/TruncatedHMAC.java,
* gnu/javax/net/ssl/provider/TrustedAuthorities.java,
* gnu/javax/net/ssl/provider/UnresolvedExtensionValue.java,
* gnu/javax/net/ssl/provider/Util.java,
* gnu/javax/net/ssl/provider/X500PrincipalList.java,
* gnu/javax/net/ssl/provider/X509KeyManagerFactory.java,
* gnu/javax/net/ssl/provider/X509TrustManagerFactory.java,
* gnu/javax/print/ipp/IppRequest.java,
* gnu/javax/rmi/CORBA/CorbaInput.java,
* gnu/javax/rmi/CORBA/CorbaOutput.java,
* gnu/javax/rmi/CORBA/DefaultWriteObjectTester.java,
* gnu/javax/rmi/CORBA/DelegateFactory.java,
* gnu/javax/rmi/CORBA/GetDelegateInstanceException.java,
* gnu/javax/rmi/CORBA/PortableRemoteObjectDelegateImpl.java,
* gnu/javax/rmi/CORBA/RmiUtilities.java,
* gnu/javax/rmi/CORBA/StubDelegateImpl.java,
* gnu/javax/rmi/CORBA/TieTargetRecord.java,
* gnu/javax/rmi/CORBA/UtilDelegateImpl.java,
* gnu/javax/rmi/CORBA/ValueHandlerDelegateImpl.java,
* gnu/javax/security/auth/callback/AWTCallbackHandler.java,
* gnu/javax/security/auth/callback/AbstractCallbackHandler.java,
* gnu/javax/security/auth/callback/CertificateCallback.java,
* gnu/javax/security/auth/callback/ConsoleCallbackHandler.java,
* gnu/javax/security/auth/callback/DefaultCallbackHandler.java,
* gnu/javax/security/auth/callback/SwingCallbackHandler.java,
* gnu/javax/security/auth/login/ConfigFileParser.java,
* gnu/javax/security/auth/login/ConfigFileTokenizer.java,
* gnu/javax/security/auth/login/GnuConfiguration.java,
* gnu/javax/sound/AudioSecurityManager.java,
* gnu/javax/sound/midi/alsa/AlsaInputPortDevice.java,
* gnu/javax/sound/midi/alsa/AlsaMidiDeviceProvider.java,
* gnu/javax/sound/midi/alsa/AlsaMidiSequencerDevice.java,
* gnu/javax/sound/midi/alsa/AlsaOutputPortDevice.java,
* gnu/javax/sound/midi/alsa/AlsaPortDevice.java,
* gnu/javax/sound/midi/dssi/DSSIMidiDeviceProvider.java,
* gnu/javax/sound/midi/dssi/DSSISynthesizer.java,
* gnu/javax/sound/midi/file/ExtendedMidiFileFormat.java,
* gnu/javax/sound/midi/file/MidiDataInputStream.java,
* gnu/javax/sound/midi/file/MidiDataOutputStream.java,
* gnu/javax/sound/midi/file/MidiFileReader.java,
* gnu/javax/sound/midi/file/MidiFileWriter.java,
* gnu/javax/sound/sampled/AU/AUReader.java,
* gnu/javax/sound/sampled/WAV/WAVReader.java,
* gnu/javax/sound/sampled/gstreamer/GStreamerMixer.java,
* gnu/javax/sound/sampled/gstreamer/GStreamerMixerProvider.java,
* gnu/javax/sound/sampled/gstreamer/io/GstAudioFileReader.java,
* gnu/javax/sound/sampled/gstreamer/io/GstAudioFileReaderNativePeer.java,
* gnu/javax/sound/sampled/gstreamer/io/GstInputStream.java,
* gnu/javax/sound/sampled/gstreamer/lines/GstDataLine.java,
* gnu/javax/sound/sampled/gstreamer/lines/GstNativeDataLine.java,
* gnu/javax/sound/sampled/gstreamer/lines/GstPipeline.java,
* gnu/javax/sound/sampled/gstreamer/lines/GstSourceDataLine.java,
* gnu/javax/swing/plaf/gnu/GNULookAndFeel.java,
* gnu/javax/swing/text/html/CharacterAttributeTranslator.java,
* gnu/javax/swing/text/html/CombinedAttributes.java,
* gnu/javax/swing/text/html/ImageViewIconFactory.java,
* gnu/javax/swing/text/html/css/BorderStyle.java,
* gnu/javax/swing/text/html/css/CSSParser.java,
* gnu/javax/swing/text/html/css/CSSScanner.java,
* gnu/javax/swing/text/html/css/Selector.java,
* gnu/javax/swing/text/html/parser/GnuParserDelegator.java,
* gnu/javax/swing/text/html/parser/HTML_401F.java,
* gnu/javax/swing/text/html/parser/SmallHtmlAttributeSet.java,
* gnu/javax/swing/text/html/parser/htmlAttributeSet.java,
* gnu/javax/swing/text/html/parser/htmlValidator.java,
* gnu/javax/swing/text/html/parser/models/list.java,
* gnu/javax/swing/text/html/parser/support/Parser.java,
* gnu/javax/swing/text/html/parser/support/low/ReaderTokenizer.java,
* gnu/javax/swing/text/html/parser/support/textPreProcessor.java,
* gnu/javax/swing/tree/GnuPath.java,
* gnu/test/Fail.java,
* gnu/test/Pass.java,
* gnu/test/Test.java,
* gnu/test/Unsupported.java,
* gnu/xml/aelfred2/JAXPFactory.java,
* gnu/xml/aelfred2/SAXDriver.java,
* gnu/xml/aelfred2/XmlParser.java,
* gnu/xml/aelfred2/XmlReader.java,
* gnu/xml/dom/Consumer.java,
* gnu/xml/dom/DTDAttributeTypeInfo.java,
* gnu/xml/dom/DTDElementTypeInfo.java,
* gnu/xml/dom/DomAttr.java,
* gnu/xml/dom/DomCDATASection.java,
* gnu/xml/dom/DomCharacterData.java,
* gnu/xml/dom/DomComment.java,
* gnu/xml/dom/DomDOMException.java,
* gnu/xml/dom/DomDoctype.java,
* gnu/xml/dom/DomDocument.java,
* gnu/xml/dom/DomDocumentBuilder.java,
* gnu/xml/dom/DomDocumentBuilderFactory.java,
* gnu/xml/dom/DomDocumentConfiguration.java,
* gnu/xml/dom/DomDocumentFragment.java,
* gnu/xml/dom/DomElement.java,
* gnu/xml/dom/DomEntity.java,
* gnu/xml/dom/DomEntityReference.java,
* gnu/xml/dom/DomEvent.java,
* gnu/xml/dom/DomExtern.java,
* gnu/xml/dom/DomImpl.java,
* gnu/xml/dom/DomIterator.java,
* gnu/xml/dom/DomNSResolverContext.java,
* gnu/xml/dom/DomNamedNodeMap.java,
* gnu/xml/dom/DomNode.java,
* gnu/xml/dom/DomNodeIterator.java,
* gnu/xml/dom/DomNotation.java,
* gnu/xml/dom/DomNsNode.java,
* gnu/xml/dom/DomProcessingInstruction.java,
* gnu/xml/dom/DomText.java,
* gnu/xml/dom/DomXPathExpression.java,
* gnu/xml/dom/DomXPathNSResolver.java,
* gnu/xml/dom/DomXPathResult.java,
* gnu/xml/dom/ImplementationList.java,
* gnu/xml/dom/ImplementationSource.java,
* gnu/xml/dom/JAXPFactory.java,
* gnu/xml/dom/html2/DomHTMLAnchorElement.java,
* gnu/xml/dom/html2/DomHTMLAppletElement.java,
* gnu/xml/dom/html2/DomHTMLAreaElement.java,
* gnu/xml/dom/html2/DomHTMLBRElement.java,
* gnu/xml/dom/html2/DomHTMLBaseElement.java,
* gnu/xml/dom/html2/DomHTMLBaseFontElement.java,
* gnu/xml/dom/html2/DomHTMLBodyElement.java,
* gnu/xml/dom/html2/DomHTMLButtonElement.java,
* gnu/xml/dom/html2/DomHTMLCollection.java,
* gnu/xml/dom/html2/DomHTMLDListElement.java,
* gnu/xml/dom/html2/DomHTMLDirectoryElement.java,
* gnu/xml/dom/html2/DomHTMLDivElement.java,
* gnu/xml/dom/html2/DomHTMLDocument.java,
* gnu/xml/dom/html2/DomHTMLElement.java,
* gnu/xml/dom/html2/DomHTMLEmbedElement.java,
* gnu/xml/dom/html2/DomHTMLFieldSetElement.java,
* gnu/xml/dom/html2/DomHTMLFontElement.java,
* gnu/xml/dom/html2/DomHTMLFormElement.java,
* gnu/xml/dom/html2/DomHTMLFrameElement.java,
* gnu/xml/dom/html2/DomHTMLFrameSetElement.java,
* gnu/xml/dom/html2/DomHTMLHRElement.java,
* gnu/xml/dom/html2/DomHTMLHeadElement.java,
* gnu/xml/dom/html2/DomHTMLHeadingElement.java,
* gnu/xml/dom/html2/DomHTMLHtmlElement.java,
* gnu/xml/dom/html2/DomHTMLIFrameElement.java,
* gnu/xml/dom/html2/DomHTMLImageElement.java,
* gnu/xml/dom/html2/DomHTMLImpl.java,
* gnu/xml/dom/html2/DomHTMLInputElement.java,
* gnu/xml/dom/html2/DomHTMLIsIndexElement.java,
* gnu/xml/dom/html2/DomHTMLLIElement.java,
* gnu/xml/dom/html2/DomHTMLLabelElement.java,
* gnu/xml/dom/html2/DomHTMLLegendElement.java,
* gnu/xml/dom/html2/DomHTMLLinkElement.java,
* gnu/xml/dom/html2/DomHTMLMapElement.java,
* gnu/xml/dom/html2/DomHTMLMenuElement.java,
* gnu/xml/dom/html2/DomHTMLMetaElement.java,
* gnu/xml/dom/html2/DomHTMLModElement.java,
* gnu/xml/dom/html2/DomHTMLOListElement.java,
* gnu/xml/dom/html2/DomHTMLObjectElement.java,
* gnu/xml/dom/html2/DomHTMLOptGroupElement.java,
* gnu/xml/dom/html2/DomHTMLOptionElement.java,
* gnu/xml/dom/html2/DomHTMLParagraphElement.java,
* gnu/xml/dom/html2/DomHTMLParamElement.java,
* gnu/xml/dom/html2/DomHTMLParser.java,
* gnu/xml/dom/html2/DomHTMLPreElement.java,
* gnu/xml/dom/html2/DomHTMLQuoteElement.java,
* gnu/xml/dom/html2/DomHTMLScriptElement.java,
* gnu/xml/dom/html2/DomHTMLSelectElement.java,
* gnu/xml/dom/html2/DomHTMLStyleElement.java,
* gnu/xml/dom/html2/DomHTMLTableCaptionElement.java,
* gnu/xml/dom/html2/DomHTMLTableCellElement.java,
* gnu/xml/dom/html2/DomHTMLTableColElement.java,
* gnu/xml/dom/html2/DomHTMLTableElement.java,
* gnu/xml/dom/html2/DomHTMLTableRowElement.java,
* gnu/xml/dom/html2/DomHTMLTableSectionElement.java,
* gnu/xml/dom/html2/DomHTMLTextAreaElement.java,
* gnu/xml/dom/html2/DomHTMLTitleElement.java,
* gnu/xml/dom/html2/DomHTMLUListElement.java,
* gnu/xml/dom/ls/DomLSException.java,
* gnu/xml/dom/ls/DomLSInput.java,
* gnu/xml/dom/ls/DomLSOutput.java,
* gnu/xml/dom/ls/DomLSParser.java,
* gnu/xml/dom/ls/DomLSSerializer.java,
* gnu/xml/dom/ls/FilteredSAXEventSink.java,
* gnu/xml/dom/ls/ReaderInputStream.java,
* gnu/xml/dom/ls/SAXEventSink.java,
* gnu/xml/dom/ls/WriterOutputStream.java,
* gnu/xml/libxmlj/dom/GnomeAttr.java,
* gnu/xml/libxmlj/dom/GnomeCDATASection.java,
* gnu/xml/libxmlj/dom/GnomeCharacterData.java,
* gnu/xml/libxmlj/dom/GnomeComment.java,
* gnu/xml/libxmlj/dom/GnomeDOMException.java,
* gnu/xml/libxmlj/dom/GnomeDOMStringList.java,
* gnu/xml/libxmlj/dom/GnomeDocument.java,
* gnu/xml/libxmlj/dom/GnomeDocumentBuilder.java,
* gnu/xml/libxmlj/dom/GnomeDocumentBuilderFactory.java,
* gnu/xml/libxmlj/dom/GnomeDocumentFragment.java,
* gnu/xml/libxmlj/dom/GnomeDocumentType.java,
* gnu/xml/libxmlj/dom/GnomeElement.java,
* gnu/xml/libxmlj/dom/GnomeEntity.java,
* gnu/xml/libxmlj/dom/GnomeEntityReference.java,
* gnu/xml/libxmlj/dom/GnomeNamedNodeMap.java,
* gnu/xml/libxmlj/dom/GnomeNode.java,
* gnu/xml/libxmlj/dom/GnomeNodeList.java,
* gnu/xml/libxmlj/dom/GnomeNotation.java,
* gnu/xml/libxmlj/dom/GnomeProcessingInstruction.java,
* gnu/xml/libxmlj/dom/GnomeText.java,
* gnu/xml/libxmlj/dom/GnomeTypeInfo.java,
* gnu/xml/libxmlj/dom/GnomeXPathExpression.java,
* gnu/xml/libxmlj/dom/GnomeXPathNSResolver.java,
* gnu/xml/libxmlj/dom/GnomeXPathNodeList.java,
* gnu/xml/libxmlj/dom/GnomeXPathResult.java,
* gnu/xml/libxmlj/sax/GnomeLocator.java,
* gnu/xml/libxmlj/sax/GnomeSAXParser.java,
* gnu/xml/libxmlj/sax/GnomeSAXParserFactory.java,
* gnu/xml/libxmlj/sax/GnomeXMLReader.java,
* gnu/xml/libxmlj/sax/Namespaces.java,
* gnu/xml/libxmlj/sax/StringArrayAttributes.java,
* gnu/xml/libxmlj/sax/XMLName.java,
* gnu/xml/libxmlj/transform/ErrorListenerErrorHandler.java,
* gnu/xml/libxmlj/transform/GnomeTransformer.java,
* gnu/xml/libxmlj/transform/GnomeTransformerFactory.java,
* gnu/xml/libxmlj/transform/URIResolverEntityResolver.java,
* gnu/xml/libxmlj/util/EmptyNodeList.java,
* gnu/xml/libxmlj/util/NamedInputStream.java,
* gnu/xml/libxmlj/util/StandaloneDocumentType.java,
* gnu/xml/libxmlj/util/StandaloneLocator.java,
* gnu/xml/libxmlj/util/XMLJ.java,
* gnu/xml/pipeline/CallFilter.java,
* gnu/xml/pipeline/DomConsumer.java,
* gnu/xml/pipeline/EventConsumer.java,
* gnu/xml/pipeline/EventFilter.java,
* gnu/xml/pipeline/LinkFilter.java,
* gnu/xml/pipeline/NSFilter.java,
* gnu/xml/pipeline/PipelineFactory.java,
* gnu/xml/pipeline/TeeConsumer.java,
* gnu/xml/pipeline/TextConsumer.java,
* gnu/xml/pipeline/ValidationConsumer.java,
* gnu/xml/pipeline/WellFormednessFilter.java,
* gnu/xml/pipeline/XIncludeFilter.java,
* gnu/xml/pipeline/XsltFilter.java,
* gnu/xml/stream/AttributeImpl.java,
* gnu/xml/stream/BufferedReader.java,
* gnu/xml/stream/CRLFReader.java,
* gnu/xml/stream/CharactersImpl.java,
* gnu/xml/stream/CommentImpl.java,
* gnu/xml/stream/DTDImpl.java,
* gnu/xml/stream/EndDocumentImpl.java,
* gnu/xml/stream/EndElementImpl.java,
* gnu/xml/stream/EntityDeclarationImpl.java,
* gnu/xml/stream/EntityReferenceImpl.java,
* gnu/xml/stream/FilteredEventReader.java,
* gnu/xml/stream/FilteredStreamReader.java,
* gnu/xml/stream/NamespaceImpl.java,
* gnu/xml/stream/NotationDeclarationImpl.java,
* gnu/xml/stream/ProcessingInstructionImpl.java,
* gnu/xml/stream/SAXParser.java,
* gnu/xml/stream/SAXParserFactory.java,
* gnu/xml/stream/StartDocumentImpl.java,
* gnu/xml/stream/StartElementImpl.java,
* gnu/xml/stream/UnicodeReader.java,
* gnu/xml/stream/XIncludeFilter.java,
* gnu/xml/stream/XMLEventAllocatorImpl.java,
* gnu/xml/stream/XMLEventFactoryImpl.java,
* gnu/xml/stream/XMLEventImpl.java,
* gnu/xml/stream/XMLEventReaderImpl.java,
* gnu/xml/stream/XMLEventWriterImpl.java,
* gnu/xml/stream/XMLInputFactoryImpl.java,
* gnu/xml/stream/XMLOutputFactoryImpl.java,
* gnu/xml/stream/XMLParser.java,
* gnu/xml/stream/XMLStreamWriterImpl.java,
* gnu/xml/transform/AbstractNumberNode.java,
* gnu/xml/transform/ApplyImportsNode.java,
* gnu/xml/transform/ApplyTemplatesNode.java,
* gnu/xml/transform/AttributeNode.java,
* gnu/xml/transform/AttributeSet.java,
* gnu/xml/transform/Bindings.java,
* gnu/xml/transform/CallTemplateNode.java,
* gnu/xml/transform/ChooseNode.java,
* gnu/xml/transform/CommentNode.java,
* gnu/xml/transform/CopyNode.java,
* gnu/xml/transform/CopyOfNode.java,
* gnu/xml/transform/CurrentFunction.java,
* gnu/xml/transform/DOMSourceLocator.java,
* gnu/xml/transform/DocumentFunction.java,
* gnu/xml/transform/ElementAvailableFunction.java,
* gnu/xml/transform/ElementNode.java,
* gnu/xml/transform/ErrorListenerErrorHandler.java,
* gnu/xml/transform/ForEachNode.java,
* gnu/xml/transform/FormatNumberFunction.java,
* gnu/xml/transform/FunctionAvailableFunction.java,
* gnu/xml/transform/GenerateIdFunction.java,
* gnu/xml/transform/IfNode.java,
* gnu/xml/transform/Key.java,
* gnu/xml/transform/KeyFunction.java,
* gnu/xml/transform/LiteralNode.java,
* gnu/xml/transform/MessageNode.java,
* gnu/xml/transform/NamespaceProxy.java,
* gnu/xml/transform/NodeNumberNode.java,
* gnu/xml/transform/NumberNode.java,
* gnu/xml/transform/OtherwiseNode.java,
* gnu/xml/transform/ParameterNode.java,
* gnu/xml/transform/ProcessingInstructionNode.java,
* gnu/xml/transform/SAXSerializer.java,
* gnu/xml/transform/SAXTemplatesHandler.java,
* gnu/xml/transform/SAXTransformerHandler.java,
* gnu/xml/transform/SortKey.java,
* gnu/xml/transform/StreamSerializer.java,
* gnu/xml/transform/StrippingInstruction.java,
* gnu/xml/transform/Stylesheet.java,
* gnu/xml/transform/SystemPropertyFunction.java,
* gnu/xml/transform/Template.java,
* gnu/xml/transform/TemplateNode.java,
* gnu/xml/transform/TemplatesImpl.java,
* gnu/xml/transform/TextNode.java,
* gnu/xml/transform/TransformerFactoryImpl.java,
* gnu/xml/transform/TransformerImpl.java,
* gnu/xml/transform/TransformerOutputProperties.java,
* gnu/xml/transform/URIResolverEntityResolver.java,
* gnu/xml/transform/UnparsedEntityUriFunction.java,
* gnu/xml/transform/ValueOfNode.java,
* gnu/xml/transform/WhenNode.java,
* gnu/xml/transform/WithParam.java,
* gnu/xml/transform/XSLComparator.java,
* gnu/xml/transform/XSLURIResolver.java,
* gnu/xml/util/DoParse.java,
* gnu/xml/util/DomParser.java,
* gnu/xml/util/Resolver.java,
* gnu/xml/util/SAXNullTransformerFactory.java,
* gnu/xml/util/XCat.java,
* gnu/xml/util/XHTMLWriter.java,
* gnu/xml/util/XMLWriter.java,
* gnu/xml/validation/datatype/Annotation.java,
* gnu/xml/validation/datatype/AnySimpleType.java,
* gnu/xml/validation/datatype/AnyType.java,
* gnu/xml/validation/datatype/AnyURIType.java,
* gnu/xml/validation/datatype/AtomicSimpleType.java,
* gnu/xml/validation/datatype/Base64BinaryType.java,
* gnu/xml/validation/datatype/BooleanType.java,
* gnu/xml/validation/datatype/ByteType.java,
* gnu/xml/validation/datatype/DateTimeType.java,
* gnu/xml/validation/datatype/DateType.java,
* gnu/xml/validation/datatype/DecimalType.java,
* gnu/xml/validation/datatype/DoubleType.java,
* gnu/xml/validation/datatype/DurationType.java,
* gnu/xml/validation/datatype/EntitiesType.java,
* gnu/xml/validation/datatype/EntityType.java,
* gnu/xml/validation/datatype/EnumerationFacet.java,
* gnu/xml/validation/datatype/Facet.java,
* gnu/xml/validation/datatype/FloatType.java,
* gnu/xml/validation/datatype/FractionDigitsFacet.java,
* gnu/xml/validation/datatype/GDayType.java,
* gnu/xml/validation/datatype/GMonthDayType.java,
* gnu/xml/validation/datatype/GMonthType.java,
* gnu/xml/validation/datatype/GYearMonthType.java,
* gnu/xml/validation/datatype/GYearType.java,
* gnu/xml/validation/datatype/HexBinaryType.java,
* gnu/xml/validation/datatype/IDRefType.java,
* gnu/xml/validation/datatype/IDRefsType.java,
* gnu/xml/validation/datatype/IDType.java,
* gnu/xml/validation/datatype/IntType.java,
* gnu/xml/validation/datatype/IntegerType.java,
* gnu/xml/validation/datatype/LanguageType.java,
* gnu/xml/validation/datatype/LengthFacet.java,
* gnu/xml/validation/datatype/ListSimpleType.java,
* gnu/xml/validation/datatype/LongType.java,
* gnu/xml/validation/datatype/MaxExclusiveFacet.java,
* gnu/xml/validation/datatype/MaxInclusiveFacet.java,
* gnu/xml/validation/datatype/MaxLengthFacet.java,
* gnu/xml/validation/datatype/MinExclusiveFacet.java,
* gnu/xml/validation/datatype/MinInclusiveFacet.java,
* gnu/xml/validation/datatype/MinLengthFacet.java,
* gnu/xml/validation/datatype/NCNameType.java,
* gnu/xml/validation/datatype/NMTokenType.java,
* gnu/xml/validation/datatype/NMTokensType.java,
* gnu/xml/validation/datatype/NameType.java,
* gnu/xml/validation/datatype/NegativeIntegerType.java,
* gnu/xml/validation/datatype/NonNegativeIntegerType.java,
* gnu/xml/validation/datatype/NonPositiveIntegerType.java,
* gnu/xml/validation/datatype/NormalizedStringType.java,
* gnu/xml/validation/datatype/NotationType.java,
* gnu/xml/validation/datatype/PatternFacet.java,
* gnu/xml/validation/datatype/PositiveIntegerType.java,
* gnu/xml/validation/datatype/QNameType.java,
* gnu/xml/validation/datatype/ShortType.java,
* gnu/xml/validation/datatype/SimpleType.java,
* gnu/xml/validation/datatype/StringType.java,
* gnu/xml/validation/datatype/TimeType.java,
* gnu/xml/validation/datatype/TokenType.java,
* gnu/xml/validation/datatype/TotalDigitsFacet.java,
* gnu/xml/validation/datatype/Type.java,
* gnu/xml/validation/datatype/TypeBuilder.java,
* gnu/xml/validation/datatype/TypeLibrary.java,
* gnu/xml/validation/datatype/TypeLibraryFactory.java,
* gnu/xml/validation/datatype/UnionSimpleType.java,
* gnu/xml/validation/datatype/UnsignedByteType.java,
* gnu/xml/validation/datatype/UnsignedIntType.java,
* gnu/xml/validation/datatype/UnsignedLongType.java,
* gnu/xml/validation/datatype/UnsignedShortType.java,
* gnu/xml/validation/datatype/WhiteSpaceFacet.java,
* gnu/xml/validation/relaxng/AnyNameNameClass.java,
* gnu/xml/validation/relaxng/AttributePattern.java,
* gnu/xml/validation/relaxng/ChoiceNameClass.java,
* gnu/xml/validation/relaxng/ChoicePattern.java,
* gnu/xml/validation/relaxng/DataPattern.java,
* gnu/xml/validation/relaxng/Define.java,
* gnu/xml/validation/relaxng/ElementPattern.java,
* gnu/xml/validation/relaxng/EmptyPattern.java,
* gnu/xml/validation/relaxng/FullSyntaxBuilder.java,
* gnu/xml/validation/relaxng/Grammar.java,
* gnu/xml/validation/relaxng/GrammarException.java,
* gnu/xml/validation/relaxng/GrammarValidator.java,
* gnu/xml/validation/relaxng/GroupPattern.java,
* gnu/xml/validation/relaxng/InterleavePattern.java,
* gnu/xml/validation/relaxng/ListPattern.java,
* gnu/xml/validation/relaxng/NSNameNameClass.java,
* gnu/xml/validation/relaxng/NameClass.java,
* gnu/xml/validation/relaxng/NameNameClass.java,
* gnu/xml/validation/relaxng/NotAllowedPattern.java,
* gnu/xml/validation/relaxng/OneOrMorePattern.java,
* gnu/xml/validation/relaxng/Param.java,
* gnu/xml/validation/relaxng/Pattern.java,
* gnu/xml/validation/relaxng/RELAXNGSchemaFactory.java,
* gnu/xml/validation/relaxng/RefPattern.java,
* gnu/xml/validation/relaxng/TextPattern.java,
* gnu/xml/validation/relaxng/ValuePattern.java,
* gnu/xml/validation/xmlschema/AnyAttribute.java,
* gnu/xml/validation/xmlschema/AttributeDeclaration.java,
* gnu/xml/validation/xmlschema/AttributeUse.java,
* gnu/xml/validation/xmlschema/ComplexType.java,
* gnu/xml/validation/xmlschema/ElementDeclaration.java,
* gnu/xml/validation/xmlschema/Particle.java,
* gnu/xml/validation/xmlschema/ValidationException.java,
* gnu/xml/validation/xmlschema/XMLSchema.java,
* gnu/xml/validation/xmlschema/XMLSchemaAttributeTypeInfo.java,
* gnu/xml/validation/xmlschema/XMLSchemaBuilder.java,
* gnu/xml/validation/xmlschema/XMLSchemaElementTypeInfo.java,
* gnu/xml/validation/xmlschema/XMLSchemaSchemaFactory.java,
* gnu/xml/validation/xmlschema/XMLSchemaTypeInfo.java,
* gnu/xml/validation/xmlschema/XMLSchemaTypeInfoProvider.java,
* gnu/xml/validation/xmlschema/XMLSchemaValidator.java,
* gnu/xml/validation/xmlschema/XMLSchemaValidatorHandler.java,
* gnu/xml/xpath/AndExpr.java,
* gnu/xml/xpath/ArithmeticExpr.java,
* gnu/xml/xpath/BooleanFunction.java,
* gnu/xml/xpath/CeilingFunction.java,
* gnu/xml/xpath/ConcatFunction.java,
* gnu/xml/xpath/Constant.java,
* gnu/xml/xpath/ContainsFunction.java,
* gnu/xml/xpath/CountFunction.java,
* gnu/xml/xpath/DocumentOrderComparator.java,
* gnu/xml/xpath/EqualityExpr.java,
* gnu/xml/xpath/Expr.java,
* gnu/xml/xpath/FalseFunction.java,
* gnu/xml/xpath/FloorFunction.java,
* gnu/xml/xpath/Function.java,
* gnu/xml/xpath/FunctionCall.java,
* gnu/xml/xpath/IdFunction.java,
* gnu/xml/xpath/LangFunction.java,
* gnu/xml/xpath/LastFunction.java,
* gnu/xml/xpath/LocalNameFunction.java,
* gnu/xml/xpath/NameFunction.java,
* gnu/xml/xpath/NameTest.java,
* gnu/xml/xpath/NamespaceTest.java,
* gnu/xml/xpath/NamespaceUriFunction.java,
* gnu/xml/xpath/NegativeExpr.java,
* gnu/xml/xpath/NodeTypeTest.java,
* gnu/xml/xpath/NormalizeSpaceFunction.java,
* gnu/xml/xpath/NotFunction.java,
* gnu/xml/xpath/NumberFunction.java,
* gnu/xml/xpath/OrExpr.java,
* gnu/xml/xpath/ParenthesizedExpr.java,
* gnu/xml/xpath/Path.java,
* gnu/xml/xpath/Pattern.java,
* gnu/xml/xpath/PositionFunction.java,
* gnu/xml/xpath/Predicate.java,
* gnu/xml/xpath/RelationalExpr.java,
* gnu/xml/xpath/Root.java,
* gnu/xml/xpath/RoundFunction.java,
* gnu/xml/xpath/Selector.java,
* gnu/xml/xpath/StartsWithFunction.java,
* gnu/xml/xpath/Steps.java,
* gnu/xml/xpath/StringFunction.java,
* gnu/xml/xpath/StringLengthFunction.java,
* gnu/xml/xpath/SubstringAfterFunction.java,
* gnu/xml/xpath/SubstringBeforeFunction.java,
* gnu/xml/xpath/SubstringFunction.java,
* gnu/xml/xpath/SumFunction.java,
* gnu/xml/xpath/Test.java,
* gnu/xml/xpath/TranslateFunction.java,
* gnu/xml/xpath/TrueFunction.java,
* gnu/xml/xpath/UnionExpr.java,
* gnu/xml/xpath/VariableReference.java,
* gnu/xml/xpath/XPathFactoryImpl.java,
* gnu/xml/xpath/XPathImpl.java,
* gnu/xml/xpath/XPathParser.java,
* gnu/xml/xpath/XPathTokenizer.java,
* java/applet/Applet.java,
* java/awt/AWTEvent.java,
* java/awt/AWTEventMulticaster.java,
* java/awt/AWTKeyStroke.java,
* java/awt/AlphaComposite.java,
* java/awt/BasicStroke.java,
* java/awt/BorderLayout.java,
* java/awt/BufferCapabilities.java,
* java/awt/Button.java,
* java/awt/Canvas.java,
* java/awt/CardLayout.java,
* java/awt/Checkbox.java,
* java/awt/CheckboxGroup.java,
* java/awt/CheckboxMenuItem.java,
* java/awt/Choice.java,
* java/awt/Color.java,
* java/awt/ColorPaintContext.java,
* java/awt/Component.java,
* java/awt/Container.java,
* java/awt/ContainerOrderFocusTraversalPolicy.java,
* java/awt/Cursor.java,
* java/awt/DefaultFocusTraversalPolicy.java,
* java/awt/DefaultKeyboardFocusManager.java,
* java/awt/Desktop.java,
* java/awt/Dialog.java,
* java/awt/DisplayMode.java,
* java/awt/Event.java,
* java/awt/EventDispatchThread.java,
* java/awt/EventQueue.java,
* java/awt/FileDialog.java,
* java/awt/FlowLayout.java,
* java/awt/FocusTraversalPolicy.java,
* java/awt/Font.java,
* java/awt/FontMetrics.java,
* java/awt/Frame.java,
* java/awt/GradientPaint.java,
* java/awt/Graphics.java,
* java/awt/Graphics2D.java,
* java/awt/GraphicsConfiguration.java,
* java/awt/GraphicsDevice.java,
* java/awt/GridBagConstraints.java,
* java/awt/GridBagLayout.java,
* java/awt/GridLayout.java,
* java/awt/Image.java,
* java/awt/Insets.java,
* java/awt/JobAttributes.java,
* java/awt/KeyboardFocusManager.java,
* java/awt/Label.java,
* java/awt/LightweightDispatcher.java,
* java/awt/List.java,
* java/awt/MediaTracker.java,
* java/awt/Menu.java,
* java/awt/MenuBar.java,
* java/awt/MenuComponent.java,
* java/awt/MenuItem.java,
* java/awt/MenuShortcut.java,
* java/awt/MouseInfo.java,
* java/awt/PageAttributes.java,
* java/awt/Point.java,
* java/awt/PointerInfo.java,
* java/awt/Polygon.java,
* java/awt/PopupMenu.java,
* java/awt/Rectangle.java,
* java/awt/RenderingHints.java,
* java/awt/Robot.java,
* java/awt/ScrollPane.java,
* java/awt/ScrollPaneAdjustable.java,
* java/awt/Scrollbar.java,
* java/awt/Shape.java,
* java/awt/SystemColor.java,
* java/awt/TextArea.java,
* java/awt/TextComponent.java,
* java/awt/TextField.java,
* java/awt/TexturePaint.java,
* java/awt/Toolkit.java,
* java/awt/Window.java,
* java/awt/color/ICC_ColorSpace.java,
* java/awt/color/ICC_Profile.java,
* java/awt/color/ICC_ProfileGray.java,
* java/awt/color/ICC_ProfileRGB.java,
* java/awt/datatransfer/Clipboard.java,
* java/awt/datatransfer/ClipboardOwner.java,
* java/awt/datatransfer/DataFlavor.java,
* java/awt/datatransfer/FlavorEvent.java,
* java/awt/datatransfer/FlavorListener.java,
* java/awt/datatransfer/MimeType.java,
* java/awt/datatransfer/StringSelection.java,
* java/awt/datatransfer/SystemFlavorMap.java,
* java/awt/datatransfer/Transferable.java,
* java/awt/datatransfer/UnsupportedFlavorException.java,
* java/awt/dnd/Autoscroll.java,
* java/awt/dnd/DnDEventMulticaster.java,
* java/awt/dnd/DragGestureEvent.java,
* java/awt/dnd/DragGestureRecognizer.java,
* java/awt/dnd/DragSource.java,
* java/awt/dnd/DragSourceContext.java,
* java/awt/dnd/DragSourceDropEvent.java,
* java/awt/dnd/DragSourceEvent.java,
* java/awt/dnd/DropTarget.java,
* java/awt/dnd/DropTargetContext.java,
* java/awt/dnd/DropTargetDragEvent.java,
* java/awt/dnd/DropTargetDropEvent.java,
* java/awt/dnd/DropTargetEvent.java,
* java/awt/dnd/MouseDragGestureRecognizer.java,
* java/awt/dnd/peer/DropTargetContextPeer.java,
* java/awt/event/AWTEventListener.java,
* java/awt/event/ActionEvent.java,
* java/awt/event/ComponentAdapter.java,
* java/awt/event/ComponentEvent.java,
* java/awt/event/InputEvent.java,
* java/awt/event/InputMethodEvent.java,
* java/awt/event/InvocationEvent.java,
* java/awt/event/KeyEvent.java,
* java/awt/event/MouseEvent.java,
* java/awt/event/MouseListener.java,
* java/awt/event/MouseWheelEvent.java,
* java/awt/event/WindowEvent.java,
* java/awt/font/FontRenderContext.java,
* java/awt/font/GlyphJustificationInfo.java,
* java/awt/font/GlyphMetrics.java,
* java/awt/font/GlyphVector.java,
* java/awt/font/GraphicAttribute.java,
* java/awt/font/ImageGraphicAttribute.java,
* java/awt/font/LineBreakMeasurer.java,
* java/awt/font/LineMetrics.java,
* java/awt/font/MultipleMaster.java,
* java/awt/font/OpenType.java,
* java/awt/font/ShapeGraphicAttribute.java,
* java/awt/font/TextAttribute.java,
* java/awt/font/TextHitInfo.java,
* java/awt/font/TextLayout.java,
* java/awt/font/TextMeasurer.java,
* java/awt/font/TransformAttribute.java,
* java/awt/geom/AffineTransform.java,
* java/awt/geom/Arc2D.java,
* java/awt/geom/Area.java,
* java/awt/geom/CubicCurve2D.java,
* java/awt/geom/Ellipse2D.java,
* java/awt/geom/FlatteningPathIterator.java,
* java/awt/geom/GeneralPath.java,
* java/awt/geom/Line2D.java,
* java/awt/geom/QuadCurve2D.java,
* java/awt/geom/RectangularShape.java,
* java/awt/geom/RoundRectangle2D.java,
* java/awt/im/InputContext.java,
* java/awt/im/spi/InputMethodDescriptor.java,
* java/awt/image/AffineTransformOp.java,
* java/awt/image/AreaAveragingScaleFilter.java,
* java/awt/image/BandCombineOp.java,
* java/awt/image/BandedSampleModel.java,
* java/awt/image/BufferedImage.java,
* java/awt/image/BufferedImageFilter.java,
* java/awt/image/BufferedImageOp.java,
* java/awt/image/ByteLookupTable.java,
* java/awt/image/ColorConvertOp.java,
* java/awt/image/ColorModel.java,
* java/awt/image/ComponentColorModel.java,
* java/awt/image/ComponentSampleModel.java,
* java/awt/image/ConvolveOp.java,
* java/awt/image/CropImageFilter.java,
* java/awt/image/DataBuffer.java,
* java/awt/image/DataBufferByte.java,
* java/awt/image/DataBufferDouble.java,
* java/awt/image/DataBufferFloat.java,
* java/awt/image/DataBufferInt.java,
* java/awt/image/DataBufferShort.java,
* java/awt/image/DataBufferUShort.java,
* java/awt/image/DirectColorModel.java,
* java/awt/image/FilteredImageSource.java,
* java/awt/image/ImageConsumer.java,
* java/awt/image/ImageFilter.java,
* java/awt/image/ImageObserver.java,
* java/awt/image/ImageProducer.java,
* java/awt/image/IndexColorModel.java,
* java/awt/image/Kernel.java,
* java/awt/image/LookupOp.java,
* java/awt/image/LookupTable.java,
* java/awt/image/MemoryImageSource.java,
* java/awt/image/MultiPixelPackedSampleModel.java,
* java/awt/image/PackedColorModel.java,
* java/awt/image/PixelGrabber.java,
* java/awt/image/PixelInterleavedSampleModel.java,
* java/awt/image/RGBImageFilter.java,
* java/awt/image/Raster.java,
* java/awt/image/RasterOp.java,
* java/awt/image/RenderedImage.java,
* java/awt/image/ReplicateScaleFilter.java,
* java/awt/image/RescaleOp.java,
* java/awt/image/SampleModel.java,
* java/awt/image/ShortLookupTable.java,
* java/awt/image/SinglePixelPackedSampleModel.java,
* java/awt/image/TileObserver.java,
* java/awt/image/WritableRaster.java,
* java/awt/image/WritableRenderedImage.java,
* java/awt/image/renderable/ContextualRenderedImageFactory.java,
* java/awt/image/renderable/ParameterBlock.java,
* java/awt/image/renderable/RenderContext.java,
* java/awt/image/renderable/RenderableImage.java,
* java/awt/image/renderable/RenderableImageOp.java,
* java/awt/image/renderable/RenderableImageProducer.java,
* java/awt/image/renderable/RenderedImageFactory.java,
* java/awt/peer/ButtonPeer.java,
* java/awt/peer/CanvasPeer.java,
* java/awt/peer/CheckboxMenuItemPeer.java,
* java/awt/peer/CheckboxPeer.java,
* java/awt/peer/ChoicePeer.java,
* java/awt/peer/ComponentPeer.java,
* java/awt/peer/ContainerPeer.java,
* java/awt/peer/DesktopPeer.java,
* java/awt/peer/DialogPeer.java,
* java/awt/peer/FileDialogPeer.java,
* java/awt/peer/FontPeer.java,
* java/awt/peer/FramePeer.java,
* java/awt/peer/LabelPeer.java,
* java/awt/peer/LightweightPeer.java,
* java/awt/peer/ListPeer.java,
* java/awt/peer/MenuBarPeer.java,
* java/awt/peer/MenuComponentPeer.java,
* java/awt/peer/MenuItemPeer.java,
* java/awt/peer/MenuPeer.java,
* java/awt/peer/MouseInfoPeer.java,
* java/awt/peer/PanelPeer.java,
* java/awt/peer/PopupMenuPeer.java,
* java/awt/peer/RobotPeer.java,
* java/awt/peer/ScrollPanePeer.java,
* java/awt/peer/ScrollbarPeer.java,
* java/awt/peer/TextComponentPeer.java,
* java/awt/peer/TextFieldPeer.java,
* java/awt/peer/WindowPeer.java,
* java/awt/print/Book.java,
* java/awt/print/PageFormat.java,
* java/awt/print/Pageable.java,
* java/awt/print/Paper.java,
* java/awt/print/PrinterGraphics.java,
* java/awt/print/PrinterIOException.java,
* java/awt/print/PrinterJob.java,
* java/beans/AppletInitializer.java,
* java/beans/BeanDescriptor.java,
* java/beans/BeanInfo.java,
* java/beans/Beans.java,
* java/beans/Customizer.java,
* java/beans/DefaultPersistenceDelegate.java,
* java/beans/DesignMode.java,
* java/beans/Encoder.java,
* java/beans/EventHandler.java,
* java/beans/EventSetDescriptor.java,
* java/beans/Expression.java,
* java/beans/FeatureDescriptor.java,
* java/beans/IndexedPropertyChangeEvent.java,
* java/beans/IndexedPropertyDescriptor.java,
* java/beans/Introspector.java,
* java/beans/MethodDescriptor.java,
* java/beans/ParameterDescriptor.java,
* java/beans/PersistenceDelegate.java,
* java/beans/PropertyChangeSupport.java,
* java/beans/PropertyDescriptor.java,
* java/beans/PropertyEditor.java,
* java/beans/PropertyEditorManager.java,
* java/beans/SimpleBeanInfo.java,
* java/beans/Statement.java,
* java/beans/VetoableChangeSupport.java,
* java/beans/Visibility.java,
* java/beans/XMLDecoder.java,
* java/beans/XMLEncoder.java,
* java/beans/beancontext/BeanContext.java,
* java/beans/beancontext/BeanContextChild.java,
* java/beans/beancontext/BeanContextChildComponentProxy.java,
* java/beans/beancontext/BeanContextChildSupport.java,
* java/beans/beancontext/BeanContextContainerProxy.java,
* java/beans/beancontext/BeanContextEvent.java,
* java/beans/beancontext/BeanContextMembershipEvent.java,
* java/beans/beancontext/BeanContextMembershipListener.java,
* java/beans/beancontext/BeanContextProxy.java,
* java/beans/beancontext/BeanContextServiceAvailableEvent.java,
* java/beans/beancontext/BeanContextServiceProvider.java,
* java/beans/beancontext/BeanContextServiceProviderBeanInfo.java,
* java/beans/beancontext/BeanContextServiceRevokedEvent.java,
* java/beans/beancontext/BeanContextServiceRevokedListener.java,
* java/beans/beancontext/BeanContextServices.java,
* java/beans/beancontext/BeanContextServicesListener.java,
* java/beans/beancontext/BeanContextServicesSupport.java,
* java/beans/beancontext/BeanContextSupport.java,
* java/io/BufferedInputStream.java,
* java/io/BufferedOutputStream.java,
* java/io/BufferedReader.java,
* java/io/BufferedWriter.java,
* java/io/ByteArrayInputStream.java,
* java/io/ByteArrayOutputStream.java,
* java/io/CharArrayReader.java,
* java/io/CharArrayWriter.java,
* java/io/DataInput.java,
* java/io/DataInputStream.java,
* java/io/DataOutput.java,
* java/io/DataOutputStream.java,
* java/io/DeleteFileHelper.java,
* java/io/EOFException.java,
* java/io/Externalizable.java,
* java/io/File.java,
* java/io/FileDescriptor.java,
* java/io/FileFilter.java,
* java/io/FileInputStream.java,
* java/io/FileOutputStream.java,
* java/io/FilePermission.java,
* java/io/FileReader.java,
* java/io/FileWriter.java,
* java/io/FilenameFilter.java,
* java/io/FilterInputStream.java,
* java/io/FilterOutputStream.java,
* java/io/FilterReader.java,
* java/io/FilterWriter.java,
* java/io/InputStream.java,
* java/io/InputStreamReader.java,
* java/io/InvalidClassException.java,
* java/io/LineNumberInputStream.java,
* java/io/LineNumberReader.java,
* java/io/ObjectInput.java,
* java/io/ObjectInputStream.java,
* java/io/ObjectInputValidation.java,
* java/io/ObjectOutput.java,
* java/io/ObjectOutputStream.java,
* java/io/ObjectStreamClass.java,
* java/io/ObjectStreamConstants.java,
* java/io/ObjectStreamField.java,
* java/io/OutputStream.java,
* java/io/OutputStreamWriter.java,
* java/io/PipedInputStream.java,
* java/io/PipedOutputStream.java,
* java/io/PipedReader.java,
* java/io/PipedWriter.java,
* java/io/PrintStream.java,
* java/io/PrintWriter.java,
* java/io/PushbackInputStream.java,
* java/io/PushbackReader.java,
* java/io/RandomAccessFile.java,
* java/io/Reader.java,
* java/io/SequenceInputStream.java,
* java/io/Serializable.java,
* java/io/SerializablePermission.java,
* java/io/StreamTokenizer.java,
* java/io/StringBufferInputStream.java,
* java/io/StringReader.java,
* java/io/StringWriter.java,
* java/io/UnsupportedEncodingException.java,
* java/io/Writer.java,
* java/lang/AbstractStringBuffer.java,
* java/lang/Boolean.java,
* java/lang/Character.java,
* java/lang/Class.java,
* java/lang/ClassLoader.java,
* java/lang/Comparable.java,
* java/lang/Double.java,
* java/lang/Enum.java,
* java/lang/EnumConstantNotPresentException.java,
* java/lang/Float.java,
* java/lang/IllegalArgumentException.java,
* java/lang/IllegalStateException.java,
* java/lang/IndexOutOfBoundsException.java,
* java/lang/Integer.java,
* java/lang/Long.java,
* java/lang/Math.java,
* java/lang/NoClassDefFoundError.java,
* java/lang/Object.java,
* java/lang/Package.java,
* java/lang/ProcessBuilder.java,
* java/lang/Runtime.java,
* java/lang/SecurityException.java,
* java/lang/SecurityManager.java,
* java/lang/StackTraceElement.java,
* java/lang/StrictMath.java,
* java/lang/String.java,
* java/lang/StringBuffer.java,
* java/lang/StringBuilder.java,
* java/lang/System.java,
* java/lang/Thread.java,
* java/lang/ThreadLocal.java,
* java/lang/Throwable.java,
* java/lang/TypeNotPresentException.java,
* java/lang/UnsupportedOperationException.java,
* java/lang/annotation/Annotation.java,
* java/lang/annotation/AnnotationTypeMismatchException.java,
* java/lang/annotation/IncompleteAnnotationException.java,
* java/lang/instrument/ClassFileTransformer.java,
* java/lang/instrument/Instrumentation.java,
* java/lang/management/ClassLoadingMXBean.java,
* java/lang/management/CompilationMXBean.java,
* java/lang/management/GarbageCollectorMXBean.java,
* java/lang/management/ManagementFactory.java,
* java/lang/management/ManagementPermission.java,
* java/lang/management/MemoryMXBean.java,
* java/lang/management/MemoryManagerMXBean.java,
* java/lang/management/MemoryNotificationInfo.java,
* java/lang/management/MemoryPoolMXBean.java,
* java/lang/management/MemoryType.java,
* java/lang/management/MemoryUsage.java,
* java/lang/management/MonitorInfo.java,
* java/lang/management/OperatingSystemMXBean.java,
* java/lang/management/RuntimeMXBean.java,
* java/lang/management/ThreadInfo.java,
* java/lang/management/ThreadMXBean.java,
* java/lang/ref/PhantomReference.java,
* java/lang/ref/Reference.java,
* java/lang/ref/ReferenceQueue.java,
* java/lang/ref/SoftReference.java,
* java/lang/ref/WeakReference.java,
* java/lang/reflect/AccessibleObject.java,
* java/lang/reflect/AnnotatedElement.java,
* java/lang/reflect/Array.java,
* java/lang/reflect/Constructor.java,
* java/lang/reflect/Field.java,
* java/lang/reflect/GenericArrayType.java,
* java/lang/reflect/GenericDeclaration.java,
* java/lang/reflect/InvocationHandler.java,
* java/lang/reflect/MalformedParameterizedTypeException.java,
* java/lang/reflect/Method.java,
* java/lang/reflect/Modifier.java,
* java/lang/reflect/Proxy.java,
* java/lang/reflect/Type.java,
* java/lang/reflect/TypeVariable.java,
* java/lang/reflect/WildcardType.java,
* java/math/BigDecimal.java,
* java/math/BigInteger.java,
* java/math/MathContext.java,
* java/math/RoundingMode.java,
* java/net/ContentHandler.java,
* java/net/DatagramSocket.java,
* java/net/DatagramSocketImpl.java,
* java/net/HttpURLConnection.java,
* java/net/Inet4Address.java,
* java/net/Inet6Address.java,
* java/net/InetAddress.java,
* java/net/InetSocketAddress.java,
* java/net/MimeTypeMapper.java,
* java/net/MulticastSocket.java,
* java/net/NetworkInterface.java,
* java/net/Proxy.java,
* java/net/ProxySelector.java,
* java/net/ResolverCache.java,
* java/net/ServerSocket.java,
* java/net/Socket.java,
* java/net/SocketPermission.java,
* java/net/URI.java,
* java/net/URL.java,
* java/net/URLClassLoader.java,
* java/net/URLConnection.java,
* java/net/URLDecoder.java,
* java/net/URLEncoder.java,
* java/net/URLStreamHandler.java,
* java/nio/Buffer.java,
* java/nio/BufferOverflowException.java,
* java/nio/BufferUnderflowException.java,
* java/nio/ByteBuffer.java,
* java/nio/ByteBufferHelper.java,
* java/nio/ByteBufferImpl.java,
* java/nio/ByteOrder.java,
* java/nio/CharBuffer.java,
* java/nio/CharBufferImpl.java,
* java/nio/CharSequenceBuffer.java,
* java/nio/CharViewBufferImpl.java,
* java/nio/DirectByteBufferImpl.java,
* java/nio/DoubleBuffer.java,
* java/nio/DoubleBufferImpl.java,
* java/nio/DoubleViewBufferImpl.java,
* java/nio/FloatBuffer.java,
* java/nio/FloatBufferImpl.java,
* java/nio/FloatViewBufferImpl.java,
* java/nio/IntBuffer.java,
* java/nio/IntBufferImpl.java,
* java/nio/IntViewBufferImpl.java,
* java/nio/InvalidMarkException.java,
* java/nio/LongBuffer.java,
* java/nio/LongBufferImpl.java,
* java/nio/LongViewBufferImpl.java,
* java/nio/MappedByteBuffer.java,
* java/nio/MappedByteBufferImpl.java,
* java/nio/ReadOnlyBufferException.java,
* java/nio/ShortBuffer.java,
* java/nio/ShortBufferImpl.java,
* java/nio/ShortViewBufferImpl.java,
* java/nio/channels/FileChannel.java,
* java/nio/channels/SocketChannel.java,
* java/nio/channels/spi/AbstractInterruptibleChannel.java,
* java/nio/channels/spi/AbstractSelectableChannel.java,
* java/nio/channels/spi/AbstractSelectionKey.java,
* java/nio/channels/spi/AbstractSelector.java,
* java/nio/channels/spi/SelectorProvider.java,
* java/nio/charset/CharacterCodingException.java,
* java/nio/charset/Charset.java,
* java/nio/charset/CharsetDecoder.java,
* java/nio/charset/CharsetEncoder.java,
* java/nio/charset/CoderMalfunctionError.java,
* java/nio/charset/CoderResult.java,
* java/nio/charset/CodingErrorAction.java,
* java/nio/charset/IllegalCharsetNameException.java,
* java/nio/charset/MalformedInputException.java,
* java/nio/charset/UnmappableCharacterException.java,
* java/nio/charset/UnsupportedCharsetException.java,
* java/rmi/AccessException.java,
* java/rmi/AlreadyBoundException.java,
* java/rmi/MarshalledObject.java,
* java/rmi/Naming.java,
* java/rmi/NoSuchObjectException.java,
* java/rmi/NotBoundException.java,
* java/rmi/RMISecurityException.java,
* java/rmi/RMISecurityManager.java,
* java/rmi/Remote.java,
* java/rmi/RemoteException.java,
* java/rmi/StubNotFoundException.java,
* java/rmi/UnknownHostException.java,
* java/rmi/activation/Activatable.java,
* java/rmi/activation/ActivationDesc.java,
* java/rmi/activation/ActivationGroup.java,
* java/rmi/activation/ActivationGroupDesc.java,
* java/rmi/activation/ActivationGroupID.java,
* java/rmi/activation/ActivationID.java,
* java/rmi/activation/ActivationInstantiator.java,
* java/rmi/activation/ActivationMonitor.java,
* java/rmi/activation/ActivationSystem.java,
* java/rmi/activation/Activator.java,
* java/rmi/activation/UnknownGroupException.java,
* java/rmi/dgc/DGC.java,
* java/rmi/dgc/Lease.java,
* java/rmi/dgc/VMID.java,
* java/rmi/registry/LocateRegistry.java,
* java/rmi/registry/Registry.java,
* java/rmi/registry/RegistryHandler.java,
* java/rmi/server/LoaderHandler.java,
* java/rmi/server/LogStream.java,
* java/rmi/server/ObjID.java,
* java/rmi/server/Operation.java,
* java/rmi/server/RMIClassLoader.java,
* java/rmi/server/RMIClientSocketFactory.java,
* java/rmi/server/RMIFailureHandler.java,
* java/rmi/server/RMIServerSocketFactory.java,
* java/rmi/server/RMISocketFactory.java,
* java/rmi/server/RemoteCall.java,
* java/rmi/server/RemoteObject.java,
* java/rmi/server/RemoteObjectInvocationHandler.java,
* java/rmi/server/RemoteRef.java,
* java/rmi/server/RemoteServer.java,
* java/rmi/server/RemoteStub.java,
* java/rmi/server/ServerRef.java,
* java/rmi/server/Skeleton.java,
* java/rmi/server/UID.java,
* java/rmi/server/UnicastRemoteObject.java,
* java/rmi/server/Unreferenced.java,
* java/security/AccessControlContext.java,
* java/security/AccessController.java,
* java/security/AlgorithmParameterGenerator.java,
* java/security/AlgorithmParameterGeneratorSpi.java,
* java/security/AlgorithmParameters.java,
* java/security/AlgorithmParametersSpi.java,
* java/security/CodeSource.java,
* java/security/DigestInputStream.java,
* java/security/DigestOutputStream.java,
* java/security/GeneralSecurityException.java,
* java/security/Identity.java,
* java/security/IdentityScope.java,
* java/security/KeyFactory.java,
* java/security/KeyFactorySpi.java,
* java/security/KeyPairGenerator.java,
* java/security/KeyPairGeneratorSpi.java,
* java/security/KeyStore.java,
* java/security/KeyStoreSpi.java,
* java/security/MessageDigest.java,
* java/security/MessageDigestSpi.java,
* java/security/Permission.java,
* java/security/Permissions.java,
* java/security/Policy.java,
* java/security/ProtectionDomain.java,
* java/security/Provider.java,
* java/security/ProviderException.java,
* java/security/SecureClassLoader.java,
* java/security/SecureRandom.java,
* java/security/SecureRandomSpi.java,
* java/security/Security.java,
* java/security/Signature.java,
* java/security/SignatureSpi.java,
* java/security/SignedObject.java,
* java/security/Signer.java,
* java/security/acl/Acl.java,
* java/security/acl/AclEntry.java,
* java/security/acl/Group.java,
* java/security/acl/Owner.java,
* java/security/cert/CRL.java,
* java/security/cert/CRLSelector.java,
* java/security/cert/CertPathBuilder.java,
* java/security/cert/CertPathBuilderResult.java,
* java/security/cert/CertPathValidator.java,
* java/security/cert/CertPathValidatorResult.java,
* java/security/cert/CertPathValidatorSpi.java,
* java/security/cert/CertSelector.java,
* java/security/cert/CertStore.java,
* java/security/cert/CertStoreParameters.java,
* java/security/cert/CertStoreSpi.java,
* java/security/cert/Certificate.java,
* java/security/cert/CertificateFactory.java,
* java/security/cert/CertificateFactorySpi.java,
* java/security/cert/CollectionCertStoreParameters.java,
* java/security/cert/LDAPCertStoreParameters.java,
* java/security/cert/PKIXBuilderParameters.java,
* java/security/cert/PKIXCertPathBuilderResult.java,
* java/security/cert/PKIXCertPathChecker.java,
* java/security/cert/PKIXCertPathValidatorResult.java,
* java/security/cert/PKIXParameters.java,
* java/security/cert/PolicyNode.java,
* java/security/cert/PolicyQualifierInfo.java,
* java/security/cert/X509CRL.java,
* java/security/cert/X509CRLEntry.java,
* java/security/cert/X509CertSelector.java,
* java/security/cert/X509Certificate.java,
* java/security/cert/X509Extension.java,
* java/security/spec/AlgorithmParameterSpec.java,
* java/security/spec/DSAParameterSpec.java,
* java/security/spec/DSAPrivateKeySpec.java,
* java/security/spec/DSAPublicKeySpec.java,
* java/security/spec/EncodedKeySpec.java,
* java/security/spec/InvalidParameterSpecException.java,
* java/security/spec/KeySpec.java,
* java/security/spec/PKCS8EncodedKeySpec.java,
* java/security/spec/PSSParameterSpec.java,
* java/security/spec/RSAKeyGenParameterSpec.java,
* java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java,
* java/security/spec/RSAOtherPrimeInfo.java,
* java/security/spec/RSAPrivateCrtKeySpec.java,
* java/security/spec/RSAPrivateKeySpec.java,
* java/security/spec/RSAPublicKeySpec.java,
* java/security/spec/X509EncodedKeySpec.java,
* java/sql/Array.java,
* java/sql/BatchUpdateException.java,
* java/sql/Blob.java,
* java/sql/CallableStatement.java,
* java/sql/Clob.java,
* java/sql/Connection.java,
* java/sql/DataTruncation.java,
* java/sql/DatabaseMetaData.java,
* java/sql/Date.java,
* java/sql/Driver.java,
* java/sql/DriverManager.java,
* java/sql/DriverPropertyInfo.java,
* java/sql/ParameterMetaData.java,
* java/sql/PreparedStatement.java,
* java/sql/Ref.java,
* java/sql/ResultSet.java,
* java/sql/ResultSetMetaData.java,
* java/sql/SQLData.java,
* java/sql/SQLException.java,
* java/sql/SQLInput.java,
* java/sql/SQLOutput.java,
* java/sql/SQLPermission.java,
* java/sql/SQLWarning.java,
* java/sql/Savepoint.java,
* java/sql/Statement.java,
* java/sql/Struct.java,
* java/sql/Time.java,
* java/sql/Timestamp.java,
* java/sql/Types.java,
* java/text/Annotation.java,
* java/text/AttributedCharacterIterator.java,
* java/text/AttributedString.java,
* java/text/AttributedStringIterator.java,
* java/text/Bidi.java,
* java/text/BreakIterator.java,
* java/text/CharacterIterator.java,
* java/text/ChoiceFormat.java,
* java/text/CollationElementIterator.java,
* java/text/CollationKey.java,
* java/text/Collator.java,
* java/text/DateFormat.java,
* java/text/DateFormatSymbols.java,
* java/text/DecimalFormat.java,
* java/text/DecimalFormatSymbols.java,
* java/text/FieldPosition.java,
* java/text/Format.java,
* java/text/MessageFormat.java,
* java/text/NumberFormat.java,
* java/text/ParsePosition.java,
* java/text/RuleBasedCollator.java,
* java/text/SimpleDateFormat.java,
* java/text/StringCharacterIterator.java,
* java/text/spi/DateFormatProvider.java,
* java/text/spi/NumberFormatProvider.java,
* java/util/AbstractCollection.java,
* java/util/AbstractList.java,
* java/util/AbstractMap.java,
* java/util/AbstractSet.java,
* java/util/ArrayList.java,
* java/util/Arrays.java,
* java/util/BitSet.java,
* java/util/Calendar.java,
* java/util/Collections.java,
* java/util/Currency.java,
* java/util/Date.java,
* java/util/Dictionary.java,
* java/util/DuplicateFormatFlagsException.java,
* java/util/EnumMap.java,
* java/util/EnumSet.java,
* java/util/FormatFlagsConversionMismatchException.java,
* java/util/Formattable.java,
* java/util/FormattableFlags.java,
* java/util/Formatter.java,
* java/util/FormatterClosedException.java,
* java/util/GregorianCalendar.java,
* java/util/HashMap.java,
* java/util/Hashtable.java,
* java/util/IdentityHashMap.java,
* java/util/IllegalFormatCodePointException.java,
* java/util/IllegalFormatConversionException.java,
* java/util/IllegalFormatException.java,
* java/util/IllegalFormatFlagsException.java,
* java/util/IllegalFormatPrecisionException.java,
* java/util/IllegalFormatWidthException.java,
* java/util/InputMismatchException.java,
* java/util/LinkedHashMap.java,
* java/util/LinkedHashSet.java,
* java/util/LinkedList.java,
* java/util/List.java,
* java/util/Locale.java,
* java/util/Map.java,
* java/util/MissingFormatArgumentException.java,
* java/util/MissingFormatWidthException.java,
* java/util/PriorityQueue.java,
* java/util/Properties.java,
* java/util/PropertyPermission.java,
* java/util/PropertyPermissionCollection.java,
* java/util/Random.java,
* java/util/ResourceBundle.java,
* java/util/ServiceConfigurationError.java,
* java/util/ServiceLoader.java,
* java/util/SimpleTimeZone.java,
* java/util/StringTokenizer.java,
* java/util/TimeZone.java,
* java/util/Timer.java,
* java/util/TreeMap.java,
* java/util/TreeSet.java,
* java/util/UUID.java,
* java/util/UnknownFormatConversionException.java,
* java/util/UnknownFormatFlagsException.java,
* java/util/Vector.java,
* java/util/WeakHashMap.java,
* java/util/concurrent/CopyOnWriteArrayList.java,
* java/util/jar/Attributes.java,
* java/util/jar/JarEntry.java,
* java/util/jar/JarFile.java,
* java/util/jar/JarInputStream.java,
* java/util/jar/JarOutputStream.java,
* java/util/jar/Manifest.java,
* java/util/logging/ConsoleHandler.java,
* java/util/logging/ErrorManager.java,
* java/util/logging/FileHandler.java,
* java/util/logging/Formatter.java,
* java/util/logging/Handler.java,
* java/util/logging/Level.java,
* java/util/logging/LogManager.java,
* java/util/logging/LogRecord.java,
* java/util/logging/Logger.java,
* java/util/logging/LoggingMXBean.java,
* java/util/logging/LoggingPermission.java,
* java/util/logging/MemoryHandler.java,
* java/util/logging/SocketHandler.java,
* java/util/logging/StreamHandler.java,
* java/util/logging/XMLFormatter.java,
* java/util/prefs/AbstractPreferences.java,
* java/util/prefs/NodeChangeEvent.java,
* java/util/prefs/NodeChangeListener.java,
* java/util/prefs/PreferenceChangeEvent.java,
* java/util/prefs/PreferenceChangeListener.java,
* java/util/prefs/Preferences.java,
* java/util/prefs/PreferencesFactory.java,
* java/util/regex/MatchResult.java,
* java/util/regex/Pattern.java,
* java/util/regex/PatternSyntaxException.java,
* java/util/spi/LocaleNameProvider.java,
* java/util/spi/TimeZoneNameProvider.java,
* java/util/zip/Adler32.java,
* java/util/zip/CRC32.java,
* java/util/zip/CheckedInputStream.java,
* java/util/zip/CheckedOutputStream.java,
* java/util/zip/Deflater.java,
* java/util/zip/DeflaterEngine.java,
* java/util/zip/DeflaterHuffman.java,
* java/util/zip/DeflaterOutputStream.java,
* java/util/zip/DeflaterPending.java,
* java/util/zip/GZIPInputStream.java,
* java/util/zip/GZIPOutputStream.java,
* java/util/zip/Inflater.java,
* java/util/zip/InflaterDynHeader.java,
* java/util/zip/InflaterHuffmanTree.java,
* java/util/zip/InflaterInputStream.java,
* java/util/zip/OutputWindow.java,
* java/util/zip/PendingBuffer.java,
* java/util/zip/StreamManipulator.java,
* java/util/zip/ZipConstants.java,
* java/util/zip/ZipEntry.java,
* java/util/zip/ZipFile.java,
* java/util/zip/ZipInputStream.java,
* java/util/zip/ZipOutputStream.java,
* javax/accessibility/AccessibleExtendedText.java,
* javax/accessibility/AccessibleRelation.java,
* javax/accessibility/AccessibleRole.java,
* javax/accessibility/AccessibleState.java,
* javax/activation/ActivationDataFlavor.java,
* javax/activation/CommandInfo.java,
* javax/activation/CommandMap.java,
* javax/activation/CommandObject.java,
* javax/activation/DataContentHandler.java,
* javax/activation/DataContentHandlerFactory.java,
* javax/activation/DataHandler.java,
* javax/activation/DataHandlerDataSource.java,
* javax/activation/DataSource.java,
* javax/activation/DataSourceDataContentHandler.java,
* javax/activation/FileDataSource.java,
* javax/activation/FileTypeMap.java,
* javax/activation/MailcapCommandMap.java,
* javax/activation/MimeType.java,
* javax/activation/MimeTypeParameterList.java,
* javax/activation/MimeTypeParseException.java,
* javax/activation/MimetypesFileTypeMap.java,
* javax/activation/ObjectDataContentHandler.java,
* javax/activation/URLDataSource.java,
* javax/activation/UnsupportedDataTypeException.java,
* javax/crypto/Cipher.java,
* javax/crypto/CipherOutputStream.java,
* javax/crypto/ExemptionMechanism.java,
* javax/crypto/KeyAgreement.java,
* javax/crypto/KeyGenerator.java,
* javax/crypto/Mac.java,
* javax/crypto/MacSpi.java,
* javax/crypto/SecretKeyFactory.java,
* javax/crypto/spec/PBEKeySpec.java,
* javax/imageio/IIOImage.java,
* javax/imageio/IIOParam.java,
* javax/imageio/IIOParamController.java,
* javax/imageio/ImageIO.java,
* javax/imageio/ImageReadParam.java,
* javax/imageio/ImageReader.java,
* javax/imageio/ImageTranscoder.java,
* javax/imageio/ImageTypeSpecifier.java,
* javax/imageio/ImageWriteParam.java,
* javax/imageio/ImageWriter.java,
* javax/imageio/event/IIOReadProgressListener.java,
* javax/imageio/event/IIOReadUpdateListener.java,
* javax/imageio/event/IIOWriteProgressListener.java,
* javax/imageio/metadata/IIOInvalidTreeException.java,
* javax/imageio/metadata/IIOMetadata.java,
* javax/imageio/metadata/IIOMetadataFormatImpl.java,
* javax/imageio/metadata/IIOMetadataNode.java,
* javax/imageio/plugins/bmp/BMPImageWriteParam.java,
* javax/imageio/plugins/jpeg/JPEGHuffmanTable.java,
* javax/imageio/spi/IIORegistry.java,
* javax/imageio/spi/ImageReaderSpi.java,
* javax/imageio/spi/ImageWriterSpi.java,
* javax/imageio/spi/RegisterableService.java,
* javax/imageio/spi/ServiceRegistry.java,
* javax/imageio/stream/FileCacheImageInputStream.java,
* javax/imageio/stream/FileCacheImageOutputStream.java,
* javax/imageio/stream/FileImageInputStream.java,
* javax/imageio/stream/FileImageOutputStream.java,
* javax/imageio/stream/ImageInputStream.java,
* javax/imageio/stream/ImageInputStreamImpl.java,
* javax/imageio/stream/ImageOutputStreamImpl.java,
* javax/imageio/stream/MemoryCacheImageInputStream.java,
* javax/imageio/stream/MemoryCacheImageOutputStream.java,
* javax/management/Attribute.java,
* javax/management/AttributeChangeNotification.java,
* javax/management/AttributeChangeNotificationFilter.java,
* javax/management/AttributeList.java,
* javax/management/AttributeNotFoundException.java,
* javax/management/AttributeValueExp.java,
* javax/management/BadAttributeValueExpException.java,
* javax/management/BadBinaryOpValueExpException.java,
* javax/management/BadStringOperationException.java,
* javax/management/DefaultLoaderRepository.java,
* javax/management/Descriptor.java,
* javax/management/DynamicMBean.java,
* javax/management/InstanceAlreadyExistsException.java,
* javax/management/InstanceNotFoundException.java,
* javax/management/IntrospectionException.java,
* javax/management/InvalidApplicationException.java,
* javax/management/InvalidAttributeValueException.java,
* javax/management/JMException.java,
* javax/management/JMRuntimeException.java,
* javax/management/JMX.java,
* javax/management/ListenerNotFoundException.java,
* javax/management/MBeanAttributeInfo.java,
* javax/management/MBeanConstructorInfo.java,
* javax/management/MBeanException.java,
* javax/management/MBeanFeatureInfo.java,
* javax/management/MBeanInfo.java,
* javax/management/MBeanNotificationInfo.java,
* javax/management/MBeanOperationInfo.java,
* javax/management/MBeanParameterInfo.java,
* javax/management/MBeanPermission.java,
* javax/management/MBeanRegistrationException.java,
* javax/management/MBeanServer.java,
* javax/management/MBeanServerBuilder.java,
* javax/management/MBeanServerConnection.java,
* javax/management/MBeanServerDelegate.java,
* javax/management/MBeanServerFactory.java,
* javax/management/MBeanServerInvocationHandler.java,
* javax/management/MBeanServerNotification.java,
* javax/management/MBeanServerPermission.java,
* javax/management/MBeanTrustPermission.java,
* javax/management/MalformedObjectNameException.java,
* javax/management/NotCompliantMBeanException.java,
* javax/management/Notification.java,
* javax/management/NotificationBroadcaster.java,
* javax/management/NotificationBroadcasterSupport.java,
* javax/management/NotificationEmitter.java,
* javax/management/NotificationFilter.java,
* javax/management/NotificationFilterSupport.java,
* javax/management/NotificationListener.java,
* javax/management/ObjectInstance.java,
* javax/management/ObjectName.java,
* javax/management/OperationsException.java,
* javax/management/PersistentMBean.java,
* javax/management/Query.java,
* javax/management/QueryEval.java,
* javax/management/QueryExp.java,
* javax/management/ReflectionException.java,
* javax/management/RuntimeErrorException.java,
* javax/management/RuntimeMBeanException.java,
* javax/management/RuntimeOperationsException.java,
* javax/management/ServiceNotFoundException.java,
* javax/management/StandardMBean.java,
* javax/management/StringValueExp.java,
* javax/management/ValueExp.java,
* javax/management/loading/ClassLoaderRepository.java,
* javax/management/openmbean/ArrayType.java,
* javax/management/openmbean/CompositeData.java,
* javax/management/openmbean/CompositeDataInvocationHandler.java,
* javax/management/openmbean/CompositeDataSupport.java,
* javax/management/openmbean/CompositeType.java,
* javax/management/openmbean/InvalidKeyException.java,
* javax/management/openmbean/InvalidOpenTypeException.java,
* javax/management/openmbean/KeyAlreadyExistsException.java,
* javax/management/openmbean/OpenDataException.java,
* javax/management/openmbean/OpenMBeanAttributeInfo.java,
* javax/management/openmbean/OpenMBeanAttributeInfoSupport.java,
* javax/management/openmbean/OpenMBeanConstructorInfo.java,
* javax/management/openmbean/OpenMBeanConstructorInfoSupport.java,
* javax/management/openmbean/OpenMBeanInfo.java,
* javax/management/openmbean/OpenMBeanInfoSupport.java,
* javax/management/openmbean/OpenMBeanOperationInfo.java,
* javax/management/openmbean/OpenMBeanOperationInfoSupport.java,
* javax/management/openmbean/OpenMBeanParameterInfo.java,
* javax/management/openmbean/OpenMBeanParameterInfoSupport.java,
* javax/management/openmbean/OpenType.java,
* javax/management/openmbean/SimpleType.java,
* javax/management/openmbean/TabularData.java,
* javax/management/openmbean/TabularDataSupport.java,
* javax/management/openmbean/TabularType.java,
* javax/management/remote/NotificationResult.java,
* javax/management/remote/TargetedNotification.java,
* javax/management/remote/rmi/RMIConnection.java,
* javax/naming/AuthenticationException.java,
* javax/naming/AuthenticationNotSupportedException.java,
* javax/naming/BinaryRefAddr.java,
* javax/naming/Binding.java,
* javax/naming/CannotProceedException.java,
* javax/naming/CommunicationException.java,
* javax/naming/CompositeName.java,
* javax/naming/CompoundName.java,
* javax/naming/ConfigurationException.java,
* javax/naming/Context.java,
* javax/naming/ContextNotEmptyException.java,
* javax/naming/InitialContext.java,
* javax/naming/InsufficientResourcesException.java,
* javax/naming/InterruptedNamingException.java,
* javax/naming/InvalidNameException.java,
* javax/naming/LimitExceededException.java,
* javax/naming/LinkException.java,
* javax/naming/LinkLoopException.java,
* javax/naming/MalformedLinkException.java,
* javax/naming/Name.java,
* javax/naming/NameAlreadyBoundException.java,
* javax/naming/NameClassPair.java,
* javax/naming/NameNotFoundException.java,
* javax/naming/NameParser.java,
* javax/naming/NamingEnumeration.java,
* javax/naming/NamingException.java,
* javax/naming/NamingSecurityException.java,
* javax/naming/NoInitialContextException.java,
* javax/naming/NoPermissionException.java,
* javax/naming/NotContextException.java,
* javax/naming/PartialResultException.java,
* javax/naming/RefAddr.java,
* javax/naming/Reference.java,
* javax/naming/Referenceable.java,
* javax/naming/ReferralException.java,
* javax/naming/ServiceUnavailableException.java,
* javax/naming/SizeLimitExceededException.java,
* javax/naming/StringRefAddr.java,
* javax/naming/TimeLimitExceededException.java,
* javax/naming/directory/AttributeInUseException.java,
* javax/naming/directory/Attributes.java,
* javax/naming/directory/BasicAttribute.java,
* javax/naming/directory/BasicAttributes.java,
* javax/naming/directory/InitialDirContext.java,
* javax/naming/directory/ModificationItem.java,
* javax/naming/directory/SearchControls.java,
* javax/naming/directory/SearchResult.java,
* javax/naming/event/EventContext.java,
* javax/naming/event/NamespaceChangeListener.java,
* javax/naming/event/NamingEvent.java,
* javax/naming/event/NamingExceptionEvent.java,
* javax/naming/event/NamingListener.java,
* javax/naming/event/ObjectChangeListener.java,
* javax/naming/ldap/Control.java,
* javax/naming/ldap/ControlFactory.java,
* javax/naming/ldap/ExtendedRequest.java,
* javax/naming/ldap/ExtendedResponse.java,
* javax/naming/ldap/HasControls.java,
* javax/naming/ldap/InitialLdapContext.java,
* javax/naming/ldap/LdapContext.java,
* javax/naming/ldap/LdapReferralException.java,
* javax/naming/ldap/StartTlsRequest.java,
* javax/naming/ldap/UnsolicitedNotification.java,
* javax/naming/ldap/UnsolicitedNotificationEvent.java,
* javax/naming/ldap/UnsolicitedNotificationListener.java,
* javax/naming/spi/DirObjectFactory.java,
* javax/naming/spi/DirStateFactory.java,
* javax/naming/spi/DirectoryManager.java,
* javax/naming/spi/InitialContextFactory.java,
* javax/naming/spi/InitialContextFactoryBuilder.java,
* javax/naming/spi/NamingManager.java,
* javax/naming/spi/ObjectFactory.java,
* javax/naming/spi/ObjectFactoryBuilder.java,
* javax/naming/spi/ResolveResult.java,
* javax/naming/spi/Resolver.java,
* javax/naming/spi/StateFactory.java,
* javax/net/ssl/CertPathTrustManagerParameters.java,
* javax/net/ssl/KeyManagerFactory.java,
* javax/net/ssl/KeyStoreBuilderParameters.java,
* javax/net/ssl/SSLContext.java,
* javax/net/ssl/SSLEngine.java,
* javax/net/ssl/SSLEngineResult.java,
* javax/net/ssl/SSLException.java,
* javax/net/ssl/TrustManagerFactory.java,
* javax/net/ssl/X509ExtendedKeyManager.java,
* javax/print/AttributeException.java,
* javax/print/CancelablePrintJob.java,
* javax/print/Doc.java,
* javax/print/DocFlavor.java,
* javax/print/DocPrintJob.java,
* javax/print/FlavorException.java,
* javax/print/MultiDoc.java,
* javax/print/MultiDocPrintJob.java,
* javax/print/MultiDocPrintService.java,
* javax/print/PrintException.java,
* javax/print/PrintService.java,
* javax/print/PrintServiceLookup.java,
* javax/print/ServiceUI.java,
* javax/print/ServiceUIFactory.java,
* javax/print/SimpleDoc.java,
* javax/print/StreamPrintService.java,
* javax/print/StreamPrintServiceFactory.java,
* javax/print/URIException.java,
* javax/print/attribute/Attribute.java,
* javax/print/attribute/AttributeSet.java,
* javax/print/attribute/AttributeSetUtilities.java,
* javax/print/attribute/DateTimeSyntax.java,
* javax/print/attribute/DocAttribute.java,
* javax/print/attribute/DocAttributeSet.java,
* javax/print/attribute/EnumSyntax.java,
* javax/print/attribute/HashAttributeSet.java,
* javax/print/attribute/HashDocAttributeSet.java,
* javax/print/attribute/HashPrintJobAttributeSet.java,
* javax/print/attribute/HashPrintRequestAttributeSet.java,
* javax/print/attribute/HashPrintServiceAttributeSet.java,
* javax/print/attribute/IntegerSyntax.java,
* javax/print/attribute/PrintJobAttribute.java,
* javax/print/attribute/PrintJobAttributeSet.java,
* javax/print/attribute/PrintRequestAttribute.java,
* javax/print/attribute/PrintRequestAttributeSet.java,
* javax/print/attribute/PrintServiceAttribute.java,
* javax/print/attribute/PrintServiceAttributeSet.java,
* javax/print/attribute/ResolutionSyntax.java,
* javax/print/attribute/SetOfIntegerSyntax.java,
* javax/print/attribute/Size2DSyntax.java,
* javax/print/attribute/SupportedValuesAttribute.java,
* javax/print/attribute/TextSyntax.java,
* javax/print/attribute/URISyntax.java,
* javax/print/attribute/UnmodifiableSetException.java,
* javax/print/attribute/standard/Chromaticity.java,
* javax/print/attribute/standard/ColorSupported.java,
* javax/print/attribute/standard/Compression.java,
* javax/print/attribute/standard/Copies.java,
* javax/print/attribute/standard/CopiesSupported.java,
* javax/print/attribute/standard/DateTimeAtCompleted.java,
* javax/print/attribute/standard/DateTimeAtCreation.java,
* javax/print/attribute/standard/DateTimeAtProcessing.java,
* javax/print/attribute/standard/Destination.java,
* javax/print/attribute/standard/DocumentName.java,
* javax/print/attribute/standard/Fidelity.java,
* javax/print/attribute/standard/Finishings.java,
* javax/print/attribute/standard/JobHoldUntil.java,
* javax/print/attribute/standard/JobImpressions.java,
* javax/print/attribute/standard/JobImpressionsCompleted.java,
* javax/print/attribute/standard/JobImpressionsSupported.java,
* javax/print/attribute/standard/JobKOctets.java,
* javax/print/attribute/standard/JobKOctetsProcessed.java,
* javax/print/attribute/standard/JobKOctetsSupported.java,
* javax/print/attribute/standard/JobMediaSheets.java,
* javax/print/attribute/standard/JobMediaSheetsCompleted.java,
* javax/print/attribute/standard/JobMediaSheetsSupported.java,
* javax/print/attribute/standard/JobMessageFromOperator.java,
* javax/print/attribute/standard/JobName.java,
* javax/print/attribute/standard/JobOriginatingUserName.java,
* javax/print/attribute/standard/JobPriority.java,
* javax/print/attribute/standard/JobPrioritySupported.java,
* javax/print/attribute/standard/JobSheets.java,
* javax/print/attribute/standard/JobState.java,
* javax/print/attribute/standard/JobStateReason.java,
* javax/print/attribute/standard/JobStateReasons.java,
* javax/print/attribute/standard/Media.java,
* javax/print/attribute/standard/MediaName.java,
* javax/print/attribute/standard/MediaPrintableArea.java,
* javax/print/attribute/standard/MediaSize.java,
* javax/print/attribute/standard/MediaSizeName.java,
* javax/print/attribute/standard/MediaTray.java,
* javax/print/attribute/standard/MultipleDocumentHandling.java,
* javax/print/attribute/standard/NumberOfDocuments.java,
* javax/print/attribute/standard/NumberOfInterveningJobs.java,
* javax/print/attribute/standard/NumberUp.java,
* javax/print/attribute/standard/NumberUpSupported.java,
* javax/print/attribute/standard/OrientationRequested.java,
* javax/print/attribute/standard/OutputDeviceAssigned.java,
* javax/print/attribute/standard/PDLOverrideSupported.java,
* javax/print/attribute/standard/PageRanges.java,
* javax/print/attribute/standard/PagesPerMinute.java,
* javax/print/attribute/standard/PagesPerMinuteColor.java,
* javax/print/attribute/standard/PresentationDirection.java,
* javax/print/attribute/standard/PrintQuality.java,
* javax/print/attribute/standard/PrinterInfo.java,
* javax/print/attribute/standard/PrinterIsAcceptingJobs.java,
* javax/print/attribute/standard/PrinterLocation.java,
* javax/print/attribute/standard/PrinterMakeAndModel.java,
* javax/print/attribute/standard/PrinterMessageFromOperator.java,
* javax/print/attribute/standard/PrinterMoreInfo.java,
* javax/print/attribute/standard/PrinterMoreInfoManufacturer.java,
* javax/print/attribute/standard/PrinterName.java,
* javax/print/attribute/standard/PrinterResolution.java,
* javax/print/attribute/standard/PrinterState.java,
* javax/print/attribute/standard/PrinterStateReason.java,
* javax/print/attribute/standard/PrinterStateReasons.java,
* javax/print/attribute/standard/PrinterURI.java,
* javax/print/attribute/standard/QueuedJobCount.java,
* javax/print/attribute/standard/ReferenceUriSchemesSupported.java,
* javax/print/attribute/standard/RequestingUserName.java,
* javax/print/attribute/standard/Severity.java,
* javax/print/attribute/standard/SheetCollate.java,
* javax/print/attribute/standard/Sides.java,
* javax/print/event/PrintEvent.java,
* javax/print/event/PrintJobAdapter.java,
* javax/print/event/PrintJobAttributeEvent.java,
* javax/print/event/PrintJobAttributeListener.java,
* javax/print/event/PrintJobEvent.java,
* javax/print/event/PrintJobListener.java,
* javax/print/event/PrintServiceAttributeEvent.java,
* javax/print/event/PrintServiceAttributeListener.java,
* javax/rmi/CORBA/ClassDesc.java,
* javax/rmi/CORBA/PortableRemoteObjectDelegate.java,
* javax/rmi/CORBA/Stub.java,
* javax/rmi/CORBA/StubDelegate.java,
* javax/rmi/CORBA/Tie.java,
* javax/rmi/CORBA/Util.java,
* javax/rmi/CORBA/UtilDelegate.java,
* javax/rmi/CORBA/ValueHandler.java,
* javax/rmi/CORBA/ValueHandlerMultiFormat.java,
* javax/rmi/PortableRemoteObject.java,
* javax/rmi/ssl/SslRMIClientSocketFactory.java,
* javax/rmi/ssl/SslRMIServerSocketFactory.java,
* javax/security/auth/Subject.java,
* javax/security/auth/callback/ChoiceCallback.java,
* javax/security/auth/callback/ConfirmationCallback.java,
* javax/security/auth/callback/NameCallback.java,
* javax/security/auth/callback/PasswordCallback.java,
* javax/security/auth/callback/TextInputCallback.java,
* javax/security/auth/callback/TextOutputCallback.java,
* javax/security/auth/kerberos/DelegationPermission.java,
* javax/security/auth/kerberos/KerberosKey.java,
* javax/security/auth/kerberos/KerberosPrincipal.java,
* javax/security/auth/kerberos/ServicePermission.java,
* javax/security/auth/login/AccountNotFoundException.java,
* javax/security/auth/login/AppConfigurationEntry.java,
* javax/security/auth/login/LoginContext.java,
* javax/security/sasl/Sasl.java,
* javax/sound/midi/ControllerEventListener.java,
* javax/sound/midi/Instrument.java,
* javax/sound/midi/InvalidMidiDataException.java,
* javax/sound/midi/MetaEventListener.java,
* javax/sound/midi/MetaMessage.java,
* javax/sound/midi/MidiChannel.java,
* javax/sound/midi/MidiDevice.java,
* javax/sound/midi/MidiEvent.java,
* javax/sound/midi/MidiFileFormat.java,
* javax/sound/midi/MidiMessage.java,
* javax/sound/midi/MidiSystem.java,
* javax/sound/midi/MidiUnavailableException.java,
* javax/sound/midi/Patch.java,
* javax/sound/midi/Receiver.java,
* javax/sound/midi/Sequence.java,
* javax/sound/midi/Sequencer.java,
* javax/sound/midi/ShortMessage.java,
* javax/sound/midi/Soundbank.java,
* javax/sound/midi/SoundbankResource.java,
* javax/sound/midi/Synthesizer.java,
* javax/sound/midi/SysexMessage.java,
* javax/sound/midi/Track.java,
* javax/sound/midi/Transmitter.java,
* javax/sound/midi/VoiceStatus.java,
* javax/sound/midi/spi/MidiDeviceProvider.java,
* javax/sound/midi/spi/MidiFileReader.java,
* javax/sound/midi/spi/MidiFileWriter.java,
* javax/sound/midi/spi/SoundbankReader.java,
* javax/sound/sampled/AudioFileFormat.java,
* javax/sound/sampled/AudioFormat.java,
* javax/sound/sampled/AudioInputStream.java,
* javax/sound/sampled/AudioPermission.java,
* javax/sound/sampled/AudioSystem.java,
* javax/sound/sampled/BooleanControl.java,
* javax/sound/sampled/Clip.java,
* javax/sound/sampled/CompoundControl.java,
* javax/sound/sampled/DataLine.java,
* javax/sound/sampled/EnumControl.java,
* javax/sound/sampled/FloatControl.java,
* javax/sound/sampled/Line.java,
* javax/sound/sampled/LineEvent.java,
* javax/sound/sampled/LineUnavailableException.java,
* javax/sound/sampled/Mixer.java,
* javax/sound/sampled/Port.java,
* javax/sound/sampled/ReverbType.java,
* javax/sound/sampled/UnsupportedAudioFileException.java,
* javax/sound/sampled/spi/AudioFileReader.java,
* javax/sound/sampled/spi/AudioFileWriter.java,
* javax/sound/sampled/spi/FormatConversionProvider.java,
* javax/sql/ConnectionEvent.java,
* javax/sql/ConnectionEventListener.java,
* javax/sql/ConnectionPoolDataSource.java,
* javax/sql/DataSource.java,
* javax/sql/PooledConnection.java,
* javax/sql/RowSet.java,
* javax/sql/RowSetEvent.java,
* javax/sql/RowSetInternal.java,
* javax/sql/RowSetListener.java,
* javax/sql/RowSetMetaData.java,
* javax/sql/RowSetReader.java,
* javax/sql/RowSetWriter.java,
* javax/sql/XAConnection.java,
* javax/sql/XADataSource.java,
* javax/swing/AbstractAction.java,
* javax/swing/AbstractButton.java,
* javax/swing/AbstractCellEditor.java,
* javax/swing/AbstractListModel.java,
* javax/swing/AbstractSpinnerModel.java,
* javax/swing/Action.java,
* javax/swing/BorderFactory.java,
* javax/swing/BoundedRangeModel.java,
* javax/swing/Box.java,
* javax/swing/BoxLayout.java,
* javax/swing/ButtonGroup.java,
* javax/swing/ButtonModel.java,
* javax/swing/CellEditor.java,
* javax/swing/CellRendererPane.java,
* javax/swing/ComboBoxModel.java,
* javax/swing/ComponentInputMap.java,
* javax/swing/DebugGraphics.java,
* javax/swing/DefaultBoundedRangeModel.java,
* javax/swing/DefaultButtonModel.java,
* javax/swing/DefaultCellEditor.java,
* javax/swing/DefaultComboBoxModel.java,
* javax/swing/DefaultDesktopManager.java,
* javax/swing/DefaultFocusManager.java,
* javax/swing/DefaultListModel.java,
* javax/swing/DefaultListSelectionModel.java,
* javax/swing/DefaultSingleSelectionModel.java,
* javax/swing/FocusManager.java,
* javax/swing/GrayFilter.java,
* javax/swing/Icon.java,
* javax/swing/ImageIcon.java,
* javax/swing/InputMap.java,
* javax/swing/InternalFrameFocusTraversalPolicy.java,
* javax/swing/JApplet.java,
* javax/swing/JButton.java,
* javax/swing/JCheckBox.java,
* javax/swing/JCheckBoxMenuItem.java,
* javax/swing/JComboBox.java,
* javax/swing/JComponent.java,
* javax/swing/JDesktopPane.java,
* javax/swing/JDialog.java,
* javax/swing/JEditorPane.java,
* javax/swing/JFileChooser.java,
* javax/swing/JFormattedTextField.java,
* javax/swing/JFrame.java,
* javax/swing/JInternalFrame.java,
* javax/swing/JLabel.java,
* javax/swing/JLayeredPane.java,
* javax/swing/JList.java,
* javax/swing/JMenu.java,
* javax/swing/JMenuBar.java,
* javax/swing/JMenuItem.java,
* javax/swing/JOptionPane.java,
* javax/swing/JPanel.java,
* javax/swing/JPasswordField.java,
* javax/swing/JPopupMenu.java,
* javax/swing/JProgressBar.java,
* javax/swing/JRadioButton.java,
* javax/swing/JRadioButtonMenuItem.java,
* javax/swing/JRootPane.java,
* javax/swing/JScrollBar.java,
* javax/swing/JScrollPane.java,
* javax/swing/JSeparator.java,
* javax/swing/JSlider.java,
* javax/swing/JSpinner.java,
* javax/swing/JSplitPane.java,
* javax/swing/JTabbedPane.java,
* javax/swing/JTable.java,
* javax/swing/JTextArea.java,
* javax/swing/JTextField.java,
* javax/swing/JTextPane.java,
* javax/swing/JToggleButton.java,
* javax/swing/JToolBar.java,
* javax/swing/JToolTip.java,
* javax/swing/JTree.java,
* javax/swing/JViewport.java,
* javax/swing/JWindow.java,
* javax/swing/KeyStroke.java,
* javax/swing/KeyboardManager.java,
* javax/swing/LayoutFocusTraversalPolicy.java,
* javax/swing/ListCellRenderer.java,
* javax/swing/ListSelectionModel.java,
* javax/swing/LookAndFeel.java,
* javax/swing/MenuSelectionManager.java,
* javax/swing/OverlayLayout.java,
* javax/swing/Popup.java,
* javax/swing/PopupFactory.java,
* javax/swing/ProgressMonitor.java,
* javax/swing/ProgressMonitorInputStream.java,
* javax/swing/Renderer.java,
* javax/swing/RepaintManager.java,
* javax/swing/ScrollPaneLayout.java,
* javax/swing/Scrollable.java,
* javax/swing/SingleSelectionModel.java,
* javax/swing/SizeRequirements.java,
* javax/swing/SizeSequence.java,
* javax/swing/SortingFocusTraversalPolicy.java,
* javax/swing/SpinnerDateModel.java,
* javax/swing/SpinnerListModel.java,
* javax/swing/SpinnerModel.java,
* javax/swing/SpinnerNumberModel.java,
* javax/swing/Spring.java,
* javax/swing/SpringLayout.java,
* javax/swing/SwingConstants.java,
* javax/swing/SwingUtilities.java,
* javax/swing/Timer.java,
* javax/swing/ToolTipManager.java,
* javax/swing/TransferHandler.java,
* javax/swing/UIDefaults.java,
* javax/swing/UIManager.java,
* javax/swing/UnsupportedLookAndFeelException.java,
* javax/swing/ViewportLayout.java,
* javax/swing/WindowConstants.java,
* javax/swing/border/AbstractBorder.java,
* javax/swing/border/BevelBorder.java,
* javax/swing/border/Border.java,
* javax/swing/border/CompoundBorder.java,
* javax/swing/border/EmptyBorder.java,
* javax/swing/border/EtchedBorder.java,
* javax/swing/border/LineBorder.java,
* javax/swing/border/MatteBorder.java,
* javax/swing/border/SoftBevelBorder.java,
* javax/swing/border/TitledBorder.java,
* javax/swing/colorchooser/AbstractColorChooserPanel.java,
* javax/swing/colorchooser/ColorChooserComponentFactory.java,
* javax/swing/colorchooser/ColorSelectionModel.java,
* javax/swing/colorchooser/DefaultColorSelectionModel.java,
* javax/swing/colorchooser/DefaultHSBChooserPanel.java,
* javax/swing/colorchooser/DefaultRGBChooserPanel.java,
* javax/swing/colorchooser/DefaultSwatchChooserPanel.java,
* javax/swing/event/AncestorEvent.java,
* javax/swing/event/AncestorListener.java,
* javax/swing/event/CaretEvent.java,
* javax/swing/event/CaretListener.java,
* javax/swing/event/CellEditorListener.java,
* javax/swing/event/ChangeEvent.java,
* javax/swing/event/ChangeListener.java,
* javax/swing/event/DocumentEvent.java,
* javax/swing/event/DocumentListener.java,
* javax/swing/event/EventListenerList.java,
* javax/swing/event/HyperlinkEvent.java,
* javax/swing/event/HyperlinkListener.java,
* javax/swing/event/InternalFrameAdapter.java,
* javax/swing/event/InternalFrameEvent.java,
* javax/swing/event/InternalFrameListener.java,
* javax/swing/event/ListDataEvent.java,
* javax/swing/event/ListDataListener.java,
* javax/swing/event/ListSelectionEvent.java,
* javax/swing/event/ListSelectionListener.java,
* javax/swing/event/MenuDragMouseEvent.java,
* javax/swing/event/MenuDragMouseListener.java,
* javax/swing/event/MenuEvent.java,
* javax/swing/event/MenuKeyEvent.java,
* javax/swing/event/MenuKeyListener.java,
* javax/swing/event/MenuListener.java,
* javax/swing/event/MouseInputListener.java,
* javax/swing/event/PopupMenuEvent.java,
* javax/swing/event/PopupMenuListener.java,
* javax/swing/event/SwingPropertyChangeSupport.java,
* javax/swing/event/TableColumnModelEvent.java,
* javax/swing/event/TableColumnModelListener.java,
* javax/swing/event/TableModelEvent.java,
* javax/swing/event/TableModelListener.java,
* javax/swing/event/TreeExpansionEvent.java,
* javax/swing/event/TreeExpansionListener.java,
* javax/swing/event/TreeModelEvent.java,
* javax/swing/event/TreeModelListener.java,
* javax/swing/event/TreeSelectionEvent.java,
* javax/swing/event/TreeSelectionListener.java,
* javax/swing/event/TreeWillExpandListener.java,
* javax/swing/event/UndoableEditEvent.java,
* javax/swing/filechooser/FileFilter.java,
* javax/swing/filechooser/FileSystemView.java,
* javax/swing/filechooser/FileView.java,
* javax/swing/filechooser/UnixFileSystemView.java,
* javax/swing/plaf/BorderUIResource.java,
* javax/swing/plaf/ColorChooserUI.java,
* javax/swing/plaf/ColorUIResource.java,
* javax/swing/plaf/ComboBoxUI.java,
* javax/swing/plaf/ComponentInputMapUIResource.java,
* javax/swing/plaf/ComponentUI.java,
* javax/swing/plaf/FileChooserUI.java,
* javax/swing/plaf/IconUIResource.java,
* javax/swing/plaf/SplitPaneUI.java,
* javax/swing/plaf/TabbedPaneUI.java,
* javax/swing/plaf/TextUI.java,
* javax/swing/plaf/UIResource.java,
* javax/swing/plaf/basic/BasicArrowButton.java,
* javax/swing/plaf/basic/BasicBorders.java,
* javax/swing/plaf/basic/BasicButtonListener.java,
* javax/swing/plaf/basic/BasicButtonUI.java,
* javax/swing/plaf/basic/BasicCheckBoxMenuItemUI.java,
* javax/swing/plaf/basic/BasicCheckBoxUI.java,
* javax/swing/plaf/basic/BasicColorChooserUI.java,
* javax/swing/plaf/basic/BasicComboBoxEditor.java,
* javax/swing/plaf/basic/BasicComboBoxRenderer.java,
* javax/swing/plaf/basic/BasicComboBoxUI.java,
* javax/swing/plaf/basic/BasicComboPopup.java,
* javax/swing/plaf/basic/BasicDesktopIconUI.java,
* javax/swing/plaf/basic/BasicDesktopPaneUI.java,
* javax/swing/plaf/basic/BasicDirectoryModel.java,
* javax/swing/plaf/basic/BasicEditorPaneUI.java,
* javax/swing/plaf/basic/BasicFileChooserUI.java,
* javax/swing/plaf/basic/BasicFormattedTextFieldUI.java,
* javax/swing/plaf/basic/BasicGraphicsUtils.java,
* javax/swing/plaf/basic/BasicHTML.java,
* javax/swing/plaf/basic/BasicIconFactory.java,
* javax/swing/plaf/basic/BasicInternalFrameTitlePane.java,
* javax/swing/plaf/basic/BasicInternalFrameUI.java,
* javax/swing/plaf/basic/BasicLabelUI.java,
* javax/swing/plaf/basic/BasicListUI.java,
* javax/swing/plaf/basic/BasicLookAndFeel.java,
* javax/swing/plaf/basic/BasicMenuBarUI.java,
* javax/swing/plaf/basic/BasicMenuItemUI.java,
* javax/swing/plaf/basic/BasicMenuUI.java,
* javax/swing/plaf/basic/BasicOptionPaneUI.java,
* javax/swing/plaf/basic/BasicPanelUI.java,
* javax/swing/plaf/basic/BasicPasswordFieldUI.java,
* javax/swing/plaf/basic/BasicPopupMenuUI.java,
* javax/swing/plaf/basic/BasicProgressBarUI.java,
* javax/swing/plaf/basic/BasicRadioButtonUI.java,
* javax/swing/plaf/basic/BasicRootPaneUI.java,
* javax/swing/plaf/basic/BasicScrollBarUI.java,
* javax/swing/plaf/basic/BasicScrollPaneUI.java,
* javax/swing/plaf/basic/BasicSeparatorUI.java,
* javax/swing/plaf/basic/BasicSliderUI.java,
* javax/swing/plaf/basic/BasicSpinnerUI.java,
* javax/swing/plaf/basic/BasicSplitPaneDivider.java,
* javax/swing/plaf/basic/BasicSplitPaneUI.java,
* javax/swing/plaf/basic/BasicTabbedPaneUI.java,
* javax/swing/plaf/basic/BasicTableHeaderUI.java,
* javax/swing/plaf/basic/BasicTableUI.java,
* javax/swing/plaf/basic/BasicTextAreaUI.java,
* javax/swing/plaf/basic/BasicTextFieldUI.java,
* javax/swing/plaf/basic/BasicTextPaneUI.java,
* javax/swing/plaf/basic/BasicTextUI.java,
* javax/swing/plaf/basic/BasicToggleButtonUI.java,
* javax/swing/plaf/basic/BasicToolBarUI.java,
* javax/swing/plaf/basic/BasicToolTipUI.java,
* javax/swing/plaf/basic/BasicTreeUI.java,
* javax/swing/plaf/basic/BasicViewportUI.java,
* javax/swing/plaf/metal/DefaultMetalTheme.java,
* javax/swing/plaf/metal/MetalBorders.java,
* javax/swing/plaf/metal/MetalButtonListener.java,
* javax/swing/plaf/metal/MetalButtonUI.java,
* javax/swing/plaf/metal/MetalCheckBoxIcon.java,
* javax/swing/plaf/metal/MetalCheckBoxUI.java,
* javax/swing/plaf/metal/MetalComboBoxButton.java,
* javax/swing/plaf/metal/MetalComboBoxEditor.java,
* javax/swing/plaf/metal/MetalComboBoxIcon.java,
* javax/swing/plaf/metal/MetalComboBoxUI.java,
* javax/swing/plaf/metal/MetalFileChooserUI.java,
* javax/swing/plaf/metal/MetalIconFactory.java,
* javax/swing/plaf/metal/MetalInternalFrameTitlePane.java,
* javax/swing/plaf/metal/MetalInternalFrameUI.java,
* javax/swing/plaf/metal/MetalLabelUI.java,
* javax/swing/plaf/metal/MetalLookAndFeel.java,
* javax/swing/plaf/metal/MetalMenuBarUI.java,
* javax/swing/plaf/metal/MetalProgressBarUI.java,
* javax/swing/plaf/metal/MetalRadioButtonUI.java,
* javax/swing/plaf/metal/MetalRootPaneUI.java,
* javax/swing/plaf/metal/MetalScrollBarUI.java,
* javax/swing/plaf/metal/MetalScrollButton.java,
* javax/swing/plaf/metal/MetalScrollPaneUI.java,
* javax/swing/plaf/metal/MetalSeparatorUI.java,
* javax/swing/plaf/metal/MetalSliderUI.java,
* javax/swing/plaf/metal/MetalSplitPaneDivider.java,
* javax/swing/plaf/metal/MetalSplitPaneUI.java,
* javax/swing/plaf/metal/MetalTabbedPaneUI.java,
* javax/swing/plaf/metal/MetalTextFieldUI.java,
* javax/swing/plaf/metal/MetalTheme.java,
* javax/swing/plaf/metal/MetalToggleButtonUI.java,
* javax/swing/plaf/metal/MetalToolBarUI.java,
* javax/swing/plaf/metal/MetalToolTipUI.java,
* javax/swing/plaf/metal/MetalTreeUI.java,
* javax/swing/plaf/metal/MetalUtils.java,
* javax/swing/plaf/metal/OceanTheme.java,
* javax/swing/plaf/multi/MultiButtonUI.java,
* javax/swing/plaf/multi/MultiColorChooserUI.java,
* javax/swing/plaf/multi/MultiComboBoxUI.java,
* javax/swing/plaf/multi/MultiDesktopIconUI.java,
* javax/swing/plaf/multi/MultiDesktopPaneUI.java,
* javax/swing/plaf/multi/MultiFileChooserUI.java,
* javax/swing/plaf/multi/MultiInternalFrameUI.java,
* javax/swing/plaf/multi/MultiLabelUI.java,
* javax/swing/plaf/multi/MultiListUI.java,
* javax/swing/plaf/multi/MultiLookAndFeel.java,
* javax/swing/plaf/multi/MultiMenuBarUI.java,
* javax/swing/plaf/multi/MultiMenuItemUI.java,
* javax/swing/plaf/multi/MultiOptionPaneUI.java,
* javax/swing/plaf/multi/MultiPanelUI.java,
* javax/swing/plaf/multi/MultiPopupMenuUI.java,
* javax/swing/plaf/multi/MultiProgressBarUI.java,
* javax/swing/plaf/multi/MultiRootPaneUI.java,
* javax/swing/plaf/multi/MultiScrollBarUI.java,
* javax/swing/plaf/multi/MultiScrollPaneUI.java,
* javax/swing/plaf/multi/MultiSeparatorUI.java,
* javax/swing/plaf/multi/MultiSliderUI.java,
* javax/swing/plaf/multi/MultiSpinnerUI.java,
* javax/swing/plaf/multi/MultiSplitPaneUI.java,
* javax/swing/plaf/multi/MultiTabbedPaneUI.java,
* javax/swing/plaf/multi/MultiTableHeaderUI.java,
* javax/swing/plaf/multi/MultiTableUI.java,
* javax/swing/plaf/multi/MultiTextUI.java,
* javax/swing/plaf/multi/MultiToolBarUI.java,
* javax/swing/plaf/multi/MultiToolTipUI.java,
* javax/swing/plaf/multi/MultiTreeUI.java,
* javax/swing/plaf/multi/MultiViewportUI.java,
* javax/swing/plaf/synth/SynthGraphicsUtils.java,
* javax/swing/plaf/synth/SynthLookAndFeel.java,
* javax/swing/plaf/synth/SynthPainter.java,
* javax/swing/table/AbstractTableModel.java,
* javax/swing/table/DefaultTableCellRenderer.java,
* javax/swing/table/DefaultTableColumnModel.java,
* javax/swing/table/DefaultTableModel.java,
* javax/swing/table/JTableHeader.java,
* javax/swing/table/TableCellEditor.java,
* javax/swing/table/TableCellRenderer.java,
* javax/swing/table/TableColumn.java,
* javax/swing/table/TableColumnModel.java,
* javax/swing/table/TableModel.java,
* javax/swing/text/AbstractDocument.java,
* javax/swing/text/AbstractWriter.java,
* javax/swing/text/AsyncBoxView.java,
* javax/swing/text/AttributeSet.java,
* javax/swing/text/BoxView.java,
* javax/swing/text/Caret.java,
* javax/swing/text/ComponentView.java,
* javax/swing/text/CompositeView.java,
* javax/swing/text/DefaultCaret.java,
* javax/swing/text/DefaultEditorKit.java,
* javax/swing/text/DefaultFormatter.java,
* javax/swing/text/DefaultFormatterFactory.java,
* javax/swing/text/DefaultHighlighter.java,
* javax/swing/text/DefaultStyledDocument.java,
* javax/swing/text/DocumentFilter.java,
* javax/swing/text/EditorKit.java,
* javax/swing/text/Element.java,
* javax/swing/text/ElementIterator.java,
* javax/swing/text/EmptyAttributeSet.java,
* javax/swing/text/FieldView.java,
* javax/swing/text/FlowView.java,
* javax/swing/text/GapContent.java,
* javax/swing/text/GlyphView.java,
* javax/swing/text/Highlighter.java,
* javax/swing/text/InternationalFormatter.java,
* javax/swing/text/JTextComponent.java,
* javax/swing/text/Keymap.java,
* javax/swing/text/LayeredHighlighter.java,
* javax/swing/text/LayoutQueue.java,
* javax/swing/text/MaskFormatter.java,
* javax/swing/text/MutableAttributeSet.java,
* javax/swing/text/NavigationFilter.java,
* javax/swing/text/NumberFormatter.java,
* javax/swing/text/ParagraphView.java,
* javax/swing/text/PasswordView.java,
* javax/swing/text/PlainDocument.java,
* javax/swing/text/PlainView.java,
* javax/swing/text/Position.java,
* javax/swing/text/Segment.java,
* javax/swing/text/SimpleAttributeSet.java,
* javax/swing/text/StringContent.java,
* javax/swing/text/Style.java,
* javax/swing/text/StyleConstants.java,
* javax/swing/text/StyleContext.java,
* javax/swing/text/StyledDocument.java,
* javax/swing/text/StyledEditorKit.java,
* javax/swing/text/TabExpander.java,
* javax/swing/text/TabSet.java,
* javax/swing/text/TabStop.java,
* javax/swing/text/TabableView.java,
* javax/swing/text/TableView.java,
* javax/swing/text/TextAction.java,
* javax/swing/text/Utilities.java,
* javax/swing/text/View.java,
* javax/swing/text/ViewFactory.java,
* javax/swing/text/WrappedPlainView.java,
* javax/swing/text/html/BRView.java,
* javax/swing/text/html/BlockView.java,
* javax/swing/text/html/CSS.java,
* javax/swing/text/html/CSSBorder.java,
* javax/swing/text/html/CSSParser.java,
* javax/swing/text/html/FormView.java,
* javax/swing/text/html/HRuleView.java,
* javax/swing/text/html/HTMLDocument.java,
* javax/swing/text/html/HTMLEditorKit.java,
* javax/swing/text/html/HTMLWriter.java,
* javax/swing/text/html/ImageView.java,
* javax/swing/text/html/InlineView.java,
* javax/swing/text/html/ListView.java,
* javax/swing/text/html/MinimalHTMLWriter.java,
* javax/swing/text/html/MultiAttributeSet.java,
* javax/swing/text/html/MultiStyle.java,
* javax/swing/text/html/ParagraphView.java,
* javax/swing/text/html/StyleSheet.java,
* javax/swing/text/html/TableView.java,
* javax/swing/text/html/ViewAttributeSet.java,
* javax/swing/text/html/parser/Entity.java,
* javax/swing/text/html/parser/Parser.java,
* javax/swing/text/rtf/RTFParser.java,
* javax/swing/text/rtf/RTFScanner.java,
* javax/swing/tree/AbstractLayoutCache.java,
* javax/swing/tree/DefaultMutableTreeNode.java,
* javax/swing/tree/DefaultTreeCellEditor.java,
* javax/swing/tree/DefaultTreeCellRenderer.java,
* javax/swing/tree/DefaultTreeModel.java,
* javax/swing/tree/DefaultTreeSelectionModel.java,
* javax/swing/tree/ExpandVetoException.java,
* javax/swing/tree/FixedHeightLayoutCache.java,
* javax/swing/tree/MutableTreeNode.java,
* javax/swing/tree/RowMapper.java,
* javax/swing/tree/TreeCellEditor.java,
* javax/swing/tree/TreeCellRenderer.java,
* javax/swing/tree/TreeNode.java,
* javax/swing/tree/TreePath.java,
* javax/swing/tree/TreeSelectionModel.java,
* javax/swing/tree/VariableHeightLayoutCache.java,
* javax/swing/undo/AbstractUndoableEdit.java,
* javax/swing/undo/CompoundEdit.java,
* javax/swing/undo/StateEdit.java,
* javax/swing/undo/UndoManager.java,
* javax/swing/undo/UndoableEdit.java,
* javax/tools/FileObject.java,
* javax/transaction/HeuristicCommitException.java,
* javax/transaction/HeuristicMixedException.java,
* javax/transaction/HeuristicRollbackException.java,
* javax/transaction/InvalidTransactionException.java,
* javax/transaction/NotSupportedException.java,
* javax/transaction/RollbackException.java,
* javax/transaction/Status.java,
* javax/transaction/Synchronization.java,
* javax/transaction/SystemException.java,
* javax/transaction/Transaction.java,
* javax/transaction/TransactionManager.java,
* javax/transaction/TransactionRequiredException.java,
* javax/transaction/TransactionRolledbackException.java,
* javax/transaction/UserTransaction.java,
* javax/transaction/xa/XAException.java,
* javax/transaction/xa/XAResource.java,
* javax/transaction/xa/Xid.java,
* javax/xml/XMLConstants.java,
* javax/xml/datatype/DatatypeConfigurationException.java,
* javax/xml/datatype/DatatypeConstants.java,
* javax/xml/datatype/DatatypeFactory.java,
* javax/xml/datatype/Duration.java,
* javax/xml/datatype/XMLGregorianCalendar.java,
* javax/xml/namespace/NamespaceContext.java,
* javax/xml/namespace/QName.java,
* javax/xml/parsers/DocumentBuilder.java,
* javax/xml/parsers/DocumentBuilderFactory.java,
* javax/xml/parsers/FactoryConfigurationError.java,
* javax/xml/parsers/ParserConfigurationException.java,
* javax/xml/parsers/SAXParser.java,
* javax/xml/parsers/SAXParserFactory.java,
* javax/xml/stream/EventFilter.java,
* javax/xml/stream/FactoryConfigurationError.java,
* javax/xml/stream/Location.java,
* javax/xml/stream/StreamFilter.java,
* javax/xml/stream/XMLEventFactory.java,
* javax/xml/stream/XMLEventReader.java,
* javax/xml/stream/XMLEventWriter.java,
* javax/xml/stream/XMLInputFactory.java,
* javax/xml/stream/XMLOutputFactory.java,
* javax/xml/stream/XMLReporter.java,
* javax/xml/stream/XMLResolver.java,
* javax/xml/stream/XMLStreamConstants.java,
* javax/xml/stream/XMLStreamException.java,
* javax/xml/stream/XMLStreamReader.java,
* javax/xml/stream/XMLStreamWriter.java,
* javax/xml/stream/events/Attribute.java,
* javax/xml/stream/events/Characters.java,
* javax/xml/stream/events/Comment.java,
* javax/xml/stream/events/DTD.java,
* javax/xml/stream/events/EndDocument.java,
* javax/xml/stream/events/EndElement.java,
* javax/xml/stream/events/EntityDeclaration.java,
* javax/xml/stream/events/EntityReference.java,
* javax/xml/stream/events/Namespace.java,
* javax/xml/stream/events/NotationDeclaration.java,
* javax/xml/stream/events/ProcessingInstruction.java,
* javax/xml/stream/events/StartDocument.java,
* javax/xml/stream/events/StartElement.java,
* javax/xml/stream/events/XMLEvent.java,
* javax/xml/stream/util/EventReaderDelegate.java,
* javax/xml/stream/util/StreamReaderDelegate.java,
* javax/xml/stream/util/XMLEventAllocator.java,
* javax/xml/stream/util/XMLEventConsumer.java,
* javax/xml/transform/ErrorListener.java,
* javax/xml/transform/OutputKeys.java,
* javax/xml/transform/Result.java,
* javax/xml/transform/Source.java,
* javax/xml/transform/SourceLocator.java,
* javax/xml/transform/Templates.java,
* javax/xml/transform/Transformer.java,
* javax/xml/transform/TransformerConfigurationException.java,
* javax/xml/transform/TransformerException.java,
* javax/xml/transform/TransformerFactory.java,
* javax/xml/transform/TransformerFactoryConfigurationError.java,
* javax/xml/transform/URIResolver.java,
* javax/xml/transform/dom/DOMLocator.java,
* javax/xml/transform/dom/DOMResult.java,
* javax/xml/transform/dom/DOMSource.java,
* javax/xml/transform/sax/SAXResult.java,
* javax/xml/transform/sax/SAXSource.java,
* javax/xml/transform/sax/SAXTransformerFactory.java,
* javax/xml/transform/sax/TemplatesHandler.java,
* javax/xml/transform/sax/TransformerHandler.java,
* javax/xml/transform/stream/StreamResult.java,
* javax/xml/transform/stream/StreamSource.java,
* javax/xml/validation/Schema.java,
* javax/xml/validation/SchemaFactory.java,
* javax/xml/validation/SchemaFactoryLoader.java,
* javax/xml/validation/TypeInfoProvider.java,
* javax/xml/validation/Validator.java,
* javax/xml/validation/ValidatorHandler.java,
* javax/xml/xpath/XPath.java,
* javax/xml/xpath/XPathConstants.java,
* javax/xml/xpath/XPathException.java,
* javax/xml/xpath/XPathExpression.java,
* javax/xml/xpath/XPathExpressionException.java,
* javax/xml/xpath/XPathFactory.java,
* javax/xml/xpath/XPathFactoryConfigurationException.java,
* javax/xml/xpath/XPathFunction.java,
* javax/xml/xpath/XPathFunctionException.java,
* javax/xml/xpath/XPathFunctionResolver.java,
* javax/xml/xpath/XPathVariableResolver.java,
* org/omg/CORBA/ARG_IN.java,
* org/omg/CORBA/ARG_INOUT.java,
* org/omg/CORBA/ARG_OUT.java,
* org/omg/CORBA/AnySeqHolder.java,
* org/omg/CORBA/BAD_CONTEXT.java,
* org/omg/CORBA/BAD_INV_ORDER.java,
* org/omg/CORBA/BAD_OPERATION.java,
* org/omg/CORBA/BAD_PARAM.java,
* org/omg/CORBA/BAD_POLICY.java,
* org/omg/CORBA/BAD_POLICY_TYPE.java,
* org/omg/CORBA/BAD_POLICY_VALUE.java,
* org/omg/CORBA/BAD_TYPECODE.java,
* org/omg/CORBA/COMM_FAILURE.java,
* org/omg/CORBA/CTX_RESTRICT_SCOPE.java,
* org/omg/CORBA/CompletionStatus.java,
* org/omg/CORBA/CompletionStatusHelper.java,
* org/omg/CORBA/Context.java,
* org/omg/CORBA/Current.java,
* org/omg/CORBA/CurrentHelper.java,
* org/omg/CORBA/CurrentHolder.java,
* org/omg/CORBA/CustomMarshal.java,
* org/omg/CORBA/CustomValue.java,
* org/omg/CORBA/DATA_CONVERSION.java,
* org/omg/CORBA/DataInputStream.java,
* org/omg/CORBA/DataOutputStream.java,
* org/omg/CORBA/DefinitionKind.java,
* org/omg/CORBA/DefinitionKindHelper.java,
* org/omg/CORBA/DynamicImplementation.java,
* org/omg/CORBA/FREE_MEM.java,
* org/omg/CORBA/FieldNameHelper.java,
* org/omg/CORBA/IDLTypeHelper.java,
* org/omg/CORBA/IMP_LIMIT.java,
* org/omg/CORBA/INITIALIZE.java,
* org/omg/CORBA/INTERNAL.java,
* org/omg/CORBA/INTF_REPOS.java,
* org/omg/CORBA/INVALID_TRANSACTION.java,
* org/omg/CORBA/INV_FLAG.java,
* org/omg/CORBA/INV_IDENT.java,
* org/omg/CORBA/INV_OBJREF.java,
* org/omg/CORBA/INV_POLICY.java,
* org/omg/CORBA/IRObject.java,
* org/omg/CORBA/IRObjectOperations.java,
* org/omg/CORBA/IdentifierHelper.java,
* org/omg/CORBA/LocalObject.java,
* org/omg/CORBA/LongSeqHolder.java,
* org/omg/CORBA/MARSHAL.java,
* org/omg/CORBA/NO_IMPLEMENT.java,
* org/omg/CORBA/NO_MEMORY.java,
* org/omg/CORBA/NO_PERMISSION.java,
* org/omg/CORBA/NO_RESOURCES.java,
* org/omg/CORBA/NO_RESPONSE.java,
* org/omg/CORBA/NVList.java,
* org/omg/CORBA/OBJECT_NOT_EXIST.java,
* org/omg/CORBA/OBJ_ADAPTER.java,
* org/omg/CORBA/OMGVMCID.java,
* org/omg/CORBA/ORB.java,
* org/omg/CORBA/ObjectHelper.java,
* org/omg/CORBA/ObjectHolder.java,
* org/omg/CORBA/PERSIST_STORE.java,
* org/omg/CORBA/ParameterMode.java,
* org/omg/CORBA/ParameterModeHelper.java,
* org/omg/CORBA/PolicyErrorCodeHelper.java,
* org/omg/CORBA/PolicyErrorHelper.java,
* org/omg/CORBA/PolicyErrorHolder.java,
* org/omg/CORBA/PolicyHelper.java,
* org/omg/CORBA/PolicyHolder.java,
* org/omg/CORBA/PolicyListHelper.java,
* org/omg/CORBA/PolicyListHolder.java,
* org/omg/CORBA/PolicyOperations.java,
* org/omg/CORBA/PolicyTypeHelper.java,
* org/omg/CORBA/RepositoryIdHelper.java,
* org/omg/CORBA/Request.java,
* org/omg/CORBA/ServiceDetailHelper.java,
* org/omg/CORBA/ServiceInformationHelper.java,
* org/omg/CORBA/SetOverrideTypeHelper.java,
* org/omg/CORBA/StringValueHelper.java,
* org/omg/CORBA/StructMember.java,
* org/omg/CORBA/StructMemberHelper.java,
* org/omg/CORBA/SystemException.java,
* org/omg/CORBA/TCKind.java,
* org/omg/CORBA/TRANSACTION_REQUIRED.java,
* org/omg/CORBA/TRANSACTION_ROLLEDBACK.java,
* org/omg/CORBA/TRANSIENT.java,
* org/omg/CORBA/TypeCode.java,
* org/omg/CORBA/TypeCodePackage/BadKind.java,
* org/omg/CORBA/TypeCodePackage/Bounds.java,
* org/omg/CORBA/UNSUPPORTED_POLICY.java,
* org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java,
* org/omg/CORBA/UnionMemberHelper.java,
* org/omg/CORBA/UnknownUserException.java,
* org/omg/CORBA/UnknownUserExceptionHolder.java,
* org/omg/CORBA/ValueBaseHelper.java,
* org/omg/CORBA/ValueBaseHolder.java,
* org/omg/CORBA/ValueMemberHelper.java,
* org/omg/CORBA/VersionSpecHelper.java,
* org/omg/CORBA/VisibilityHelper.java,
* org/omg/CORBA/WStringValueHelper.java,
* org/omg/CORBA/WrongTransactionHelper.java,
* org/omg/CORBA/WrongTransactionHolder.java,
* org/omg/CORBA/_IDLTypeStub.java,
* org/omg/CORBA/_PolicyStub.java,
* org/omg/CORBA/portable/CustomValue.java,
* org/omg/CORBA/portable/Delegate.java,
* org/omg/CORBA/portable/ObjectImpl.java,
* org/omg/CORBA/portable/StreamableValue.java,
* org/omg/CORBA/portable/ValueBase.java,
* org/omg/CORBA_2_3/ORB.java,
* org/omg/CORBA_2_3/portable/Delegate.java,
* org/omg/CORBA_2_3/portable/InputStream.java,
* org/omg/CORBA_2_3/portable/ObjectImpl.java,
* org/omg/CORBA_2_3/portable/OutputStream.java,
* org/omg/CosNaming/BindingHelper.java,
* org/omg/CosNaming/BindingIterator.java,
* org/omg/CosNaming/BindingIteratorHelper.java,
* org/omg/CosNaming/BindingIteratorOperations.java,
* org/omg/CosNaming/BindingIteratorPOA.java,
* org/omg/CosNaming/BindingType.java,
* org/omg/CosNaming/BindingTypeHelper.java,
* org/omg/CosNaming/IstringHelper.java,
* org/omg/CosNaming/NameComponentHelper.java,
* org/omg/CosNaming/NameHelper.java,
* org/omg/CosNaming/NamingContext.java,
* org/omg/CosNaming/NamingContextExtHelper.java,
* org/omg/CosNaming/NamingContextExtPOA.java,
* org/omg/CosNaming/NamingContextExtPackage/InvalidAddress.java,
* org/omg/CosNaming/NamingContextHelper.java,
* org/omg/CosNaming/NamingContextPOA.java,
* org/omg/CosNaming/NamingContextPackage/AlreadyBound.java,
* org/omg/CosNaming/NamingContextPackage/CannotProceed.java,
* org/omg/CosNaming/NamingContextPackage/CannotProceedHelper.java,
* org/omg/CosNaming/NamingContextPackage/InvalidName.java,
* org/omg/CosNaming/NamingContextPackage/InvalidNameHelper.java,
* org/omg/CosNaming/NamingContextPackage/NotEmptyHelper.java,
* org/omg/CosNaming/NamingContextPackage/NotFound.java,
* org/omg/CosNaming/NamingContextPackage/NotFoundHelper.java,
* org/omg/CosNaming/NamingContextPackage/NotFoundReason.java,
* org/omg/CosNaming/NamingContextPackage/NotFoundReasonHelper.java,
* org/omg/CosNaming/NamingContextPackage/NotFoundReasonHolder.java,
* org/omg/CosNaming/_BindingIteratorImplBase.java,
* org/omg/CosNaming/_BindingIteratorStub.java,
* org/omg/CosNaming/_NamingContextExtStub.java,
* org/omg/CosNaming/_NamingContextStub.java,
* org/omg/Dynamic/Parameter.java,
* org/omg/DynamicAny/AnySeqHelper.java,
* org/omg/DynamicAny/DynAny.java,
* org/omg/DynamicAny/DynAnyFactoryHelper.java,
* org/omg/DynamicAny/DynAnyFactoryPackage/InconsistentTypeCode.java,
* org/omg/DynamicAny/DynAnyFactoryPackage/InconsistentTypeCodeHelper.java,
* org/omg/DynamicAny/DynAnyHelper.java,
* org/omg/DynamicAny/DynAnyPackage/InvalidValue.java,
* org/omg/DynamicAny/DynAnyPackage/InvalidValueHelper.java,
* org/omg/DynamicAny/DynAnyPackage/TypeMismatch.java,
* org/omg/DynamicAny/DynAnyPackage/TypeMismatchHelper.java,
* org/omg/DynamicAny/DynAnySeqHelper.java,
* org/omg/DynamicAny/DynArrayHelper.java,
* org/omg/DynamicAny/DynEnumHelper.java,
* org/omg/DynamicAny/DynFixedHelper.java,
* org/omg/DynamicAny/DynSequenceHelper.java,
* org/omg/DynamicAny/DynStructHelper.java,
* org/omg/DynamicAny/DynUnionHelper.java,
* org/omg/DynamicAny/DynValueBox.java,
* org/omg/DynamicAny/DynValueCommonOperations.java,
* org/omg/DynamicAny/DynValueHelper.java,
* org/omg/DynamicAny/FieldNameHelper.java,
* org/omg/DynamicAny/NameDynAnyPairHelper.java,
* org/omg/DynamicAny/NameDynAnyPairSeqHelper.java,
* org/omg/DynamicAny/NameValuePair.java,
* org/omg/DynamicAny/NameValuePairHelper.java,
* org/omg/DynamicAny/NameValuePairSeqHelper.java,
* org/omg/DynamicAny/_DynAnyFactoryStub.java,
* org/omg/DynamicAny/_DynAnyStub.java,
* org/omg/DynamicAny/_DynArrayStub.java,
* org/omg/DynamicAny/_DynEnumStub.java,
* org/omg/DynamicAny/_DynFixedStub.java,
* org/omg/DynamicAny/_DynSequenceStub.java,
* org/omg/DynamicAny/_DynStructStub.java,
* org/omg/DynamicAny/_DynUnionStub.java,
* org/omg/DynamicAny/_DynValueStub.java,
* org/omg/IOP/Codec.java,
* org/omg/IOP/CodecFactory.java,
* org/omg/IOP/CodecFactoryHelper.java,
* org/omg/IOP/CodecFactoryOperations.java,
* org/omg/IOP/CodecFactoryPackage/UnknownEncoding.java,
* org/omg/IOP/CodecFactoryPackage/UnknownEncodingHelper.java,
* org/omg/IOP/CodecOperations.java,
* org/omg/IOP/CodecPackage/FormatMismatch.java,
* org/omg/IOP/CodecPackage/FormatMismatchHelper.java,
* org/omg/IOP/CodecPackage/InvalidTypeForEncoding.java,
* org/omg/IOP/CodecPackage/InvalidTypeForEncodingHelper.java,
* org/omg/IOP/CodecPackage/TypeMismatch.java,
* org/omg/IOP/CodecPackage/TypeMismatchHelper.java,
* org/omg/IOP/ComponentIdHelper.java,
* org/omg/IOP/Encoding.java,
* org/omg/IOP/IOR.java,
* org/omg/IOP/IORHelper.java,
* org/omg/IOP/IORHolder.java,
* org/omg/IOP/MultipleComponentProfileHelper.java,
* org/omg/IOP/MultipleComponentProfileHolder.java,
* org/omg/IOP/ProfileIdHelper.java,
* org/omg/IOP/ServiceContext.java,
* org/omg/IOP/ServiceContextHelper.java,
* org/omg/IOP/ServiceContextHolder.java,
* org/omg/IOP/ServiceContextListHelper.java,
* org/omg/IOP/ServiceContextListHolder.java,
* org/omg/IOP/ServiceIdHelper.java,
* org/omg/IOP/TaggedComponent.java,
* org/omg/IOP/TaggedComponentHelper.java,
* org/omg/IOP/TaggedComponentHolder.java,
* org/omg/IOP/TaggedProfile.java,
* org/omg/IOP/TaggedProfileHelper.java,
* org/omg/IOP/TaggedProfileHolder.java,
* org/omg/IOP/TransactionService.java,
* org/omg/Messaging/SYNC_WITH_TRANSPORT.java,
* org/omg/Messaging/SyncScopeHelper.java,
* org/omg/PortableInterceptor/AdapterManagerIdHelper.java,
* org/omg/PortableInterceptor/AdapterNameHelper.java,
* org/omg/PortableInterceptor/AdapterStateHelper.java,
* org/omg/PortableInterceptor/ClientRequestInfo.java,
* org/omg/PortableInterceptor/ClientRequestInfoOperations.java,
* org/omg/PortableInterceptor/ClientRequestInterceptor.java,
* org/omg/PortableInterceptor/ClientRequestInterceptorOperations.java,
* org/omg/PortableInterceptor/Current.java,
* org/omg/PortableInterceptor/CurrentHelper.java,
* org/omg/PortableInterceptor/CurrentOperations.java,
* org/omg/PortableInterceptor/ForwardRequest.java,
* org/omg/PortableInterceptor/ForwardRequestHelper.java,
* org/omg/PortableInterceptor/IORInfo.java,
* org/omg/PortableInterceptor/IORInfoOperations.java,
* org/omg/PortableInterceptor/IORInterceptor.java,
* org/omg/PortableInterceptor/IORInterceptorOperations.java,
* org/omg/PortableInterceptor/IORInterceptor_3_0.java,
* org/omg/PortableInterceptor/IORInterceptor_3_0Helper.java,
* org/omg/PortableInterceptor/IORInterceptor_3_0Holder.java,
* org/omg/PortableInterceptor/IORInterceptor_3_0Operations.java,
* org/omg/PortableInterceptor/Interceptor.java,
* org/omg/PortableInterceptor/InterceptorOperations.java,
* org/omg/PortableInterceptor/InvalidSlot.java,
* org/omg/PortableInterceptor/InvalidSlotHelper.java,
* org/omg/PortableInterceptor/LOCATION_FORWARD.java,
* org/omg/PortableInterceptor/ORBIdHelper.java,
* org/omg/PortableInterceptor/ORBInitInfo.java,
* org/omg/PortableInterceptor/ORBInitInfoOperations.java,
* org/omg/PortableInterceptor/ORBInitInfoPackage/DuplicateName.java,
* org/omg/PortableInterceptor/ORBInitInfoPackage/DuplicateNameHelper.java,
* org/omg/PortableInterceptor/ORBInitInfoPackage/InvalidName.java,
* org/omg/PortableInterceptor/ORBInitInfoPackage/InvalidNameHelper.java,
* org/omg/PortableInterceptor/ORBInitInfoPackage/ObjectIdHelper.java,
* org/omg/PortableInterceptor/ORBInitializer.java,
* org/omg/PortableInterceptor/ORBInitializerOperations.java,
* org/omg/PortableInterceptor/ObjectIdHelper.java,
* org/omg/PortableInterceptor/ObjectReferenceFactory.java,
* org/omg/PortableInterceptor/ObjectReferenceFactoryHelper.java,
* org/omg/PortableInterceptor/ObjectReferenceFactoryHolder.java,
* org/omg/PortableInterceptor/ObjectReferenceTemplate.java,
* org/omg/PortableInterceptor/ObjectReferenceTemplateHelper.java,
* org/omg/PortableInterceptor/ObjectReferenceTemplateHolder.java,
* org/omg/PortableInterceptor/ObjectReferenceTemplateSeqHelper.java,
* org/omg/PortableInterceptor/ObjectReferenceTemplateSeqHolder.java,
* org/omg/PortableInterceptor/PolicyFactory.java,
* org/omg/PortableInterceptor/PolicyFactoryOperations.java,
* org/omg/PortableInterceptor/RequestInfo.java,
* org/omg/PortableInterceptor/RequestInfoOperations.java,
* org/omg/PortableInterceptor/SUCCESSFUL.java,
* org/omg/PortableInterceptor/SYSTEM_EXCEPTION.java,
* org/omg/PortableInterceptor/ServerIdHelper.java,
* org/omg/PortableInterceptor/ServerRequestInfo.java,
* org/omg/PortableInterceptor/ServerRequestInfoOperations.java,
* org/omg/PortableInterceptor/ServerRequestInterceptor.java,
* org/omg/PortableInterceptor/ServerRequestInterceptorOperations.java,
* org/omg/PortableInterceptor/TRANSPORT_RETRY.java,
* org/omg/PortableInterceptor/USER_EXCEPTION.java,
* org/omg/PortableInterceptor/_IORInterceptor_3_0Stub.java,
* org/omg/PortableServer/AdapterActivator.java,
* org/omg/PortableServer/AdapterActivatorOperations.java,
* org/omg/PortableServer/Current.java,
* org/omg/PortableServer/CurrentHelper.java,
* org/omg/PortableServer/CurrentOperations.java,
* org/omg/PortableServer/CurrentPackage/NoContext.java,
* org/omg/PortableServer/CurrentPackage/NoContextHelper.java,
* org/omg/PortableServer/DynamicImplementation.java,
* org/omg/PortableServer/ForwardRequest.java,
* org/omg/PortableServer/ForwardRequestHelper.java,
* org/omg/PortableServer/ID_ASSIGNMENT_POLICY_ID.java,
* org/omg/PortableServer/ID_UNIQUENESS_POLICY_ID.java,
* org/omg/PortableServer/IMPLICIT_ACTIVATION_POLICY_ID.java,
* org/omg/PortableServer/IdAssignmentPolicy.java,
* org/omg/PortableServer/IdAssignmentPolicyOperations.java,
* org/omg/PortableServer/IdAssignmentPolicyValue.java,
* org/omg/PortableServer/IdUniquenessPolicy.java,
* org/omg/PortableServer/IdUniquenessPolicyOperations.java,
* org/omg/PortableServer/IdUniquenessPolicyValue.java,
* org/omg/PortableServer/ImplicitActivationPolicy.java,
* org/omg/PortableServer/ImplicitActivationPolicyOperations.java,
* org/omg/PortableServer/ImplicitActivationPolicyValue.java,
* org/omg/PortableServer/LifespanPolicy.java,
* org/omg/PortableServer/LifespanPolicyOperations.java,
* org/omg/PortableServer/LifespanPolicyValue.java,
* org/omg/PortableServer/POA.java,
* org/omg/PortableServer/POAHelper.java,
* org/omg/PortableServer/POAManager.java,
* org/omg/PortableServer/POAManagerOperations.java,
* org/omg/PortableServer/POAManagerPackage/AdapterInactive.java,
* org/omg/PortableServer/POAManagerPackage/AdapterInactiveHelper.java,
* org/omg/PortableServer/POAManagerPackage/State.java,
* org/omg/PortableServer/POAOperations.java,
* org/omg/PortableServer/POAPackage/AdapterAlreadyExists.java,
* org/omg/PortableServer/POAPackage/AdapterAlreadyExistsHelper.java,
* org/omg/PortableServer/POAPackage/AdapterNonExistent.java,
* org/omg/PortableServer/POAPackage/AdapterNonExistentHelper.java,
* org/omg/PortableServer/POAPackage/InvalidPolicy.java,
* org/omg/PortableServer/POAPackage/InvalidPolicyHelper.java,
* org/omg/PortableServer/POAPackage/NoServant.java,
* org/omg/PortableServer/POAPackage/NoServantHelper.java,
* org/omg/PortableServer/POAPackage/ObjectAlreadyActive.java,
* org/omg/PortableServer/POAPackage/ObjectAlreadyActiveHelper.java,
* org/omg/PortableServer/POAPackage/ObjectNotActive.java,
* org/omg/PortableServer/POAPackage/ObjectNotActiveHelper.java,
* org/omg/PortableServer/POAPackage/ServantAlreadyActive.java,
* org/omg/PortableServer/POAPackage/ServantAlreadyActiveHelper.java,
* org/omg/PortableServer/POAPackage/ServantNotActive.java,
* org/omg/PortableServer/POAPackage/ServantNotActiveHelper.java,
* org/omg/PortableServer/POAPackage/WrongAdapter.java,
* org/omg/PortableServer/POAPackage/WrongAdapterHelper.java,
* org/omg/PortableServer/POAPackage/WrongPolicy.java,
* org/omg/PortableServer/POAPackage/WrongPolicyHelper.java,
* org/omg/PortableServer/RequestProcessingPolicy.java,
* org/omg/PortableServer/RequestProcessingPolicyOperations.java,
* org/omg/PortableServer/RequestProcessingPolicyValue.java,
* org/omg/PortableServer/Servant.java,
* org/omg/PortableServer/ServantActivator.java,
* org/omg/PortableServer/ServantActivatorHelper.java,
* org/omg/PortableServer/ServantActivatorOperations.java,
* org/omg/PortableServer/ServantActivatorPOA.java,
* org/omg/PortableServer/ServantLocator.java,
* org/omg/PortableServer/ServantLocatorHelper.java,
* org/omg/PortableServer/ServantLocatorOperations.java,
* org/omg/PortableServer/ServantLocatorPOA.java,
* org/omg/PortableServer/ServantLocatorPackage/CookieHolder.java,
* org/omg/PortableServer/ServantManager.java,
* org/omg/PortableServer/ServantManagerOperations.java,
* org/omg/PortableServer/ServantRetentionPolicy.java,
* org/omg/PortableServer/ServantRetentionPolicyOperations.java,
* org/omg/PortableServer/ServantRetentionPolicyValue.java,
* org/omg/PortableServer/ThreadPolicy.java,
* org/omg/PortableServer/ThreadPolicyOperations.java,
* org/omg/PortableServer/ThreadPolicyValue.java,
* org/omg/PortableServer/_ServantActivatorStub.java,
* org/omg/PortableServer/_ServantLocatorStub.java,
* org/omg/PortableServer/portable/Delegate.java,
* org/omg/SendingContext/RunTime.java,
* org/omg/SendingContext/RunTimeOperations.java,
* sun/misc/Service.java,
* sun/misc/ServiceConfigurationError.java,
* sun/reflect/annotation/AnnotationInvocationHandler.java,
* sun/reflect/annotation/AnnotationParser.java,
* sun/reflect/annotation/AnnotationType.java,
* sun/reflect/annotation/EnumConstantNotPresentExceptionProxy.java,
* sun/reflect/annotation/ExceptionProxy.java,
* tools/com/sun/javadoc/ClassDoc.java,
* tools/com/sun/javadoc/ConstructorDoc.java,
* tools/com/sun/javadoc/Doc.java,
* tools/com/sun/javadoc/DocErrorReporter.java,
* tools/com/sun/javadoc/Doclet.java,
* tools/com/sun/javadoc/ExecutableMemberDoc.java,
* tools/com/sun/javadoc/FieldDoc.java,
* tools/com/sun/javadoc/MemberDoc.java,
* tools/com/sun/javadoc/MethodDoc.java,
* tools/com/sun/javadoc/PackageDoc.java,
* tools/com/sun/javadoc/ParamTag.java,
* tools/com/sun/javadoc/Parameter.java,
* tools/com/sun/javadoc/ProgramElementDoc.java,
* tools/com/sun/javadoc/RootDoc.java,
* tools/com/sun/javadoc/SeeTag.java,
* tools/com/sun/javadoc/SerialFieldTag.java,
* tools/com/sun/javadoc/Tag.java,
* tools/com/sun/javadoc/ThrowsTag.java,
* tools/com/sun/javadoc/Type.java,
* tools/com/sun/javadoc/TypeVariable.java,
* tools/com/sun/tools/javadoc/Main.java,
* tools/com/sun/tools/javah/Main.java,
* tools/external/asm/org/objectweb/asm/AnnotationVisitor.java,
* tools/external/asm/org/objectweb/asm/AnnotationWriter.java,
* tools/external/asm/org/objectweb/asm/Attribute.java,
* tools/external/asm/org/objectweb/asm/ByteVector.java,
* tools/external/asm/org/objectweb/asm/ClassAdapter.java,
* tools/external/asm/org/objectweb/asm/ClassReader.java,
* tools/external/asm/org/objectweb/asm/ClassVisitor.java,
* tools/external/asm/org/objectweb/asm/ClassWriter.java,
* tools/external/asm/org/objectweb/asm/Edge.java,
* tools/external/asm/org/objectweb/asm/FieldVisitor.java,
* tools/external/asm/org/objectweb/asm/FieldWriter.java,
* tools/external/asm/org/objectweb/asm/Handler.java,
* tools/external/asm/org/objectweb/asm/Item.java,
* tools/external/asm/org/objectweb/asm/Label.java,
* tools/external/asm/org/objectweb/asm/MethodAdapter.java,
* tools/external/asm/org/objectweb/asm/MethodVisitor.java,
* tools/external/asm/org/objectweb/asm/MethodWriter.java,
* tools/external/asm/org/objectweb/asm/Opcodes.java,
* tools/external/asm/org/objectweb/asm/Type.java,
* tools/external/asm/org/objectweb/asm/attrs/StackMapAttribute.java,
* tools/external/asm/org/objectweb/asm/attrs/StackMapFrame.java,
* tools/external/asm/org/objectweb/asm/attrs/StackMapTableAttribute.java,
* tools/external/asm/org/objectweb/asm/attrs/StackMapType.java,
* tools/external/asm/org/objectweb/asm/commons/AdviceAdapter.java,
* tools/external/asm/org/objectweb/asm/commons/EmptyVisitor.java,
* tools/external/asm/org/objectweb/asm/commons/GeneratorAdapter.java,
* tools/external/asm/org/objectweb/asm/commons/LocalVariablesSorter.java,
* tools/external/asm/org/objectweb/asm/commons/Method.java,
* tools/external/asm/org/objectweb/asm/commons/SerialVersionUIDAdder.java,
* tools/external/asm/org/objectweb/asm/commons/StaticInitMerger.java,
* tools/external/asm/org/objectweb/asm/commons/TableSwitchGenerator.java,
* tools/external/asm/org/objectweb/asm/optimizer/AnnotationConstantsCollector.java,
* tools/external/asm/org/objectweb/asm/optimizer/ClassConstantsCollector.java,
* tools/external/asm/org/objectweb/asm/optimizer/ClassOptimizer.java,
* tools/external/asm/org/objectweb/asm/optimizer/Constant.java,
* tools/external/asm/org/objectweb/asm/optimizer/ConstantPool.java,
* tools/external/asm/org/objectweb/asm/optimizer/FieldConstantsCollector.java,
* tools/external/asm/org/objectweb/asm/optimizer/JarOptimizer.java,
* tools/external/asm/org/objectweb/asm/optimizer/MethodConstantsCollector.java,
* tools/external/asm/org/objectweb/asm/optimizer/MethodOptimizer.java,
* tools/external/asm/org/objectweb/asm/optimizer/NameMapping.java,
* tools/external/asm/org/objectweb/asm/optimizer/Shrinker.java,
* tools/external/asm/org/objectweb/asm/signature/SignatureReader.java,
* tools/external/asm/org/objectweb/asm/signature/SignatureVisitor.java,
* tools/external/asm/org/objectweb/asm/signature/SignatureWriter.java,
* tools/external/asm/org/objectweb/asm/tree/AbstractInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/AnnotationNode.java,
* tools/external/asm/org/objectweb/asm/tree/ClassNode.java,
* tools/external/asm/org/objectweb/asm/tree/FieldInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/FieldNode.java,
* tools/external/asm/org/objectweb/asm/tree/IincInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/InnerClassNode.java,
* tools/external/asm/org/objectweb/asm/tree/InsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/IntInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/JumpInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/LabelNode.java,
* tools/external/asm/org/objectweb/asm/tree/LdcInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/LineNumberNode.java,
* tools/external/asm/org/objectweb/asm/tree/LocalVariableNode.java,
* tools/external/asm/org/objectweb/asm/tree/LookupSwitchInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/MemberNode.java,
* tools/external/asm/org/objectweb/asm/tree/MethodInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/MethodNode.java,
* tools/external/asm/org/objectweb/asm/tree/MultiANewArrayInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/TableSwitchInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/TryCatchBlockNode.java,
* tools/external/asm/org/objectweb/asm/tree/TypeInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/VarInsnNode.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/Analyzer.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/AnalyzerException.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/BasicInterpreter.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/BasicValue.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/BasicVerifier.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/DataflowInterpreter.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/DataflowValue.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/Frame.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/IntMap.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/Interpreter.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/SimpleVerifier.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/SmallSet.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/Subroutine.java,
* tools/external/asm/org/objectweb/asm/tree/analysis/Value.java,
* tools/external/asm/org/objectweb/asm/util/ASMifierAbstractVisitor.java,
* tools/external/asm/org/objectweb/asm/util/ASMifierAnnotationVisitor.java,
* tools/external/asm/org/objectweb/asm/util/ASMifierClassVisitor.java,
* tools/external/asm/org/objectweb/asm/util/ASMifierFieldVisitor.java,
* tools/external/asm/org/objectweb/asm/util/ASMifierMethodVisitor.java,
* tools/external/asm/org/objectweb/asm/util/AbstractVisitor.java,
* tools/external/asm/org/objectweb/asm/util/CheckAnnotationAdapter.java,
* tools/external/asm/org/objectweb/asm/util/CheckClassAdapter.java,
* tools/external/asm/org/objectweb/asm/util/CheckMethodAdapter.java,
* tools/external/asm/org/objectweb/asm/util/TraceAbstractVisitor.java,
* tools/external/asm/org/objectweb/asm/util/TraceAnnotationVisitor.java,
* tools/external/asm/org/objectweb/asm/util/TraceClassVisitor.java,
* tools/external/asm/org/objectweb/asm/util/TraceFieldVisitor.java,
* tools/external/asm/org/objectweb/asm/util/TraceMethodVisitor.java,
* tools/external/asm/org/objectweb/asm/util/TraceSignatureVisitor.java,
* tools/external/asm/org/objectweb/asm/util/attrs/ASMStackMapAttribute.java,
* tools/external/asm/org/objectweb/asm/util/attrs/ASMStackMapTableAttribute.java,
* tools/external/asm/org/objectweb/asm/util/attrs/ASMifiable.java,
* tools/external/asm/org/objectweb/asm/util/attrs/Traceable.java,
* tools/external/asm/org/objectweb/asm/xml/ASMContentHandler.java,
* tools/external/asm/org/objectweb/asm/xml/Processor.java,
* tools/external/asm/org/objectweb/asm/xml/SAXAdapter.java,
* tools/external/asm/org/objectweb/asm/xml/SAXAnnotationAdapter.java,
* tools/external/asm/org/objectweb/asm/xml/SAXClassAdapter.java,
* tools/external/asm/org/objectweb/asm/xml/SAXCodeAdapter.java,
* tools/external/asm/org/objectweb/asm/xml/SAXFieldAdapter.java,
* tools/generated/gnu/classpath/tools/gjdoc/expr/JavaLexer.java,
* tools/generated/gnu/classpath/tools/gjdoc/expr/JavaRecognizer.java,
* tools/generated/gnu/classpath/tools/gjdoc/expr/JavaTokenTypes.java,
* tools/gnu/classpath/tools/FileSystemClassLoader.java,
* tools/gnu/classpath/tools/IOToolkit.java,
* tools/gnu/classpath/tools/MalformedInputEvent.java,
* tools/gnu/classpath/tools/MalformedInputListener.java,
* tools/gnu/classpath/tools/NotifyingInputStreamReader.java,
* tools/gnu/classpath/tools/StringToolkit.java,
* tools/gnu/classpath/tools/appletviewer/AppletSecurityManager.java,
* tools/gnu/classpath/tools/appletviewer/AppletTag.java,
* tools/gnu/classpath/tools/appletviewer/CommonAppletContext.java,
* tools/gnu/classpath/tools/appletviewer/CommonAppletStub.java,
* tools/gnu/classpath/tools/appletviewer/Main.java,
* tools/gnu/classpath/tools/appletviewer/PluginAppletViewer.java,
* tools/gnu/classpath/tools/appletviewer/PluginAppletWindow.java,
* tools/gnu/classpath/tools/appletviewer/StandaloneAppletViewer.java,
* tools/gnu/classpath/tools/appletviewer/StandaloneAppletWindow.java,
* tools/gnu/classpath/tools/appletviewer/TagParser.java,
* tools/gnu/classpath/tools/common/CallbackUtil.java,
* tools/gnu/classpath/tools/common/ClasspathToolParser.java,
* tools/gnu/classpath/tools/common/Persistent.java,
* tools/gnu/classpath/tools/common/ProviderUtil.java,
* tools/gnu/classpath/tools/common/SecurityProviderInfo.java,
* tools/gnu/classpath/tools/doclets/AbstractDoclet.java,
* tools/gnu/classpath/tools/doclets/DocletConfigurationException.java,
* tools/gnu/classpath/tools/doclets/DocletOption.java,
* tools/gnu/classpath/tools/doclets/DocletOptionColonSeparated.java,
* tools/gnu/classpath/tools/doclets/DocletOptionFile.java,
* tools/gnu/classpath/tools/doclets/DocletOptionFlag.java,
* tools/gnu/classpath/tools/doclets/DocletOptionPackageWildcard.java,
* tools/gnu/classpath/tools/doclets/DocletOptionString.java,
* tools/gnu/classpath/tools/doclets/InlineTagRenderer.java,
* tools/gnu/classpath/tools/doclets/InvalidPackageWildcardException.java,
* tools/gnu/classpath/tools/doclets/PackageGroup.java,
* tools/gnu/classpath/tools/doclets/PackageMatcher.java,
* tools/gnu/classpath/tools/doclets/StandardTaglet.java,
* tools/gnu/classpath/tools/doclets/TagletPrinter.java,
* tools/gnu/classpath/tools/doclets/debugdoclet/DebugDoclet.java,
* tools/gnu/classpath/tools/doclets/htmldoclet/CssClass.java,
* tools/gnu/classpath/tools/doclets/htmldoclet/ExternalDocSet.java,
* tools/gnu/classpath/tools/doclets/htmldoclet/HtmlDoclet.java,
* tools/gnu/classpath/tools/doclets/htmldoclet/HtmlPage.java,
* tools/gnu/classpath/tools/doclets/htmldoclet/HtmlTagletContext.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/Driver.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/Driver1_4.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/HtmlRepairer.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/TargetContext.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/DocTranslet.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/DocTransletConfigurationException.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/DocTransletException.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/DocTransletOptions.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/JarClassLoader.java,
* tools/gnu/classpath/tools/doclets/xmldoclet/doctranslet/OutputFileInfo.java,
* tools/gnu/classpath/tools/getopt/FileArgumentCallback.java,
* tools/gnu/classpath/tools/getopt/Option.java,
* tools/gnu/classpath/tools/getopt/OptionGroup.java,
* tools/gnu/classpath/tools/getopt/Parser.java,
* tools/gnu/classpath/tools/gjdoc/AbstractTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/ArrayCharacterIterator.java,
* tools/gnu/classpath/tools/gjdoc/ClassDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/ClassDocProxy.java,
* tools/gnu/classpath/tools/gjdoc/ClassDocReflectedImpl.java,
* tools/gnu/classpath/tools/gjdoc/ConstructorDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/Debug.java,
* tools/gnu/classpath/tools/gjdoc/DirectoryTree.java,
* tools/gnu/classpath/tools/gjdoc/DocImpl.java,
* tools/gnu/classpath/tools/gjdoc/ErrorReporter.java,
* tools/gnu/classpath/tools/gjdoc/ExecutableMemberDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/FieldDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/GjdocPackageDoc.java,
* tools/gnu/classpath/tools/gjdoc/GjdocRootDoc.java,
* tools/gnu/classpath/tools/gjdoc/InheritDocTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/JavadocWrapper.java,
* tools/gnu/classpath/tools/gjdoc/LinkTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/Main.java,
* tools/gnu/classpath/tools/gjdoc/MemberDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/MethodDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/PackageDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/ParamTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/ParameterImpl.java,
* tools/gnu/classpath/tools/gjdoc/ParseException.java,
* tools/gnu/classpath/tools/gjdoc/Parser.java,
* tools/gnu/classpath/tools/gjdoc/ProgramElementDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/RootDocImpl.java,
* tools/gnu/classpath/tools/gjdoc/SeeTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/SerialFieldTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/SourcePositionImpl.java,
* tools/gnu/classpath/tools/gjdoc/TagContainer.java,
* tools/gnu/classpath/tools/gjdoc/TagImpl.java,
* tools/gnu/classpath/tools/gjdoc/TemporaryStore.java,
* tools/gnu/classpath/tools/gjdoc/TextTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/ThrowsTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/Timer.java,
* tools/gnu/classpath/tools/gjdoc/TimerDoclet.java,
* tools/gnu/classpath/tools/gjdoc/TypeImpl.java,
* tools/gnu/classpath/tools/gjdoc/TypeVariableImpl.java,
* tools/gnu/classpath/tools/gjdoc/ValueTagImpl.java,
* tools/gnu/classpath/tools/gjdoc/WritableType.java,
* tools/gnu/classpath/tools/gjdoc/expr/AdditionExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/AndExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryBitwiseExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryComputationExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryEqualityExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryLogicalExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryRelationExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BinaryShiftExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/BitShiftRightExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/CircularExpressionException.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConditionalExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantBoolean.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantByte.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantChar.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantDouble.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantFloat.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantInteger.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantLong.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantNull.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantShort.java,
* tools/gnu/classpath/tools/gjdoc/expr/ConstantString.java,
* tools/gnu/classpath/tools/gjdoc/expr/Context.java,
* tools/gnu/classpath/tools/gjdoc/expr/DivisionExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/EqualExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/Evaluator.java,
* tools/gnu/classpath/tools/gjdoc/expr/EvaluatorEnvironment.java,
* tools/gnu/classpath/tools/gjdoc/expr/ExclusiveOrExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/Expression.java,
* tools/gnu/classpath/tools/gjdoc/expr/GreaterThanExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/GreaterThanOrEqualExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/IdentifierExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/IllegalExpressionException.java,
* tools/gnu/classpath/tools/gjdoc/expr/InclusiveOrExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/LessThanExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/LessThanOrEqualExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/LogicalAndExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/LogicalNotExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/LogicalOrExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/ModuloExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/MultiplicationExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/NegateExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/NotEqualExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/NotExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/ShiftLeftExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/ShiftRightExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/SubtractionExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/Type.java,
* tools/gnu/classpath/tools/gjdoc/expr/TypeCastExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/UnaryExpression.java,
* tools/gnu/classpath/tools/gjdoc/expr/UnknownIdentifierException.java,
* tools/gnu/classpath/tools/jar/Creator.java,
* tools/gnu/classpath/tools/jar/Indexer.java,
* tools/gnu/classpath/tools/jar/Main.java,
* tools/gnu/classpath/tools/jar/Updater.java,
* tools/gnu/classpath/tools/jarsigner/JarVerifier.java,
* tools/gnu/classpath/tools/jarsigner/Main.java,
* tools/gnu/classpath/tools/jarsigner/SFHelper.java,
* tools/gnu/classpath/tools/java2xhtml/Java2xhtml.java,
* tools/gnu/classpath/tools/javah/ClassWrapper.java,
* tools/gnu/classpath/tools/javah/CniPrintStream.java,
* tools/gnu/classpath/tools/javah/GcjhMain.java,
* tools/gnu/classpath/tools/javah/JniHelper.java,
* tools/gnu/classpath/tools/javah/JniIncludePrinter.java,
* tools/gnu/classpath/tools/javah/JniStubPrinter.java,
* tools/gnu/classpath/tools/javah/Keywords.java,
* tools/gnu/classpath/tools/javah/Main.java,
* tools/gnu/classpath/tools/javah/MethodHelper.java,
* tools/gnu/classpath/tools/keytool/CACertCmd.java,
* tools/gnu/classpath/tools/keytool/CertReqCmd.java,
* tools/gnu/classpath/tools/keytool/Command.java,
* tools/gnu/classpath/tools/keytool/DeleteCmd.java,
* tools/gnu/classpath/tools/keytool/ExportCmd.java,
* tools/gnu/classpath/tools/keytool/GenKeyCmd.java,
* tools/gnu/classpath/tools/keytool/IdentityDBCmd.java,
* tools/gnu/classpath/tools/keytool/ImportCmd.java,
* tools/gnu/classpath/tools/keytool/KeyCloneCmd.java,
* tools/gnu/classpath/tools/keytool/KeyPasswdCmd.java,
* tools/gnu/classpath/tools/keytool/ListCmd.java,
* tools/gnu/classpath/tools/keytool/PrintCertCmd.java,
* tools/gnu/classpath/tools/keytool/SelfCertCmd.java,
* tools/gnu/classpath/tools/keytool/StorePasswdCmd.java,
* tools/gnu/classpath/tools/orbd/Main.java,
* tools/gnu/classpath/tools/orbd/PersistentContext.java,
* tools/gnu/classpath/tools/orbd/PersistentContextMap.java,
* tools/gnu/classpath/tools/orbd/PersistentMap.java,
* tools/gnu/classpath/tools/rmic/AbstractMethodGenerator.java,
* tools/gnu/classpath/tools/rmic/ClassRmicCompiler.java,
* tools/gnu/classpath/tools/rmic/CompilationError.java,
* tools/gnu/classpath/tools/rmic/Generator.java,
* tools/gnu/classpath/tools/rmic/GiopIo.java,
* tools/gnu/classpath/tools/rmic/HashFinder.java,
* tools/gnu/classpath/tools/rmic/Main.java,
* tools/gnu/classpath/tools/rmic/MethodGenerator.java,
* tools/gnu/classpath/tools/rmic/RMICException.java,
* tools/gnu/classpath/tools/rmic/RmiMethodGenerator.java,
* tools/gnu/classpath/tools/rmic/RmicBackend.java,
* tools/gnu/classpath/tools/rmic/SourceGiopRmicCompiler.java,
* tools/gnu/classpath/tools/rmic/SourceRmicCompiler.java,
* tools/gnu/classpath/tools/rmic/Variables.java,
* tools/gnu/classpath/tools/rmic/WrapUnWrapper.java,
* tools/gnu/classpath/tools/rmid/ActivationSystemImpl.java,
* tools/gnu/classpath/tools/rmid/ActivationSystemImpl_Stub.java,
* tools/gnu/classpath/tools/rmid/Main.java,
* tools/gnu/classpath/tools/rmid/PersistentBidiHashTable.java,
* tools/gnu/classpath/tools/rmiregistry/Main.java,
* tools/gnu/classpath/tools/rmiregistry/PersistentHashTable.java,
* tools/gnu/classpath/tools/rmiregistry/RegistryImpl.java,
* tools/gnu/classpath/tools/rmiregistry/RegistryImpl_Skel.java,
* tools/gnu/classpath/tools/rmiregistry/RegistryImpl_Stub.java,
* tools/gnu/classpath/tools/serialver/SerialVer.java,
* tools/gnu/classpath/tools/taglets/AuthorTaglet.java,
* tools/gnu/classpath/tools/taglets/CodeTaglet.java,
* tools/gnu/classpath/tools/taglets/CopyrightTaglet.java,
* tools/gnu/classpath/tools/taglets/DeprecatedTaglet.java,
* tools/gnu/classpath/tools/taglets/GenericTaglet.java,
* tools/gnu/classpath/tools/taglets/GnuExtendedTaglet.java,
* tools/gnu/classpath/tools/taglets/SinceTaglet.java,
* tools/gnu/classpath/tools/taglets/TagletContext.java,
* tools/gnu/classpath/tools/taglets/ValueTaglet.java,
* tools/gnu/classpath/tools/taglets/VersionTaglet.java,
* tools/gnu/classpath/tools/tnameserv/Main.java,
* vm/reference/gnu/classpath/jdwp/VMFrame.java,
* vm/reference/gnu/classpath/jdwp/VMIdManager.java,
* vm/reference/gnu/classpath/jdwp/VMMethod.java,
* vm/reference/gnu/classpath/jdwp/VMVirtualMachine.java,
* vm/reference/gnu/java/lang/VMCPStringBuilder.java,
* vm/reference/gnu/java/lang/VMInstrumentationImpl.java,
* vm/reference/gnu/java/lang/management/VMClassLoadingMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMCompilationMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMGarbageCollectorMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMMemoryMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMMemoryManagerMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMMemoryPoolMXBeanImpl.java,
* vm/reference/gnu/java/lang/management/VMThreadMXBeanImpl.java,
* vm/reference/gnu/java/net/VMPlainDatagramSocketImpl.java,
* vm/reference/gnu/java/net/VMPlainSocketImpl.java,
* vm/reference/gnu/java/nio/VMChannel.java,
* vm/reference/gnu/java/nio/VMPipe.java,
* vm/reference/gnu/java/nio/VMSelector.java,
* vm/reference/gnu/java/security/jce/prng/VMSecureRandom.java,
* vm/reference/java/io/VMFile.java,
* vm/reference/java/io/VMObjectInputStream.java,
* vm/reference/java/io/VMObjectStreamClass.java,
* vm/reference/java/lang/VMClass.java,
* vm/reference/java/lang/VMClassLoader.java,
* vm/reference/java/lang/VMDouble.java,
* vm/reference/java/lang/VMFloat.java,
* vm/reference/java/lang/VMMath.java,
* vm/reference/java/lang/VMObject.java,
* vm/reference/java/lang/VMProcess.java,
* vm/reference/java/lang/VMRuntime.java,
* vm/reference/java/lang/VMString.java,
* vm/reference/java/lang/VMSystem.java,
* vm/reference/java/lang/VMThread.java,
* vm/reference/java/lang/reflect/VMConstructor.java,
* vm/reference/java/lang/reflect/VMField.java,
* vm/reference/java/lang/reflect/VMMethod.java,
* vm/reference/java/net/VMNetworkInterface.java,
* vm/reference/java/nio/channels/VMChannels.java,
* vm/reference/java/security/VMAccessController.java,
* vm/reference/java/security/VMSecureRandom.java,
* vm/reference/java/util/VMTimeZone.java,
* vm/reference/sun/misc/Unsafe.java,
* vm/reference/sun/reflect/Reflection.java,
* vm/reference/sun/reflect/misc/ReflectUtil.java:
Normalise whitespace.
From-SVN: r168680
Diffstat (limited to 'libjava/classpath/external')
217 files changed, 9458 insertions, 9461 deletions
diff --git a/libjava/classpath/external/jsr166/java/util/ArrayDeque.java b/libjava/classpath/external/jsr166/java/util/ArrayDeque.java index c0ee16ea7b3..a4bc75c9939 100644 --- a/libjava/classpath/external/jsr166/java/util/ArrayDeque.java +++ b/libjava/classpath/external/jsr166/java/util/ArrayDeque.java @@ -479,11 +479,11 @@ public class ArrayDeque<E> extends AbstractCollection<E> } private void checkInvariants() { - assert elements[tail] == null; - assert head == tail ? elements[head] == null : - (elements[head] != null && - elements[(tail - 1) & (elements.length - 1)] != null); - assert elements[(head - 1) & (elements.length - 1)] == null; + assert elements[tail] == null; + assert head == tail ? elements[head] == null : + (elements[head] != null && + elements[(tail - 1) & (elements.length - 1)] != null); + assert elements[(head - 1) & (elements.length - 1)] == null; } /** @@ -497,42 +497,42 @@ public class ArrayDeque<E> extends AbstractCollection<E> * @return true if elements moved backwards */ private boolean delete(int i) { - checkInvariants(); - final E[] elements = this.elements; - final int mask = elements.length - 1; - final int h = head; - final int t = tail; - final int front = (i - h) & mask; - final int back = (t - i) & mask; - - // Invariant: head <= i < tail mod circularity - if (front >= ((t - h) & mask)) - throw new ConcurrentModificationException(); - - // Optimize for least element motion - if (front < back) { - if (h <= i) { - System.arraycopy(elements, h, elements, h + 1, front); - } else { // Wrap around - System.arraycopy(elements, 0, elements, 1, i); - elements[0] = elements[mask]; - System.arraycopy(elements, h, elements, h + 1, mask - h); - } - elements[h] = null; - head = (h + 1) & mask; - return false; - } else { - if (i < t) { // Copy the null tail as well - System.arraycopy(elements, i + 1, elements, i, back); - tail = t - 1; - } else { // Wrap around - System.arraycopy(elements, i + 1, elements, i, mask - i); - elements[mask] = elements[0]; - System.arraycopy(elements, 1, elements, 0, t); - tail = (t - 1) & mask; - } - return true; - } + checkInvariants(); + final E[] elements = this.elements; + final int mask = elements.length - 1; + final int h = head; + final int t = tail; + final int front = (i - h) & mask; + final int back = (t - i) & mask; + + // Invariant: head <= i < tail mod circularity + if (front >= ((t - h) & mask)) + throw new ConcurrentModificationException(); + + // Optimize for least element motion + if (front < back) { + if (h <= i) { + System.arraycopy(elements, h, elements, h + 1, front); + } else { // Wrap around + System.arraycopy(elements, 0, elements, 1, i); + elements[0] = elements[mask]; + System.arraycopy(elements, h, elements, h + 1, mask - h); + } + elements[h] = null; + head = (h + 1) & mask; + return false; + } else { + if (i < t) { // Copy the null tail as well + System.arraycopy(elements, i + 1, elements, i, back); + tail = t - 1; + } else { // Wrap around + System.arraycopy(elements, i + 1, elements, i, mask - i); + elements[mask] = elements[0]; + System.arraycopy(elements, 1, elements, 0, t); + tail = (t - 1) & mask; + } + return true; + } } // *** Collection Methods *** @@ -611,8 +611,8 @@ public class ArrayDeque<E> extends AbstractCollection<E> throw new IllegalStateException(); if (delete(lastRet)) { // if left-shifted, undo increment in next() cursor = (cursor - 1) & (elements.length - 1); - fence = tail; - } + fence = tail; + } lastRet = -1; } } @@ -635,7 +635,7 @@ public class ArrayDeque<E> extends AbstractCollection<E> if (cursor == fence) throw new NoSuchElementException(); cursor = (cursor - 1) & (elements.length - 1); - E result = elements[cursor]; + E result = elements[cursor]; if (head != fence || result == null) throw new ConcurrentModificationException(); lastRet = cursor; @@ -647,8 +647,8 @@ public class ArrayDeque<E> extends AbstractCollection<E> throw new IllegalStateException(); if (!delete(lastRet)) { cursor = (cursor + 1) & (elements.length - 1); - fence = head; - } + fence = head; + } lastRet = -1; } } @@ -724,7 +724,7 @@ public class ArrayDeque<E> extends AbstractCollection<E> * @return an array containing all of the elements in this deque */ public Object[] toArray() { - return copyElements(new Object[size()]); + return copyElements(new Object[size()]); } /** @@ -769,7 +769,7 @@ public class ArrayDeque<E> extends AbstractCollection<E> if (a.length < size) a = (T[])java.lang.reflect.Array.newInstance( a.getClass().getComponentType(), size); - copyElements(a); + copyElements(a); if (a.length > size) a[size] = null; return a; diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ArrayBlockingQueue.java b/libjava/classpath/external/jsr166/java/util/concurrent/ArrayBlockingQueue.java index bdf34d28a20..3ce9ed85902 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ArrayBlockingQueue.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ArrayBlockingQueue.java @@ -205,7 +205,7 @@ public class ArrayBlockingQueue<E> extends AbstractQueue<E> * @throws NullPointerException if the specified element is null */ public boolean add(E e) { - return super.add(e); + return super.add(e); } /** @@ -271,7 +271,7 @@ public class ArrayBlockingQueue<E> extends AbstractQueue<E> throws InterruptedException { if (e == null) throw new NullPointerException(); - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); final ReentrantLock lock = this.lock; lock.lockInterruptibly(); try { @@ -326,7 +326,7 @@ public class ArrayBlockingQueue<E> extends AbstractQueue<E> } public E poll(long timeout, TimeUnit unit) throws InterruptedException { - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); final ReentrantLock lock = this.lock; lock.lockInterruptibly(); try { diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentHashMap.java b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentHashMap.java index 7f6d4493c06..9ad9ab25bad 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentHashMap.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentHashMap.java @@ -196,10 +196,10 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> this.value = value; } - @SuppressWarnings("unchecked") - static final <K,V> HashEntry<K,V>[] newArray(int i) { - return new HashEntry[i]; - } + @SuppressWarnings("unchecked") + static final <K,V> HashEntry<K,V>[] newArray(int i) { + return new HashEntry[i]; + } } /** @@ -287,9 +287,9 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> setTable(HashEntry.<K,V>newArray(initialCapacity)); } - @SuppressWarnings("unchecked") + @SuppressWarnings("unchecked") static final <K,V> Segment<K,V>[] newArray(int i) { - return new Segment[i]; + return new Segment[i]; } /** @@ -775,7 +775,7 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> * @throws NullPointerException if the specified key is null */ public boolean containsKey(Object key) { - int hash = hash(key.hashCode()); + int hash = hash(key.hashCode()); return segmentFor(hash).containsKey(key, hash); } @@ -915,7 +915,7 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> * @throws NullPointerException if the specified key is null */ public V remove(Object key) { - int hash = hash(key.hashCode()); + int hash = hash(key.hashCode()); return segmentFor(hash).remove(key, hash, null); } @@ -1107,16 +1107,16 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> } final class KeyIterator - extends HashIterator - implements Iterator<K>, Enumeration<K> + extends HashIterator + implements Iterator<K>, Enumeration<K> { public K next() { return super.nextEntry().key; } public K nextElement() { return super.nextEntry().key; } } final class ValueIterator - extends HashIterator - implements Iterator<V>, Enumeration<V> + extends HashIterator + implements Iterator<V>, Enumeration<V> { public V next() { return super.nextEntry().value; } public V nextElement() { return super.nextEntry().value; } @@ -1127,7 +1127,7 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> * setValue changes to the underlying map. */ final class WriteThroughEntry - extends AbstractMap.SimpleEntry<K,V> + extends AbstractMap.SimpleEntry<K,V> { WriteThroughEntry(K k, V v) { super(k,v); @@ -1142,7 +1142,7 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> * removed in which case the put will re-establish). We do not * and cannot guarantee more. */ - public V setValue(V value) { + public V setValue(V value) { if (value == null) throw new NullPointerException(); V v = super.setValue(value); ConcurrentHashMap.this.put(getKey(), value); @@ -1151,8 +1151,8 @@ public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> } final class EntryIterator - extends HashIterator - implements Iterator<Entry<K,V>> + extends HashIterator + implements Iterator<Entry<K,V>> { public Map.Entry<K,V> next() { HashEntry<K,V> e = super.nextEntry(); diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListMap.java b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListMap.java index bbb00a0f0a0..1ad9244548d 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListMap.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListMap.java @@ -1175,7 +1175,7 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> findFirst(); // retry clearIndexToFirst(); return new AbstractMap.SimpleImmutableEntry<K,V>(n.key, (V)v); - } + } } /** @@ -1852,19 +1852,19 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> * @return <tt>true</tt> if the specified object is equal to this map */ public boolean equals(Object o) { - if (o == this) - return true; - if (!(o instanceof Map)) - return false; - Map<?,?> m = (Map<?,?>) o; + if (o == this) + return true; + if (!(o instanceof Map)) + return false; + Map<?,?> m = (Map<?,?>) o; try { - for (Map.Entry<K,V> e : this.entrySet()) - if (! e.getValue().equals(m.get(e.getKey()))) + for (Map.Entry<K,V> e : this.entrySet()) + if (! e.getValue().equals(m.get(e.getKey()))) return false; - for (Map.Entry<?,?> e : m.entrySet()) { + for (Map.Entry<?,?> e : m.entrySet()) { Object k = e.getKey(); Object v = e.getValue(); - if (k == null || v == null || !v.equals(get(k))) + if (k == null || v == null || !v.equals(get(k))) return false; } return true; @@ -2208,20 +2208,20 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> Node<K,V> lastReturned; /** the next node to return from next(); */ Node<K,V> next; - /** Cache of next value field to maintain weak consistency */ - V nextValue; + /** Cache of next value field to maintain weak consistency */ + V nextValue; /** Initializes ascending iterator for entire range. */ Iter() { for (;;) { - next = findFirst(); + next = findFirst(); if (next == null) break; Object x = next.value; if (x != null && x != next) { - nextValue = (V) x; + nextValue = (V) x; break; - } + } } } @@ -2234,14 +2234,14 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> if ((lastReturned = next) == null) throw new NoSuchElementException(); for (;;) { - next = next.next; + next = next.next; if (next == null) break; Object x = next.value; if (x != null && x != next) { - nextValue = (V) x; + nextValue = (V) x; break; - } + } } } @@ -2252,7 +2252,7 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> // It would not be worth all of the overhead to directly // unlink from here. Using remove is fast enough. ConcurrentSkipListMap.this.remove(l.key); - lastReturned = null; + lastReturned = null; } } @@ -2305,11 +2305,11 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> */ static final <E> List<E> toList(Collection<E> c) { - // Using size() here would be a pessimization. - List<E> list = new ArrayList<E>(); - for (E e : c) - list.add(e); - return list; + // Using size() here would be a pessimization. + List<E> list = new ArrayList<E>(); + for (E e : c) + list.add(e); + return list; } static final class KeySet<E> extends AbstractSet<E> implements NavigableSet<E> { @@ -2355,8 +2355,8 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> return false; } } - public Object[] toArray() { return toList(this).toArray(); } - public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } + public Object[] toArray() { return toList(this).toArray(); } + public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } public Iterator<E> descendingIterator() { return descendingSet().iterator(); } @@ -2411,8 +2411,8 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> public void clear() { m.clear(); } - public Object[] toArray() { return toList(this).toArray(); } - public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } + public Object[] toArray() { return toList(this).toArray(); } + public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } } static final class EntrySet<K1,V1> extends AbstractSet<Map.Entry<K1,V1>> { @@ -2465,8 +2465,8 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> return false; } } - public Object[] toArray() { return toList(this).toArray(); } - public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } + public Object[] toArray() { return toList(this).toArray(); } + public <T> T[] toArray(T[] a) { return toList(this).toArray(a); } } /** @@ -2820,10 +2820,10 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> public Comparator<? super K> comparator() { Comparator<? super K> cmp = m.comparator(); - if (isDescending) - return Collections.reverseOrder(cmp); - else - return cmp; + if (isDescending) + return Collections.reverseOrder(cmp); + else + return cmp; } /** @@ -3020,12 +3020,12 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> next = isDescending ? hiNode() : loNode(); if (next == null) break; - Object x = next.value; + Object x = next.value; if (x != null && x != next) { - if (! inBounds(next.key)) + if (! inBounds(next.key)) next = null; - else - nextValue = (V) x; + else + nextValue = (V) x; break; } } @@ -3049,12 +3049,12 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> next = next.next; if (next == null) break; - Object x = next.value; + Object x = next.value; if (x != null && x != next) { if (tooHigh(next.key)) next = null; else - nextValue = (V) x; + nextValue = (V) x; break; } } @@ -3065,11 +3065,11 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> next = m.findNear(lastReturned.key, LT); if (next == null) break; - Object x = next.value; + Object x = next.value; if (x != null && x != next) { if (tooLow(next.key)) next = null; - else + else nextValue = (V) x; break; } @@ -3081,7 +3081,7 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> if (l == null) throw new IllegalStateException(); m.remove(l.key); - lastReturned = null; + lastReturned = null; } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListSet.java b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListSet.java index 7da50d593ae..7fd1c7608a0 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListSet.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ConcurrentSkipListSet.java @@ -128,12 +128,12 @@ public class ConcurrentSkipListSet<E> */ public ConcurrentSkipListSet<E> clone() { ConcurrentSkipListSet<E> clone = null; - try { - clone = (ConcurrentSkipListSet<E>) super.clone(); + try { + clone = (ConcurrentSkipListSet<E>) super.clone(); clone.setMap(new ConcurrentSkipListMap(m)); - } catch (CloneNotSupportedException e) { - throw new InternalError(); - } + } catch (CloneNotSupportedException e) { + throw new InternalError(); + } return clone; } @@ -157,7 +157,7 @@ public class ConcurrentSkipListSet<E> * @return the number of elements in this set */ public int size() { - return m.size(); + return m.size(); } /** @@ -165,7 +165,7 @@ public class ConcurrentSkipListSet<E> * @return <tt>true</tt> if this set contains no elements */ public boolean isEmpty() { - return m.isEmpty(); + return m.isEmpty(); } /** @@ -180,7 +180,7 @@ public class ConcurrentSkipListSet<E> * @throws NullPointerException if the specified element is null */ public boolean contains(Object o) { - return m.containsKey(o); + return m.containsKey(o); } /** @@ -198,7 +198,7 @@ public class ConcurrentSkipListSet<E> * @throws NullPointerException if the specified element is null */ public boolean add(E e) { - return m.putIfAbsent(e, Boolean.TRUE) == null; + return m.putIfAbsent(e, Boolean.TRUE) == null; } /** @@ -216,14 +216,14 @@ public class ConcurrentSkipListSet<E> * @throws NullPointerException if the specified element is null */ public boolean remove(Object o) { - return m.remove(o, Boolean.TRUE); + return m.remove(o, Boolean.TRUE); } /** * Removes all of the elements from this set. */ public void clear() { - m.clear(); + m.clear(); } /** @@ -241,7 +241,7 @@ public class ConcurrentSkipListSet<E> * @return an iterator over the elements in this set in descending order */ public Iterator<E> descendingIterator() { - return m.descendingKeySet().iterator(); + return m.descendingKeySet().iterator(); } @@ -261,11 +261,11 @@ public class ConcurrentSkipListSet<E> */ public boolean equals(Object o) { // Override AbstractSet version to avoid calling size() - if (o == this) - return true; - if (!(o instanceof Set)) - return false; - Collection<?> c = (Collection<?>) o; + if (o == this) + return true; + if (!(o instanceof Set)) + return false; + Collection<?> c = (Collection<?>) o; try { return containsAll(c) && c.containsAll(this); } catch (ClassCastException unused) { @@ -373,7 +373,7 @@ public class ConcurrentSkipListSet<E> boolean fromInclusive, E toElement, boolean toInclusive) { - return new ConcurrentSkipListSet<E> + return new ConcurrentSkipListSet<E> (m.subMap(fromElement, fromInclusive, toElement, toInclusive)); } @@ -384,7 +384,7 @@ public class ConcurrentSkipListSet<E> * @throws IllegalArgumentException {@inheritDoc} */ public NavigableSet<E> headSet(E toElement, boolean inclusive) { - return new ConcurrentSkipListSet<E>(m.headMap(toElement, inclusive)); + return new ConcurrentSkipListSet<E>(m.headMap(toElement, inclusive)); } /** @@ -393,7 +393,7 @@ public class ConcurrentSkipListSet<E> * @throws IllegalArgumentException {@inheritDoc} */ public NavigableSet<E> tailSet(E fromElement, boolean inclusive) { - return new ConcurrentSkipListSet<E>(m.tailMap(fromElement, inclusive)); + return new ConcurrentSkipListSet<E>(m.tailMap(fromElement, inclusive)); } /** @@ -403,7 +403,7 @@ public class ConcurrentSkipListSet<E> * @throws IllegalArgumentException {@inheritDoc} */ public NavigableSet<E> subSet(E fromElement, E toElement) { - return subSet(fromElement, true, toElement, false); + return subSet(fromElement, true, toElement, false); } /** @@ -412,7 +412,7 @@ public class ConcurrentSkipListSet<E> * @throws IllegalArgumentException {@inheritDoc} */ public NavigableSet<E> headSet(E toElement) { - return headSet(toElement, false); + return headSet(toElement, false); } /** @@ -421,7 +421,7 @@ public class ConcurrentSkipListSet<E> * @throws IllegalArgumentException {@inheritDoc} */ public NavigableSet<E> tailSet(E fromElement) { - return tailSet(fromElement, true); + return tailSet(fromElement, true); } /** @@ -437,7 +437,7 @@ public class ConcurrentSkipListSet<E> * @return a reverse order view of this set */ public NavigableSet<E> descendingSet() { - return new ConcurrentSkipListSet(m.descendingMap()); + return new ConcurrentSkipListSet(m.descendingMap()); } // Support for resetting map in clone diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/CopyOnWriteArraySet.java b/libjava/classpath/external/jsr166/java/util/concurrent/CopyOnWriteArraySet.java index 39c0e5868de..063636bd81e 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/CopyOnWriteArraySet.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/CopyOnWriteArraySet.java @@ -89,7 +89,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return the number of elements in this set */ public int size() { - return al.size(); + return al.size(); } /** @@ -98,7 +98,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return <tt>true</tt> if this set contains no elements */ public boolean isEmpty() { - return al.isEmpty(); + return al.isEmpty(); } /** @@ -111,7 +111,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return <tt>true</tt> if this set contains the specified element */ public boolean contains(Object o) { - return al.contains(o); + return al.contains(o); } /** @@ -131,7 +131,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return an array containing all the elements in this set */ public Object[] toArray() { - return al.toArray(); + return al.toArray(); } /** @@ -177,7 +177,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @throws NullPointerException if the specified array is null */ public <T> T[] toArray(T[] a) { - return al.toArray(a); + return al.toArray(a); } /** @@ -201,7 +201,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return <tt>true</tt> if this set contained the specified element */ public boolean remove(Object o) { - return al.remove(o); + return al.remove(o); } /** @@ -217,7 +217,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * element */ public boolean add(E e) { - return al.addIfAbsent(e); + return al.addIfAbsent(e); } /** @@ -227,12 +227,12 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * * @param c collection to be checked for containment in this set * @return <tt>true</tt> if this set contains all of the elements of the - * specified collection + * specified collection * @throws NullPointerException if the specified collection is null * @see #contains(Object) */ public boolean containsAll(Collection<?> c) { - return al.containsAll(c); + return al.containsAll(c); } /** @@ -249,7 +249,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @see #add(Object) */ public boolean addAll(Collection<? extends E> c) { - return al.addAllAbsent(c) > 0; + return al.addAllAbsent(c) > 0; } /** @@ -268,7 +268,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @see #remove(Object) */ public boolean removeAll(Collection<?> c) { - return al.removeAll(c); + return al.removeAll(c); } /** @@ -289,7 +289,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @see #remove(Object) */ public boolean retainAll(Collection<?> c) { - return al.retainAll(c); + return al.retainAll(c); } /** @@ -304,7 +304,7 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> * @return an iterator over the elements in this set */ public Iterator<E> iterator() { - return al.iterator(); + return al.iterator(); } /** @@ -329,14 +329,14 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> if (!(o instanceof Set)) return false; Set<?> set = (Set<?>)(o); - Iterator<?> it = set.iterator(); + Iterator<?> it = set.iterator(); // Uses O(n^2) algorithm that is only appropriate // for small sets, which CopyOnWriteArraySets should be. // Use a single snapshot of underlying array - Object[] elements = al.getArray(); - int len = elements.length; + Object[] elements = al.getArray(); + int len = elements.length; // Mark matched elements to avoid re-checking boolean[] matched = new boolean[len]; int k = 0; @@ -347,10 +347,10 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E> for (int i = 0; i < len; ++i) { if (!matched[i] && eq(x, elements[i])) { matched[i] = true; - continue outer; + continue outer; } } - return false; + return false; } return k == len; } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/CyclicBarrier.java b/libjava/classpath/external/jsr166/java/util/concurrent/CyclicBarrier.java index e72577537d4..d5738c5ae8b 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/CyclicBarrier.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/CyclicBarrier.java @@ -152,7 +152,7 @@ public class CyclicBarrier { */ private void breakBarrier() { generation.broken = true; - count = parties; + count = parties; trip.signalAll(); } @@ -179,7 +179,7 @@ public class CyclicBarrier { if (index == 0) { // tripped boolean ranAction = false; try { - final Runnable command = barrierCommand; + final Runnable command = barrierCommand; if (command != null) command.run(); ranAction = true; @@ -201,13 +201,13 @@ public class CyclicBarrier { } catch (InterruptedException ie) { if (g == generation && ! g.broken) { breakBarrier(); - throw ie; - } else { - // We're about to finish waiting even if we had not - // been interrupted, so this interrupt is deemed to - // "belong" to subsequent execution. - Thread.currentThread().interrupt(); - } + throw ie; + } else { + // We're about to finish waiting even if we had not + // been interrupted, so this interrupt is deemed to + // "belong" to subsequent execution. + Thread.currentThread().interrupt(); + } } if (g.broken) diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/DelayQueue.java b/libjava/classpath/external/jsr166/java/util/concurrent/DelayQueue.java index 8b839878c3a..4ce7bc65217 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/DelayQueue.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/DelayQueue.java @@ -444,8 +444,8 @@ public class DelayQueue<E extends Delayed> extends AbstractQueue<E> */ private class Itr implements Iterator<E> { final Object[] array; // Array of all elements - int cursor; // index of next element to return; - int lastRet; // index of last element, or -1 if no such + int cursor; // index of next element to return; + int lastRet; // index of last element, or -1 if no such Itr(Object[] array) { lastRet = -1; @@ -465,7 +465,7 @@ public class DelayQueue<E extends Delayed> extends AbstractQueue<E> public void remove() { if (lastRet < 0) - throw new IllegalStateException(); + throw new IllegalStateException(); Object x = array[lastRet]; lastRet = -1; // Traverse underlying queue to find == element, diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/Executors.java b/libjava/classpath/external/jsr166/java/util/concurrent/Executors.java index f44e66160f7..18e6b33cc9f 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/Executors.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/Executors.java @@ -362,7 +362,7 @@ public class Executors { if (action == null) throw new NullPointerException(); return new Callable<Object>() { - public Object call() { return action.run(); }}; + public Object call() { return action.run(); }}; } /** @@ -376,8 +376,8 @@ public class Executors { public static Callable<Object> callable(final PrivilegedExceptionAction<?> action) { if (action == null) throw new NullPointerException(); - return new Callable<Object>() { - public Object call() throws Exception { return action.run(); }}; + return new Callable<Object>() { + public Object call() throws Exception { return action.run(); }}; } /** @@ -625,13 +625,13 @@ public class Executors { } static class FinalizableDelegatedExecutorService - extends DelegatedExecutorService { - FinalizableDelegatedExecutorService(ExecutorService executor) { - super(executor); - } - protected void finalize() { - super.shutdown(); - } + extends DelegatedExecutorService { + FinalizableDelegatedExecutorService(ExecutorService executor) { + super(executor); + } + protected void finalize() { + super.shutdown(); + } } /** diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/FutureTask.java b/libjava/classpath/external/jsr166/java/util/concurrent/FutureTask.java index bbe49d7aed0..94742405dec 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/FutureTask.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/FutureTask.java @@ -233,59 +233,59 @@ public class FutureTask<V> implements RunnableFuture<V> { } void innerSet(V v) { - for (;;) { - int s = getState(); - if (s == RAN) - return; + for (;;) { + int s = getState(); + if (s == RAN) + return; if (s == CANCELLED) { - // aggressively release to set runner to null, - // in case we are racing with a cancel request - // that will try to interrupt runner + // aggressively release to set runner to null, + // in case we are racing with a cancel request + // that will try to interrupt runner releaseShared(0); return; } - if (compareAndSetState(s, RAN)) { + if (compareAndSetState(s, RAN)) { result = v; releaseShared(0); done(); - return; + return; } } } void innerSetException(Throwable t) { - for (;;) { - int s = getState(); - if (s == RAN) - return; + for (;;) { + int s = getState(); + if (s == RAN) + return; if (s == CANCELLED) { - // aggressively release to set runner to null, - // in case we are racing with a cancel request - // that will try to interrupt runner + // aggressively release to set runner to null, + // in case we are racing with a cancel request + // that will try to interrupt runner releaseShared(0); return; } - if (compareAndSetState(s, RAN)) { + if (compareAndSetState(s, RAN)) { exception = t; result = null; releaseShared(0); done(); - return; + return; } - } + } } boolean innerCancel(boolean mayInterruptIfRunning) { - for (;;) { - int s = getState(); - if (ranOrCancelled(s)) - return false; - if (compareAndSetState(s, CANCELLED)) - break; - } + for (;;) { + int s = getState(); + if (ranOrCancelled(s)) + return false; + if (compareAndSetState(s, CANCELLED)) + break; + } if (mayInterruptIfRunning) { Thread r = runner; - if (r != null) + if (r != null) r.interrupt(); } releaseShared(0); diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingDeque.java b/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingDeque.java index 91acccfbe8c..2dc8fa8774a 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingDeque.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingDeque.java @@ -57,7 +57,7 @@ public class LinkedBlockingDeque<E> /** Doubly-linked list node class */ static final class Node<E> { - E item; + E item; Node<E> prev; Node<E> next; Node(E x, Node<E> p, Node<E> n) { @@ -299,7 +299,7 @@ public class LinkedBlockingDeque<E> public boolean offerFirst(E e, long timeout, TimeUnit unit) throws InterruptedException { if (e == null) throw new NullPointerException(); - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); lock.lockInterruptibly(); try { for (;;) { @@ -321,7 +321,7 @@ public class LinkedBlockingDeque<E> public boolean offerLast(E e, long timeout, TimeUnit unit) throws InterruptedException { if (e == null) throw new NullPointerException(); - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); lock.lockInterruptibly(); try { for (;;) { @@ -398,7 +398,7 @@ public class LinkedBlockingDeque<E> public E pollFirst(long timeout, TimeUnit unit) throws InterruptedException { - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); lock.lockInterruptibly(); try { for (;;) { @@ -416,7 +416,7 @@ public class LinkedBlockingDeque<E> public E pollLast(long timeout, TimeUnit unit) throws InterruptedException { - long nanos = unit.toNanos(timeout); + long nanos = unit.toNanos(timeout); lock.lockInterruptibly(); try { for (;;) { @@ -514,15 +514,15 @@ public class LinkedBlockingDeque<E> * @throws NullPointerException if the specified element is null */ public boolean add(E e) { - addLast(e); - return true; + addLast(e); + return true; } /** * @throws NullPointerException if the specified element is null */ public boolean offer(E e) { - return offerLast(e); + return offerLast(e); } /** @@ -530,7 +530,7 @@ public class LinkedBlockingDeque<E> * @throws InterruptedException {@inheritDoc} */ public void put(E e) throws InterruptedException { - putLast(e); + putLast(e); } /** @@ -539,7 +539,7 @@ public class LinkedBlockingDeque<E> */ public boolean offer(E e, long timeout, TimeUnit unit) throws InterruptedException { - return offerLast(e, timeout, unit); + return offerLast(e, timeout, unit); } /** @@ -553,19 +553,19 @@ public class LinkedBlockingDeque<E> * @throws NoSuchElementException if this deque is empty */ public E remove() { - return removeFirst(); + return removeFirst(); } public E poll() { - return pollFirst(); + return pollFirst(); } public E take() throws InterruptedException { - return takeFirst(); + return takeFirst(); } public E poll(long timeout, TimeUnit unit) throws InterruptedException { - return pollFirst(timeout, unit); + return pollFirst(timeout, unit); } /** @@ -579,11 +579,11 @@ public class LinkedBlockingDeque<E> * @throws NoSuchElementException if this deque is empty */ public E element() { - return getFirst(); + return getFirst(); } public E peek() { - return peekFirst(); + return peekFirst(); } /** @@ -668,14 +668,14 @@ public class LinkedBlockingDeque<E> * @throws NullPointerException {@inheritDoc} */ public void push(E e) { - addFirst(e); + addFirst(e); } /** * @throws NoSuchElementException {@inheritDoc} */ public E pop() { - return removeFirst(); + return removeFirst(); } // Collection methods @@ -695,7 +695,7 @@ public class LinkedBlockingDeque<E> * @return <tt>true</tt> if this deque changed as a result of the call */ public boolean remove(Object o) { - return removeFirstOccurrence(o); + return removeFirstOccurrence(o); } /** diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingQueue.java b/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingQueue.java index 3dedee56da0..62018096a50 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingQueue.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/LinkedBlockingQueue.java @@ -584,8 +584,8 @@ public class LinkedBlockingQueue<E> extends AbstractQueue<E> fullyLock(); try { head.next = null; - assert head.item == null; - last = head; + assert head.item == null; + last = head; if (count.getAndSet(0) == capacity) notFull.signalAll(); } finally { @@ -609,8 +609,8 @@ public class LinkedBlockingQueue<E> extends AbstractQueue<E> try { first = head.next; head.next = null; - assert head.item == null; - last = head; + assert head.item == null; + last = head; if (count.getAndSet(0) == capacity) notFull.signalAll(); } finally { @@ -649,9 +649,9 @@ public class LinkedBlockingQueue<E> extends AbstractQueue<E> } if (n != 0) { head.next = p; - assert head.item == null; - if (p == null) - last = head; + assert head.item == null; + if (p == null) + last = head; if (count.getAndAdd(-n) == capacity) notFull.signalAll(); } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/PriorityBlockingQueue.java b/libjava/classpath/external/jsr166/java/util/concurrent/PriorityBlockingQueue.java index 91ae61b631f..9466aa477a8 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/PriorityBlockingQueue.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/PriorityBlockingQueue.java @@ -503,8 +503,8 @@ public class PriorityBlockingQueue<E> extends AbstractQueue<E> */ private class Itr implements Iterator<E> { final Object[] array; // Array of all elements - int cursor; // index of next element to return; - int lastRet; // index of last element, or -1 if no such + int cursor; // index of next element to return; + int lastRet; // index of last element, or -1 if no such Itr(Object[] array) { lastRet = -1; @@ -524,7 +524,7 @@ public class PriorityBlockingQueue<E> extends AbstractQueue<E> public void remove() { if (lastRet < 0) - throw new IllegalStateException(); + throw new IllegalStateException(); Object x = array[lastRet]; lastRet = -1; // Traverse underlying queue to find == element, diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledExecutorService.java b/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledExecutorService.java index 976537ef5d6..c170c4a52d2 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledExecutorService.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledExecutorService.java @@ -82,7 +82,7 @@ public interface ScheduledExecutorService extends ExecutorService { * @throws NullPointerException if command is null */ public ScheduledFuture<?> schedule(Runnable command, - long delay, TimeUnit unit); + long delay, TimeUnit unit); /** * Creates and executes a ScheduledFuture that becomes enabled after the @@ -97,7 +97,7 @@ public interface ScheduledExecutorService extends ExecutorService { * @throws NullPointerException if callable is null */ public <V> ScheduledFuture<V> schedule(Callable<V> callable, - long delay, TimeUnit unit); + long delay, TimeUnit unit); /** * Creates and executes a periodic action that becomes enabled first @@ -125,9 +125,9 @@ public interface ScheduledExecutorService extends ExecutorService { * @throws IllegalArgumentException if period less than or equal to zero */ public ScheduledFuture<?> scheduleAtFixedRate(Runnable command, - long initialDelay, - long period, - TimeUnit unit); + long initialDelay, + long period, + TimeUnit unit); /** * Creates and executes a periodic action that becomes enabled first @@ -152,8 +152,8 @@ public interface ScheduledExecutorService extends ExecutorService { * @throws IllegalArgumentException if delay less than or equal to zero */ public ScheduledFuture<?> scheduleWithFixedDelay(Runnable command, - long initialDelay, - long delay, - TimeUnit unit); + long initialDelay, + long delay, + TimeUnit unit); } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledThreadPoolExecutor.java b/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledThreadPoolExecutor.java index d4da334c6e0..f08b9ac2eed 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledThreadPoolExecutor.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ScheduledThreadPoolExecutor.java @@ -587,11 +587,11 @@ public class ScheduledThreadPoolExecutor } public boolean add(Runnable x) { - return dq.add((RunnableScheduledFuture)x); - } + return dq.add((RunnableScheduledFuture)x); + } public boolean offer(Runnable x) { - return dq.offer((RunnableScheduledFuture)x); - } + return dq.offer((RunnableScheduledFuture)x); + } public void put(Runnable x) { dq.put((RunnableScheduledFuture)x); } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/Semaphore.java b/libjava/classpath/external/jsr166/java/util/concurrent/Semaphore.java index 94e9746ae85..10523643909 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/Semaphore.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/Semaphore.java @@ -614,7 +614,7 @@ public class Semaphore implements java.io.Serializable { * @throws IllegalArgumentException if {@code reduction} is negative */ protected void reducePermits(int reduction) { - if (reduction < 0) throw new IllegalArgumentException(); + if (reduction < 0) throw new IllegalArgumentException(); sync.reducePermits(reduction); } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/SynchronousQueue.java b/libjava/classpath/external/jsr166/java/util/concurrent/SynchronousQueue.java index e47e0401cfe..92f586ce8e5 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/SynchronousQueue.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/SynchronousQueue.java @@ -737,11 +737,11 @@ public class SynchronousQueue<E> extends AbstractQueue<E> advanceHead(h, hn); continue; } - QNode t = tail; // Ensure consistent read for tail + QNode t = tail; // Ensure consistent read for tail if (t == h) return; - QNode tn = t.next; - if (t != tail) + QNode tn = t.next; + if (t != tail) continue; if (tn != null) { advanceTail(t, tn); @@ -808,9 +808,9 @@ public class SynchronousQueue<E> extends AbstractQueue<E> public void put(E o) throws InterruptedException { if (o == null) throw new NullPointerException(); if (transferer.transfer(o, false, 0) == null) { - Thread.interrupted(); + Thread.interrupted(); throw new InterruptedException(); - } + } } /** @@ -857,7 +857,7 @@ public class SynchronousQueue<E> extends AbstractQueue<E> Object e = transferer.transfer(null, false, 0); if (e != null) return (E)e; - Thread.interrupted(); + Thread.interrupted(); throw new InterruptedException(); } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/ThreadPoolExecutor.java b/libjava/classpath/external/jsr166/java/util/concurrent/ThreadPoolExecutor.java index ea89a2c082f..e303f14a827 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/ThreadPoolExecutor.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/ThreadPoolExecutor.java @@ -669,8 +669,8 @@ public class ThreadPoolExecutor extends AbstractExecutorService { runLock.lock(); try { // If not shutting down then clear an outstanding interrupt. - if (runState != STOP && - Thread.interrupted() && + if (runState != STOP && + Thread.interrupted() && runState == STOP) // Re-interrupt if stopped after clearing thread.interrupt(); boolean ran = false; @@ -911,8 +911,8 @@ public class ThreadPoolExecutor extends AbstractExecutorService { */ public void shutdown() { // Fail if caller doesn't have modifyThread permission. - SecurityManager security = System.getSecurityManager(); - if (security != null) + SecurityManager security = System.getSecurityManager(); + if (security != null) security.checkPermission(shutdownPerm); boolean fullyTerminated = false; @@ -978,8 +978,8 @@ public class ThreadPoolExecutor extends AbstractExecutorService { */ public List<Runnable> shutdownNow() { // Almost the same code as shutdown() - SecurityManager security = System.getSecurityManager(); - if (security != null) + SecurityManager security = System.getSecurityManager(); + if (security != null) security.checkPermission(shutdownPerm); boolean fullyTerminated = false; diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicInteger.java b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicInteger.java index dc4d470c32a..0f723f61362 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicInteger.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicInteger.java @@ -103,7 +103,7 @@ public class AtomicInteger extends Number implements java.io.Serializable { * the actual value was not equal to the expected value. */ public final boolean compareAndSet(int expect, int update) { - return unsafe.compareAndSwapInt(this, valueOffset, expect, update); + return unsafe.compareAndSwapInt(this, valueOffset, expect, update); } /** @@ -117,7 +117,7 @@ public class AtomicInteger extends Number implements java.io.Serializable { * @return true if successful. */ public final boolean weakCompareAndSet(int expect, int update) { - return unsafe.compareAndSwapInt(this, valueOffset, expect, update); + return unsafe.compareAndSwapInt(this, valueOffset, expect, update); } /** @@ -216,19 +216,19 @@ public class AtomicInteger extends Number implements java.io.Serializable { public int intValue() { - return get(); + return get(); } public long longValue() { - return (long)get(); + return (long)get(); } public float floatValue() { - return (float)get(); + return (float)get(); } public double doubleValue() { - return (double)get(); + return (double)get(); } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java index 102c2a7c9bd..c957bbf3f98 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java @@ -240,15 +240,15 @@ public abstract class AtomicIntegerFieldUpdater<T> { AtomicIntegerFieldUpdaterImpl(Class<T> tclass, String fieldName) { Field field = null; - Class caller = null; - int modifiers = 0; + Class caller = null; + int modifiers = 0; try { field = tclass.getDeclaredField(fieldName); - caller = sun.reflect.Reflection.getCallerClass(3); - modifiers = field.getModifiers(); + caller = sun.reflect.Reflection.getCallerClass(3); + modifiers = field.getModifiers(); sun.reflect.misc.ReflectUtil.ensureMemberAccess( - caller, tclass, null, modifiers); - sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); + caller, tclass, null, modifiers); + sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); } catch(Exception ex) { throw new RuntimeException(ex); } @@ -256,12 +256,12 @@ public abstract class AtomicIntegerFieldUpdater<T> { Class fieldt = field.getType(); if (fieldt != int.class) throw new IllegalArgumentException("Must be integer type"); - + if (!Modifier.isVolatile(modifiers)) throw new IllegalArgumentException("Must be volatile type"); - - this.cclass = (Modifier.isProtected(modifiers) && - caller != tclass) ? caller : null; + + this.cclass = (Modifier.isProtected(modifiers) && + caller != tclass) ? caller : null; this.tclass = tclass; offset = unsafe.objectFieldOffset(field); } @@ -269,8 +269,8 @@ public abstract class AtomicIntegerFieldUpdater<T> { private void fullCheck(T obj) { if (!tclass.isInstance(obj)) throw new ClassCastException(); - if (cclass != null) - ensureProtectedAccess(obj); + if (cclass != null) + ensureProtectedAccess(obj); } public boolean compareAndSet(T obj, int expect, int update) { @@ -298,19 +298,19 @@ public abstract class AtomicIntegerFieldUpdater<T> { return unsafe.getIntVolatile(obj, offset); } - private void ensureProtectedAccess(T obj) { - if (cclass.isInstance(obj)) { - return; - } - throw new RuntimeException( + private void ensureProtectedAccess(T obj) { + if (cclass.isInstance(obj)) { + return; + } + throw new RuntimeException( new IllegalAccessException("Class " + - cclass.getName() + + cclass.getName() + " can not access a protected member of class " + tclass.getName() + - " using an instance of " + + " using an instance of " + obj.getClass().getName() - ) - ); - } + ) + ); + } } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLong.java b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLong.java index 136dc60fb7d..fa254ba626d 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLong.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLong.java @@ -117,7 +117,7 @@ public class AtomicLong extends Number implements java.io.Serializable { * the actual value was not equal to the expected value. */ public final boolean compareAndSet(long expect, long update) { - return unsafe.compareAndSwapLong(this, valueOffset, expect, update); + return unsafe.compareAndSwapLong(this, valueOffset, expect, update); } /** @@ -131,7 +131,7 @@ public class AtomicLong extends Number implements java.io.Serializable { * @return true if successful. */ public final boolean weakCompareAndSet(long expect, long update) { - return unsafe.compareAndSwapLong(this, valueOffset, expect, update); + return unsafe.compareAndSwapLong(this, valueOffset, expect, update); } /** @@ -230,19 +230,19 @@ public class AtomicLong extends Number implements java.io.Serializable { public int intValue() { - return (int)get(); + return (int)get(); } public long longValue() { - return (long)get(); + return (long)get(); } public float floatValue() { - return (float)get(); + return (float)get(); } public double doubleValue() { - return (double)get(); + return (double)get(); } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLongFieldUpdater.java b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLongFieldUpdater.java index dafd089236e..f6135d1fc84 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLongFieldUpdater.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicLongFieldUpdater.java @@ -239,15 +239,15 @@ public abstract class AtomicLongFieldUpdater<T> { CASUpdater(Class<T> tclass, String fieldName) { Field field = null; - Class caller = null; - int modifiers = 0; + Class caller = null; + int modifiers = 0; try { field = tclass.getDeclaredField(fieldName); - caller = sun.reflect.Reflection.getCallerClass(3); - modifiers = field.getModifiers(); + caller = sun.reflect.Reflection.getCallerClass(3); + modifiers = field.getModifiers(); sun.reflect.misc.ReflectUtil.ensureMemberAccess( - caller, tclass, null, modifiers); - sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); + caller, tclass, null, modifiers); + sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); } catch(Exception ex) { throw new RuntimeException(ex); } @@ -259,8 +259,8 @@ public abstract class AtomicLongFieldUpdater<T> { if (!Modifier.isVolatile(modifiers)) throw new IllegalArgumentException("Must be volatile type"); - this.cclass = (Modifier.isProtected(modifiers) && - caller != tclass) ? caller : null; + this.cclass = (Modifier.isProtected(modifiers) && + caller != tclass) ? caller : null; this.tclass = tclass; offset = unsafe.objectFieldOffset(field); } @@ -268,9 +268,9 @@ public abstract class AtomicLongFieldUpdater<T> { private void fullCheck(T obj) { if (!tclass.isInstance(obj)) throw new ClassCastException(); - if (cclass != null) - ensureProtectedAccess(obj); - } + if (cclass != null) + ensureProtectedAccess(obj); + } public boolean compareAndSet(T obj, long expect, long update) { if (obj == null || obj.getClass() != tclass || cclass != null) fullCheck(obj); @@ -297,20 +297,20 @@ public abstract class AtomicLongFieldUpdater<T> { return unsafe.getLongVolatile(obj, offset); } - private void ensureProtectedAccess(T obj) { - if (cclass.isInstance(obj)) { - return; - } - throw new RuntimeException ( + private void ensureProtectedAccess(T obj) { + if (cclass.isInstance(obj)) { + return; + } + throw new RuntimeException ( new IllegalAccessException("Class " + - cclass.getName() + + cclass.getName() + " can not access a protected member of class " + tclass.getName() + - " using an instance of " + + " using an instance of " + obj.getClass().getName() - ) - ); - } + ) + ); + } } @@ -322,15 +322,15 @@ public abstract class AtomicLongFieldUpdater<T> { LockedUpdater(Class<T> tclass, String fieldName) { Field field = null; - Class caller = null; - int modifiers = 0; + Class caller = null; + int modifiers = 0; try { field = tclass.getDeclaredField(fieldName); - caller = sun.reflect.Reflection.getCallerClass(3); - modifiers = field.getModifiers(); + caller = sun.reflect.Reflection.getCallerClass(3); + modifiers = field.getModifiers(); sun.reflect.misc.ReflectUtil.ensureMemberAccess( - caller, tclass, null, modifiers); - sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); + caller, tclass, null, modifiers); + sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); } catch(Exception ex) { throw new RuntimeException(ex); } @@ -342,8 +342,8 @@ public abstract class AtomicLongFieldUpdater<T> { if (!Modifier.isVolatile(modifiers)) throw new IllegalArgumentException("Must be volatile type"); - this.cclass = (Modifier.isProtected(modifiers) && - caller != tclass) ? caller : null; + this.cclass = (Modifier.isProtected(modifiers) && + caller != tclass) ? caller : null; this.tclass = tclass; offset = unsafe.objectFieldOffset(field); } @@ -351,9 +351,9 @@ public abstract class AtomicLongFieldUpdater<T> { private void fullCheck(T obj) { if (!tclass.isInstance(obj)) throw new ClassCastException(); - if (cclass != null) - ensureProtectedAccess(obj); - } + if (cclass != null) + ensureProtectedAccess(obj); + } public boolean compareAndSet(T obj, long expect, long update) { if (obj == null || obj.getClass() != tclass || cclass != null) fullCheck(obj); @@ -378,7 +378,7 @@ public abstract class AtomicLongFieldUpdater<T> { } public void lazySet(T obj, long newValue) { - set(obj, newValue); + set(obj, newValue); } public long get(T obj) { @@ -388,19 +388,19 @@ public abstract class AtomicLongFieldUpdater<T> { } } - private void ensureProtectedAccess(T obj) { - if (cclass.isInstance(obj)) { - return; - } - throw new RuntimeException ( + private void ensureProtectedAccess(T obj) { + if (cclass.isInstance(obj)) { + return; + } + throw new RuntimeException ( new IllegalAccessException("Class " + - cclass.getName() + + cclass.getName() + " can not access a protected member of class " + tclass.getName() + - " using an instance of " + + " using an instance of " + obj.getClass().getName() - ) - ); - } + ) + ); + } } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java index 5c18eca33cf..24014a9df75 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java @@ -149,7 +149,7 @@ public abstract class AtomicReferenceFieldUpdater<T, V> { } private static final class AtomicReferenceFieldUpdaterImpl<T,V> - extends AtomicReferenceFieldUpdater<T,V> { + extends AtomicReferenceFieldUpdater<T,V> { private static final Unsafe unsafe = Unsafe.getUnsafe(); private final long offset; private final Class<T> tclass; @@ -169,19 +169,19 @@ public abstract class AtomicReferenceFieldUpdater<T, V> { */ AtomicReferenceFieldUpdaterImpl(Class<T> tclass, - Class<V> vclass, - String fieldName) { + Class<V> vclass, + String fieldName) { Field field = null; Class fieldClass = null; - Class caller = null; - int modifiers = 0; + Class caller = null; + int modifiers = 0; try { field = tclass.getDeclaredField(fieldName); - caller = sun.reflect.Reflection.getCallerClass(3); - modifiers = field.getModifiers(); + caller = sun.reflect.Reflection.getCallerClass(3); + modifiers = field.getModifiers(); sun.reflect.misc.ReflectUtil.ensureMemberAccess( - caller, tclass, null, modifiers); - sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); + caller, tclass, null, modifiers); + sun.reflect.misc.ReflectUtil.checkPackageAccess(tclass); fieldClass = field.getType(); } catch (Exception ex) { throw new RuntimeException(ex); @@ -189,12 +189,12 @@ public abstract class AtomicReferenceFieldUpdater<T, V> { if (vclass != fieldClass) throw new ClassCastException(); - + if (!Modifier.isVolatile(modifiers)) throw new IllegalArgumentException("Must be volatile type"); - this.cclass = (Modifier.isProtected(modifiers) && - caller != tclass) ? caller : null; + this.cclass = (Modifier.isProtected(modifiers) && + caller != tclass) ? caller : null; this.tclass = tclass; if (vclass == Object.class) this.vclass = null; @@ -206,16 +206,16 @@ public abstract class AtomicReferenceFieldUpdater<T, V> { void targetCheck(T obj) { if (!tclass.isInstance(obj)) throw new ClassCastException(); - if (cclass != null) - ensureProtectedAccess(obj); + if (cclass != null) + ensureProtectedAccess(obj); } void updateCheck(T obj, V update) { if (!tclass.isInstance(obj) || (update != null && vclass != null && !vclass.isInstance(update))) throw new ClassCastException(); - if (cclass != null) - ensureProtectedAccess(obj); + if (cclass != null) + ensureProtectedAccess(obj); } public boolean compareAndSet(T obj, V expect, V update) { @@ -257,19 +257,19 @@ public abstract class AtomicReferenceFieldUpdater<T, V> { return (V)unsafe.getObjectVolatile(obj, offset); } - private void ensureProtectedAccess(T obj) { - if (cclass.isInstance(obj)) { - return; - } - throw new RuntimeException ( + private void ensureProtectedAccess(T obj) { + if (cclass.isInstance(obj)) { + return; + } + throw new RuntimeException ( new IllegalAccessException("Class " + - cclass.getName() + + cclass.getName() + " can not access a protected member of class " + tclass.getName() + - " using an instance of " + + " using an instance of " + obj.getClass().getName() - ) - ); - } + ) + ); + } } } diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java b/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java index 88a4354bc71..45d744bb841 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java @@ -892,10 +892,10 @@ public abstract class AbstractQueuedLongSynchronizer * @throws InterruptedException if the current thread is interrupted */ public final boolean tryAcquireNanos(long arg, long nanosTimeout) throws InterruptedException { - if (Thread.interrupted()) - throw new InterruptedException(); - return tryAcquire(arg) || - doAcquireNanos(arg, nanosTimeout); + if (Thread.interrupted()) + throw new InterruptedException(); + return tryAcquire(arg) || + doAcquireNanos(arg, nanosTimeout); } /** @@ -971,10 +971,10 @@ public abstract class AbstractQueuedLongSynchronizer * @throws InterruptedException if the current thread is interrupted */ public final boolean tryAcquireSharedNanos(long arg, long nanosTimeout) throws InterruptedException { - if (Thread.interrupted()) - throw new InterruptedException(); - return tryAcquireShared(arg) >= 0 || - doAcquireSharedNanos(arg, nanosTimeout); + if (Thread.interrupted()) + throw new InterruptedException(); + return tryAcquireShared(arg) >= 0 || + doAcquireSharedNanos(arg, nanosTimeout); } /** diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedSynchronizer.java b/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedSynchronizer.java index a3abb2cf553..647f4fcbcdb 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedSynchronizer.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/locks/AbstractQueuedSynchronizer.java @@ -1119,10 +1119,10 @@ public abstract class AbstractQueuedSynchronizer * @throws InterruptedException if the current thread is interrupted */ public final boolean tryAcquireNanos(int arg, long nanosTimeout) throws InterruptedException { - if (Thread.interrupted()) - throw new InterruptedException(); - return tryAcquire(arg) || - doAcquireNanos(arg, nanosTimeout); + if (Thread.interrupted()) + throw new InterruptedException(); + return tryAcquire(arg) || + doAcquireNanos(arg, nanosTimeout); } /** @@ -1198,10 +1198,10 @@ public abstract class AbstractQueuedSynchronizer * @throws InterruptedException if the current thread is interrupted */ public final boolean tryAcquireSharedNanos(int arg, long nanosTimeout) throws InterruptedException { - if (Thread.interrupted()) - throw new InterruptedException(); - return tryAcquireShared(arg) >= 0 || - doAcquireSharedNanos(arg, nanosTimeout); + if (Thread.interrupted()) + throw new InterruptedException(); + return tryAcquireShared(arg) >= 0 || + doAcquireSharedNanos(arg, nanosTimeout); } /** diff --git a/libjava/classpath/external/jsr166/java/util/concurrent/locks/ReentrantReadWriteLock.java b/libjava/classpath/external/jsr166/java/util/concurrent/locks/ReentrantReadWriteLock.java index df18a7c0884..a6eadff5b13 100644 --- a/libjava/classpath/external/jsr166/java/util/concurrent/locks/ReentrantReadWriteLock.java +++ b/libjava/classpath/external/jsr166/java/util/concurrent/locks/ReentrantReadWriteLock.java @@ -746,7 +746,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab /** * Throws {@code UnsupportedOperationException} because - * {@code ReadLocks} do not support conditions. + * {@code ReadLocks} do not support conditions. * * @throws UnsupportedOperationException always */ @@ -773,7 +773,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab */ public static class WriteLock implements Lock, java.io.Serializable { private static final long serialVersionUID = -4992448646407690164L; - private final Sync sync; + private final Sync sync; /** * Constructor for use by subclasses @@ -789,7 +789,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab * Acquires the write lock. * * <p>Acquires the write lock if neither the read nor write lock - * are held by another thread + * are held by another thread * and returns immediately, setting the write lock hold count to * one. * @@ -811,7 +811,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab * {@linkplain Thread#interrupt interrupted}. * * <p>Acquires the write lock if neither the read nor write lock - * are held by another thread + * are held by another thread * and returns immediately, setting the write lock hold count to * one. * @@ -866,7 +866,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab * at the time of invocation. * * <p>Acquires the write lock if neither the read nor write lock - * are held by another thread + * are held by another thread * and returns immediately with the value {@code true}, * setting the write lock hold count to one. Even when this lock has * been set to use a fair ordering policy, a call to @@ -900,7 +900,7 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab * not been {@linkplain Thread#interrupt interrupted}. * * <p>Acquires the write lock if neither the read nor write lock - * are held by another thread + * are held by another thread * and returns immediately with the value {@code true}, * setting the write lock hold count to one. If this lock has been * set to use a fair ordering policy then an available lock @@ -1053,32 +1053,32 @@ public class ReentrantReadWriteLock implements ReadWriteLock, java.io.Serializab "[Locked by thread " + o.getName() + "]"); } - /** - * Queries if this write lock is held by the current thread. - * Identical in effect to {@link - * ReentrantReadWriteLock#isWriteLockedByCurrentThread}. - * - * @return {@code true} if the current thread holds this lock and - * {@code false} otherwise - * @since 1.6 - */ - public boolean isHeldByCurrentThread() { - return sync.isHeldExclusively(); - } - - /** - * Queries the number of holds on this write lock by the current - * thread. A thread has a hold on a lock for each lock action - * that is not matched by an unlock action. Identical in effect - * to {@link ReentrantReadWriteLock#getWriteHoldCount}. - * - * @return the number of holds on this lock by the current thread, - * or zero if this lock is not held by the current thread - * @since 1.6 - */ - public int getHoldCount() { - return sync.getWriteHoldCount(); - } + /** + * Queries if this write lock is held by the current thread. + * Identical in effect to {@link + * ReentrantReadWriteLock#isWriteLockedByCurrentThread}. + * + * @return {@code true} if the current thread holds this lock and + * {@code false} otherwise + * @since 1.6 + */ + public boolean isHeldByCurrentThread() { + return sync.isHeldExclusively(); + } + + /** + * Queries the number of holds on this write lock by the current + * thread. A thread has a hold on a lock for each lock action + * that is not matched by an unlock action. Identical in effect + * to {@link ReentrantReadWriteLock#getWriteHoldCount}. + * + * @return the number of holds on this lock by the current thread, + * or zero if this lock is not held by the current thread + * @since 1.6 + */ + public int getHoldCount() { + return sync.getWriteHoldCount(); + } } // Instrumentation and status diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/Datatype.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/Datatype.java index cf2dac134d8..325384c27d8 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/Datatype.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/Datatype.java @@ -1,237 +1,237 @@ -package org.relaxng.datatype;
-
-/**
- * Datatype object.
- *
- * This object has the following functionality:
- *
- * <ol>
- * <li> functionality to identify a class of character sequences. This is
- * done through the isValid method.
- *
- * <li> functionality to produce a "value object" from a character sequence and
- * context information.
- *
- * <li> functionality to test the equality of two value objects.
- * </ol>
- *
- * This interface also defines the createStreamingValidator method,
- * which is intended to efficiently support the validation of
- * large character sequences.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface Datatype {
-
- /**
- * Checks if the specified 'literal' matches this Datatype
- * with respect to the current context.
- *
- * @param literal
- * the lexical representation to be checked.
- * @param context
- * If this datatype is context-dependent
- * (i.e. the {@link #isContextDependent} method returns true),
- * then the caller must provide a non-null valid context object.
- * Otherwise, the caller can pass null.
- *
- * @return
- * true if the 'literal' is a member of this Datatype;
- * false if it's not a member of this Datatype.
- */
- boolean isValid( String literal, ValidationContext context );
-
- /**
- * Similar to the isValid method but throws an exception with diagnosis
- * in case of errors.
- *
- * <p>
- * If the specified 'literal' is a valid lexical representation for this
- * datatype, then this method must return without throwing any exception.
- * If not, the callee must throw an exception (with diagnosis message,
- * if possible.)
- *
- * <p>
- * The application can use this method to provide detailed error message
- * to users. This method is kept separate from the isValid method to
- * achieve higher performance during normal validation.
- *
- * @exception DatatypeException
- * If the given literal is invalid, then this exception is thrown.
- * If the callee supports error diagnosis, then the exception should
- * contain a diagnosis message.
- */
- void checkValid( String literal, ValidationContext context )
- throws DatatypeException;
-
- /**
- * Creates an instance of a streaming validator for this type.
- *
- * <p>
- * By using streaming validators instead of the isValid method,
- * the caller can avoid keeping the entire string, which is
- * sometimes quite big, in memory.
- *
- * @param context
- * If this datatype is context-dependent
- * (i.e. the {@link #isContextDependent} method returns true),
- * then the caller must provide a non-null valid context object.
- * Otherwise, the caller can pass null.
- * The callee may keep a reference to this context object
- * only while the returned streaming validator is being used.
- */
- DatatypeStreamingValidator createStreamingValidator( ValidationContext context );
-
- /**
- * Converts lexcial value and the current context to the corresponding
- * value object.
- *
- * <p>
- * The caller cannot generally assume that the value object is
- * a meaningful Java object. For example, the caller cannot expect
- * this method to return <code>java.lang.Number</code> type for
- * the "integer" type of XML Schema Part 2.
- *
- * <p>
- * Also, the caller cannot assume that the equals method and
- * the hashCode method of the value object are consistent with
- * the semantics of the datatype. For that purpose, the sameValue
- * method and the valueHashCode method have to be used. Note that
- * this means you cannot use classes like
- * <code>java.util.Hashtable</code> to store the value objects.
- *
- * <p>
- * The returned value object should be used solely for the sameValue
- * and valueHashCode methods.
- *
- * @param context
- * If this datatype is context-dependent
- * (when the {@link #isContextDependent} method returns true),
- * then the caller must provide a non-null valid context object.
- * Otherwise, the caller can pass null.
- *
- * @return null
- * when the given lexical value is not a valid lexical
- * value for this type.
- */
- Object createValue( String literal, ValidationContext context );
-
- /**
- * Tests the equality of two value objects which were originally
- * created by the createValue method of this object.
- *
- * The behavior is undefined if objects not created by this type
- * are passed. It is the caller's responsibility to ensure that
- * value objects belong to this type.
- *
- * @return
- * true if two value objects are considered equal according to
- * the definition of this datatype; false if otherwise.
- */
- boolean sameValue( Object value1, Object value2 );
-
-
- /**
- * Computes the hash code for a value object,
- * which is consistent with the sameValue method.
- *
- * @return
- * hash code for the specified value object.
- */
- int valueHashCode( Object value );
-
-
-
-
- /**
- * Indicates that the datatype doesn't have ID/IDREF semantics.
- *
- * This value is one of the possible return values of the
- * {@link #getIdType} method.
- */
- public static final int ID_TYPE_NULL = 0;
-
- /**
- * Indicates that RELAX NG compatibility processors should
- * treat this datatype as having ID semantics.
- *
- * This value is one of the possible return values of the
- * {@link #getIdType} method.
- */
- public static final int ID_TYPE_ID = 1;
-
- /**
- * Indicates that RELAX NG compatibility processors should
- * treat this datatype as having IDREF semantics.
- *
- * This value is one of the possible return values of the
- * {@link #getIdType} method.
- */
- public static final int ID_TYPE_IDREF = 2;
-
- /**
- * Indicates that RELAX NG compatibility processors should
- * treat this datatype as having IDREFS semantics.
- *
- * This value is one of the possible return values of the
- * {@link #getIdType} method.
- */
- public static final int ID_TYPE_IDREFS = 3;
-
- /**
- * Checks if the ID/IDREF semantics is associated with this
- * datatype.
- *
- * <p>
- * This method is introduced to support the RELAX NG DTD
- * compatibility spec. (Of course it's always free to use
- * this method for other purposes.)
- *
- * <p>
- * If you are implementing a datatype library and have no idea about
- * the "RELAX NG DTD compatibility" thing, just return
- * <code>ID_TYPE_NULL</code> is fine.
- *
- * @return
- * If this datatype doesn't have any ID/IDREF semantics,
- * it returns {@link #ID_TYPE_NULL}. If it has such a semantics
- * (for example, XSD:ID, XSD:IDREF and comp:ID type), then
- * it returns {@link #ID_TYPE_ID}, {@link #ID_TYPE_IDREF} or
- * {@link #ID_TYPE_IDREFS}.
- */
- public int getIdType();
-
-
- /**
- * Checks if this datatype may need a context object for
- * the validation.
- *
- * <p>
- * The callee must return true even when the context
- * is not always necessary. (For example, the "QName" type
- * doesn't need a context object when validating unprefixed
- * string. But nonetheless QName must return true.)
- *
- * <p>
- * XSD's <code>string</code> and <code>short</code> types
- * are examples of context-independent datatypes.
- * Its <code>QName</code> and <code>ENTITY</code> types
- * are examples of context-dependent datatypes.
- *
- * <p>
- * When a datatype is context-independent, then
- * the {@link #isValid} method, the {@link #checkValid} method,
- * the {@link #createStreamingValidator} method and
- * the {@link #createValue} method can be called without
- * providing a context object.
- *
- * @return
- * <b>true</b> if this datatype is context-dependent
- * (it needs a context object sometimes);
- *
- * <b>false</b> if this datatype is context-<b>in</b>dependent
- * (it never needs a context object).
- */
- public boolean isContextDependent();
-}
+package org.relaxng.datatype; + +/** + * Datatype object. + * + * This object has the following functionality: + * + * <ol> + * <li> functionality to identify a class of character sequences. This is + * done through the isValid method. + * + * <li> functionality to produce a "value object" from a character sequence and + * context information. + * + * <li> functionality to test the equality of two value objects. + * </ol> + * + * This interface also defines the createStreamingValidator method, + * which is intended to efficiently support the validation of + * large character sequences. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface Datatype { + + /** + * Checks if the specified 'literal' matches this Datatype + * with respect to the current context. + * + * @param literal + * the lexical representation to be checked. + * @param context + * If this datatype is context-dependent + * (i.e. the {@link #isContextDependent} method returns true), + * then the caller must provide a non-null valid context object. + * Otherwise, the caller can pass null. + * + * @return + * true if the 'literal' is a member of this Datatype; + * false if it's not a member of this Datatype. + */ + boolean isValid( String literal, ValidationContext context ); + + /** + * Similar to the isValid method but throws an exception with diagnosis + * in case of errors. + * + * <p> + * If the specified 'literal' is a valid lexical representation for this + * datatype, then this method must return without throwing any exception. + * If not, the callee must throw an exception (with diagnosis message, + * if possible.) + * + * <p> + * The application can use this method to provide detailed error message + * to users. This method is kept separate from the isValid method to + * achieve higher performance during normal validation. + * + * @exception DatatypeException + * If the given literal is invalid, then this exception is thrown. + * If the callee supports error diagnosis, then the exception should + * contain a diagnosis message. + */ + void checkValid( String literal, ValidationContext context ) + throws DatatypeException; + + /** + * Creates an instance of a streaming validator for this type. + * + * <p> + * By using streaming validators instead of the isValid method, + * the caller can avoid keeping the entire string, which is + * sometimes quite big, in memory. + * + * @param context + * If this datatype is context-dependent + * (i.e. the {@link #isContextDependent} method returns true), + * then the caller must provide a non-null valid context object. + * Otherwise, the caller can pass null. + * The callee may keep a reference to this context object + * only while the returned streaming validator is being used. + */ + DatatypeStreamingValidator createStreamingValidator( ValidationContext context ); + + /** + * Converts lexcial value and the current context to the corresponding + * value object. + * + * <p> + * The caller cannot generally assume that the value object is + * a meaningful Java object. For example, the caller cannot expect + * this method to return <code>java.lang.Number</code> type for + * the "integer" type of XML Schema Part 2. + * + * <p> + * Also, the caller cannot assume that the equals method and + * the hashCode method of the value object are consistent with + * the semantics of the datatype. For that purpose, the sameValue + * method and the valueHashCode method have to be used. Note that + * this means you cannot use classes like + * <code>java.util.Hashtable</code> to store the value objects. + * + * <p> + * The returned value object should be used solely for the sameValue + * and valueHashCode methods. + * + * @param context + * If this datatype is context-dependent + * (when the {@link #isContextDependent} method returns true), + * then the caller must provide a non-null valid context object. + * Otherwise, the caller can pass null. + * + * @return null + * when the given lexical value is not a valid lexical + * value for this type. + */ + Object createValue( String literal, ValidationContext context ); + + /** + * Tests the equality of two value objects which were originally + * created by the createValue method of this object. + * + * The behavior is undefined if objects not created by this type + * are passed. It is the caller's responsibility to ensure that + * value objects belong to this type. + * + * @return + * true if two value objects are considered equal according to + * the definition of this datatype; false if otherwise. + */ + boolean sameValue( Object value1, Object value2 ); + + + /** + * Computes the hash code for a value object, + * which is consistent with the sameValue method. + * + * @return + * hash code for the specified value object. + */ + int valueHashCode( Object value ); + + + + + /** + * Indicates that the datatype doesn't have ID/IDREF semantics. + * + * This value is one of the possible return values of the + * {@link #getIdType} method. + */ + public static final int ID_TYPE_NULL = 0; + + /** + * Indicates that RELAX NG compatibility processors should + * treat this datatype as having ID semantics. + * + * This value is one of the possible return values of the + * {@link #getIdType} method. + */ + public static final int ID_TYPE_ID = 1; + + /** + * Indicates that RELAX NG compatibility processors should + * treat this datatype as having IDREF semantics. + * + * This value is one of the possible return values of the + * {@link #getIdType} method. + */ + public static final int ID_TYPE_IDREF = 2; + + /** + * Indicates that RELAX NG compatibility processors should + * treat this datatype as having IDREFS semantics. + * + * This value is one of the possible return values of the + * {@link #getIdType} method. + */ + public static final int ID_TYPE_IDREFS = 3; + + /** + * Checks if the ID/IDREF semantics is associated with this + * datatype. + * + * <p> + * This method is introduced to support the RELAX NG DTD + * compatibility spec. (Of course it's always free to use + * this method for other purposes.) + * + * <p> + * If you are implementing a datatype library and have no idea about + * the "RELAX NG DTD compatibility" thing, just return + * <code>ID_TYPE_NULL</code> is fine. + * + * @return + * If this datatype doesn't have any ID/IDREF semantics, + * it returns {@link #ID_TYPE_NULL}. If it has such a semantics + * (for example, XSD:ID, XSD:IDREF and comp:ID type), then + * it returns {@link #ID_TYPE_ID}, {@link #ID_TYPE_IDREF} or + * {@link #ID_TYPE_IDREFS}. + */ + public int getIdType(); + + + /** + * Checks if this datatype may need a context object for + * the validation. + * + * <p> + * The callee must return true even when the context + * is not always necessary. (For example, the "QName" type + * doesn't need a context object when validating unprefixed + * string. But nonetheless QName must return true.) + * + * <p> + * XSD's <code>string</code> and <code>short</code> types + * are examples of context-independent datatypes. + * Its <code>QName</code> and <code>ENTITY</code> types + * are examples of context-dependent datatypes. + * + * <p> + * When a datatype is context-independent, then + * the {@link #isValid} method, the {@link #checkValid} method, + * the {@link #createStreamingValidator} method and + * the {@link #createValue} method can be called without + * providing a context object. + * + * @return + * <b>true</b> if this datatype is context-dependent + * (it needs a context object sometimes); + * + * <b>false</b> if this datatype is context-<b>in</b>dependent + * (it never needs a context object). + */ + public boolean isContextDependent(); +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeBuilder.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeBuilder.java index 75530de3c55..0a2b55e2ecd 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeBuilder.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeBuilder.java @@ -1,45 +1,45 @@ -package org.relaxng.datatype;
-
-/**
- * Creates a user-defined type by adding parameters to
- * the pre-defined type.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface DatatypeBuilder {
-
- /**
- * Adds a new parameter.
- *
- * @param name
- * The name of the parameter to be added.
- * @param strValue
- * The raw value of the parameter. Caller may not normalize
- * this value because any white space is potentially significant.
- * @param context
- * The context information which can be used by the callee to
- * acquire additional information. This context object is
- * valid only during this method call. The callee may not
- * keep a reference to this object.
- * @exception DatatypeException
- * When the given parameter is inappropriate for some reason.
- * The callee is responsible to recover from this error.
- * That is, the object should behave as if no such error
- * was occured.
- */
- void addParameter( String name, String strValue, ValidationContext context )
- throws DatatypeException;
-
- /**
- * Derives a new Datatype from a Datatype by parameters that
- * were already set through the addParameter method.
- *
- * @exception DatatypeException
- * DatatypeException must be thrown if the derivation is
- * somehow invalid. For example, a required parameter is missing,
- * etc. The exception should contain a diagnosis message
- * if possible.
- */
- Datatype createDatatype() throws DatatypeException;
-}
+package org.relaxng.datatype; + +/** + * Creates a user-defined type by adding parameters to + * the pre-defined type. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface DatatypeBuilder { + + /** + * Adds a new parameter. + * + * @param name + * The name of the parameter to be added. + * @param strValue + * The raw value of the parameter. Caller may not normalize + * this value because any white space is potentially significant. + * @param context + * The context information which can be used by the callee to + * acquire additional information. This context object is + * valid only during this method call. The callee may not + * keep a reference to this object. + * @exception DatatypeException + * When the given parameter is inappropriate for some reason. + * The callee is responsible to recover from this error. + * That is, the object should behave as if no such error + * was occured. + */ + void addParameter( String name, String strValue, ValidationContext context ) + throws DatatypeException; + + /** + * Derives a new Datatype from a Datatype by parameters that + * were already set through the addParameter method. + * + * @exception DatatypeException + * DatatypeException must be thrown if the derivation is + * somehow invalid. For example, a required parameter is missing, + * etc. The exception should contain a diagnosis message + * if possible. + */ + Datatype createDatatype() throws DatatypeException; +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeException.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeException.java index 970a99548b7..554385fe49b 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeException.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeException.java @@ -1,39 +1,39 @@ -package org.relaxng.datatype;
-
-/**
- * Signals Datatype related exceptions.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public class DatatypeException extends Exception {
-
- public DatatypeException( int index, String msg ) {
- super(msg);
- this.index = index;
- }
- public DatatypeException( String msg ) {
- this(UNKNOWN,msg);
- }
- /**
- * A constructor for those datatype libraries which don't support any
- * diagnostic information at all.
- */
- public DatatypeException() {
- this(UNKNOWN,null);
- }
-
-
- private final int index;
-
- public static final int UNKNOWN = -1;
-
- /**
- * Gets the index of the content where the error occured.
- * UNKNOWN can be returned to indicate that no index information
- * is available.
- */
- public int getIndex() {
- return index;
- }
-}
+package org.relaxng.datatype; + +/** + * Signals Datatype related exceptions. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public class DatatypeException extends Exception { + + public DatatypeException( int index, String msg ) { + super(msg); + this.index = index; + } + public DatatypeException( String msg ) { + this(UNKNOWN,msg); + } + /** + * A constructor for those datatype libraries which don't support any + * diagnostic information at all. + */ + public DatatypeException() { + this(UNKNOWN,null); + } + + + private final int index; + + public static final int UNKNOWN = -1; + + /** + * Gets the index of the content where the error occured. + * UNKNOWN can be returned to indicate that no index information + * is available. + */ + public int getIndex() { + return index; + } +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibrary.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibrary.java index e18f2b379f6..3a9b4d0bb18 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibrary.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibrary.java @@ -1,37 +1,37 @@ -package org.relaxng.datatype;
-
-/**
- * A Datatype library
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface DatatypeLibrary {
-
- /**
- * Creates a new instance of DatatypeBuilder.
- *
- * The callee should throw a DatatypeException in case of an error.
- *
- * @param baseTypeLocalName
- * The local name of the base type.
- *
- * @return
- * A non-null valid datatype object.
- */
- DatatypeBuilder createDatatypeBuilder( String baseTypeLocalName )
- throws DatatypeException;
-
- /**
- * Gets or creates a pre-defined type.
- *
- * This is just a short-cut of
- * <code>createDatatypeBuilder(typeLocalName).createDatatype();</code>
- *
- * The callee should throw a DatatypeException in case of an error.
- *
- * @return
- * A non-null valid datatype object.
- */
- Datatype createDatatype( String typeLocalName ) throws DatatypeException;
-}
+package org.relaxng.datatype; + +/** + * A Datatype library + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface DatatypeLibrary { + + /** + * Creates a new instance of DatatypeBuilder. + * + * The callee should throw a DatatypeException in case of an error. + * + * @param baseTypeLocalName + * The local name of the base type. + * + * @return + * A non-null valid datatype object. + */ + DatatypeBuilder createDatatypeBuilder( String baseTypeLocalName ) + throws DatatypeException; + + /** + * Gets or creates a pre-defined type. + * + * This is just a short-cut of + * <code>createDatatypeBuilder(typeLocalName).createDatatype();</code> + * + * The callee should throw a DatatypeException in case of an error. + * + * @return + * A non-null valid datatype object. + */ + Datatype createDatatype( String typeLocalName ) throws DatatypeException; +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibraryFactory.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibraryFactory.java index cdf1eef3c42..ebc9b910b2f 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibraryFactory.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeLibraryFactory.java @@ -1,26 +1,26 @@ -package org.relaxng.datatype;
-
-/**
- * Factory class for the DatatypeLibrary class.
- *
- * <p>
- * The datatype library should provide the implementation of
- * this interface if it wants to be found by the schema processors.
- * The implementor also have to place a file in your jar file.
- * See the reference datatype library implementation for detail.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface DatatypeLibraryFactory
-{
- /**
- * Creates a new instance of a DatatypeLibrary that supports
- * the specified namespace URI.
- *
- * @return
- * <code>null</code> if the specified namespace URI is not
- * supported.
- */
- DatatypeLibrary createDatatypeLibrary( String namespaceURI );
-}
+package org.relaxng.datatype; + +/** + * Factory class for the DatatypeLibrary class. + * + * <p> + * The datatype library should provide the implementation of + * this interface if it wants to be found by the schema processors. + * The implementor also have to place a file in your jar file. + * See the reference datatype library implementation for detail. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface DatatypeLibraryFactory +{ + /** + * Creates a new instance of a DatatypeLibrary that supports + * the specified namespace URI. + * + * @return + * <code>null</code> if the specified namespace URI is not + * supported. + */ + DatatypeLibrary createDatatypeLibrary( String namespaceURI ); +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeStreamingValidator.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeStreamingValidator.java index 99520573148..d181b032927 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeStreamingValidator.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/DatatypeStreamingValidator.java @@ -1,46 +1,46 @@ -package org.relaxng.datatype;
-
-/**
- * Datatype streaming validator.
- *
- * <p>
- * The streaming validator is an optional feature that is useful for
- * certain Datatypes. It allows the caller to incrementally provide
- * the literal.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface DatatypeStreamingValidator {
-
- /**
- * Passes an additional fragment of the literal.
- *
- * <p>
- * The application can call this method several times, then call
- * the isValid method (or the checkValid method) to check the validity
- * of the accumulated characters.
- */
- void addCharacters( char[] buf, int start, int len );
-
- /**
- * Tells if the accumulated literal is valid with respect to
- * the underlying Datatype.
- *
- * @return
- * True if it is valid. False if otherwise.
- */
- boolean isValid();
-
- /**
- * Similar to the isValid method, but this method throws
- * Exception (with possibly diagnostic information), instead of
- * returning false.
- *
- * @exception DatatypeException
- * If the callee supports the diagnosis and the accumulated
- * literal is invalid, then this exception that possibly
- * contains diagnosis information is thrown.
- */
- void checkValid() throws DatatypeException;
-}
+package org.relaxng.datatype; + +/** + * Datatype streaming validator. + * + * <p> + * The streaming validator is an optional feature that is useful for + * certain Datatypes. It allows the caller to incrementally provide + * the literal. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface DatatypeStreamingValidator { + + /** + * Passes an additional fragment of the literal. + * + * <p> + * The application can call this method several times, then call + * the isValid method (or the checkValid method) to check the validity + * of the accumulated characters. + */ + void addCharacters( char[] buf, int start, int len ); + + /** + * Tells if the accumulated literal is valid with respect to + * the underlying Datatype. + * + * @return + * True if it is valid. False if otherwise. + */ + boolean isValid(); + + /** + * Similar to the isValid method, but this method throws + * Exception (with possibly diagnostic information), instead of + * returning false. + * + * @exception DatatypeException + * If the callee supports the diagnosis and the accumulated + * literal is invalid, then this exception that possibly + * contains diagnosis information is thrown. + */ + void checkValid() throws DatatypeException; +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/ValidationContext.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/ValidationContext.java index 61e38f28d29..b25df7c7ad8 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/ValidationContext.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/ValidationContext.java @@ -1,66 +1,66 @@ -package org.relaxng.datatype;
-
-/**
- * An interface that must be implemented by caller to
- * provide context information that is necessary to
- * perform validation of some Datatypes.
- *
- * @author <a href="mailto:jjc@jclark.com">James Clark</a>
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public interface ValidationContext {
-
- /**
- * Resolves a namespace prefix to the corresponding namespace URI.
- *
- * This method is used for validating the QName type, for example.
- *
- * <p>
- * If the prefix is "" (empty string), it indicates
- * an unprefixed value. The callee
- * should resolve it as for an unprefixed
- * element, rather than for an unprefixed attribute.
- *
- * <p>
- * If the prefix is "xml", then the callee must resolve
- * this prefix into "http://www.w3.org/XML/1998/namespace",
- * as defined in the XML Namespaces Recommendation.
- *
- * @return
- * namespace URI of this prefix.
- * If the specified prefix is not declared,
- * the implementation must return null.
- */
- String resolveNamespacePrefix( String prefix );
-
- /**
- * Returns the base URI of the context. The null string may be returned
- * if no base URI is known.
- */
- String getBaseUri();
-
- /**
- * Checks if an unparsed entity is declared with the
- * specified name.
- *
- * @return
- * true
- * if the DTD has an unparsed entity declaration for
- * the specified name.
- * false
- * otherwise.
- */
- boolean isUnparsedEntity( String entityName );
-
- /**
- * Checks if a notation is declared with the
- * specified name.
- *
- * @return
- * true
- * if the DTD has a notation declaration for the specified name.
- * false
- * otherwise.
- */
- boolean isNotation( String notationName );
-}
+package org.relaxng.datatype; + +/** + * An interface that must be implemented by caller to + * provide context information that is necessary to + * perform validation of some Datatypes. + * + * @author <a href="mailto:jjc@jclark.com">James Clark</a> + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public interface ValidationContext { + + /** + * Resolves a namespace prefix to the corresponding namespace URI. + * + * This method is used for validating the QName type, for example. + * + * <p> + * If the prefix is "" (empty string), it indicates + * an unprefixed value. The callee + * should resolve it as for an unprefixed + * element, rather than for an unprefixed attribute. + * + * <p> + * If the prefix is "xml", then the callee must resolve + * this prefix into "http://www.w3.org/XML/1998/namespace", + * as defined in the XML Namespaces Recommendation. + * + * @return + * namespace URI of this prefix. + * If the specified prefix is not declared, + * the implementation must return null. + */ + String resolveNamespacePrefix( String prefix ); + + /** + * Returns the base URI of the context. The null string may be returned + * if no base URI is known. + */ + String getBaseUri(); + + /** + * Checks if an unparsed entity is declared with the + * specified name. + * + * @return + * true + * if the DTD has an unparsed entity declaration for + * the specified name. + * false + * otherwise. + */ + boolean isUnparsedEntity( String entityName ); + + /** + * Checks if a notation is declared with the + * specified name. + * + * @return + * true + * if the DTD has a notation declaration for the specified name. + * false + * otherwise. + */ + boolean isNotation( String notationName ); +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/DatatypeLibraryLoader.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/DatatypeLibraryLoader.java index 43c44382f9c..3aa7c0481b4 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/DatatypeLibraryLoader.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/DatatypeLibraryLoader.java @@ -1,262 +1,261 @@ -/**
- * Copyright (c) 2001, Thai Open Source Software Center Ltd
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are
- * met:
- *
- * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * Neither the name of the Thai Open Source Software Center Ltd nor
- * the names of its contributors may be used to endorse or promote
- * products derived from this software without specific prior written
- * permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-package org.relaxng.datatype.helpers;
-
-import org.relaxng.datatype.DatatypeLibraryFactory;
-import org.relaxng.datatype.DatatypeLibrary;
-import java.util.Enumeration;
-import java.util.NoSuchElementException;
-import java.util.Vector;
-import java.io.Reader;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.UnsupportedEncodingException;
-import java.net.URL;
-
-/**
- * Discovers the datatype library implementation from the classpath.
- *
- * <p>
- * The call of the createDatatypeLibrary method finds an implementation
- * from a given datatype library URI at run-time.
- */
-public class DatatypeLibraryLoader implements DatatypeLibraryFactory {
- private final Service service = new Service(DatatypeLibraryFactory.class);
-
- public DatatypeLibrary createDatatypeLibrary(String uri) {
- for (Enumeration e = service.getProviders();
- e.hasMoreElements();) {
- DatatypeLibraryFactory factory
- = (DatatypeLibraryFactory)e.nextElement();
- DatatypeLibrary library = factory.createDatatypeLibrary(uri);
- if (library != null)
- return library;
- }
- return null;
- }
-
- private static class Service {
- private final Class serviceClass;
- private final Enumeration configFiles;
- private Enumeration classNames = null;
- private final Vector providers = new Vector();
- private Loader loader;
-
- private class ProviderEnumeration implements Enumeration {
- private int nextIndex = 0;
-
- public boolean hasMoreElements() {
- return nextIndex < providers.size() || moreProviders();
- }
-
- public Object nextElement() {
- try {
- return providers.elementAt(nextIndex++);
- }
- catch (ArrayIndexOutOfBoundsException e) {
- throw new NoSuchElementException();
- }
- }
- }
-
- private static class Singleton implements Enumeration {
- private Object obj;
- private Singleton(Object obj) {
- this.obj = obj;
- }
-
- public boolean hasMoreElements() {
- return obj != null;
- }
-
- public Object nextElement() {
- if (obj == null)
- throw new NoSuchElementException();
- Object tem = obj;
- obj = null;
- return tem;
- }
- }
-
- // JDK 1.1
- private static class Loader {
- Enumeration getResources(String resName) {
- ClassLoader cl = Loader.class.getClassLoader();
- URL url;
- if (cl == null)
- url = ClassLoader.getSystemResource(resName);
- else
- url = cl.getResource(resName);
- return new Singleton(url);
- }
-
- Class loadClass(String name) throws ClassNotFoundException {
- return Class.forName(name);
- }
- }
-
- // JDK 1.2+
- private static class Loader2 extends Loader {
- private ClassLoader cl;
-
- Loader2() {
- cl = Loader2.class.getClassLoader();
- // If the thread context class loader has the class loader
- // of this class as an ancestor, use the thread context class
- // loader. Otherwise, the thread context class loader
- // probably hasn't been set up properly, so don't use it.
- ClassLoader clt = Thread.currentThread().getContextClassLoader();
- for (ClassLoader tem = clt; tem != null; tem = tem.getParent())
- if (tem == cl) {
- cl = clt;
- break;
- }
- }
-
- Enumeration getResources(String resName) {
- try {
- return cl.getResources(resName);
- }
- catch (IOException e) {
- return new Singleton(null);
- }
- }
-
- Class loadClass(String name) throws ClassNotFoundException {
- return Class.forName(name, true, cl);
- }
- }
-
- public Service(Class cls) {
- try {
- loader = new Loader2();
- }
- catch (NoSuchMethodError e) {
- loader = new Loader();
- }
- serviceClass = cls;
- String resName = "META-INF/services/" + serviceClass.getName();
- configFiles = loader.getResources(resName);
- }
-
- public Enumeration getProviders() {
- return new ProviderEnumeration();
- }
-
- synchronized private boolean moreProviders() {
- for (;;) {
- while (classNames == null) {
- if (!configFiles.hasMoreElements())
- return false;
- classNames = parseConfigFile((URL)configFiles.nextElement());
- }
- while (classNames.hasMoreElements()) {
- String className = (String)classNames.nextElement();
- try {
- Class cls = loader.loadClass(className);
- Object obj = cls.newInstance();
- if (serviceClass.isInstance(obj)) {
- providers.addElement(obj);
- return true;
- }
- }
- catch (ClassNotFoundException e) { }
- catch (InstantiationException e) { }
- catch (IllegalAccessException e) { }
- catch (LinkageError e) { }
- }
- classNames = null;
- }
- }
-
- private static final int START = 0;
- private static final int IN_NAME = 1;
- private static final int IN_COMMENT = 2;
-
- private static Enumeration parseConfigFile(URL url) {
- try {
- InputStream in = url.openStream();
- Reader r;
- try {
- r = new InputStreamReader(in, "UTF-8");
- }
- catch (UnsupportedEncodingException e) {
- r = new InputStreamReader(in, "UTF8");
- }
- r = new BufferedReader(r);
- Vector tokens = new Vector();
- StringBuffer tokenBuf = new StringBuffer();
- int state = START;
- for (;;) {
- int n = r.read();
- if (n < 0)
- break;
- char c = (char)n;
- switch (c) {
- case '\r':
- case '\n':
- state = START;
- break;
- case ' ':
- case '\t':
- break;
- case '#':
- state = IN_COMMENT;
- break;
- default:
- if (state != IN_COMMENT) {
- state = IN_NAME;
- tokenBuf.append(c);
- }
- break;
- }
- if (tokenBuf.length() != 0 && state != IN_NAME) {
- tokens.addElement(tokenBuf.toString());
- tokenBuf.setLength(0);
- }
- }
- if (tokenBuf.length() != 0)
- tokens.addElement(tokenBuf.toString());
- return tokens.elements();
- }
- catch (IOException e) {
- return null;
- }
- }
- }
-
-}
-
+/** + * Copyright (c) 2001, Thai Open Source Software Center Ltd + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * Neither the name of the Thai Open Source Software Center Ltd nor + * the names of its contributors may be used to endorse or promote + * products derived from this software without specific prior written + * permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package org.relaxng.datatype.helpers; + +import org.relaxng.datatype.DatatypeLibraryFactory; +import org.relaxng.datatype.DatatypeLibrary; +import java.util.Enumeration; +import java.util.NoSuchElementException; +import java.util.Vector; +import java.io.Reader; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.io.BufferedReader; +import java.io.IOException; +import java.io.UnsupportedEncodingException; +import java.net.URL; + +/** + * Discovers the datatype library implementation from the classpath. + * + * <p> + * The call of the createDatatypeLibrary method finds an implementation + * from a given datatype library URI at run-time. + */ +public class DatatypeLibraryLoader implements DatatypeLibraryFactory { + private final Service service = new Service(DatatypeLibraryFactory.class); + + public DatatypeLibrary createDatatypeLibrary(String uri) { + for (Enumeration e = service.getProviders(); + e.hasMoreElements();) { + DatatypeLibraryFactory factory + = (DatatypeLibraryFactory)e.nextElement(); + DatatypeLibrary library = factory.createDatatypeLibrary(uri); + if (library != null) + return library; + } + return null; + } + + private static class Service { + private final Class serviceClass; + private final Enumeration configFiles; + private Enumeration classNames = null; + private final Vector providers = new Vector(); + private Loader loader; + + private class ProviderEnumeration implements Enumeration { + private int nextIndex = 0; + + public boolean hasMoreElements() { + return nextIndex < providers.size() || moreProviders(); + } + + public Object nextElement() { + try { + return providers.elementAt(nextIndex++); + } + catch (ArrayIndexOutOfBoundsException e) { + throw new NoSuchElementException(); + } + } + } + + private static class Singleton implements Enumeration { + private Object obj; + private Singleton(Object obj) { + this.obj = obj; + } + + public boolean hasMoreElements() { + return obj != null; + } + + public Object nextElement() { + if (obj == null) + throw new NoSuchElementException(); + Object tem = obj; + obj = null; + return tem; + } + } + + // JDK 1.1 + private static class Loader { + Enumeration getResources(String resName) { + ClassLoader cl = Loader.class.getClassLoader(); + URL url; + if (cl == null) + url = ClassLoader.getSystemResource(resName); + else + url = cl.getResource(resName); + return new Singleton(url); + } + + Class loadClass(String name) throws ClassNotFoundException { + return Class.forName(name); + } + } + + // JDK 1.2+ + private static class Loader2 extends Loader { + private ClassLoader cl; + + Loader2() { + cl = Loader2.class.getClassLoader(); + // If the thread context class loader has the class loader + // of this class as an ancestor, use the thread context class + // loader. Otherwise, the thread context class loader + // probably hasn't been set up properly, so don't use it. + ClassLoader clt = Thread.currentThread().getContextClassLoader(); + for (ClassLoader tem = clt; tem != null; tem = tem.getParent()) + if (tem == cl) { + cl = clt; + break; + } + } + + Enumeration getResources(String resName) { + try { + return cl.getResources(resName); + } + catch (IOException e) { + return new Singleton(null); + } + } + + Class loadClass(String name) throws ClassNotFoundException { + return Class.forName(name, true, cl); + } + } + + public Service(Class cls) { + try { + loader = new Loader2(); + } + catch (NoSuchMethodError e) { + loader = new Loader(); + } + serviceClass = cls; + String resName = "META-INF/services/" + serviceClass.getName(); + configFiles = loader.getResources(resName); + } + + public Enumeration getProviders() { + return new ProviderEnumeration(); + } + + synchronized private boolean moreProviders() { + for (;;) { + while (classNames == null) { + if (!configFiles.hasMoreElements()) + return false; + classNames = parseConfigFile((URL)configFiles.nextElement()); + } + while (classNames.hasMoreElements()) { + String className = (String)classNames.nextElement(); + try { + Class cls = loader.loadClass(className); + Object obj = cls.newInstance(); + if (serviceClass.isInstance(obj)) { + providers.addElement(obj); + return true; + } + } + catch (ClassNotFoundException e) { } + catch (InstantiationException e) { } + catch (IllegalAccessException e) { } + catch (LinkageError e) { } + } + classNames = null; + } + } + + private static final int START = 0; + private static final int IN_NAME = 1; + private static final int IN_COMMENT = 2; + + private static Enumeration parseConfigFile(URL url) { + try { + InputStream in = url.openStream(); + Reader r; + try { + r = new InputStreamReader(in, "UTF-8"); + } + catch (UnsupportedEncodingException e) { + r = new InputStreamReader(in, "UTF8"); + } + r = new BufferedReader(r); + Vector tokens = new Vector(); + StringBuffer tokenBuf = new StringBuffer(); + int state = START; + for (;;) { + int n = r.read(); + if (n < 0) + break; + char c = (char)n; + switch (c) { + case '\r': + case '\n': + state = START; + break; + case ' ': + case '\t': + break; + case '#': + state = IN_COMMENT; + break; + default: + if (state != IN_COMMENT) { + state = IN_NAME; + tokenBuf.append(c); + } + break; + } + if (tokenBuf.length() != 0 && state != IN_NAME) { + tokens.addElement(tokenBuf.toString()); + tokenBuf.setLength(0); + } + } + if (tokenBuf.length() != 0) + tokens.addElement(tokenBuf.toString()); + return tokens.elements(); + } + catch (IOException e) { + return null; + } + } + } + +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java index 1f571978f7c..c59b0935529 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java @@ -1,42 +1,42 @@ -package org.relaxng.datatype.helpers;
-
-import org.relaxng.datatype.*;
-
-/**
- * Dummy implementation of {@link DatatypeBuilder}.
- *
- * This implementation can be used for Datatypes which have no parameters.
- * Any attempt to add parameters will be rejected.
- *
- * <p>
- * Typical usage would be:
- * <PRE><XMP>
- * class MyDatatypeLibrary implements DatatypeLibrary {
- * ....
- * DatatypeBuilder createDatatypeBuilder( String typeName ) {
- * return new ParameterleessDatatypeBuilder(createDatatype(typeName));
- * }
- * ....
- * }
- * </XMP></PRE>
- *
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public final class ParameterlessDatatypeBuilder implements DatatypeBuilder {
-
- /** This type object is returned for the derive method. */
- private final Datatype baseType;
-
- public ParameterlessDatatypeBuilder( Datatype baseType ) {
- this.baseType = baseType;
- }
-
- public void addParameter( String name, String strValue, ValidationContext context )
- throws DatatypeException {
- throw new DatatypeException();
- }
-
- public Datatype createDatatype() throws DatatypeException {
- return baseType;
- }
-}
+package org.relaxng.datatype.helpers; + +import org.relaxng.datatype.*; + +/** + * Dummy implementation of {@link DatatypeBuilder}. + * + * This implementation can be used for Datatypes which have no parameters. + * Any attempt to add parameters will be rejected. + * + * <p> + * Typical usage would be: + * <PRE><XMP> + * class MyDatatypeLibrary implements DatatypeLibrary { + * .... + * DatatypeBuilder createDatatypeBuilder( String typeName ) { + * return new ParameterleessDatatypeBuilder(createDatatype(typeName)); + * } + * .... + * } + * </XMP></PRE> + * + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public final class ParameterlessDatatypeBuilder implements DatatypeBuilder { + + /** This type object is returned for the derive method. */ + private final Datatype baseType; + + public ParameterlessDatatypeBuilder( Datatype baseType ) { + this.baseType = baseType; + } + + public void addParameter( String name, String strValue, ValidationContext context ) + throws DatatypeException { + throw new DatatypeException(); + } + + public Datatype createDatatype() throws DatatypeException { + return baseType; + } +} diff --git a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/StreamingValidatorImpl.java b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/StreamingValidatorImpl.java index 63686706576..f553e908ede 100755 --- a/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/StreamingValidatorImpl.java +++ b/libjava/classpath/external/relaxngDatatype/org/relaxng/datatype/helpers/StreamingValidatorImpl.java @@ -1,55 +1,55 @@ -package org.relaxng.datatype.helpers;
-
-import org.relaxng.datatype.*;
-
-/**
- * Dummy implementation of {@link DatatypeStreamingValidator}.
- *
- * <p>
- * This implementation can be used as a quick hack when the performance
- * of streaming validation is not important. And this implementation
- * also shows you how to implement the DatatypeStreamingValidator interface.
- *
- * <p>
- * Typical usage would be:
- * <PRE><XMP>
- * class MyDatatype implements Datatype {
- * ....
- * public DatatypeStreamingValidator createStreamingValidator( ValidationContext context ) {
- * return new StreamingValidatorImpl(this,context);
- * }
- * ....
- * }
- * </XMP></PRE>
- *
- * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a>
- */
-public final class StreamingValidatorImpl implements DatatypeStreamingValidator {
-
- /** This buffer accumulates characters. */
- private final StringBuffer buffer = new StringBuffer();
-
- /** Datatype obejct that creates this streaming validator. */
- private final Datatype baseType;
-
- /** The current context. */
- private final ValidationContext context;
-
- public void addCharacters( char[] buf, int start, int len ) {
- // append characters to the current buffer.
- buffer.append(buf,start,len);
- }
-
- public boolean isValid() {
- return baseType.isValid(buffer.toString(),context);
- }
-
- public void checkValid() throws DatatypeException {
- baseType.checkValid(buffer.toString(),context);
- }
-
- public StreamingValidatorImpl( Datatype baseType, ValidationContext context ) {
- this.baseType = baseType;
- this.context = context;
- }
-}
+package org.relaxng.datatype.helpers; + +import org.relaxng.datatype.*; + +/** + * Dummy implementation of {@link DatatypeStreamingValidator}. + * + * <p> + * This implementation can be used as a quick hack when the performance + * of streaming validation is not important. And this implementation + * also shows you how to implement the DatatypeStreamingValidator interface. + * + * <p> + * Typical usage would be: + * <PRE><XMP> + * class MyDatatype implements Datatype { + * .... + * public DatatypeStreamingValidator createStreamingValidator( ValidationContext context ) { + * return new StreamingValidatorImpl(this,context); + * } + * .... + * } + * </XMP></PRE> + * + * @author <a href="mailto:kohsuke.kawaguchi@sun.com">Kohsuke KAWAGUCHI</a> + */ +public final class StreamingValidatorImpl implements DatatypeStreamingValidator { + + /** This buffer accumulates characters. */ + private final StringBuffer buffer = new StringBuffer(); + + /** Datatype obejct that creates this streaming validator. */ + private final Datatype baseType; + + /** The current context. */ + private final ValidationContext context; + + public void addCharacters( char[] buf, int start, int len ) { + // append characters to the current buffer. + buffer.append(buf,start,len); + } + + public boolean isValid() { + return baseType.isValid(buffer.toString(),context); + } + + public void checkValid() throws DatatypeException { + baseType.checkValid(buffer.toString(),context); + } + + public StreamingValidatorImpl( Datatype baseType, ValidationContext context ) { + this.baseType = baseType; + this.context = context; + } +} diff --git a/libjava/classpath/external/sax/org/xml/sax/AttributeList.java b/libjava/classpath/external/sax/org/xml/sax/AttributeList.java index 7d8e9beec37..cceac8983b9 100644 --- a/libjava/classpath/external/sax/org/xml/sax/AttributeList.java +++ b/libjava/classpath/external/sax/org/xml/sax/AttributeList.java @@ -71,11 +71,11 @@ package org.xml.sax; */ public interface AttributeList { - + //////////////////////////////////////////////////////////////////// // Iteration methods. //////////////////////////////////////////////////////////////////// - + /** * Return the number of attributes in this list. @@ -85,11 +85,11 @@ public interface AttributeList { * declared or specified. The number of attributes may be * zero.</p> * - * @return The number of attributes in the list. + * @return The number of attributes in the list. */ public abstract int getLength (); - - + + /** * Return the name of an attribute in this list (by position). * @@ -104,11 +104,11 @@ public interface AttributeList { * @param i The index of the attribute in the list (starting at 0). * @return The name of the indexed attribute, or null * if the index is out of range. - * @see #getLength + * @see #getLength */ public abstract String getName (int i); - - + + /** * Return the type of an attribute in the list (by position). * @@ -127,12 +127,12 @@ public interface AttributeList { * @param i The index of the attribute in the list (starting at 0). * @return The attribute type as a string, or * null if the index is out of range. - * @see #getLength + * @see #getLength * @see #getType(java.lang.String) */ public abstract String getType (int i); - - + + /** * Return the value of an attribute in the list (by position). * @@ -149,12 +149,12 @@ public interface AttributeList { public abstract String getValue (int i); - + //////////////////////////////////////////////////////////////////// // Lookup methods. //////////////////////////////////////////////////////////////////// - - + + /** * Return the type of an attribute in the list (by name). * @@ -170,8 +170,8 @@ public interface AttributeList { * @see #getType(int) */ public abstract String getType (String name); - - + + /** * Return the value of an attribute in the list (by name). * @@ -187,7 +187,7 @@ public interface AttributeList { * @see #getValue(int) */ public abstract String getValue (String name); - + } // end of AttributeList.java diff --git a/libjava/classpath/external/sax/org/xml/sax/Attributes.java b/libjava/classpath/external/sax/org/xml/sax/Attributes.java index 51735908936..0f3c23682fc 100644 --- a/libjava/classpath/external/sax/org/xml/sax/Attributes.java +++ b/libjava/classpath/external/sax/org/xml/sax/Attributes.java @@ -29,8 +29,8 @@ package org.xml.sax; * <p>The list will not contain attributes that were declared * #IMPLIED but not specified in the start tag. It will also not * contain attributes used as Namespace declarations (xmlns*) unless - * the <code>http://xml.org/sax/features/namespace-prefixes</code> - * feature is set to <var>true</var> (it is <var>false</var> by + * the <code>http://xml.org/sax/features/namespace-prefixes</code> + * feature is set to <var>true</var> (it is <var>false</var> by * default). * Because SAX2 conforms to the original "Namespaces in XML" * recommendation, it normally does not @@ -53,8 +53,8 @@ package org.xml.sax; * available.</p> * * <p>This interface replaces the now-deprecated SAX1 {@link - * org.xml.sax.AttributeList AttributeList} interface, which does not - * contain Namespace support. In addition to Namespace support, it + * org.xml.sax.AttributeList AttributeList} interface, which does not + * contain Namespace support. In addition to Namespace support, it * adds the <var>getIndex</var> methods (below).</p> * * <p>The order of attributes in the list is unspecified, and will @@ -69,7 +69,7 @@ package org.xml.sax; public interface Attributes { - + //////////////////////////////////////////////////////////////////// // Indexed access. //////////////////////////////////////////////////////////////////// @@ -166,7 +166,7 @@ public interface Attributes public abstract String getValue (int index); - + //////////////////////////////////////////////////////////////////// // Name-based query. //////////////////////////////////////////////////////////////////// diff --git a/libjava/classpath/external/sax/org/xml/sax/ContentHandler.java b/libjava/classpath/external/sax/org/xml/sax/ContentHandler.java index c0df614108d..f5f439d78c1 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ContentHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/ContentHandler.java @@ -18,11 +18,11 @@ package org.xml.sax; * </blockquote> * * <p>This is the main interface that most SAX applications - * implement: if the application needs to be informed of basic parsing - * events, it implements this interface and registers an instance with - * the SAX parser using the {@link org.xml.sax.XMLReader#setContentHandler - * setContentHandler} method. The parser uses the instance to report - * basic document-related events like the start and end of elements + * implement: if the application needs to be informed of basic parsing + * events, it implements this interface and registers an instance with + * the SAX parser using the {@link org.xml.sax.XMLReader#setContentHandler + * setContentHandler} method. The parser uses the instance to report + * basic document-related events like the start and end of elements * and character data.</p> * * <p>The order of events in this interface is very important, and @@ -36,7 +36,7 @@ package org.xml.sax; * and for reporting skipped entities (in non-validating XML * processors).</p> * - * <p>Implementors should note that there is also a + * <p>Implementors should note that there is also a * <code>ContentHandler</code> class in the <code>java.net</code> * package; that means that it's probably a bad idea to do</p> * @@ -92,7 +92,7 @@ public interface ContentHandler * Receive notification of the beginning of a document. * * <p>The SAX parser will invoke this method only once, before any - * other event callbacks (except for {@link #setDocumentLocator + * other event callbacks (except for {@link #setDocumentLocator * setDocumentLocator}).</p> * * @throws org.xml.sax.SAXException any SAX exception, possibly @@ -100,7 +100,7 @@ public interface ContentHandler * @see #endDocument */ public void startDocument () - throws SAXException; + throws SAXException; /** @@ -125,14 +125,14 @@ public interface ContentHandler * @see #startDocument */ public void endDocument() - throws SAXException; + throws SAXException; /** * Begin the scope of a prefix-URI Namespace mapping. * * <p>The information from this event is not necessary for - * normal Namespace processing: the SAX XML reader will + * normal Namespace processing: the SAX XML reader will * automatically replace prefixes for element and attribute * names when the <code>http://xml.org/sax/features/namespaces</code> * feature is <var>true</var> (the default).</p> @@ -147,19 +147,19 @@ public interface ContentHandler * <p>Note that start/endPrefixMapping events are not * guaranteed to be properly nested relative to each other: * all startPrefixMapping events will occur immediately before the - * corresponding {@link #startElement startElement} event, + * corresponding {@link #startElement startElement} event, * and all {@link #endPrefixMapping endPrefixMapping} * events will occur immediately after the corresponding * {@link #endElement endElement} event, - * but their order is not otherwise + * but their order is not otherwise * guaranteed.</p> * * <p>There should never be start/endPrefixMapping events for the * "xml" prefix, since it is predeclared and immutable.</p> * * @param prefix the Namespace prefix being declared. - * An empty string is used for the default element namespace, - * which has no prefix. + * An empty string is used for the default element namespace, + * which has no prefix. * @param uri the Namespace URI the prefix is mapped to * @throws org.xml.sax.SAXException the client may throw * an exception during processing @@ -167,27 +167,27 @@ public interface ContentHandler * @see #startElement */ public void startPrefixMapping (String prefix, String uri) - throws SAXException; + throws SAXException; /** * End the scope of a prefix-URI mapping. * - * <p>See {@link #startPrefixMapping startPrefixMapping} for + * <p>See {@link #startPrefixMapping startPrefixMapping} for * details. These events will always occur immediately after the - * corresponding {@link #endElement endElement} event, but the order of + * corresponding {@link #endElement endElement} event, but the order of * {@link #endPrefixMapping endPrefixMapping} events is not otherwise * guaranteed.</p> * * @param prefix the prefix that was being mapped. - * This is the empty string when a default mapping scope ends. + * This is the empty string when a default mapping scope ends. * @throws org.xml.sax.SAXException the client may throw * an exception during processing * @see #startPrefixMapping * @see #endElement */ public void endPrefixMapping (String prefix) - throws SAXException; + throws SAXException; /** @@ -215,7 +215,7 @@ public interface ContentHandler * properties:</p> * * <ul> - * <li>the Namespace URI and local name are required when + * <li>the Namespace URI and local name are required when * the namespaces property is <var>true</var> (the default), and are * optional when the namespaces property is <var>false</var> (if one is * specified, both must be);</li> @@ -230,7 +230,7 @@ public interface ContentHandler * will contain attributes used for Namespace declarations * (xmlns* attributes) only if the * <code>http://xml.org/sax/features/namespace-prefixes</code> - * property is true (it is false by default, and support for a + * property is true (it is false by default, and support for a * true value is optional).</p> * * <p>Like {@link #characters characters()}, attribute values may have @@ -255,8 +255,8 @@ public interface ContentHandler * @see org.xml.sax.helpers.AttributesImpl */ public void startElement (String uri, String localName, - String qName, Attributes atts) - throws SAXException; + String qName, Attributes atts) + throws SAXException; /** @@ -264,7 +264,7 @@ public interface ContentHandler * * <p>The SAX parser will invoke this method at the end of every * element in the XML document; there will be a corresponding - * {@link #startElement startElement} event for every endElement + * {@link #startElement startElement} event for every endElement * event (even when the element is empty).</p> * * <p>For information on the names, see startElement.</p> @@ -281,8 +281,8 @@ public interface ContentHandler * wrapping another exception */ public void endElement (String uri, String localName, - String qName) - throws SAXException; + String qName) + throws SAXException; /** @@ -317,7 +317,7 @@ public interface ContentHandler * * <p>Note that some parsers will report whitespace in element * content using the {@link #ignorableWhitespace ignorableWhitespace} - * method rather than this one (validating parsers <em>must</em> + * method rather than this one (validating parsers <em>must</em> * do so).</p> * * @param ch the characters from the XML document @@ -325,11 +325,11 @@ public interface ContentHandler * @param length the number of characters to read from the array * @throws org.xml.sax.SAXException any SAX exception, possibly * wrapping another exception - * @see #ignorableWhitespace + * @see #ignorableWhitespace * @see org.xml.sax.Locator */ public void characters (char ch[], int start, int length) - throws SAXException; + throws SAXException; /** @@ -358,7 +358,7 @@ public interface ContentHandler * @see #characters */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException; + throws SAXException; /** @@ -384,7 +384,7 @@ public interface ContentHandler * wrapping another exception */ public void processingInstruction (String target, String data) - throws SAXException; + throws SAXException; /** @@ -405,7 +405,7 @@ public interface ContentHandler * <code>http://xml.org/sax/features/external-parameter-entities</code> * properties.</p> * - * @param name the name of the skipped entity. If it is a + * @param name the name of the skipped entity. If it is a * parameter entity, the name will begin with '%', and if * it is the external DTD subset, it will be the string * "[dtd]" @@ -413,7 +413,7 @@ public interface ContentHandler * wrapping another exception */ public void skippedEntity (String name) - throws SAXException; + throws SAXException; } // end of ContentHandler.java diff --git a/libjava/classpath/external/sax/org/xml/sax/DTDHandler.java b/libjava/classpath/external/sax/org/xml/sax/DTDHandler.java index f894298cded..67f5bd6a3a4 100644 --- a/libjava/classpath/external/sax/org/xml/sax/DTDHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/DTDHandler.java @@ -16,10 +16,10 @@ package org.xml.sax; * </blockquote> * * <p>If a SAX application needs information about notations and - * unparsed entities, then the application implements this - * interface and registers an instance with the SAX parser using - * the parser's setDTDHandler method. The parser uses the - * instance to report notation and unparsed entity declarations to + * unparsed entities, then the application implements this + * interface and registers an instance with the SAX parser using + * the parser's setDTDHandler method. The parser uses the + * instance to report notation and unparsed entity declarations to * the application.</p> * * <p>Note that this interface includes only those DTD events that @@ -35,7 +35,7 @@ package org.xml.sax; * used, these events must also be reported before the endDTD event.) * </p> * - * <p>It is up to the application to store the information for + * <p>It is up to the application to store the information for * future use (perhaps in a hash table or object tree). * If the application encounters attributes of type "NOTATION", * "ENTITY", or "ENTITIES", it can use the information that it @@ -48,8 +48,8 @@ package org.xml.sax; * @see org.xml.sax.XMLReader#setDTDHandler */ public interface DTDHandler { - - + + /** * Receive notification of a notation declaration event. * @@ -78,19 +78,19 @@ public interface DTDHandler { * @see org.xml.sax.Attributes */ public abstract void notationDecl (String name, - String publicId, - String systemId) - throws SAXException; - - + String publicId, + String systemId) + throws SAXException; + + /** * Receive notification of an unparsed entity declaration event. * * <p>Note that the notation name corresponds to a notation - * reported by the {@link #notationDecl notationDecl} event. - * It is up to the application to record the entity for later + * reported by the {@link #notationDecl notationDecl} event. + * It is up to the application to record the entity for later * reference, if necessary; - * unparsed entities may appear as attribute values. + * unparsed entities may appear as attribute values. * </p> * * <p>If the system identifier is a URL, the parser must resolve it @@ -107,11 +107,11 @@ public interface DTDHandler { * @see org.xml.sax.Attributes */ public abstract void unparsedEntityDecl (String name, - String publicId, - String systemId, - String notationName) - throws SAXException; - + String publicId, + String systemId, + String notationName) + throws SAXException; + } // end of DTDHandler.java diff --git a/libjava/classpath/external/sax/org/xml/sax/DocumentHandler.java b/libjava/classpath/external/sax/org/xml/sax/DocumentHandler.java index 08429b6bcf4..339a0ea657a 100644 --- a/libjava/classpath/external/sax/org/xml/sax/DocumentHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/DocumentHandler.java @@ -45,8 +45,8 @@ package org.xml.sax; * @see org.xml.sax.HandlerBase */ public interface DocumentHandler { - - + + /** * Receive an object for locating the origin of SAX document events. * @@ -73,8 +73,8 @@ public interface DocumentHandler { * @see org.xml.sax.Locator */ public abstract void setDocumentLocator (Locator locator); - - + + /** * Receive notification of the beginning of a document. * @@ -86,9 +86,9 @@ public interface DocumentHandler { * wrapping another exception. */ public abstract void startDocument () - throws SAXException; - - + throws SAXException; + + /** * Receive notification of the end of a document. * @@ -102,9 +102,9 @@ public interface DocumentHandler { * wrapping another exception. */ public abstract void endDocument () - throws SAXException; - - + throws SAXException; + + /** * Receive notification of the beginning of an element. * @@ -125,12 +125,12 @@ public interface DocumentHandler { * @exception org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. * @see #endElement - * @see org.xml.sax.AttributeList + * @see org.xml.sax.AttributeList */ public abstract void startElement (String name, AttributeList atts) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of the end of an element. * @@ -147,9 +147,9 @@ public interface DocumentHandler { * wrapping another exception. */ public abstract void endElement (String name) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of character data. * @@ -172,13 +172,13 @@ public interface DocumentHandler { * @param length The number of characters to read from the array. * @exception org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. - * @see #ignorableWhitespace + * @see #ignorableWhitespace * @see org.xml.sax.Locator */ public abstract void characters (char ch[], int start, int length) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of ignorable whitespace in element content. * @@ -204,9 +204,9 @@ public interface DocumentHandler { * @see #characters */ public abstract void ignorableWhitespace (char ch[], int start, int length) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of a processing instruction. * @@ -225,8 +225,8 @@ public interface DocumentHandler { * wrapping another exception. */ public abstract void processingInstruction (String target, String data) - throws SAXException; - + throws SAXException; + } // end of DocumentHandler.java diff --git a/libjava/classpath/external/sax/org/xml/sax/EntityResolver.java b/libjava/classpath/external/sax/org/xml/sax/EntityResolver.java index e240ba14b48..f1953d5ba0e 100644 --- a/libjava/classpath/external/sax/org/xml/sax/EntityResolver.java +++ b/libjava/classpath/external/sax/org/xml/sax/EntityResolver.java @@ -67,8 +67,8 @@ import java.io.IOException; * @see org.xml.sax.InputSource */ public interface EntityResolver { - - + + /** * Allow the application to resolve external entities. * @@ -111,9 +111,9 @@ public interface EntityResolver { * @see org.xml.sax.InputSource */ public abstract InputSource resolveEntity (String publicId, - String systemId) - throws SAXException, IOException; - + String systemId) + throws SAXException, IOException; + } // end of EntityResolver.java diff --git a/libjava/classpath/external/sax/org/xml/sax/ErrorHandler.java b/libjava/classpath/external/sax/org/xml/sax/ErrorHandler.java index 5ebe3926321..b315ec06d39 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ErrorHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/ErrorHandler.java @@ -29,12 +29,12 @@ package org.xml.sax; * In order to detect validity errors, an ErrorHandler that does something * with {@link #error error()} calls must be registered.</p> * - * <p>For XML processing errors, a SAX driver must use this interface - * in preference to throwing an exception: it is up to the application - * to decide whether to throw an exception for different types of - * errors and warnings. Note, however, that there is no requirement that - * the parser continue to report additional errors after a call to - * {@link #fatalError fatalError}. In other words, a SAX driver class + * <p>For XML processing errors, a SAX driver must use this interface + * in preference to throwing an exception: it is up to the application + * to decide whether to throw an exception for different types of + * errors and warnings. Note, however, that there is no requirement that + * the parser continue to report additional errors after a call to + * {@link #fatalError fatalError}. In other words, a SAX driver class * may throw an exception after reporting any fatalError. * Also parsers may throw appropriate exceptions for non-XML errors. * For example, {@link XMLReader#parse XMLReader.parse()} would throw @@ -44,11 +44,11 @@ package org.xml.sax; * @author David Megginson * @version 2.0.1+ (sax2r3pre1) * @see org.xml.sax.XMLReader#setErrorHandler - * @see org.xml.sax.SAXParseException + * @see org.xml.sax.SAXParseException */ public interface ErrorHandler { - - + + /** * Receive notification of a warning. * @@ -68,12 +68,12 @@ public interface ErrorHandler { * SAX parse exception. * @exception org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. - * @see org.xml.sax.SAXParseException + * @see org.xml.sax.SAXParseException */ public abstract void warning (SAXParseException exception) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of a recoverable error. * @@ -97,12 +97,12 @@ public interface ErrorHandler { * SAX parse exception. * @exception org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. - * @see org.xml.sax.SAXParseException + * @see org.xml.sax.SAXParseException */ public abstract void error (SAXParseException exception) - throws SAXException; - - + throws SAXException; + + /** * Receive notification of a non-recoverable error. * @@ -126,14 +126,14 @@ public interface ErrorHandler { * other events once this method has been invoked.</p> * * @param exception The error information encapsulated in a - * SAX parse exception. + * SAX parse exception. * @exception org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. * @see org.xml.sax.SAXParseException */ public abstract void fatalError (SAXParseException exception) - throws SAXException; - + throws SAXException; + } // end of ErrorHandler.java diff --git a/libjava/classpath/external/sax/org/xml/sax/HandlerBase.java b/libjava/classpath/external/sax/org/xml/sax/HandlerBase.java index 7d6ce73616a..da27249fd50 100644 --- a/libjava/classpath/external/sax/org/xml/sax/HandlerBase.java +++ b/libjava/classpath/external/sax/org/xml/sax/HandlerBase.java @@ -45,12 +45,12 @@ package org.xml.sax; public class HandlerBase implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler { - - + + //////////////////////////////////////////////////////////////////// // Default implementation of the EntityResolver interface. //////////////////////////////////////////////////////////////////// - + /** * Resolve an external entity. * @@ -62,7 +62,7 @@ public class HandlerBase * * @param publicId The public identifer, or null if none is * available. - * @param systemId The system identifier provided in the XML + * @param systemId The system identifier provided in the XML * document. * @return The new input source, or null to require the * default behaviour. @@ -71,18 +71,18 @@ public class HandlerBase * @see org.xml.sax.EntityResolver#resolveEntity */ public InputSource resolveEntity (String publicId, String systemId) - throws SAXException + throws SAXException { - return null; + return null; } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of DTDHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive notification of a notation declaration. * @@ -98,10 +98,10 @@ public class HandlerBase */ public void notationDecl (String name, String publicId, String systemId) { - // no op + // no op } - - + + /** * Receive notification of an unparsed entity declaration. * @@ -117,18 +117,18 @@ public class HandlerBase * @see org.xml.sax.DTDHandler#unparsedEntityDecl */ public void unparsedEntityDecl (String name, String publicId, - String systemId, String notationName) + String systemId, String notationName) { - // no op + // no op } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of DocumentHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive a Locator object for document events. * @@ -142,10 +142,10 @@ public class HandlerBase */ public void setDocumentLocator (Locator locator) { - // no op + // no op } - - + + /** * Receive notification of the beginning of the document. * @@ -159,12 +159,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#startDocument */ public void startDocument () - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the end of the document. * @@ -178,12 +178,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#endDocument */ public void endDocument () - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the start of an element. * @@ -199,12 +199,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#startElement */ public void startElement (String name, AttributeList attributes) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the end of an element. * @@ -219,12 +219,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#endElement */ public void endElement (String name) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of character data inside an element. * @@ -242,12 +242,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#characters */ public void characters (char ch[], int start, int length) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of ignorable whitespace in element content. * @@ -265,12 +265,12 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#ignorableWhitespace */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of a processing instruction. * @@ -287,18 +287,18 @@ public class HandlerBase * @see org.xml.sax.DocumentHandler#processingInstruction */ public void processingInstruction (String target, String data) - throws SAXException + throws SAXException { - // no op + // no op } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of the ErrorHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive notification of a parser warning. * @@ -314,12 +314,12 @@ public class HandlerBase * @see org.xml.sax.SAXParseException */ public void warning (SAXParseException e) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of a recoverable parser error. * @@ -335,12 +335,12 @@ public class HandlerBase * @see org.xml.sax.SAXParseException */ public void error (SAXParseException e) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Report a fatal XML parsing error. * @@ -359,11 +359,11 @@ public class HandlerBase * @see org.xml.sax.SAXParseException */ public void fatalError (SAXParseException e) - throws SAXException + throws SAXException { - throw e; + throw e; } - + } // end of HandlerBase.java diff --git a/libjava/classpath/external/sax/org/xml/sax/InputSource.java b/libjava/classpath/external/sax/org/xml/sax/InputSource.java index 3737b63712d..b5474921c3e 100644 --- a/libjava/classpath/external/sax/org/xml/sax/InputSource.java +++ b/libjava/classpath/external/sax/org/xml/sax/InputSource.java @@ -43,7 +43,7 @@ import java.io.InputStream; * identifier.</p> * * <p>An InputSource object belongs to the application: the SAX parser - * shall never modify it in any way (it may modify a copy if + * shall never modify it in any way (it may modify a copy if * necessary). However, standard processing of both byte and * character streams is to close them on as part of end-of-parse cleanup, * so applications should not attempt to re-use such streams after they @@ -58,7 +58,7 @@ import java.io.InputStream; * @see java.io.Reader */ public class InputSource { - + /** * Zero-argument default constructor. * @@ -71,12 +71,12 @@ public class InputSource { public InputSource () { } - - + + /** * Create a new input source with a system identifier. * - * <p>Applications may use setPublicId to include a + * <p>Applications may use setPublicId to include a * public identifier as well, or setEncoding to specify * the character encoding, if known.</p> * @@ -92,15 +92,15 @@ public class InputSource { */ public InputSource (String systemId) { - setSystemId(systemId); + setSystemId(systemId); } - - + + /** * Create a new input source with a byte stream. * - * <p>Application writers should use setSystemId() to provide a base - * for resolving relative URIs, may use setPublicId to include a + * <p>Application writers should use setSystemId() to provide a base + * for resolving relative URIs, may use setPublicId to include a * public identifier, and may use setEncoding to specify the object's * character encoding.</p> * @@ -113,15 +113,15 @@ public class InputSource { */ public InputSource (InputStream byteStream) { - setByteStream(byteStream); + setByteStream(byteStream); } - - + + /** * Create a new input source with a character stream. * - * <p>Application writers should use setSystemId() to provide a base - * for resolving relative URIs, and may use setPublicId to include a + * <p>Application writers should use setSystemId() to provide a base + * for resolving relative URIs, and may use setPublicId to include a * public identifier.</p> * * <p>The character stream shall not include a byte order mark.</p> @@ -133,10 +133,10 @@ public class InputSource { */ public InputSource (Reader characterStream) { - setCharacterStream(characterStream); + setCharacterStream(characterStream); } - - + + /** * Set the public identifier for this input source. * @@ -151,10 +151,10 @@ public class InputSource { */ public void setPublicId (String publicId) { - this.publicId = publicId; + this.publicId = publicId; } - - + + /** * Get the public identifier for this input source. * @@ -163,10 +163,10 @@ public class InputSource { */ public String getPublicId () { - return publicId; + return publicId; } - - + + /** * Set the system identifier for this input source. * @@ -192,10 +192,10 @@ public class InputSource { */ public void setSystemId (String systemId) { - this.systemId = systemId; + this.systemId = systemId; } - - + + /** * Get the system identifier for this input source. * @@ -210,10 +210,10 @@ public class InputSource { */ public String getSystemId () { - return systemId; + return systemId; } - - + + /** * Set the byte stream for this input source. * @@ -233,10 +233,10 @@ public class InputSource { */ public void setByteStream (InputStream byteStream) { - this.byteStream = byteStream; + this.byteStream = byteStream; } - - + + /** * Get the byte stream for this input source. * @@ -249,11 +249,11 @@ public class InputSource { */ public InputStream getByteStream () { - return byteStream; + return byteStream; } - - - /** + + + /** * Set the character encoding, if known. * * <p>The encoding must be a string acceptable for an @@ -270,10 +270,10 @@ public class InputSource { */ public void setEncoding (String encoding) { - this.encoding = encoding; + this.encoding = encoding; } - - + + /** * Get the character encoding for a byte stream or URI. * This value will be ignored when the application provides a @@ -286,10 +286,10 @@ public class InputSource { */ public String getEncoding () { - return encoding; + return encoding; } - - + + /** * Set the character stream for this input source. * @@ -304,10 +304,10 @@ public class InputSource { */ public void setCharacterStream (Reader characterStream) { - this.characterStream = characterStream; + this.characterStream = characterStream; } - - + + /** * Get the character stream for this input source. * @@ -316,21 +316,21 @@ public class InputSource { */ public Reader getCharacterStream () { - return characterStream; + return characterStream; } - - - + + + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// - + private String publicId; private String systemId; private InputStream byteStream; private String encoding; private Reader characterStream; - + } // end of InputSource.java diff --git a/libjava/classpath/external/sax/org/xml/sax/Locator.java b/libjava/classpath/external/sax/org/xml/sax/Locator.java index 63947df7ac7..910f0d294fa 100644 --- a/libjava/classpath/external/sax/org/xml/sax/Locator.java +++ b/libjava/classpath/external/sax/org/xml/sax/Locator.java @@ -34,17 +34,17 @@ package org.xml.sax; * locator, it must do so before reporting any other document events. * If no locator has been set by the time the application receives * the {@link org.xml.sax.ContentHandler#startDocument startDocument} - * event, the application should assume that a locator is not + * event, the application should assume that a locator is not * available.</p> * * @since SAX 1.0 * @author David Megginson * @version 2.0.1 (sax2r2) - * @see org.xml.sax.ContentHandler#setDocumentLocator + * @see org.xml.sax.ContentHandler#setDocumentLocator */ public interface Locator { - - + + /** * Return the public identifier for the current document event. * @@ -57,8 +57,8 @@ public interface Locator { * @see #getSystemId */ public abstract String getPublicId (); - - + + /** * Return the system identifier for the current document event. * @@ -76,8 +76,8 @@ public interface Locator { * @see #getPublicId */ public abstract String getSystemId (); - - + + /** * Return the line number where the current document event ends. * Lines are delimited by line ends, which are defined in @@ -95,16 +95,16 @@ public interface Locator { * in the document entity or external parsed entity where the * markup triggering the event appears.</p> * - * <p>If possible, the SAX driver should provide the line position - * of the first character after the text associated with the document + * <p>If possible, the SAX driver should provide the line position + * of the first character after the text associated with the document * event. The first line is line 1.</p> * * @return The line number, or -1 if none is available. * @see #getColumnNumber */ public abstract int getLineNumber (); - - + + /** * Return the column number where the current document event ends. * This is one-based number of Java <code>char</code> values since @@ -122,15 +122,15 @@ public interface Locator { * in the document entity or external parsed entity where the * markup triggering the event appears.</p> * - * <p>If possible, the SAX driver should provide the line position - * of the first character after the text associated with the document + * <p>If possible, the SAX driver should provide the line position + * of the first character after the text associated with the document * event. The first column in each line is column 1.</p> * * @return The column number, or -1 if none is available. * @see #getLineNumber */ public abstract int getColumnNumber (); - + } // end of Locator.java diff --git a/libjava/classpath/external/sax/org/xml/sax/Parser.java b/libjava/classpath/external/sax/org/xml/sax/Parser.java index 5866eb09ce1..994648897ba 100644 --- a/libjava/classpath/external/sax/org/xml/sax/Parser.java +++ b/libjava/classpath/external/sax/org/xml/sax/Parser.java @@ -49,9 +49,9 @@ import java.util.Locale; * @see org.xml.sax.HandlerBase * @see org.xml.sax.InputSource */ -public interface Parser +public interface Parser { - + /** * Allow an application to request a locale for errors and warnings. * @@ -62,15 +62,15 @@ public interface Parser * * @param locale A Java Locale object. * @exception org.xml.sax.SAXException Throws an exception - * (using the previous or default locale) if the + * (using the previous or default locale) if the * requested locale is not supported. * @see org.xml.sax.SAXException * @see org.xml.sax.SAXParseException */ public abstract void setLocale (Locale locale) - throws SAXException; - - + throws SAXException; + + /** * Allow an application to register a custom entity resolver. * @@ -88,8 +88,8 @@ public interface Parser * @see HandlerBase */ public abstract void setEntityResolver (EntityResolver resolver); - - + + /** * Allow an application to register a DTD event handler. * @@ -107,8 +107,8 @@ public interface Parser * @see HandlerBase */ public abstract void setDTDHandler (DTDHandler handler); - - + + /** * Allow an application to register a document event handler. * @@ -126,8 +126,8 @@ public interface Parser * @see HandlerBase */ public abstract void setDocumentHandler (DocumentHandler handler); - - + + /** * Allow an application to register an error event handler. * @@ -146,8 +146,8 @@ public interface Parser * @see HandlerBase */ public abstract void setErrorHandler (ErrorHandler handler); - - + + /** * Parse an XML document. * @@ -176,9 +176,9 @@ public interface Parser * @see #setErrorHandler */ public abstract void parse (InputSource source) - throws SAXException, IOException; - - + throws SAXException, IOException; + + /** * Parse an XML document from a system identifier (URI). * @@ -202,8 +202,8 @@ public interface Parser * @see #parse(org.xml.sax.InputSource) */ public abstract void parse (String systemId) - throws SAXException, IOException; - + throws SAXException, IOException; + } // end of Parser.java diff --git a/libjava/classpath/external/sax/org/xml/sax/SAXException.java b/libjava/classpath/external/sax/org/xml/sax/SAXException.java index b3c23e9aedb..f8691bc575e 100644 --- a/libjava/classpath/external/sax/org/xml/sax/SAXException.java +++ b/libjava/classpath/external/sax/org/xml/sax/SAXException.java @@ -42,22 +42,22 @@ public class SAXException extends Exception { */ public SAXException () { - super(); - this.exception = null; + super(); + this.exception = null; } - - + + /** * Create a new SAXException. * * @param message The error or warning message. */ public SAXException (String message) { - super(message); - this.exception = null; + super(message); + this.exception = null; } - - + + /** * Create a new SAXException wrapping an existing exception. * @@ -69,11 +69,11 @@ public class SAXException extends Exception { */ public SAXException (Exception e) { - super(); - this.exception = e; + super(); + this.exception = e; } - - + + /** * Create a new SAXException from an existing exception. * @@ -85,11 +85,11 @@ public class SAXException extends Exception { */ public SAXException (String message, Exception e) { - super(message); - this.exception = e; + super(message); + this.exception = e; } - - + + /** * Return a detail message for this exception. * @@ -101,16 +101,16 @@ public class SAXException extends Exception { */ public String getMessage () { - String message = super.getMessage(); - - if (message == null && exception != null) { - return exception.getMessage(); - } else { - return message; - } + String message = super.getMessage(); + + if (message == null && exception != null) { + return exception.getMessage(); + } else { + return message; + } } - - + + /** * Return the embedded exception, if any. * @@ -118,7 +118,7 @@ public class SAXException extends Exception { */ public Exception getException () { - return exception; + return exception; } @@ -129,15 +129,15 @@ public class SAXException extends Exception { */ public String toString () { - if (exception != null) { - return exception.toString(); - } else { - return super.toString(); - } + if (exception != null) { + return exception.toString(); + } else { + return super.toString(); + } } - - - + + + ////////////////////////////////////////////////////////////////////// // Internal state. ////////////////////////////////////////////////////////////////////// @@ -145,9 +145,9 @@ public class SAXException extends Exception { /** * @serial The embedded exception if tunnelling, or null. - */ + */ private Exception exception; - + } // end of SAXException.java diff --git a/libjava/classpath/external/sax/org/xml/sax/SAXNotRecognizedException.java b/libjava/classpath/external/sax/org/xml/sax/SAXNotRecognizedException.java index dc411b105ce..b512288ec74 100644 --- a/libjava/classpath/external/sax/org/xml/sax/SAXNotRecognizedException.java +++ b/libjava/classpath/external/sax/org/xml/sax/SAXNotRecognizedException.java @@ -34,7 +34,7 @@ public class SAXNotRecognizedException extends SAXException */ public SAXNotRecognizedException () { - super(); + super(); } @@ -45,7 +45,7 @@ public class SAXNotRecognizedException extends SAXException */ public SAXNotRecognizedException (String message) { - super(message); + super(message); } } diff --git a/libjava/classpath/external/sax/org/xml/sax/SAXNotSupportedException.java b/libjava/classpath/external/sax/org/xml/sax/SAXNotSupportedException.java index 232ce8026de..e59fd40e0f2 100644 --- a/libjava/classpath/external/sax/org/xml/sax/SAXNotSupportedException.java +++ b/libjava/classpath/external/sax/org/xml/sax/SAXNotSupportedException.java @@ -24,7 +24,7 @@ package org.xml.sax; * @since SAX 2.0 * @author David Megginson * @version 2.0.1 (sax2r2) - * @see org.xml.sax.SAXNotRecognizedException + * @see org.xml.sax.SAXNotRecognizedException */ public class SAXNotSupportedException extends SAXException { @@ -34,7 +34,7 @@ public class SAXNotSupportedException extends SAXException */ public SAXNotSupportedException () { - super(); + super(); } @@ -45,7 +45,7 @@ public class SAXNotSupportedException extends SAXException */ public SAXNotSupportedException (String message) { - super(message); + super(message); } } diff --git a/libjava/classpath/external/sax/org/xml/sax/SAXParseException.java b/libjava/classpath/external/sax/org/xml/sax/SAXParseException.java index c49ff095be3..0921be76241 100644 --- a/libjava/classpath/external/sax/org/xml/sax/SAXParseException.java +++ b/libjava/classpath/external/sax/org/xml/sax/SAXParseException.java @@ -19,12 +19,12 @@ package org.xml.sax; * in the original XML document, as if it came from a {@link Locator} * object. Note that although the application * will receive a SAXParseException as the argument to the handlers - * in the {@link org.xml.sax.ErrorHandler ErrorHandler} interface, - * the application is not actually required to throw the exception; - * instead, it can simply read the information in it and take a + * in the {@link org.xml.sax.ErrorHandler ErrorHandler} interface, + * the application is not actually required to throw the exception; + * instead, it can simply read the information in it and take a * different action.</p> * - * <p>Since this exception is a subclass of {@link org.xml.sax.SAXException + * <p>Since this exception is a subclass of {@link org.xml.sax.SAXException * SAXException}, it inherits the ability to wrap another exception.</p> * * @since SAX 1.0 @@ -35,8 +35,8 @@ package org.xml.sax; * @see org.xml.sax.ErrorHandler */ public class SAXParseException extends SAXException { - - + + ////////////////////////////////////////////////////////////////////// // Constructors. ////////////////////////////////////////////////////////////////////// @@ -55,16 +55,16 @@ public class SAXParseException extends SAXException { * @see org.xml.sax.Locator */ public SAXParseException (String message, Locator locator) { - super(message); - if (locator != null) { - init(locator.getPublicId(), locator.getSystemId(), - locator.getLineNumber(), locator.getColumnNumber()); - } else { - init(null, null, -1, -1); - } + super(message); + if (locator != null) { + init(locator.getPublicId(), locator.getSystemId(), + locator.getLineNumber(), locator.getColumnNumber()); + } else { + init(null, null, -1, -1); + } } - - + + /** * Wrap an existing exception in a SAXParseException. * @@ -81,17 +81,17 @@ public class SAXParseException extends SAXException { * @see org.xml.sax.Locator */ public SAXParseException (String message, Locator locator, - Exception e) { - super(message, e); - if (locator != null) { - init(locator.getPublicId(), locator.getSystemId(), - locator.getLineNumber(), locator.getColumnNumber()); - } else { - init(null, null, -1, -1); - } + Exception e) { + super(message, e); + if (locator != null) { + init(locator.getPublicId(), locator.getSystemId(), + locator.getLineNumber(), locator.getColumnNumber()); + } else { + init(null, null, -1, -1); + } } - - + + /** * Create a new SAXParseException. * @@ -114,13 +114,13 @@ public class SAXParseException extends SAXException { * cause the error or warning. */ public SAXParseException (String message, String publicId, String systemId, - int lineNumber, int columnNumber) + int lineNumber, int columnNumber) { - super(message); - init(publicId, systemId, lineNumber, columnNumber); + super(message); + init(publicId, systemId, lineNumber, columnNumber); } - - + + /** * Create a new SAXParseException with an embedded exception. * @@ -146,10 +146,10 @@ public class SAXParseException extends SAXException { * @param e Another exception to embed in this one. */ public SAXParseException (String message, String publicId, String systemId, - int lineNumber, int columnNumber, Exception e) + int lineNumber, int columnNumber, Exception e) { - super(message, e); - init(publicId, systemId, lineNumber, columnNumber); + super(message, e); + init(publicId, systemId, lineNumber, columnNumber); } @@ -164,15 +164,15 @@ public class SAXParseException extends SAXException { * @param columnNumber The column number of the error, or -1. */ private void init (String publicId, String systemId, - int lineNumber, int columnNumber) + int lineNumber, int columnNumber) { - this.publicId = publicId; - this.systemId = systemId; - this.lineNumber = lineNumber; - this.columnNumber = columnNumber; + this.publicId = publicId; + this.systemId = systemId; + this.lineNumber = lineNumber; + this.columnNumber = columnNumber; } - - + + /** * Get the public identifier of the entity where the exception occurred. * @@ -182,10 +182,10 @@ public class SAXParseException extends SAXException { */ public String getPublicId () { - return this.publicId; + return this.publicId; } - - + + /** * Get the system identifier of the entity where the exception occurred. * @@ -198,10 +198,10 @@ public class SAXParseException extends SAXException { */ public String getSystemId () { - return this.systemId; + return this.systemId; } - - + + /** * The line number of the end of the text where the exception occurred. * @@ -213,10 +213,10 @@ public class SAXParseException extends SAXException { */ public int getLineNumber () { - return this.lineNumber; + return this.lineNumber; } - - + + /** * The column number of the end of the text where the exception occurred. * @@ -228,10 +228,10 @@ public class SAXParseException extends SAXException { */ public int getColumnNumber () { - return this.columnNumber; + return this.columnNumber; } - - + + ////////////////////////////////////////////////////////////////////// // Internal state. ////////////////////////////////////////////////////////////////////// @@ -240,7 +240,7 @@ public class SAXParseException extends SAXException { /** * @serial The public identifier, or null. * @see #getPublicId - */ + */ private String publicId; @@ -263,7 +263,7 @@ public class SAXParseException extends SAXException { * @see #getColumnNumber */ private int columnNumber; - + } // end of SAXParseException.java diff --git a/libjava/classpath/external/sax/org/xml/sax/XMLReader.java b/libjava/classpath/external/sax/org/xml/sax/XMLReader.java index 92d0a94e3d1..d334f03fbfd 100644 --- a/libjava/classpath/external/sax/org/xml/sax/XMLReader.java +++ b/libjava/classpath/external/sax/org/xml/sax/XMLReader.java @@ -19,9 +19,9 @@ import java.io.IOException; * for further information. * </blockquote> * - * <p><strong>Note:</strong> despite its name, this interface does - * <em>not</em> extend the standard Java {@link java.io.Reader Reader} - * interface, because reading XML is a fundamentally different activity + * <p><strong>Note:</strong> despite its name, this interface does + * <em>not</em> extend the standard Java {@link java.io.Reader Reader} + * interface, because reading XML is a fundamentally different activity * than reading character data.</p> * * <p>XMLReader is the interface that an XML parser's SAX2 driver must @@ -41,7 +41,7 @@ import java.io.IOException; * interface (as well as some minor ones):</p> * * <ol> - * <li>it adds a standard way to query and set features and + * <li>it adds a standard way to query and set features and * properties; and</li> * <li>it adds Namespace support, which is required for many * higher-level XML standards.</li> @@ -55,12 +55,12 @@ import java.io.IOException; * @version 2.0.1+ (sax2r3pre1) * @see org.xml.sax.XMLFilter * @see org.xml.sax.helpers.ParserAdapter - * @see org.xml.sax.helpers.XMLReaderAdapter + * @see org.xml.sax.helpers.XMLReaderAdapter */ public interface XMLReader { - + //////////////////////////////////////////////////////////////////// // Configuration. //////////////////////////////////////////////////////////////////// @@ -93,7 +93,7 @@ public interface XMLReader * try { * r.setFeature("http://xml.org/sax/features/validation", true); * } catch (SAXException e) { - * System.err.println("Cannot activate validation."); + * System.err.println("Cannot activate validation."); * } * * // register event handlers @@ -118,7 +118,7 @@ public interface XMLReader * @exception org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved. * @exception org.xml.sax.SAXNotSupportedException When the - * XMLReader recognizes the feature name but + * XMLReader recognizes the feature name but * cannot determine its value at this time. * @see #setFeature */ @@ -132,8 +132,8 @@ public interface XMLReader * <p>The feature name is any fully-qualified URI. It is * possible for an XMLReader to expose a feature value but * to be unable to change the current value. - * Some feature values may be immutable or mutable only - * in specific contexts, such as before, during, or after + * Some feature values may be immutable or mutable only + * in specific contexts, such as before, during, or after * a parse.</p> * * <p>All XMLReaders are required to support setting @@ -145,12 +145,12 @@ public interface XMLReader * @exception org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved. * @exception org.xml.sax.SAXNotSupportedException When the - * XMLReader recognizes the feature name but + * XMLReader recognizes the feature name but * cannot set the requested value. * @see #getFeature */ public void setFeature (String name, boolean value) - throws SAXNotRecognizedException, SAXNotSupportedException; + throws SAXNotRecognizedException, SAXNotSupportedException; /** @@ -174,12 +174,12 @@ public interface XMLReader * @exception org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved. * @exception org.xml.sax.SAXNotSupportedException When the - * XMLReader recognizes the property name but + * XMLReader recognizes the property name but * cannot determine its value at this time. * @see #setProperty */ public Object getProperty (String name) - throws SAXNotRecognizedException, SAXNotSupportedException; + throws SAXNotRecognizedException, SAXNotSupportedException; /** @@ -188,12 +188,12 @@ public interface XMLReader * <p>The property name is any fully-qualified URI. It is * possible for an XMLReader to recognize a property name but * to be unable to change the current value. - * Some property values may be immutable or mutable only - * in specific contexts, such as before, during, or after + * Some property values may be immutable or mutable only + * in specific contexts, such as before, during, or after * a parse.</p> * * <p>XMLReaders are not required to recognize setting - * any specific property names, though a core set is defined by + * any specific property names, though a core set is defined by * SAX2.</p> * * <p>This method is also the standard mechanism for setting @@ -204,14 +204,14 @@ public interface XMLReader * @exception org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved. * @exception org.xml.sax.SAXNotSupportedException When the - * XMLReader recognizes the property name but + * XMLReader recognizes the property name but * cannot set the requested value. */ public void setProperty (String name, Object value) - throws SAXNotRecognizedException, SAXNotSupportedException; + throws SAXNotRecognizedException, SAXNotSupportedException; + - //////////////////////////////////////////////////////////////////// // Event handlers. //////////////////////////////////////////////////////////////////// @@ -325,7 +325,7 @@ public interface XMLReader public ErrorHandler getErrorHandler (); - + //////////////////////////////////////////////////////////////////// // Parsing. //////////////////////////////////////////////////////////////////// @@ -355,7 +355,7 @@ public interface XMLReader * handlers.</p> * * <p>This method is synchronous: it will not return until parsing - * has ended. If a client application wants to terminate + * has ended. If a client application wants to terminate * parsing early, it should throw an exception.</p> * * @param input The input source for the top-level of the @@ -370,10 +370,10 @@ public interface XMLReader * @see #setEntityResolver * @see #setDTDHandler * @see #setContentHandler - * @see #setErrorHandler + * @see #setErrorHandler */ public void parse (InputSource input) - throws IOException, SAXException; + throws IOException, SAXException; /** @@ -399,6 +399,6 @@ public interface XMLReader * @see #parse(org.xml.sax.InputSource) */ public void parse (String systemId) - throws IOException, SAXException; + throws IOException, SAXException; } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2.java b/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2.java index 5c839bd1acf..a814d9de31b 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2.java @@ -46,7 +46,7 @@ public interface Attributes2 extends Attributes * * @param index The attribute index (zero-based). * @return true if the attribute was declared in the DTD, - * false otherwise. + * false otherwise. * @exception java.lang.ArrayIndexOutOfBoundsException When the * supplied index does not identify an attribute. */ @@ -60,7 +60,7 @@ public interface Attributes2 extends Attributes * * @param qName The XML qualified (prefixed) name. * @return true if the attribute was declared in the DTD, - * false otherwise. + * false otherwise. * @exception java.lang.IllegalArgumentException When the * supplied name does not identify an attribute. */ @@ -81,7 +81,7 @@ public interface Attributes2 extends Attributes * the name has no Namespace URI. * @param localName The attribute's local name. * @return true if the attribute was declared in the DTD, - * false otherwise. + * false otherwise. * @exception java.lang.IllegalArgumentException When the * supplied names do not identify an attribute. */ @@ -93,7 +93,7 @@ public interface Attributes2 extends Attributes * * @param index The attribute index (zero-based). * @return true if the value was found in the XML text, - * false if the value was provided by DTD defaulting. + * false if the value was provided by DTD defaulting. * @exception java.lang.ArrayIndexOutOfBoundsException When the * supplied index does not identify an attribute. */ @@ -112,7 +112,7 @@ public interface Attributes2 extends Attributes * the name has no Namespace URI. * @param localName The attribute's local name. * @return true if the value was found in the XML text, - * false if the value was provided by DTD defaulting. + * false if the value was provided by DTD defaulting. * @exception java.lang.IllegalArgumentException When the * supplied names do not identify an attribute. */ @@ -124,7 +124,7 @@ public interface Attributes2 extends Attributes * * @param qName The XML qualified (prefixed) name. * @return true if the value was found in the XML text, - * false if the value was provided by DTD defaulting. + * false if the value was provided by DTD defaulting. * @exception java.lang.IllegalArgumentException When the * supplied name does not identify an attribute. */ diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2Impl.java b/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2Impl.java index 485a5d6ac44..08225593307 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2Impl.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/Attributes2Impl.java @@ -28,7 +28,7 @@ import org.xml.sax.helpers.AttributesImpl; * is false), non-CDATA attributes, or when it is set to true using * {@link #setDeclared}. * If you change an attribute's type by hand, you may need to modify - * its <em>declared</em> flag to match. + * its <em>declared</em> flag to match. * </p> * * @since SAX 2.0 (extensions 1.1 alpha) @@ -37,8 +37,8 @@ import org.xml.sax.helpers.AttributesImpl; */ public class Attributes2Impl extends AttributesImpl implements Attributes2 { - private boolean declared []; - private boolean specified []; + private boolean declared []; + private boolean specified []; /** @@ -63,7 +63,7 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public Attributes2Impl (Attributes atts) { - super (atts); + super (atts); } @@ -78,10 +78,10 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 // javadoc mostly from interface public boolean isDeclared (int index) { - if (index < 0 || index >= getLength ()) - throw new ArrayIndexOutOfBoundsException ( - "No attribute at index: " + index); - return declared [index]; + if (index < 0 || index >= getLength ()) + throw new ArrayIndexOutOfBoundsException ( + "No attribute at index: " + index); + return declared [index]; } @@ -91,13 +91,13 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 // javadoc mostly from interface public boolean isDeclared (String uri, String localName) { - int index = getIndex (uri, localName); + int index = getIndex (uri, localName); - if (index < 0) - throw new IllegalArgumentException ( - "No such attribute: local=" + localName - + ", namespace=" + uri); - return declared [index]; + if (index < 0) + throw new IllegalArgumentException ( + "No such attribute: local=" + localName + + ", namespace=" + uri); + return declared [index]; } @@ -107,12 +107,12 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 // javadoc mostly from interface public boolean isDeclared (String qName) { - int index = getIndex (qName); + int index = getIndex (qName); - if (index < 0) - throw new IllegalArgumentException ( - "No such attribute: " + qName); - return declared [index]; + if (index < 0) + throw new IllegalArgumentException ( + "No such attribute: " + qName); + return declared [index]; } @@ -126,10 +126,10 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public boolean isSpecified (int index) { - if (index < 0 || index >= getLength ()) - throw new ArrayIndexOutOfBoundsException ( - "No attribute at index: " + index); - return specified [index]; + if (index < 0 || index >= getLength ()) + throw new ArrayIndexOutOfBoundsException ( + "No attribute at index: " + index); + return specified [index]; } @@ -145,13 +145,13 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public boolean isSpecified (String uri, String localName) { - int index = getIndex (uri, localName); + int index = getIndex (uri, localName); - if (index < 0) - throw new IllegalArgumentException ( - "No such attribute: local=" + localName - + ", namespace=" + uri); - return specified [index]; + if (index < 0) + throw new IllegalArgumentException ( + "No such attribute: local=" + localName + + ", namespace=" + uri); + return specified [index]; } @@ -165,12 +165,12 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public boolean isSpecified (String qName) { - int index = getIndex (qName); + int index = getIndex (qName); - if (index < 0) - throw new IllegalArgumentException ( - "No such attribute: " + qName); - return specified [index]; + if (index < 0) + throw new IllegalArgumentException ( + "No such attribute: " + qName); + return specified [index]; } @@ -190,24 +190,24 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public void setAttributes (Attributes atts) { - int length = atts.getLength (); - - super.setAttributes (atts); - declared = new boolean [length]; - specified = new boolean [length]; - - if (atts instanceof Attributes2) { - Attributes2 a2 = (Attributes2) atts; - for (int i = 0; i < length; i++) { - declared [i] = a2.isDeclared (i); - specified [i] = a2.isSpecified (i); - } - } else { - for (int i = 0; i < length; i++) { - declared [i] = !"CDATA".equals (atts.getType (i)); - specified [i] = true; - } - } + int length = atts.getLength (); + + super.setAttributes (atts); + declared = new boolean [length]; + specified = new boolean [length]; + + if (atts instanceof Attributes2) { + Attributes2 a2 = (Attributes2) atts; + for (int i = 0; i < length; i++) { + declared [i] = a2.isDeclared (i); + specified [i] = a2.isSpecified (i); + } + } else { + for (int i = 0; i < length; i++) { + declared [i] = !"CDATA".equals (atts.getType (i)); + specified [i] = true; + } + } } @@ -223,41 +223,41 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 * @see AttributesImpl#addAttribute */ public void addAttribute (String uri, String localName, String qName, - String type, String value) + String type, String value) { - super.addAttribute (uri, localName, qName, type, value); + super.addAttribute (uri, localName, qName, type, value); - int length = getLength (); + int length = getLength (); - if (length < specified.length) { - boolean newFlags []; + if (length < specified.length) { + boolean newFlags []; - newFlags = new boolean [length]; - System.arraycopy (declared, 0, newFlags, 0, declared.length); - declared = newFlags; + newFlags = new boolean [length]; + System.arraycopy (declared, 0, newFlags, 0, declared.length); + declared = newFlags; - newFlags = new boolean [length]; - System.arraycopy (specified, 0, newFlags, 0, specified.length); - specified = newFlags; - } + newFlags = new boolean [length]; + System.arraycopy (specified, 0, newFlags, 0, specified.length); + specified = newFlags; + } - specified [length - 1] = true; - declared [length - 1] = !"CDATA".equals (type); + specified [length - 1] = true; + declared [length - 1] = !"CDATA".equals (type); } // javadoc entirely from superclass public void removeAttribute (int index) { - int origMax = getLength () - 1; - - super.removeAttribute (index); - if (index != origMax) { - System.arraycopy (declared, index + 1, declared, index, - origMax - index); - System.arraycopy (specified, index + 1, specified, index, - origMax - index); - } + int origMax = getLength () - 1; + + super.removeAttribute (index); + if (index != origMax) { + System.arraycopy (declared, index + 1, declared, index, + origMax - index); + System.arraycopy (specified, index + 1, specified, index, + origMax - index); + } } @@ -274,10 +274,10 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public void setDeclared (int index, boolean value) { - if (index < 0 || index >= getLength ()) - throw new ArrayIndexOutOfBoundsException ( - "No attribute at index: " + index); - declared [index] = value; + if (index < 0 || index >= getLength ()) + throw new ArrayIndexOutOfBoundsException ( + "No attribute at index: " + index); + declared [index] = value; } @@ -293,9 +293,9 @@ public class Attributes2Impl extends AttributesImpl implements Attributes2 */ public void setSpecified (int index, boolean value) { - if (index < 0 || index >= getLength ()) - throw new ArrayIndexOutOfBoundsException ( - "No attribute at index: " + index); - specified [index] = value; + if (index < 0 || index >= getLength ()) + throw new ArrayIndexOutOfBoundsException ( + "No attribute at index: " + index); + specified [index] = value; } } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/DeclHandler.java b/libjava/classpath/external/sax/org/xml/sax/ext/DeclHandler.java index 1bb4dea4a41..42d92269f6f 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/DeclHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/DeclHandler.java @@ -54,9 +54,9 @@ public interface DeclHandler * <p>The content model will consist of the string "EMPTY", the * string "ANY", or a parenthesised group, optionally followed * by an occurrence indicator. The model will be normalized so - * that all parameter entities are fully resolved and all whitespace + * that all parameter entities are fully resolved and all whitespace * is removed,and will include the enclosing parentheses. Other - * normalization (such as removing redundant parentheses or + * normalization (such as removing redundant parentheses or * simplifying occurrence indicators) is at the discretion of the * parser.</p> * @@ -65,7 +65,7 @@ public interface DeclHandler * @exception SAXException The application may raise an exception. */ public abstract void elementDecl (String name, String model) - throws SAXException; + throws SAXException; /** @@ -74,7 +74,7 @@ public interface DeclHandler * <p>Only the effective (first) declaration for an attribute will * be reported. The type will be one of the strings "CDATA", * "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY", - * "ENTITIES", a parenthesized token group with + * "ENTITIES", a parenthesized token group with * the separator "|" and all whitespace removed, or the word * "NOTATION" followed by a space followed by a parenthesized * token group with all whitespace removed.</p> @@ -94,11 +94,11 @@ public interface DeclHandler * @exception SAXException The application may raise an exception. */ public abstract void attributeDecl (String eName, - String aName, - String type, - String mode, - String value) - throws SAXException; + String aName, + String type, + String mode, + String value) + throws SAXException; /** @@ -116,7 +116,7 @@ public interface DeclHandler * @see org.xml.sax.DTDHandler#unparsedEntityDecl */ public abstract void internalEntityDecl (String name, String value) - throws SAXException; + throws SAXException; /** @@ -138,8 +138,8 @@ public interface DeclHandler * @see org.xml.sax.DTDHandler#unparsedEntityDecl */ public abstract void externalEntityDecl (String name, String publicId, - String systemId) - throws SAXException; + String systemId) + throws SAXException; } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/DefaultHandler2.java b/libjava/classpath/external/sax/org/xml/sax/ext/DefaultHandler2.java index 2b792e9df24..bf47ea889df 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/DefaultHandler2.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/DefaultHandler2.java @@ -45,52 +45,52 @@ public class DefaultHandler2 extends DefaultHandler public void startCDATA () throws SAXException - {} + {} public void endCDATA () throws SAXException - {} + {} public void startDTD (String name, String publicId, String systemId) throws SAXException - {} + {} public void endDTD () throws SAXException - {} + {} public void startEntity (String name) throws SAXException - {} + {} public void endEntity (String name) throws SAXException - {} + {} public void comment (char ch [], int start, int length) throws SAXException - { } + { } // SAX2 ext-1.0 DeclHandler public void attributeDecl (String eName, String aName, - String type, String mode, String value) + String type, String mode, String value) throws SAXException - {} + {} public void elementDecl (String name, String model) throws SAXException - {} + {} public void externalEntityDecl (String name, - String publicId, String systemId) + String publicId, String systemId) throws SAXException - {} + {} public void internalEntityDecl (String name, String value) throws SAXException - {} + {} // SAX2 ext-1.1 EntityResolver2 @@ -100,22 +100,22 @@ public class DefaultHandler2 extends DefaultHandler */ public InputSource getExternalSubset (String name, String baseURI) throws SAXException, IOException - { return null; } + { return null; } /** * Tells the parser to resolve the systemId against the baseURI * and read the entity text from that resulting absolute URI. * Note that because the older * {@link DefaultHandler#resolveEntity DefaultHandler.resolveEntity()}, - * method is overridden to call this one, this method may sometimes + * method is overridden to call this one, this method may sometimes * be invoked with null <em>name</em> and <em>baseURI</em>, and * with the <em>systemId</em> already absolutized. */ public InputSource resolveEntity (String name, String publicId, - String baseURI, String systemId) + String baseURI, String systemId) throws SAXException, IOException - { return null; } - + { return null; } + // SAX1 EntityResolver /** @@ -126,5 +126,5 @@ public class DefaultHandler2 extends DefaultHandler */ public InputSource resolveEntity (String publicId, String systemId) throws SAXException, IOException - { return resolveEntity (null, publicId, null, systemId); } + { return resolveEntity (null, publicId, null, systemId); } } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/EntityResolver2.java b/libjava/classpath/external/sax/org/xml/sax/ext/EntityResolver2.java index 1936f7e0421..96dcf6779b7 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/EntityResolver2.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/EntityResolver2.java @@ -108,28 +108,28 @@ public interface EntityResolver2 extends EntityResolver * that attributes are handled consistently. * For example, an XPath processor needs to know which attibutes have * type "ID" before it can process a widely used type of reference.</p> - * + * * <p><strong>Warning:</strong> Returning an external subset modifies * the input document. By providing definitions for general entities, * it can make a malformed document appear to be well formed. * </p> * * @param name Identifies the document root element. This name comes - * from a DOCTYPE declaration (where available) or from the actual - * root element. + * from a DOCTYPE declaration (where available) or from the actual + * root element. * @param baseURI The document's base URI, serving as an additional - * hint for selecting the external subset. This is always an absolute - * URI, unless it is null because the XMLReader was given an InputSource - * without one. + * hint for selecting the external subset. This is always an absolute + * URI, unless it is null because the XMLReader was given an InputSource + * without one. * * @return An InputSource object describing the new external subset - * to be used by the parser, or null to indicate that no external - * subset is provided. + * to be used by the parser, or null to indicate that no external + * subset is provided. * * @exception SAXException Any SAX exception, possibly wrapping - * another exception. + * another exception. * @exception IOException Probably indicating a failure to create - * a new InputStream or Reader, or an illegal URL. + * a new InputStream or Reader, or an illegal URL. */ public InputSource getExternalSubset (String name, String baseURI) throws SAXException, IOException; @@ -142,8 +142,8 @@ public interface EntityResolver2 extends EntityResolver * This method provides more flexibility than the {@link EntityResolver} * interface, supporting implementations of more complex catalogue * schemes such as the one defined by the <a href= - "http://www.oasis-open.org/committees/entity/spec-2001-08-06.html" - >OASIS XML Catalogs</a> specification.</p> + "http://www.oasis-open.org/committees/entity/spec-2001-08-06.html" + >OASIS XML Catalogs</a> specification.</p> * * <p>Parsers configured to use this resolver method will call it * to determine the input source to use for any external entity @@ -156,42 +156,42 @@ public interface EntityResolver2 extends EntityResolver * * <p>Note that the entity naming scheme used here is the same one * used in the {@link LexicalHandler}, or in the {@link - org.xml.sax.ContentHandler#skippedEntity - ContentHandler.skippedEntity()} + org.xml.sax.ContentHandler#skippedEntity + ContentHandler.skippedEntity()} * method. </p> * * @param name Identifies the external entity being resolved. - * Either "[dtd]" for the external subset, or a name starting - * with "%" to indicate a parameter entity, or else the name of - * a general entity. This is never null when invoked by a SAX2 - * parser. + * Either "[dtd]" for the external subset, or a name starting + * with "%" to indicate a parameter entity, or else the name of + * a general entity. This is never null when invoked by a SAX2 + * parser. * @param publicId The public identifier of the external entity being - * referenced (normalized as required by the XML specification), or - * null if none was supplied. + * referenced (normalized as required by the XML specification), or + * null if none was supplied. * @param baseURI The URI with respect to which relative systemIDs - * are interpreted. This is always an absolute URI, unless it is - * null (likely because the XMLReader was given an InputSource without + * are interpreted. This is always an absolute URI, unless it is + * null (likely because the XMLReader was given an InputSource without * one). This URI is defined by the XML specification to be the one - * associated with the "<" starting the relevant declaration. + * associated with the "<" starting the relevant declaration. * @param systemId The system identifier of the external entity - * being referenced; either a relative or absolute URI. + * being referenced; either a relative or absolute URI. * This is never null when invoked by a SAX2 parser; only declared - * entities, and any external subset, are resolved by such parsers. + * entities, and any external subset, are resolved by such parsers. * * @return An InputSource object describing the new input source to - * be used by the parser. Returning null directs the parser to - * resolve the system ID against the base URI and open a connection - * to resulting URI. + * be used by the parser. Returning null directs the parser to + * resolve the system ID against the base URI and open a connection + * to resulting URI. * * @exception SAXException Any SAX exception, possibly wrapping - * another exception. + * another exception. * @exception IOException Probably indicating a failure to create - * a new InputStream or Reader, or an illegal URL. + * a new InputStream or Reader, or an illegal URL. */ public InputSource resolveEntity ( - String name, - String publicId, - String baseURI, - String systemId + String name, + String publicId, + String baseURI, + String systemId ) throws SAXException, IOException; } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/LexicalHandler.java b/libjava/classpath/external/sax/org/xml/sax/ext/LexicalHandler.java index 076bdf857c2..376d1c8d005 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/LexicalHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/LexicalHandler.java @@ -51,7 +51,7 @@ public interface LexicalHandler * DOCTYPE declaration; if the document has no DOCTYPE declaration, * this method will not be invoked.</p> * - * <p>All declarations reported through + * <p>All declarations reported through * {@link org.xml.sax.DTDHandler DTDHandler} or * {@link org.xml.sax.ext.DeclHandler DeclHandler} events must appear * between the startDTD and {@link #endDTD endDTD} events. @@ -59,14 +59,14 @@ public interface LexicalHandler * unless they appear between {@link #startEntity startEntity} * and {@link #endEntity endEntity} events. Comments and * processing instructions from the DTD should also be reported - * between the startDTD and endDTD events, in their original + * between the startDTD and endDTD events, in their original * order of (logical) occurrence; they are not required to * appear in their correct locations relative to DTDHandler * or DeclHandler events, however.</p> * * <p>Note that the start/endDTD events will appear within * the start/endDocument events from ContentHandler and - * before the first + * before the first * {@link org.xml.sax.ContentHandler#startElement startElement} * event.</p> * @@ -83,8 +83,8 @@ public interface LexicalHandler * @see #startEntity */ public abstract void startDTD (String name, String publicId, - String systemId) - throws SAXException; + String systemId) + throws SAXException; /** @@ -98,7 +98,7 @@ public interface LexicalHandler * @see #startDTD */ public abstract void endDTD () - throws SAXException; + throws SAXException; /** @@ -112,12 +112,12 @@ public interface LexicalHandler * feature to query or control the reporting of parameter entities.</p> * * <p>General entities are reported with their regular names, - * parameter entities have '%' prepended to their names, and + * parameter entities have '%' prepended to their names, and * the external DTD subset has the pseudo-entity name "[dtd]".</p> * - * <p>When a SAX2 driver is providing these events, all other - * events must be properly nested within start/end entity - * events. There is no additional requirement that events from + * <p>When a SAX2 driver is providing these events, all other + * events must be properly nested within start/end entity + * events. There is no additional requirement that events from * {@link org.xml.sax.ext.DeclHandler DeclHandler} or * {@link org.xml.sax.DTDHandler DTDHandler} be properly ordered.</p> * @@ -126,7 +126,7 @@ public interface LexicalHandler * event, which is part of the ContentHandler interface.</p> * * <p>Because of the streaming event model that SAX uses, some - * entity boundaries cannot be reported under any + * entity boundaries cannot be reported under any * circumstances:</p> * * <ul> @@ -148,10 +148,10 @@ public interface LexicalHandler * @exception SAXException The application may raise an exception. * @see #endEntity * @see org.xml.sax.ext.DeclHandler#internalEntityDecl - * @see org.xml.sax.ext.DeclHandler#externalEntityDecl + * @see org.xml.sax.ext.DeclHandler#externalEntityDecl */ public abstract void startEntity (String name) - throws SAXException; + throws SAXException; /** @@ -162,7 +162,7 @@ public interface LexicalHandler * @see #startEntity */ public abstract void endEntity (String name) - throws SAXException; + throws SAXException; /** @@ -177,7 +177,7 @@ public interface LexicalHandler * @see #endCDATA */ public abstract void startCDATA () - throws SAXException; + throws SAXException; /** @@ -187,7 +187,7 @@ public interface LexicalHandler * @see #startCDATA */ public abstract void endCDATA () - throws SAXException; + throws SAXException; /** @@ -205,7 +205,7 @@ public interface LexicalHandler * @exception SAXException The application may raise an exception. */ public abstract void comment (char ch[], int start, int length) - throws SAXException; + throws SAXException; } diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/Locator2.java b/libjava/classpath/external/sax/org/xml/sax/ext/Locator2.java index 5fe3ba7706a..b186d3a282c 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/Locator2.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/Locator2.java @@ -9,7 +9,7 @@ import org.xml.sax.Locator; /** - * SAX2 extension to augment the entity information provided + * SAX2 extension to augment the entity information provided * though a {@link Locator}. * If an implementation supports this extension, the Locator * provided in {@link org.xml.sax.ContentHandler#setDocumentLocator diff --git a/libjava/classpath/external/sax/org/xml/sax/ext/Locator2Impl.java b/libjava/classpath/external/sax/org/xml/sax/ext/Locator2Impl.java index f0b35459dba..d3c7511144f 100644 --- a/libjava/classpath/external/sax/org/xml/sax/ext/Locator2Impl.java +++ b/libjava/classpath/external/sax/org/xml/sax/ext/Locator2Impl.java @@ -26,8 +26,8 @@ import org.xml.sax.helpers.LocatorImpl; */ public class Locator2Impl extends LocatorImpl implements Locator2 { - private String encoding; - private String version; + private String encoding; + private String version; /** @@ -41,32 +41,32 @@ public class Locator2Impl extends LocatorImpl implements Locator2 * Copy an existing Locator or Locator2 object. * If the object implements Locator2, values of the * <em>encoding</em> and <em>version</em>strings are copied, - * otherwise they set to <em>null</em>. + * otherwise they set to <em>null</em>. * * @param locator The existing Locator object. */ public Locator2Impl (Locator locator) { - super (locator); - if (locator instanceof Locator2) { - Locator2 l2 = (Locator2) locator; + super (locator); + if (locator instanceof Locator2) { + Locator2 l2 = (Locator2) locator; - version = l2.getXMLVersion (); - encoding = l2.getEncoding (); - } + version = l2.getXMLVersion (); + encoding = l2.getEncoding (); + } } //////////////////////////////////////////////////////////////////// // Locator2 method implementations //////////////////////////////////////////////////////////////////// - + /** * Returns the current value of the version property. * * @see #setXMLVersion */ public String getXMLVersion () - { return version; } + { return version; } /** * Returns the current value of the encoding property. @@ -74,13 +74,13 @@ public class Locator2Impl extends LocatorImpl implements Locator2 * @see #setEncoding */ public String getEncoding () - { return encoding; } + { return encoding; } //////////////////////////////////////////////////////////////////// - // Setters + // Setters //////////////////////////////////////////////////////////////////// - + /** * Assigns the current value of the version property. * @@ -88,7 +88,7 @@ public class Locator2Impl extends LocatorImpl implements Locator2 * @see #getXMLVersion */ public void setXMLVersion (String version) - { this.version = version; } + { this.version = version; } /** * Assigns the current value of the encoding property. @@ -97,5 +97,5 @@ public class Locator2Impl extends LocatorImpl implements Locator2 * @see #getEncoding */ public void setEncoding (String encoding) - { this.encoding = encoding; } + { this.encoding = encoding; } } diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/AttributeListImpl.java b/libjava/classpath/external/sax/org/xml/sax/helpers/AttributeListImpl.java index ca859fb1450..decf3abc199 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/AttributeListImpl.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/AttributeListImpl.java @@ -26,10 +26,10 @@ import java.util.Vector; * AttributesImpl} interface.</p> * * <p>This class provides a convenience implementation of the SAX - * {@link org.xml.sax.AttributeList AttributeList} interface. This - * implementation is useful both for SAX parser writers, who can use - * it to provide attributes to the application, and for SAX application - * writers, who can use it to create a persistent copy of an element's + * {@link org.xml.sax.AttributeList AttributeList} interface. This + * implementation is useful both for SAX parser writers, who can use + * it to provide attributes to the application, and for SAX application + * writers, who can use it to create a persistent copy of an element's * attribute specifications:</p> * * <pre> @@ -46,7 +46,7 @@ import java.util.Vector; * * <p>Please note that SAX parsers are not required to use this * class to provide an implementation of AttributeList; it is - * supplied only as an optional convenience. In particular, + * supplied only as an optional convenience. In particular, * parser writers are encouraged to invent more efficient * implementations.</p> * @@ -55,17 +55,17 @@ import java.util.Vector; * that interface has been replaced by * {@link org.xml.sax.Attributes Attributes}, * which is implemented in the - * {@link org.xml.sax.helpers.AttributesImpl + * {@link org.xml.sax.helpers.AttributesImpl * AttributesImpl} helper class. * @since SAX 1.0 * @author David Megginson * @version 2.0.1 (sax2r2) * @see org.xml.sax.AttributeList - * @see org.xml.sax.DocumentHandler#startElement + * @see org.xml.sax.DocumentHandler#startElement */ public class AttributeListImpl implements AttributeList { - + /** * Create an empty attribute list. * @@ -79,8 +79,8 @@ public class AttributeListImpl implements AttributeList public AttributeListImpl () { } - - + + /** * Construct a persistent copy of an existing attribute list. * @@ -93,16 +93,16 @@ public class AttributeListImpl implements AttributeList */ public AttributeListImpl (AttributeList atts) { - setAttributeList(atts); + setAttributeList(atts); } - - - + + + //////////////////////////////////////////////////////////////////// // Methods specific to this class. //////////////////////////////////////////////////////////////////// - - + + /** * Set the attribute list, discarding previous contents. * @@ -113,16 +113,16 @@ public class AttributeListImpl implements AttributeList */ public void setAttributeList (AttributeList atts) { - int count = atts.getLength(); - - clear(); - - for (int i = 0; i < count; i++) { - addAttribute(atts.getName(i), atts.getType(i), atts.getValue(i)); - } + int count = atts.getLength(); + + clear(); + + for (int i = 0; i < count; i++) { + addAttribute(atts.getName(i), atts.getType(i), atts.getValue(i)); + } } - - + + /** * Add an attribute to an attribute list. * @@ -138,12 +138,12 @@ public class AttributeListImpl implements AttributeList */ public void addAttribute (String name, String type, String value) { - names.addElement(name); - types.addElement(type); - values.addElement(value); + names.addElement(name); + types.addElement(type); + values.addElement(value); } - - + + /** * Remove an attribute from the list. * @@ -160,16 +160,16 @@ public class AttributeListImpl implements AttributeList */ public void removeAttribute (String name) { - int i = names.indexOf(name); - - if (i >= 0) { - names.removeElementAt(i); - types.removeElementAt(i); - values.removeElementAt(i); - } + int i = names.indexOf(name); + + if (i >= 0) { + names.removeElementAt(i); + types.removeElementAt(i); + values.removeElementAt(i); + } } - - + + /** * Clear the attribute list. * @@ -182,18 +182,18 @@ public class AttributeListImpl implements AttributeList */ public void clear () { - names.removeAllElements(); - types.removeAllElements(); - values.removeAllElements(); + names.removeAllElements(); + types.removeAllElements(); + values.removeAllElements(); } - - - + + + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.AttributeList //////////////////////////////////////////////////////////////////// - - + + /** * Return the number of attributes in the list. * @@ -202,10 +202,10 @@ public class AttributeListImpl implements AttributeList */ public int getLength () { - return names.size(); + return names.size(); } - - + + /** * Get the name of an attribute (by position). * @@ -216,17 +216,17 @@ public class AttributeListImpl implements AttributeList */ public String getName (int i) { - if (i < 0) { - return null; - } - try { - return (String)names.elementAt(i); - } catch (ArrayIndexOutOfBoundsException e) { - return null; - } + if (i < 0) { + return null; + } + try { + return (String)names.elementAt(i); + } catch (ArrayIndexOutOfBoundsException e) { + return null; + } } - - + + /** * Get the type of an attribute (by position). * @@ -239,17 +239,17 @@ public class AttributeListImpl implements AttributeList */ public String getType (int i) { - if (i < 0) { - return null; - } - try { - return (String)types.elementAt(i); - } catch (ArrayIndexOutOfBoundsException e) { - return null; - } + if (i < 0) { + return null; + } + try { + return (String)types.elementAt(i); + } catch (ArrayIndexOutOfBoundsException e) { + return null; + } } - - + + /** * Get the value of an attribute (by position). * @@ -260,17 +260,17 @@ public class AttributeListImpl implements AttributeList */ public String getValue (int i) { - if (i < 0) { - return null; - } - try { - return (String)values.elementAt(i); - } catch (ArrayIndexOutOfBoundsException e) { - return null; - } + if (i < 0) { + return null; + } + try { + return (String)values.elementAt(i); + } catch (ArrayIndexOutOfBoundsException e) { + return null; + } } - - + + /** * Get the type of an attribute (by name). * @@ -282,10 +282,10 @@ public class AttributeListImpl implements AttributeList */ public String getType (String name) { - return getType(names.indexOf(name)); + return getType(names.indexOf(name)); } - - + + /** * Get the value of an attribute (by name). * @@ -294,11 +294,11 @@ public class AttributeListImpl implements AttributeList */ public String getValue (String name) { - return getValue(names.indexOf(name)); + return getValue(names.indexOf(name)); } - - - + + + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/AttributesImpl.java b/libjava/classpath/external/sax/org/xml/sax/helpers/AttributesImpl.java index 8753968ba0a..589b9209fae 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/AttributesImpl.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/AttributesImpl.java @@ -20,8 +20,8 @@ import org.xml.sax.Attributes; * </blockquote> * * <p>This class provides a default implementation of the SAX2 - * {@link org.xml.sax.Attributes Attributes} interface, with the - * addition of manipulators so that the list can be modified or + * {@link org.xml.sax.Attributes Attributes} interface, with the + * addition of manipulators so that the list can be modified or * reused.</p> * * <p>There are two typical uses of this class:</p> @@ -32,11 +32,11 @@ import org.xml.sax.Attributes; * <li>to construct or modify an Attributes object in a SAX2 driver or filter.</li> * </ol> * - * <p>This class replaces the now-deprecated SAX1 {@link + * <p>This class replaces the now-deprecated SAX1 {@link * org.xml.sax.helpers.AttributeListImpl AttributeListImpl} * class; in addition to supporting the updated Attributes * interface rather than the deprecated {@link org.xml.sax.AttributeList - * AttributeList} interface, it also includes a much more efficient + * AttributeList} interface, it also includes a much more efficient * implementation using a single array rather than a set of Vectors.</p> * * @since SAX 2.0 @@ -46,7 +46,7 @@ import org.xml.sax.Attributes; public class AttributesImpl implements Attributes { - + //////////////////////////////////////////////////////////////////// // Constructors. //////////////////////////////////////////////////////////////////// @@ -57,8 +57,8 @@ public class AttributesImpl implements Attributes */ public AttributesImpl () { - length = 0; - data = null; + length = 0; + data = null; } @@ -72,11 +72,11 @@ public class AttributesImpl implements Attributes */ public AttributesImpl (Attributes atts) { - setAttributes(atts); + setAttributes(atts); } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.Attributes. //////////////////////////////////////////////////////////////////// @@ -90,7 +90,7 @@ public class AttributesImpl implements Attributes */ public int getLength () { - return length; + return length; } @@ -104,11 +104,11 @@ public class AttributesImpl implements Attributes */ public String getURI (int index) { - if (index >= 0 && index < length) { - return data[index*5]; - } else { - return null; - } + if (index >= 0 && index < length) { + return data[index*5]; + } else { + return null; + } } @@ -116,17 +116,17 @@ public class AttributesImpl implements Attributes * Return an attribute's local name. * * @param index The attribute's index (zero-based). - * @return The attribute's local name, the empty string if + * @return The attribute's local name, the empty string if * none is available, or null if the index if out of range. * @see org.xml.sax.Attributes#getLocalName */ public String getLocalName (int index) { - if (index >= 0 && index < length) { - return data[index*5+1]; - } else { - return null; - } + if (index >= 0 && index < length) { + return data[index*5+1]; + } else { + return null; + } } @@ -134,17 +134,17 @@ public class AttributesImpl implements Attributes * Return an attribute's qualified (prefixed) name. * * @param index The attribute's index (zero-based). - * @return The attribute's qualified name, the empty string if + * @return The attribute's qualified name, the empty string if * none is available, or null if the index is out of bounds. * @see org.xml.sax.Attributes#getQName */ public String getQName (int index) { - if (index >= 0 && index < length) { - return data[index*5+2]; - } else { - return null; - } + if (index >= 0 && index < length) { + return data[index*5+2]; + } else { + return null; + } } @@ -158,11 +158,11 @@ public class AttributesImpl implements Attributes */ public String getType (int index) { - if (index >= 0 && index < length) { - return data[index*5+3]; - } else { - return null; - } + if (index >= 0 && index < length) { + return data[index*5+3]; + } else { + return null; + } } @@ -175,11 +175,11 @@ public class AttributesImpl implements Attributes */ public String getValue (int index) { - if (index >= 0 && index < length) { - return data[index*5+4]; - } else { - return null; - } + if (index >= 0 && index < length) { + return data[index*5+4]; + } else { + return null; + } } @@ -198,13 +198,13 @@ public class AttributesImpl implements Attributes */ public int getIndex (String uri, String localName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i].equals(uri) && data[i+1].equals(localName)) { - return i / 5; - } - } - return -1; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i].equals(uri) && data[i+1].equals(localName)) { + return i / 5; + } + } + return -1; } @@ -217,13 +217,13 @@ public class AttributesImpl implements Attributes */ public int getIndex (String qName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i+2].equals(qName)) { - return i / 5; - } - } - return -1; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i+2].equals(qName)) { + return i / 5; + } + } + return -1; } @@ -239,13 +239,13 @@ public class AttributesImpl implements Attributes */ public String getType (String uri, String localName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i].equals(uri) && data[i+1].equals(localName)) { - return data[i+3]; - } - } - return null; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i].equals(uri) && data[i+1].equals(localName)) { + return data[i+3]; + } + } + return null; } @@ -259,13 +259,13 @@ public class AttributesImpl implements Attributes */ public String getType (String qName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i+2].equals(qName)) { - return data[i+3]; - } - } - return null; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i+2].equals(qName)) { + return data[i+3]; + } + } + return null; } @@ -281,13 +281,13 @@ public class AttributesImpl implements Attributes */ public String getValue (String uri, String localName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i].equals(uri) && data[i+1].equals(localName)) { - return data[i+4]; - } - } - return null; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i].equals(uri) && data[i+1].equals(localName)) { + return data[i+4]; + } + } + return null; } @@ -301,17 +301,17 @@ public class AttributesImpl implements Attributes */ public String getValue (String qName) { - int max = length * 5; - for (int i = 0; i < max; i += 5) { - if (data[i+2].equals(qName)) { - return data[i+4]; - } - } - return null; + int max = length * 5; + for (int i = 0; i < max; i += 5) { + if (data[i+2].equals(qName)) { + return data[i+4]; + } + } + return null; } - + //////////////////////////////////////////////////////////////////// // Manipulators. //////////////////////////////////////////////////////////////////// @@ -321,16 +321,16 @@ public class AttributesImpl implements Attributes * Clear the attribute list for reuse. * * <p>Note that little memory is freed by this call: - * the current array is kept so it can be + * the current array is kept so it can be * reused.</p> */ public void clear () { - if (data != null) { - for (int i = 0; i < (length * 5); i++) - data [i] = null; - } - length = 0; + if (data != null) { + for (int i = 0; i < (length * 5); i++) + data [i] = null; + } + length = 0; } @@ -339,7 +339,7 @@ public class AttributesImpl implements Attributes * * <p>It may be more efficient to reuse an existing object * rather than constantly allocating new ones.</p> - * + * * @param atts The attributes to copy. */ public void setAttributes (Attributes atts) @@ -355,7 +355,7 @@ public class AttributesImpl implements Attributes data[i*5+3] = atts.getType(i); data[i*5+4] = atts.getValue(i); } - } + } } @@ -377,15 +377,15 @@ public class AttributesImpl implements Attributes * @param value The attribute value. */ public void addAttribute (String uri, String localName, String qName, - String type, String value) + String type, String value) { - ensureCapacity(length+1); - data[length*5] = uri; - data[length*5+1] = localName; - data[length*5+2] = qName; - data[length*5+3] = type; - data[length*5+4] = value; - length++; + ensureCapacity(length+1); + data[length*5] = uri; + data[length*5+1] = localName; + data[length*5+2] = qName; + data[length*5+3] = type; + data[length*5+4] = value; + length++; } @@ -411,17 +411,17 @@ public class AttributesImpl implements Attributes * in the list. */ public void setAttribute (int index, String uri, String localName, - String qName, String type, String value) + String qName, String type, String value) { - if (index >= 0 && index < length) { - data[index*5] = uri; - data[index*5+1] = localName; - data[index*5+2] = qName; - data[index*5+3] = type; - data[index*5+4] = value; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5] = uri; + data[index*5+1] = localName; + data[index*5+2] = qName; + data[index*5+3] = type; + data[index*5+4] = value; + } else { + badIndex(index); + } } @@ -435,21 +435,21 @@ public class AttributesImpl implements Attributes */ public void removeAttribute (int index) { - if (index >= 0 && index < length) { - if (index < length - 1) { - System.arraycopy(data, (index+1)*5, data, index*5, - (length-index-1)*5); - } - index = (length - 1) * 5; - data [index++] = null; - data [index++] = null; - data [index++] = null; - data [index++] = null; - data [index] = null; - length--; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + if (index < length - 1) { + System.arraycopy(data, (index+1)*5, data, index*5, + (length-index-1)*5); + } + index = (length - 1) * 5; + data [index++] = null; + data [index++] = null; + data [index++] = null; + data [index++] = null; + data [index] = null; + length--; + } else { + badIndex(index); + } } @@ -465,11 +465,11 @@ public class AttributesImpl implements Attributes */ public void setURI (int index, String uri) { - if (index >= 0 && index < length) { - data[index*5] = uri; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5] = uri; + } else { + badIndex(index); + } } @@ -485,11 +485,11 @@ public class AttributesImpl implements Attributes */ public void setLocalName (int index, String localName) { - if (index >= 0 && index < length) { - data[index*5+1] = localName; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5+1] = localName; + } else { + badIndex(index); + } } @@ -505,11 +505,11 @@ public class AttributesImpl implements Attributes */ public void setQName (int index, String qName) { - if (index >= 0 && index < length) { - data[index*5+2] = qName; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5+2] = qName; + } else { + badIndex(index); + } } @@ -524,11 +524,11 @@ public class AttributesImpl implements Attributes */ public void setType (int index, String type) { - if (index >= 0 && index < length) { - data[index*5+3] = type; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5+3] = type; + } else { + badIndex(index); + } } @@ -543,15 +543,15 @@ public class AttributesImpl implements Attributes */ public void setValue (int index, String value) { - if (index >= 0 && index < length) { - data[index*5+4] = value; - } else { - badIndex(index); - } + if (index >= 0 && index < length) { + data[index*5+4] = value; + } else { + badIndex(index); + } } - + //////////////////////////////////////////////////////////////////// // Internal methods. //////////////////////////////////////////////////////////////////// @@ -596,15 +596,15 @@ public class AttributesImpl implements Attributes * @exception java.lang.ArrayIndexOutOfBoundsException Always. */ private void badIndex (int index) - throws ArrayIndexOutOfBoundsException + throws ArrayIndexOutOfBoundsException { - String msg = - "Attempt to modify attribute at illegal index: " + index; - throw new ArrayIndexOutOfBoundsException(msg); + String msg = + "Attempt to modify attribute at illegal index: " + index; + throw new ArrayIndexOutOfBoundsException(msg); } - + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// @@ -615,4 +615,3 @@ public class AttributesImpl implements Attributes } // end of AttributesImpl.java - diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/DefaultHandler.java b/libjava/classpath/external/sax/org/xml/sax/helpers/DefaultHandler.java index e01c3be403d..f3d6eae44c6 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/DefaultHandler.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/DefaultHandler.java @@ -59,12 +59,12 @@ import org.xml.sax.SAXParseException; public class DefaultHandler implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler { - - + + //////////////////////////////////////////////////////////////////// // Default implementation of the EntityResolver interface. //////////////////////////////////////////////////////////////////// - + /** * Resolve an external entity. * @@ -76,7 +76,7 @@ public class DefaultHandler * * @param publicId The public identifer, or null if none is * available. - * @param systemId The system identifier provided in the XML + * @param systemId The system identifier provided in the XML * document. * @return The new input source, or null to require the * default behaviour. @@ -87,18 +87,18 @@ public class DefaultHandler * @see org.xml.sax.EntityResolver#resolveEntity */ public InputSource resolveEntity (String publicId, String systemId) - throws IOException, SAXException + throws IOException, SAXException { - return null; + return null; } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of DTDHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive notification of a notation declaration. * @@ -115,12 +115,12 @@ public class DefaultHandler * @see org.xml.sax.DTDHandler#notationDecl */ public void notationDecl (String name, String publicId, String systemId) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of an unparsed entity declaration. * @@ -138,19 +138,19 @@ public class DefaultHandler * @see org.xml.sax.DTDHandler#unparsedEntityDecl */ public void unparsedEntityDecl (String name, String publicId, - String systemId, String notationName) - throws SAXException + String systemId, String notationName) + throws SAXException { - // no op + // no op } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of ContentHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive a Locator object for document events. * @@ -164,10 +164,10 @@ public class DefaultHandler */ public void setDocumentLocator (Locator locator) { - // no op + // no op } - - + + /** * Receive notification of the beginning of the document. * @@ -181,12 +181,12 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#startDocument */ public void startDocument () - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the end of the document. * @@ -200,9 +200,9 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#endDocument */ public void endDocument () - throws SAXException + throws SAXException { - // no op + // no op } @@ -220,9 +220,9 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#startPrefixMapping */ public void startPrefixMapping (String prefix, String uri) - throws SAXException + throws SAXException { - // no op + // no op } @@ -239,12 +239,12 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#endPrefixMapping */ public void endPrefixMapping (String prefix) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the start of an element. * @@ -269,13 +269,13 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#startElement */ public void startElement (String uri, String localName, - String qName, Attributes attributes) - throws SAXException + String qName, Attributes attributes) + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of the end of an element. * @@ -297,12 +297,12 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#endElement */ public void endElement (String uri, String localName, String qName) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of character data inside an element. * @@ -320,12 +320,12 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#characters */ public void characters (char ch[], int start, int length) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of ignorable whitespace in element content. * @@ -343,12 +343,12 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#ignorableWhitespace */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of a processing instruction. * @@ -365,9 +365,9 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#processingInstruction */ public void processingInstruction (String target, String data) - throws SAXException + throws SAXException { - // no op + // no op } @@ -385,18 +385,18 @@ public class DefaultHandler * @see org.xml.sax.ContentHandler#processingInstruction */ public void skippedEntity (String name) - throws SAXException + throws SAXException { - // no op + // no op } - - - + + + //////////////////////////////////////////////////////////////////// // Default implementation of the ErrorHandler interface. //////////////////////////////////////////////////////////////////// - - + + /** * Receive notification of a parser warning. * @@ -412,12 +412,12 @@ public class DefaultHandler * @see org.xml.sax.SAXParseException */ public void warning (SAXParseException e) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Receive notification of a recoverable parser error. * @@ -433,12 +433,12 @@ public class DefaultHandler * @see org.xml.sax.SAXParseException */ public void error (SAXParseException e) - throws SAXException + throws SAXException { - // no op + // no op } - - + + /** * Report a fatal XML parsing error. * @@ -457,11 +457,11 @@ public class DefaultHandler * @see org.xml.sax.SAXParseException */ public void fatalError (SAXParseException e) - throws SAXException + throws SAXException { - throw e; + throw e; } - + } // end of DefaultHandler.java diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/LocatorImpl.java b/libjava/classpath/external/sax/org/xml/sax/helpers/LocatorImpl.java index 6fa4857277c..d45813e5b00 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/LocatorImpl.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/LocatorImpl.java @@ -51,8 +51,8 @@ import org.xml.sax.Locator; */ public class LocatorImpl implements Locator { - - + + /** * Zero-argument constructor. * @@ -62,8 +62,8 @@ public class LocatorImpl implements Locator public LocatorImpl () { } - - + + /** * Copy constructor. * @@ -76,19 +76,19 @@ public class LocatorImpl implements Locator */ public LocatorImpl (Locator locator) { - setPublicId(locator.getPublicId()); - setSystemId(locator.getSystemId()); - setLineNumber(locator.getLineNumber()); - setColumnNumber(locator.getColumnNumber()); + setPublicId(locator.getPublicId()); + setSystemId(locator.getSystemId()); + setLineNumber(locator.getLineNumber()); + setColumnNumber(locator.getColumnNumber()); } - - - + + + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.Locator //////////////////////////////////////////////////////////////////// - - + + /** * Return the saved public identifier. * @@ -99,10 +99,10 @@ public class LocatorImpl implements Locator */ public String getPublicId () { - return publicId; + return publicId; } - - + + /** * Return the saved system identifier. * @@ -113,10 +113,10 @@ public class LocatorImpl implements Locator */ public String getSystemId () { - return systemId; + return systemId; } - - + + /** * Return the saved line number (1-based). * @@ -126,10 +126,10 @@ public class LocatorImpl implements Locator */ public int getLineNumber () { - return lineNumber; + return lineNumber; } - - + + /** * Return the saved column number (1-based). * @@ -139,42 +139,42 @@ public class LocatorImpl implements Locator */ public int getColumnNumber () { - return columnNumber; + return columnNumber; } - - - + + + //////////////////////////////////////////////////////////////////// // Setters for the properties (not in org.xml.sax.Locator) //////////////////////////////////////////////////////////////////// - - + + /** * Set the public identifier for this locator. * - * @param publicId The new public identifier, or null + * @param publicId The new public identifier, or null * if none is available. * @see #getPublicId */ public void setPublicId (String publicId) { - this.publicId = publicId; + this.publicId = publicId; } - - + + /** * Set the system identifier for this locator. * - * @param systemId The new system identifier, or null + * @param systemId The new system identifier, or null * if none is available. * @see #getSystemId */ public void setSystemId (String systemId) { - this.systemId = systemId; + this.systemId = systemId; } - - + + /** * Set the line number for this locator (1-based). * @@ -183,10 +183,10 @@ public class LocatorImpl implements Locator */ public void setLineNumber (int lineNumber) { - this.lineNumber = lineNumber; + this.lineNumber = lineNumber; } - - + + /** * Set the column number for this locator (1-based). * @@ -195,20 +195,20 @@ public class LocatorImpl implements Locator */ public void setColumnNumber (int columnNumber) { - this.columnNumber = columnNumber; + this.columnNumber = columnNumber; } - - - + + + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// - + private String publicId; private String systemId; private int lineNumber; private int columnNumber; - + } // end of LocatorImpl.java diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/NamespaceSupport.java b/libjava/classpath/external/sax/org/xml/sax/helpers/NamespaceSupport.java index 01e11faf83e..d1e74639ac4 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/NamespaceSupport.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/NamespaceSupport.java @@ -72,7 +72,7 @@ import java.util.Vector; public class NamespaceSupport { - + //////////////////////////////////////////////////////////////////// // Constants. //////////////////////////////////////////////////////////////////// @@ -87,16 +87,16 @@ public class NamespaceSupport * to the "xml" prefix.</p> */ public final static String XMLNS = - "http://www.w3.org/XML/1998/namespace"; + "http://www.w3.org/XML/1998/namespace"; /** * The namespace declaration URI as a constant. * The value is <code>http://www.w3.org/xmlns/2000/</code>, as defined * in a backwards-incompatible erratum to the "Namespaces in XML" - * recommendation. Because that erratum postdated SAX2, SAX2 defaults + * recommendation. Because that erratum postdated SAX2, SAX2 defaults * to the original recommendation, and does not normally use this URI. - * + * * * <p>This is the Namespace URI that is optionally applied to * <em>xmlns</em> and <em>xmlns:*</em> attributes, which are used to @@ -107,16 +107,16 @@ public class NamespaceSupport * @see #isNamespaceDeclUris */ public final static String NSDECL = - "http://www.w3.org/xmlns/2000/"; + "http://www.w3.org/xmlns/2000/"; /** * An empty enumeration. */ private final static Enumeration EMPTY_ENUMERATION = - new Vector().elements(); + new Vector().elements(); + - //////////////////////////////////////////////////////////////////// // Constructor. //////////////////////////////////////////////////////////////////// @@ -127,11 +127,11 @@ public class NamespaceSupport */ public NamespaceSupport () { - reset(); + reset(); } - + //////////////////////////////////////////////////////////////////// // Context management. //////////////////////////////////////////////////////////////////// @@ -150,11 +150,11 @@ public class NamespaceSupport */ public void reset () { - contexts = new Context[32]; - namespaceDeclUris = false; - contextPos = 0; - contexts[contextPos] = currentContext = new Context(); - currentContext.declarePrefix("xml", XMLNS); + contexts = new Context[32]; + namespaceDeclUris = false; + contextPos = 0; + contexts[contextPos] = currentContext = new Context(); + currentContext.declarePrefix("xml", XMLNS); } @@ -196,29 +196,29 @@ public class NamespaceSupport */ public void pushContext () { - int max = contexts.length; - - contexts [contextPos].declsOK = false; - contextPos++; - - // Extend the array if necessary - if (contextPos >= max) { - Context newContexts[] = new Context[max*2]; - System.arraycopy(contexts, 0, newContexts, 0, max); - max *= 2; - contexts = newContexts; - } - - // Allocate the context if necessary. - currentContext = contexts[contextPos]; - if (currentContext == null) { - contexts[contextPos] = currentContext = new Context(); - } - - // Set the parent, if any. - if (contextPos > 0) { - currentContext.setParent(contexts[contextPos - 1]); - } + int max = contexts.length; + + contexts [contextPos].declsOK = false; + contextPos++; + + // Extend the array if necessary + if (contextPos >= max) { + Context newContexts[] = new Context[max*2]; + System.arraycopy(contexts, 0, newContexts, 0, max); + max *= 2; + contexts = newContexts; + } + + // Allocate the context if necessary. + currentContext = contexts[contextPos]; + if (currentContext == null) { + contexts[contextPos] = currentContext = new Context(); + } + + // Set the parent, if any. + if (contextPos > 0) { + currentContext.setParent(contexts[contextPos - 1]); + } } @@ -237,16 +237,16 @@ public class NamespaceSupport */ public void popContext () { - contexts[contextPos].clear(); - contextPos--; - if (contextPos < 0) { - throw new EmptyStackException(); - } - currentContext = contexts[contextPos]; + contexts[contextPos].clear(); + contextPos--; + if (contextPos < 0) { + throw new EmptyStackException(); + } + currentContext = contexts[contextPos]; } - + //////////////////////////////////////////////////////////////////// // Operations within a context. //////////////////////////////////////////////////////////////////// @@ -281,8 +281,8 @@ public class NamespaceSupport * for attribute names, where the default prefix is not allowed.</p> * * @param prefix The prefix to declare, or the empty string to - * indicate the default element namespace. This may never have - * the value "xml" or "xmlns". + * indicate the default element namespace. This may never have + * the value "xml" or "xmlns". * @param uri The Namespace URI to associate with the prefix. * @return true if the prefix was legal, false otherwise * @@ -292,12 +292,12 @@ public class NamespaceSupport */ public boolean declarePrefix (String prefix, String uri) { - if (prefix.equals("xml") || prefix.equals("xmlns")) { - return false; - } else { - currentContext.declarePrefix(prefix, uri); - return true; - } + if (prefix.equals("xml") || prefix.equals("xmlns")) { + return false; + } else { + currentContext.declarePrefix(prefix, uri); + return true; + } } @@ -335,24 +335,24 @@ public class NamespaceSupport * holding at least three members. * @param isAttribute A flag indicating whether this is an * attribute name (true) or an element name (false). - * @return The supplied array holding three internalized strings + * @return The supplied array holding three internalized strings * representing the Namespace URI (or empty string), the * local name, and the XML qualified name; or null if there * is an undeclared prefix. * @see #declarePrefix * @see java.lang.String#intern */ public String [] processName (String qName, String parts[], - boolean isAttribute) + boolean isAttribute) { - String myParts[] = currentContext.processName(qName, isAttribute); - if (myParts == null) { - return null; - } else { - parts[0] = myParts[0]; - parts[1] = myParts[1]; - parts[2] = myParts[2]; - return parts; - } + String myParts[] = currentContext.processName(qName, isAttribute); + if (myParts == null) { + return null; + } else { + parts[0] = myParts[0]; + parts[1] = myParts[1]; + parts[2] = myParts[2]; + return parts; + } } @@ -370,7 +370,7 @@ public class NamespaceSupport */ public String getURI (String prefix) { - return currentContext.getURI(prefix); + return currentContext.getURI(prefix); } @@ -390,7 +390,7 @@ public class NamespaceSupport */ public Enumeration getPrefixes () { - return currentContext.getPrefixes(); + return currentContext.getPrefixes(); } @@ -415,7 +415,7 @@ public class NamespaceSupport */ public String getPrefix (String uri) { - return currentContext.getPrefix(uri); + return currentContext.getPrefix(uri); } @@ -427,7 +427,7 @@ public class NamespaceSupport * * <p>This method returns prefixes mapped to a specific Namespace * URI. The xml: prefix will be included. If you want only one - * prefix that's mapped to the Namespace URI, and you don't care + * prefix that's mapped to the Namespace URI, and you don't care * which one you get, use the {@link #getPrefix getPrefix} * method instead.</p> * @@ -444,22 +444,22 @@ public class NamespaceSupport */ public Enumeration getPrefixes (String uri) { - Vector prefixes = new Vector(); - Enumeration allPrefixes = getPrefixes(); - while (allPrefixes.hasMoreElements()) { - String prefix = (String)allPrefixes.nextElement(); - if (uri.equals(getURI(prefix))) { - prefixes.addElement(prefix); - } - } - return prefixes.elements(); + Vector prefixes = new Vector(); + Enumeration allPrefixes = getPrefixes(); + while (allPrefixes.hasMoreElements()) { + String prefix = (String)allPrefixes.nextElement(); + if (uri.equals(getURI(prefix))) { + prefixes.addElement(prefix); + } + } + return prefixes.elements(); } /** * Return an enumeration of all prefixes declared in this context. * - * <p>The empty (default) prefix will be included in this + * <p>The empty (default) prefix will be included in this * enumeration; note that this behaviour differs from that of * {@link #getPrefix} and {@link #getPrefixes}.</p> * @@ -470,7 +470,7 @@ public class NamespaceSupport */ public Enumeration getDeclaredPrefixes () { - return currentContext.getDeclaredPrefixes(); + return currentContext.getDeclaredPrefixes(); } /** @@ -482,21 +482,21 @@ public class NamespaceSupport * @since SAX 2.1alpha * * @exception IllegalStateException when attempting to set this - * after any context has been pushed. + * after any context has been pushed. */ public void setNamespaceDeclUris (boolean value) { - if (contextPos != 0) - throw new IllegalStateException (); - if (value == namespaceDeclUris) - return; - namespaceDeclUris = value; - if (value) - currentContext.declarePrefix ("xmlns", NSDECL); - else { - contexts[contextPos] = currentContext = new Context(); - currentContext.declarePrefix("xml", XMLNS); - } + if (contextPos != 0) + throw new IllegalStateException (); + if (value == namespaceDeclUris) + return; + namespaceDeclUris = value; + if (value) + currentContext.declarePrefix ("xmlns", NSDECL); + else { + contexts[contextPos] = currentContext = new Context(); + currentContext.declarePrefix("xml", XMLNS); + } } /** @@ -506,10 +506,10 @@ public class NamespaceSupport * @since SAX 2.1alpha */ public boolean isNamespaceDeclUris () - { return namespaceDeclUris; } + { return namespaceDeclUris; } + - //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// @@ -519,7 +519,7 @@ public class NamespaceSupport private int contextPos; private boolean namespaceDeclUris; - + //////////////////////////////////////////////////////////////////// // Internal classes. //////////////////////////////////////////////////////////////////// @@ -538,297 +538,297 @@ public class NamespaceSupport */ final class Context { - /** - * Create the root-level Namespace context. - */ - Context () - { - copyTables(); - } - - - /** - * (Re)set the parent of this Namespace context. - * The context must either have been freshly constructed, - * or must have been cleared. - * - * @param context The parent Namespace context object. - */ - void setParent (Context parent) - { - this.parent = parent; - declarations = null; - prefixTable = parent.prefixTable; - uriTable = parent.uriTable; - elementNameTable = parent.elementNameTable; - attributeNameTable = parent.attributeNameTable; - defaultNS = parent.defaultNS; - declSeen = false; - declsOK = true; - } - - /** - * Makes associated state become collectible, - * invalidating this context. - * {@link #setParent} must be called before - * this context may be used again. - */ - void clear () - { - parent = null; - prefixTable = null; - uriTable = null; - elementNameTable = null; - attributeNameTable = null; - defaultNS = null; - } - - - /** - * Declare a Namespace prefix for this context. - * - * @param prefix The prefix to declare. - * @param uri The associated Namespace URI. - * @see org.xml.sax.helpers.NamespaceSupport#declarePrefix - */ - void declarePrefix (String prefix, String uri) - { - // Lazy processing... - if (!declsOK) - throw new IllegalStateException ( - "can't declare any more prefixes in this context"); - if (!declSeen) { - copyTables(); - } - if (declarations == null) { - declarations = new Vector(); - } - - prefix = prefix.intern(); - uri = uri.intern(); - if ("".equals(prefix)) { - if ("".equals(uri)) { - defaultNS = null; - } else { - defaultNS = uri; - } - } else { - prefixTable.put(prefix, uri); - uriTable.put(uri, prefix); // may wipe out another prefix - } - declarations.addElement(prefix); - } - - - /** - * Process an XML qualified name in this context. - * - * @param qName The XML qualified name. - * @param isAttribute true if this is an attribute name. - * @return An array of three strings containing the - * URI part (or empty string), the local part, - * and the raw name, all internalized, or null - * if there is an undeclared prefix. - * @see org.xml.sax.helpers.NamespaceSupport#processName - */ - String [] processName (String qName, boolean isAttribute) - { - String name[]; - Hashtable table; - - // detect errors in call sequence - declsOK = false; - - // Select the appropriate table. - if (isAttribute) { - table = attributeNameTable; - } else { - table = elementNameTable; - } - - // Start by looking in the cache, and - // return immediately if the name - // is already known in this content - name = (String[])table.get(qName); - if (name != null) { - return name; - } - - // We haven't seen this name in this - // context before. Maybe in the parent - // context, but we can't assume prefix - // bindings are the same. - name = new String[3]; - name[2] = qName.intern(); - int index = qName.indexOf(':'); - - - // No prefix. - if (index == -1) { - if (isAttribute) { - if (qName == "xmlns" && namespaceDeclUris) - name[0] = NSDECL; - else - name[0] = ""; - } else if (defaultNS == null) { - name[0] = ""; - } else { - name[0] = defaultNS; - } - name[1] = name[2]; - } - - // Prefix - else { - String prefix = qName.substring(0, index); - String local = qName.substring(index+1); - String uri; - if ("".equals(prefix)) { - uri = defaultNS; - } else { - uri = (String)prefixTable.get(prefix); - } - if (uri == null - || (!isAttribute && "xmlns".equals (prefix))) { - return null; - } - name[0] = uri; - name[1] = local.intern(); - } - - // Save in the cache for future use. - // (Could be shared with parent context...) - table.put(name[2], name); - return name; - } - - - /** - * Look up the URI associated with a prefix in this context. - * - * @param prefix The prefix to look up. - * @return The associated Namespace URI, or null if none is - * declared. - * @see org.xml.sax.helpers.NamespaceSupport#getURI - */ - String getURI (String prefix) - { - if ("".equals(prefix)) { - return defaultNS; - } else if (prefixTable == null) { - return null; - } else { - return (String)prefixTable.get(prefix); - } - } - - - /** - * Look up one of the prefixes associated with a URI in this context. - * - * <p>Since many prefixes may be mapped to the same URI, - * the return value may be unreliable.</p> - * - * @param uri The URI to look up. - * @return The associated prefix, or null if none is declared. - * @see org.xml.sax.helpers.NamespaceSupport#getPrefix - */ - String getPrefix (String uri) - { - if (uriTable == null) { - return null; - } else { - return (String)uriTable.get(uri); - } - } - - - /** - * Return an enumeration of prefixes declared in this context. - * - * @return An enumeration of prefixes (possibly empty). - * @see org.xml.sax.helpers.NamespaceSupport#getDeclaredPrefixes - */ - Enumeration getDeclaredPrefixes () - { - if (declarations == null) { - return EMPTY_ENUMERATION; - } else { - return declarations.elements(); - } - } - - - /** - * Return an enumeration of all prefixes currently in force. - * - * <p>The default prefix, if in force, is <em>not</em> - * returned, and will have to be checked for separately.</p> - * - * @return An enumeration of prefixes (never empty). - * @see org.xml.sax.helpers.NamespaceSupport#getPrefixes - */ - Enumeration getPrefixes () - { - if (prefixTable == null) { - return EMPTY_ENUMERATION; - } else { - return prefixTable.keys(); - } - } - - - - //////////////////////////////////////////////////////////////// - // Internal methods. - //////////////////////////////////////////////////////////////// - - - /** - * Copy on write for the internal tables in this context. - * - * <p>This class is optimized for the normal case where most - * elements do not contain Namespace declarations.</p> - */ - private void copyTables () - { - if (prefixTable != null) { - prefixTable = (Hashtable)prefixTable.clone(); - } else { - prefixTable = new Hashtable(); - } - if (uriTable != null) { - uriTable = (Hashtable)uriTable.clone(); - } else { - uriTable = new Hashtable(); - } - elementNameTable = new Hashtable(); - attributeNameTable = new Hashtable(); - declSeen = true; - } - - - - //////////////////////////////////////////////////////////////// - // Protected state. - //////////////////////////////////////////////////////////////// - - Hashtable prefixTable; - Hashtable uriTable; - Hashtable elementNameTable; - Hashtable attributeNameTable; - String defaultNS = null; - boolean declsOK = true; - - - - //////////////////////////////////////////////////////////////// - // Internal state. - //////////////////////////////////////////////////////////////// - - private Vector declarations = null; - private boolean declSeen = false; - private Context parent = null; + /** + * Create the root-level Namespace context. + */ + Context () + { + copyTables(); + } + + + /** + * (Re)set the parent of this Namespace context. + * The context must either have been freshly constructed, + * or must have been cleared. + * + * @param context The parent Namespace context object. + */ + void setParent (Context parent) + { + this.parent = parent; + declarations = null; + prefixTable = parent.prefixTable; + uriTable = parent.uriTable; + elementNameTable = parent.elementNameTable; + attributeNameTable = parent.attributeNameTable; + defaultNS = parent.defaultNS; + declSeen = false; + declsOK = true; + } + + /** + * Makes associated state become collectible, + * invalidating this context. + * {@link #setParent} must be called before + * this context may be used again. + */ + void clear () + { + parent = null; + prefixTable = null; + uriTable = null; + elementNameTable = null; + attributeNameTable = null; + defaultNS = null; + } + + + /** + * Declare a Namespace prefix for this context. + * + * @param prefix The prefix to declare. + * @param uri The associated Namespace URI. + * @see org.xml.sax.helpers.NamespaceSupport#declarePrefix + */ + void declarePrefix (String prefix, String uri) + { + // Lazy processing... + if (!declsOK) + throw new IllegalStateException ( + "can't declare any more prefixes in this context"); + if (!declSeen) { + copyTables(); + } + if (declarations == null) { + declarations = new Vector(); + } + + prefix = prefix.intern(); + uri = uri.intern(); + if ("".equals(prefix)) { + if ("".equals(uri)) { + defaultNS = null; + } else { + defaultNS = uri; + } + } else { + prefixTable.put(prefix, uri); + uriTable.put(uri, prefix); // may wipe out another prefix + } + declarations.addElement(prefix); + } + + + /** + * Process an XML qualified name in this context. + * + * @param qName The XML qualified name. + * @param isAttribute true if this is an attribute name. + * @return An array of three strings containing the + * URI part (or empty string), the local part, + * and the raw name, all internalized, or null + * if there is an undeclared prefix. + * @see org.xml.sax.helpers.NamespaceSupport#processName + */ + String [] processName (String qName, boolean isAttribute) + { + String name[]; + Hashtable table; + + // detect errors in call sequence + declsOK = false; + + // Select the appropriate table. + if (isAttribute) { + table = attributeNameTable; + } else { + table = elementNameTable; + } + + // Start by looking in the cache, and + // return immediately if the name + // is already known in this content + name = (String[])table.get(qName); + if (name != null) { + return name; + } + + // We haven't seen this name in this + // context before. Maybe in the parent + // context, but we can't assume prefix + // bindings are the same. + name = new String[3]; + name[2] = qName.intern(); + int index = qName.indexOf(':'); + + + // No prefix. + if (index == -1) { + if (isAttribute) { + if (qName == "xmlns" && namespaceDeclUris) + name[0] = NSDECL; + else + name[0] = ""; + } else if (defaultNS == null) { + name[0] = ""; + } else { + name[0] = defaultNS; + } + name[1] = name[2]; + } + + // Prefix + else { + String prefix = qName.substring(0, index); + String local = qName.substring(index+1); + String uri; + if ("".equals(prefix)) { + uri = defaultNS; + } else { + uri = (String)prefixTable.get(prefix); + } + if (uri == null + || (!isAttribute && "xmlns".equals (prefix))) { + return null; + } + name[0] = uri; + name[1] = local.intern(); + } + + // Save in the cache for future use. + // (Could be shared with parent context...) + table.put(name[2], name); + return name; + } + + + /** + * Look up the URI associated with a prefix in this context. + * + * @param prefix The prefix to look up. + * @return The associated Namespace URI, or null if none is + * declared. + * @see org.xml.sax.helpers.NamespaceSupport#getURI + */ + String getURI (String prefix) + { + if ("".equals(prefix)) { + return defaultNS; + } else if (prefixTable == null) { + return null; + } else { + return (String)prefixTable.get(prefix); + } + } + + + /** + * Look up one of the prefixes associated with a URI in this context. + * + * <p>Since many prefixes may be mapped to the same URI, + * the return value may be unreliable.</p> + * + * @param uri The URI to look up. + * @return The associated prefix, or null if none is declared. + * @see org.xml.sax.helpers.NamespaceSupport#getPrefix + */ + String getPrefix (String uri) + { + if (uriTable == null) { + return null; + } else { + return (String)uriTable.get(uri); + } + } + + + /** + * Return an enumeration of prefixes declared in this context. + * + * @return An enumeration of prefixes (possibly empty). + * @see org.xml.sax.helpers.NamespaceSupport#getDeclaredPrefixes + */ + Enumeration getDeclaredPrefixes () + { + if (declarations == null) { + return EMPTY_ENUMERATION; + } else { + return declarations.elements(); + } + } + + + /** + * Return an enumeration of all prefixes currently in force. + * + * <p>The default prefix, if in force, is <em>not</em> + * returned, and will have to be checked for separately.</p> + * + * @return An enumeration of prefixes (never empty). + * @see org.xml.sax.helpers.NamespaceSupport#getPrefixes + */ + Enumeration getPrefixes () + { + if (prefixTable == null) { + return EMPTY_ENUMERATION; + } else { + return prefixTable.keys(); + } + } + + + + //////////////////////////////////////////////////////////////// + // Internal methods. + //////////////////////////////////////////////////////////////// + + + /** + * Copy on write for the internal tables in this context. + * + * <p>This class is optimized for the normal case where most + * elements do not contain Namespace declarations.</p> + */ + private void copyTables () + { + if (prefixTable != null) { + prefixTable = (Hashtable)prefixTable.clone(); + } else { + prefixTable = new Hashtable(); + } + if (uriTable != null) { + uriTable = (Hashtable)uriTable.clone(); + } else { + uriTable = new Hashtable(); + } + elementNameTable = new Hashtable(); + attributeNameTable = new Hashtable(); + declSeen = true; + } + + + + //////////////////////////////////////////////////////////////// + // Protected state. + //////////////////////////////////////////////////////////////// + + Hashtable prefixTable; + Hashtable uriTable; + Hashtable elementNameTable; + Hashtable attributeNameTable; + String defaultNS = null; + boolean declsOK = true; + + + + //////////////////////////////////////////////////////////////// + // Internal state. + //////////////////////////////////////////////////////////////// + + private Vector declarations = null; + private boolean declSeen = false; + private Context parent = null; } } diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/NewInstance.java b/libjava/classpath/external/sax/org/xml/sax/helpers/NewInstance.java index 70c043eb42f..211f47f1c0b 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/NewInstance.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/NewInstance.java @@ -54,7 +54,7 @@ class NewInstance { /** * Figure out which ClassLoader to use. For JDK 1.2 and later use * the context ClassLoader. - */ + */ static ClassLoader getClassLoader () { Method m = null; diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/ParserAdapter.java b/libjava/classpath/external/sax/org/xml/sax/helpers/ParserAdapter.java index 748ad1c8499..cc0695d2727 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/ParserAdapter.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/ParserAdapter.java @@ -10,7 +10,7 @@ import java.io.IOException; import java.util.Enumeration; import java.util.Vector; -import org.xml.sax.Parser; // deprecated +import org.xml.sax.Parser; // deprecated import org.xml.sax.InputSource; import org.xml.sax.Locator; import org.xml.sax.AttributeList; // deprecated @@ -57,7 +57,7 @@ import org.xml.sax.SAXNotSupportedException; public class ParserAdapter implements XMLReader, DocumentHandler { - + //////////////////////////////////////////////////////////////////// // Constructors. //////////////////////////////////////////////////////////////////// @@ -76,35 +76,35 @@ public class ParserAdapter implements XMLReader, DocumentHandler public ParserAdapter () throws SAXException { - super(); - - String driver = System.getProperty("org.xml.sax.parser"); - - try { - setup(ParserFactory.makeParser()); - } catch (ClassNotFoundException e1) { - throw new - SAXException("Cannot find SAX1 driver class " + - driver, e1); - } catch (IllegalAccessException e2) { - throw new - SAXException("SAX1 driver class " + - driver + - " found but cannot be loaded", e2); - } catch (InstantiationException e3) { - throw new - SAXException("SAX1 driver class " + - driver + - " loaded but cannot be instantiated", e3); - } catch (ClassCastException e4) { - throw new - SAXException("SAX1 driver class " + - driver + - " does not implement org.xml.sax.Parser"); - } catch (NullPointerException e5) { - throw new - SAXException("System property org.xml.sax.parser not specified"); - } + super(); + + String driver = System.getProperty("org.xml.sax.parser"); + + try { + setup(ParserFactory.makeParser()); + } catch (ClassNotFoundException e1) { + throw new + SAXException("Cannot find SAX1 driver class " + + driver, e1); + } catch (IllegalAccessException e2) { + throw new + SAXException("SAX1 driver class " + + driver + + " found but cannot be loaded", e2); + } catch (InstantiationException e3) { + throw new + SAXException("SAX1 driver class " + + driver + + " loaded but cannot be instantiated", e3); + } catch (ClassCastException e4) { + throw new + SAXException("SAX1 driver class " + + driver + + " does not implement org.xml.sax.Parser"); + } catch (NullPointerException e5) { + throw new + SAXException("System property org.xml.sax.parser not specified"); + } } @@ -121,8 +121,8 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public ParserAdapter (Parser parser) { - super(); - setup(parser); + super(); + setup(parser); } @@ -135,18 +135,18 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ private void setup (Parser parser) { - if (parser == null) { - throw new - NullPointerException("Parser argument must not be null"); - } - this.parser = parser; - atts = new AttributesImpl(); - nsSupport = new NamespaceSupport(); - attAdapter = new AttributeListAdapter(); + if (parser == null) { + throw new + NullPointerException("Parser argument must not be null"); + } + this.parser = parser; + atts = new AttributesImpl(); + nsSupport = new NamespaceSupport(); + attAdapter = new AttributeListAdapter(); } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.XMLReader. //////////////////////////////////////////////////////////////////// @@ -164,7 +164,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler /** * Set a feature flag for the parser. * - * <p>The only features recognized are namespaces and + * <p>The only features recognized are namespaces and * namespace-prefixes.</p> * * @param name The feature name, as a complete URI. @@ -176,33 +176,33 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.XMLReader#setFeature */ public void setFeature (String name, boolean value) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (name.equals(NAMESPACES)) { - checkNotParsing("feature", name); - namespaces = value; - if (!namespaces && !prefixes) { - prefixes = true; - } - } else if (name.equals(NAMESPACE_PREFIXES)) { - checkNotParsing("feature", name); - prefixes = value; - if (!prefixes && !namespaces) { - namespaces = true; - } - } else if (name.equals(XMLNS_URIs)) { - checkNotParsing("feature", name); - uris = value; - } else { - throw new SAXNotRecognizedException("Feature: " + name); - } + if (name.equals(NAMESPACES)) { + checkNotParsing("feature", name); + namespaces = value; + if (!namespaces && !prefixes) { + prefixes = true; + } + } else if (name.equals(NAMESPACE_PREFIXES)) { + checkNotParsing("feature", name); + prefixes = value; + if (!prefixes && !namespaces) { + namespaces = true; + } + } else if (name.equals(XMLNS_URIs)) { + checkNotParsing("feature", name); + uris = value; + } else { + throw new SAXNotRecognizedException("Feature: " + name); + } } /** * Check a parser feature flag. * - * <p>The only features recognized are namespaces and + * <p>The only features recognized are namespaces and * namespace-prefixes.</p> * * @param name The feature name, as a complete URI. @@ -214,17 +214,17 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.XMLReader#setFeature */ public boolean getFeature (String name) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (name.equals(NAMESPACES)) { - return namespaces; - } else if (name.equals(NAMESPACE_PREFIXES)) { - return prefixes; - } else if (name.equals(XMLNS_URIs)) { - return uris; - } else { - throw new SAXNotRecognizedException("Feature: " + name); - } + if (name.equals(NAMESPACES)) { + return namespaces; + } else if (name.equals(NAMESPACE_PREFIXES)) { + return prefixes; + } else if (name.equals(XMLNS_URIs)) { + return uris; + } else { + throw new SAXNotRecognizedException("Feature: " + name); + } } @@ -242,9 +242,9 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.XMLReader#setProperty */ public void setProperty (String name, Object value) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - throw new SAXNotRecognizedException("Property: " + name); + throw new SAXNotRecognizedException("Property: " + name); } @@ -262,9 +262,9 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.XMLReader#getProperty */ public Object getProperty (String name) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - throw new SAXNotRecognizedException("Property: " + name); + throw new SAXNotRecognizedException("Property: " + name); } @@ -276,7 +276,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public void setEntityResolver (EntityResolver resolver) { - entityResolver = resolver; + entityResolver = resolver; } @@ -288,7 +288,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public EntityResolver getEntityResolver () { - return entityResolver; + return entityResolver; } @@ -300,7 +300,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public void setDTDHandler (DTDHandler handler) { - dtdHandler = handler; + dtdHandler = handler; } @@ -312,7 +312,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public DTDHandler getDTDHandler () { - return dtdHandler; + return dtdHandler; } @@ -324,7 +324,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public void setContentHandler (ContentHandler handler) { - contentHandler = handler; + contentHandler = handler; } @@ -336,7 +336,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public ContentHandler getContentHandler () { - return contentHandler; + return contentHandler; } @@ -348,7 +348,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public void setErrorHandler (ErrorHandler handler) { - errorHandler = handler; + errorHandler = handler; } @@ -360,7 +360,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public ErrorHandler getErrorHandler () { - return errorHandler; + return errorHandler; } @@ -376,9 +376,9 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.Parser#parse(java.lang.String) */ public void parse (String systemId) - throws IOException, SAXException + throws IOException, SAXException { - parse(new InputSource(systemId)); + parse(new InputSource(systemId)); } @@ -394,19 +394,19 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.Parser#parse(org.xml.sax.InputSource) */ public void parse (InputSource input) - throws IOException, SAXException + throws IOException, SAXException { - if (parsing) { - throw new SAXException("Parser is already in use"); - } - setupParser(); - parsing = true; - try { - parser.parse(input); - } finally { - parsing = false; - } - parsing = false; + if (parsing) { + throw new SAXException("Parser is already in use"); + } + setupParser(); + parsing = true; + try { + parser.parse(input); + } finally { + parsing = false; + } + parsing = false; } @@ -425,10 +425,10 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ public void setDocumentLocator (Locator locator) { - this.locator = locator; - if (contentHandler != null) { - contentHandler.setDocumentLocator(locator); - } + this.locator = locator; + if (contentHandler != null) { + contentHandler.setDocumentLocator(locator); + } } @@ -441,11 +441,11 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#startDocument */ public void startDocument () - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.startDocument(); - } + if (contentHandler != null) { + contentHandler.startDocument(); + } } @@ -458,11 +458,11 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#endDocument */ public void endDocument () - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.endDocument(); - } + if (contentHandler != null) { + contentHandler.endDocument(); + } } @@ -478,124 +478,124 @@ public class ParserAdapter implements XMLReader, DocumentHandler * processing exception. */ public void startElement (String qName, AttributeList qAtts) - throws SAXException + throws SAXException { - // These are exceptions from the - // first pass; they should be - // ignored if there's a second pass, - // but reported otherwise. - Vector exceptions = null; - - // If we're not doing Namespace - // processing, dispatch this quickly. - if (!namespaces) { - if (contentHandler != null) { - attAdapter.setAttributeList(qAtts); - contentHandler.startElement("", "", qName.intern(), - attAdapter); - } - return; - } - - - // OK, we're doing Namespace processing. - nsSupport.pushContext(); - int length = qAtts.getLength(); - - // First pass: handle NS decls - for (int i = 0; i < length; i++) { - String attQName = qAtts.getName(i); - - if (!attQName.startsWith("xmlns")) - continue; - // Could be a declaration... - String prefix; - int n = attQName.indexOf(':'); - - // xmlns=... - if (n == -1 && attQName.length () == 5) { - prefix = ""; - } else if (n != 5) { - // XML namespaces spec doesn't discuss "xmlnsf:oo" - // (and similarly named) attributes ... at most, warn - continue; - } else // xmlns:foo=... - prefix = attQName.substring(n+1); - - String value = qAtts.getValue(i); - if (!nsSupport.declarePrefix(prefix, value)) { - reportError("Illegal Namespace prefix: " + prefix); - continue; - } - if (contentHandler != null) - contentHandler.startPrefixMapping(prefix, value); - } - - // Second pass: copy all relevant - // attributes into the SAX2 AttributeList - // using updated prefix bindings - atts.clear(); - for (int i = 0; i < length; i++) { - String attQName = qAtts.getName(i); - String type = qAtts.getType(i); - String value = qAtts.getValue(i); - - // Declaration? - if (attQName.startsWith("xmlns")) { - String prefix; - int n = attQName.indexOf(':'); - - if (n == -1 && attQName.length () == 5) { - prefix = ""; - } else if (n != 5) { - // XML namespaces spec doesn't discuss "xmlnsf:oo" - // (and similarly named) attributes ... ignore - prefix = null; - } else { - prefix = attQName.substring(6); - } - // Yes, decl: report or prune - if (prefix != null) { - if (prefixes) { - if (uris) - // note funky case: localname can be null - // when declaring the default prefix, and - // yet the uri isn't null. - atts.addAttribute (nsSupport.XMLNS, prefix, - attQName.intern(), type, value); - else - atts.addAttribute ("", "", - attQName.intern(), type, value); - } - continue; - } - } - - // Not a declaration -- report - try { - String attName[] = processName(attQName, true, true); - atts.addAttribute(attName[0], attName[1], attName[2], - type, value); - } catch (SAXException e) { - if (exceptions == null) - exceptions = new Vector(); - exceptions.addElement(e); - atts.addAttribute("", attQName, attQName, type, value); - } - } - - // now handle the deferred exception reports - if (exceptions != null && errorHandler != null) { - for (int i = 0; i < exceptions.size(); i++) - errorHandler.error((SAXParseException) - (exceptions.elementAt(i))); - } - - // OK, finally report the event. - if (contentHandler != null) { - String name[] = processName(qName, false, false); - contentHandler.startElement(name[0], name[1], name[2], atts); - } + // These are exceptions from the + // first pass; they should be + // ignored if there's a second pass, + // but reported otherwise. + Vector exceptions = null; + + // If we're not doing Namespace + // processing, dispatch this quickly. + if (!namespaces) { + if (contentHandler != null) { + attAdapter.setAttributeList(qAtts); + contentHandler.startElement("", "", qName.intern(), + attAdapter); + } + return; + } + + + // OK, we're doing Namespace processing. + nsSupport.pushContext(); + int length = qAtts.getLength(); + + // First pass: handle NS decls + for (int i = 0; i < length; i++) { + String attQName = qAtts.getName(i); + + if (!attQName.startsWith("xmlns")) + continue; + // Could be a declaration... + String prefix; + int n = attQName.indexOf(':'); + + // xmlns=... + if (n == -1 && attQName.length () == 5) { + prefix = ""; + } else if (n != 5) { + // XML namespaces spec doesn't discuss "xmlnsf:oo" + // (and similarly named) attributes ... at most, warn + continue; + } else // xmlns:foo=... + prefix = attQName.substring(n+1); + + String value = qAtts.getValue(i); + if (!nsSupport.declarePrefix(prefix, value)) { + reportError("Illegal Namespace prefix: " + prefix); + continue; + } + if (contentHandler != null) + contentHandler.startPrefixMapping(prefix, value); + } + + // Second pass: copy all relevant + // attributes into the SAX2 AttributeList + // using updated prefix bindings + atts.clear(); + for (int i = 0; i < length; i++) { + String attQName = qAtts.getName(i); + String type = qAtts.getType(i); + String value = qAtts.getValue(i); + + // Declaration? + if (attQName.startsWith("xmlns")) { + String prefix; + int n = attQName.indexOf(':'); + + if (n == -1 && attQName.length () == 5) { + prefix = ""; + } else if (n != 5) { + // XML namespaces spec doesn't discuss "xmlnsf:oo" + // (and similarly named) attributes ... ignore + prefix = null; + } else { + prefix = attQName.substring(6); + } + // Yes, decl: report or prune + if (prefix != null) { + if (prefixes) { + if (uris) + // note funky case: localname can be null + // when declaring the default prefix, and + // yet the uri isn't null. + atts.addAttribute (nsSupport.XMLNS, prefix, + attQName.intern(), type, value); + else + atts.addAttribute ("", "", + attQName.intern(), type, value); + } + continue; + } + } + + // Not a declaration -- report + try { + String attName[] = processName(attQName, true, true); + atts.addAttribute(attName[0], attName[1], attName[2], + type, value); + } catch (SAXException e) { + if (exceptions == null) + exceptions = new Vector(); + exceptions.addElement(e); + atts.addAttribute("", attQName, attQName, type, value); + } + } + + // now handle the deferred exception reports + if (exceptions != null && errorHandler != null) { + for (int i = 0; i < exceptions.size(); i++) + errorHandler.error((SAXParseException) + (exceptions.elementAt(i))); + } + + // OK, finally report the event. + if (contentHandler != null) { + String name[] = processName(qName, false, false); + contentHandler.startElement(name[0], name[1], name[2], atts); + } } @@ -609,28 +609,28 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#endElement */ public void endElement (String qName) - throws SAXException + throws SAXException { - // If we're not doing Namespace - // processing, dispatch this quickly. - if (!namespaces) { - if (contentHandler != null) { - contentHandler.endElement("", "", qName.intern()); - } - return; - } - - // Split the name. - String names[] = processName(qName, false, false); - if (contentHandler != null) { - contentHandler.endElement(names[0], names[1], names[2]); - Enumeration prefixes = nsSupport.getDeclaredPrefixes(); - while (prefixes.hasMoreElements()) { - String prefix = (String)prefixes.nextElement(); - contentHandler.endPrefixMapping(prefix); - } - } - nsSupport.popContext(); + // If we're not doing Namespace + // processing, dispatch this quickly. + if (!namespaces) { + if (contentHandler != null) { + contentHandler.endElement("", "", qName.intern()); + } + return; + } + + // Split the name. + String names[] = processName(qName, false, false); + if (contentHandler != null) { + contentHandler.endElement(names[0], names[1], names[2]); + Enumeration prefixes = nsSupport.getDeclaredPrefixes(); + while (prefixes.hasMoreElements()) { + String prefix = (String)prefixes.nextElement(); + contentHandler.endPrefixMapping(prefix); + } + } + nsSupport.popContext(); } @@ -646,11 +646,11 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#characters */ public void characters (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.characters(ch, start, length); - } + if (contentHandler != null) { + contentHandler.characters(ch, start, length); + } } @@ -666,11 +666,11 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#ignorableWhitespace */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.ignorableWhitespace(ch, start, length); - } + if (contentHandler != null) { + contentHandler.ignorableWhitespace(ch, start, length); + } } @@ -685,15 +685,15 @@ public class ParserAdapter implements XMLReader, DocumentHandler * @see org.xml.sax.DocumentHandler#processingInstruction */ public void processingInstruction (String target, String data) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.processingInstruction(target, data); - } + if (contentHandler != null) { + contentHandler.processingInstruction(target, data); + } } - + //////////////////////////////////////////////////////////////////// // Internal utility methods. //////////////////////////////////////////////////////////////////// @@ -704,25 +704,25 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ private void setupParser () { - // catch an illegal "nonsense" state. - if (!prefixes && !namespaces) - throw new IllegalStateException (); - - nsSupport.reset(); - if (uris) - nsSupport.setNamespaceDeclUris (true); - - if (entityResolver != null) { - parser.setEntityResolver(entityResolver); - } - if (dtdHandler != null) { - parser.setDTDHandler(dtdHandler); - } - if (errorHandler != null) { - parser.setErrorHandler(errorHandler); - } - parser.setDocumentHandler(this); - locator = null; + // catch an illegal "nonsense" state. + if (!prefixes && !namespaces) + throw new IllegalStateException (); + + nsSupport.reset(); + if (uris) + nsSupport.setNamespaceDeclUris (true); + + if (entityResolver != null) { + parser.setEntityResolver(entityResolver); + } + if (dtdHandler != null) { + parser.setDTDHandler(dtdHandler); + } + if (errorHandler != null) { + parser.setErrorHandler(errorHandler); + } + parser.setDocumentHandler(this); + locator = null; } @@ -740,20 +740,20 @@ public class ParserAdapter implements XMLReader, DocumentHandler * an exception if there is an error callback. */ private String [] processName (String qName, boolean isAttribute, - boolean useException) - throws SAXException + boolean useException) + throws SAXException { - String parts[] = nsSupport.processName(qName, nameParts, - isAttribute); - if (parts == null) { - if (useException) - throw makeException("Undeclared prefix: " + qName); - reportError("Undeclared prefix: " + qName); - parts = new String[3]; - parts[0] = parts[1] = ""; - parts[2] = qName.intern(); - } - return parts; + String parts[] = nsSupport.processName(qName, nameParts, + isAttribute); + if (parts == null) { + if (useException) + throw makeException("Undeclared prefix: " + qName); + reportError("Undeclared prefix: " + qName); + parts = new String[3]; + parts[0] = parts[1] = ""; + parts[2] = qName.intern(); + } + return parts; } @@ -765,13 +765,13 @@ public class ParserAdapter implements XMLReader, DocumentHandler * an exception. */ void reportError (String message) - throws SAXException + throws SAXException { - if (errorHandler != null) - errorHandler.error(makeException(message)); + if (errorHandler != null) + errorHandler.error(makeException(message)); } - + /** * Construct an exception for the current context. * @@ -779,11 +779,11 @@ public class ParserAdapter implements XMLReader, DocumentHandler */ private SAXParseException makeException (String message) { - if (locator != null) { - return new SAXParseException(message, locator); - } else { - return new SAXParseException(message, null, null, -1, -1); - } + if (locator != null) { + return new SAXParseException(message, locator); + } else { + return new SAXParseException(message, null, null, -1, -1); + } } @@ -799,18 +799,18 @@ public class ParserAdapter implements XMLReader, DocumentHandler * document is currently being parsed. */ private void checkNotParsing (String type, String name) - throws SAXNotSupportedException + throws SAXNotSupportedException { - if (parsing) { - throw new SAXNotSupportedException("Cannot change " + - type + ' ' + - name + " while parsing"); - - } + if (parsing) { + throw new SAXNotSupportedException("Cannot change " + + type + ' ' + + name + " while parsing"); + + } } - + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// @@ -825,14 +825,14 @@ public class ParserAdapter implements XMLReader, DocumentHandler private AttributesImpl atts = null; - // Features + // Features private boolean namespaces = true; private boolean prefixes = false; private boolean uris = false; - // Properties + // Properties - // Handlers + // Handlers Locator locator; EntityResolver entityResolver = null; @@ -841,7 +841,7 @@ public class ParserAdapter implements XMLReader, DocumentHandler ErrorHandler errorHandler = null; - + //////////////////////////////////////////////////////////////////// // Inner class to wrap an AttributeList when not doing NS proc. //////////////////////////////////////////////////////////////////// @@ -855,191 +855,191 @@ public class ParserAdapter implements XMLReader, DocumentHandler * * <p>This wrapper class is used only when Namespace support * is disabled -- it provides pretty much a direct mapping - * from SAX1 to SAX2, except that names and types are + * from SAX1 to SAX2, except that names and types are * interned whenever requested.</p> */ final class AttributeListAdapter implements Attributes { - /** - * Construct a new adapter. - */ - AttributeListAdapter () - { - } - - - /** - * Set the embedded AttributeList. - * - * <p>This method must be invoked before any of the others - * can be used.</p> - * - * @param The SAX1 attribute list (with qnames). - */ - void setAttributeList (AttributeList qAtts) - { - this.qAtts = qAtts; - } - - - /** - * Return the length of the attribute list. - * - * @return The number of attributes in the list. - * @see org.xml.sax.Attributes#getLength - */ - public int getLength () - { - return qAtts.getLength(); - } - - - /** - * Return the Namespace URI of the specified attribute. - * - * @param The attribute's index. - * @return Always the empty string. - * @see org.xml.sax.Attributes#getURI - */ - public String getURI (int i) - { - return ""; - } - - - /** - * Return the local name of the specified attribute. - * - * @param The attribute's index. - * @return Always the empty string. - * @see org.xml.sax.Attributes#getLocalName - */ - public String getLocalName (int i) - { - return ""; - } - - - /** - * Return the qualified (prefixed) name of the specified attribute. - * - * @param The attribute's index. - * @return The attribute's qualified name, internalized. - */ - public String getQName (int i) - { - return qAtts.getName(i).intern(); - } - - - /** - * Return the type of the specified attribute. - * - * @param The attribute's index. - * @return The attribute's type as an internalized string. - */ - public String getType (int i) - { - return qAtts.getType(i).intern(); - } - - - /** - * Return the value of the specified attribute. - * - * @param The attribute's index. - * @return The attribute's value. - */ - public String getValue (int i) - { - return qAtts.getValue(i); - } - - - /** - * Look up an attribute index by Namespace name. - * - * @param uri The Namespace URI or the empty string. - * @param localName The local name. - * @return The attributes index, or -1 if none was found. - * @see org.xml.sax.Attributes#getIndex(java.lang.String,java.lang.String) - */ - public int getIndex (String uri, String localName) - { - return -1; - } - - - /** - * Look up an attribute index by qualified (prefixed) name. - * - * @param qName The qualified name. - * @return The attributes index, or -1 if none was found. - * @see org.xml.sax.Attributes#getIndex(java.lang.String) - */ - public int getIndex (String qName) - { - int max = atts.getLength(); - for (int i = 0; i < max; i++) { - if (qAtts.getName(i).equals(qName)) { - return i; - } - } - return -1; - } - - - /** - * Look up the type of an attribute by Namespace name. - * - * @param uri The Namespace URI - * @param localName The local name. - * @return The attribute's type as an internalized string. - */ - public String getType (String uri, String localName) - { - return null; - } - - - /** - * Look up the type of an attribute by qualified (prefixed) name. - * - * @param qName The qualified name. - * @return The attribute's type as an internalized string. - */ - public String getType (String qName) - { - return qAtts.getType(qName).intern(); - } - - - /** - * Look up the value of an attribute by Namespace name. - * - * @param uri The Namespace URI - * @param localName The local name. - * @return The attribute's value. - */ - public String getValue (String uri, String localName) - { - return null; - } - - - /** - * Look up the value of an attribute by qualified (prefixed) name. - * - * @param qName The qualified name. - * @return The attribute's value. - */ - public String getValue (String qName) - { - return qAtts.getValue(qName); - } - - private AttributeList qAtts; + /** + * Construct a new adapter. + */ + AttributeListAdapter () + { + } + + + /** + * Set the embedded AttributeList. + * + * <p>This method must be invoked before any of the others + * can be used.</p> + * + * @param The SAX1 attribute list (with qnames). + */ + void setAttributeList (AttributeList qAtts) + { + this.qAtts = qAtts; + } + + + /** + * Return the length of the attribute list. + * + * @return The number of attributes in the list. + * @see org.xml.sax.Attributes#getLength + */ + public int getLength () + { + return qAtts.getLength(); + } + + + /** + * Return the Namespace URI of the specified attribute. + * + * @param The attribute's index. + * @return Always the empty string. + * @see org.xml.sax.Attributes#getURI + */ + public String getURI (int i) + { + return ""; + } + + + /** + * Return the local name of the specified attribute. + * + * @param The attribute's index. + * @return Always the empty string. + * @see org.xml.sax.Attributes#getLocalName + */ + public String getLocalName (int i) + { + return ""; + } + + + /** + * Return the qualified (prefixed) name of the specified attribute. + * + * @param The attribute's index. + * @return The attribute's qualified name, internalized. + */ + public String getQName (int i) + { + return qAtts.getName(i).intern(); + } + + + /** + * Return the type of the specified attribute. + * + * @param The attribute's index. + * @return The attribute's type as an internalized string. + */ + public String getType (int i) + { + return qAtts.getType(i).intern(); + } + + + /** + * Return the value of the specified attribute. + * + * @param The attribute's index. + * @return The attribute's value. + */ + public String getValue (int i) + { + return qAtts.getValue(i); + } + + + /** + * Look up an attribute index by Namespace name. + * + * @param uri The Namespace URI or the empty string. + * @param localName The local name. + * @return The attributes index, or -1 if none was found. + * @see org.xml.sax.Attributes#getIndex(java.lang.String,java.lang.String) + */ + public int getIndex (String uri, String localName) + { + return -1; + } + + + /** + * Look up an attribute index by qualified (prefixed) name. + * + * @param qName The qualified name. + * @return The attributes index, or -1 if none was found. + * @see org.xml.sax.Attributes#getIndex(java.lang.String) + */ + public int getIndex (String qName) + { + int max = atts.getLength(); + for (int i = 0; i < max; i++) { + if (qAtts.getName(i).equals(qName)) { + return i; + } + } + return -1; + } + + + /** + * Look up the type of an attribute by Namespace name. + * + * @param uri The Namespace URI + * @param localName The local name. + * @return The attribute's type as an internalized string. + */ + public String getType (String uri, String localName) + { + return null; + } + + + /** + * Look up the type of an attribute by qualified (prefixed) name. + * + * @param qName The qualified name. + * @return The attribute's type as an internalized string. + */ + public String getType (String qName) + { + return qAtts.getType(qName).intern(); + } + + + /** + * Look up the value of an attribute by Namespace name. + * + * @param uri The Namespace URI + * @param localName The local name. + * @return The attribute's value. + */ + public String getValue (String uri, String localName) + { + return null; + } + + + /** + * Look up the value of an attribute by qualified (prefixed) name. + * + * @param qName The qualified name. + * @return The attribute's value. + */ + public String getValue (String qName) + { + return qAtts.getValue(qName); + } + + private AttributeList qAtts; } } diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/ParserFactory.java b/libjava/classpath/external/sax/org/xml/sax/helpers/ParserFactory.java index 23139981088..ec822b540cc 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/ParserFactory.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/ParserFactory.java @@ -47,16 +47,16 @@ import org.xml.sax.Parser; * @version 2.0.1 (sax2r2) */ public class ParserFactory { - - + + /** * Private null constructor. */ private ParserFactory () { } - - + + /** * Create a new SAX parser using the `org.xml.sax.parser' system property. * @@ -79,21 +79,21 @@ public class ParserFactory { * @see org.xml.sax.Parser */ public static Parser makeParser () - throws ClassNotFoundException, - IllegalAccessException, - InstantiationException, - NullPointerException, - ClassCastException + throws ClassNotFoundException, + IllegalAccessException, + InstantiationException, + NullPointerException, + ClassCastException { - String className = System.getProperty("org.xml.sax.parser"); - if (className == null) { - throw new NullPointerException("No value for sax.parser property"); - } else { - return makeParser(className); - } + String className = System.getProperty("org.xml.sax.parser"); + if (className == null) { + throw new NullPointerException("No value for sax.parser property"); + } else { + return makeParser(className); + } } - - + + /** * Create a new SAX parser object using the class name provided. * @@ -116,14 +116,13 @@ public class ParserFactory { * @see org.xml.sax.Parser */ public static Parser makeParser (String className) - throws ClassNotFoundException, - IllegalAccessException, - InstantiationException, - ClassCastException + throws ClassNotFoundException, + IllegalAccessException, + InstantiationException, + ClassCastException { - return (Parser) NewInstance.newInstance ( - NewInstance.getClassLoader (), className); + return (Parser) NewInstance.newInstance ( + NewInstance.getClassLoader (), className); } - -} +} diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLFilterImpl.java b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLFilterImpl.java index 64ff0a4cf88..4b4aba092b3 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLFilterImpl.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLFilterImpl.java @@ -54,7 +54,7 @@ public class XMLFilterImpl implements XMLFilter, EntityResolver, DTDHandler, ContentHandler, ErrorHandler { - + //////////////////////////////////////////////////////////////////// // Constructors. //////////////////////////////////////////////////////////////////// @@ -74,7 +74,7 @@ public class XMLFilterImpl */ public XMLFilterImpl () { - super(); + super(); } @@ -87,11 +87,11 @@ public class XMLFilterImpl public XMLFilterImpl (XMLReader parent) { super(); - setParent(parent); + setParent(parent); } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.XMLFilter. //////////////////////////////////////////////////////////////////// @@ -100,8 +100,8 @@ public class XMLFilterImpl /** * Set the parent reader. * - * <p>This is the {@link org.xml.sax.XMLReader XMLReader} from which - * this filter will obtain its events and to which it will pass its + * <p>This is the {@link org.xml.sax.XMLReader XMLReader} from which + * this filter will obtain its events and to which it will pass its * configuration requests. The parent may itself be another filter.</p> * * <p>If there is no parent reader set, any attempt to parse @@ -112,7 +112,7 @@ public class XMLFilterImpl */ public void setParent (XMLReader parent) { - this.parent = parent; + this.parent = parent; } @@ -124,11 +124,11 @@ public class XMLFilterImpl */ public XMLReader getParent () { - return parent; + return parent; } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.XMLReader. //////////////////////////////////////////////////////////////////// @@ -144,17 +144,17 @@ public class XMLFilterImpl * @exception org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved from the parent. * @exception org.xml.sax.SAXNotSupportedException When the - * parent recognizes the feature name but + * parent recognizes the feature name but * cannot set the requested value. */ public void setFeature (String name, boolean value) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (parent != null) { - parent.setFeature(name, value); - } else { - throw new SAXNotRecognizedException("Feature: " + name); - } + if (parent != null) { + parent.setFeature(name, value); + } else { + throw new SAXNotRecognizedException("Feature: " + name); + } } @@ -168,17 +168,17 @@ public class XMLFilterImpl * @exception org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved from the parent. * @exception org.xml.sax.SAXNotSupportedException When the - * parent recognizes the feature name but + * parent recognizes the feature name but * cannot determine its value at this time. */ public boolean getFeature (String name) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (parent != null) { - return parent.getFeature(name); - } else { - throw new SAXNotRecognizedException("Feature: " + name); - } + if (parent != null) { + return parent.getFeature(name); + } else { + throw new SAXNotRecognizedException("Feature: " + name); + } } @@ -192,17 +192,17 @@ public class XMLFilterImpl * @exception org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved from the parent. * @exception org.xml.sax.SAXNotSupportedException When the - * parent recognizes the property name but + * parent recognizes the property name but * cannot set the requested value. */ public void setProperty (String name, Object value) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (parent != null) { - parent.setProperty(name, value); - } else { - throw new SAXNotRecognizedException("Property: " + name); - } + if (parent != null) { + parent.setProperty(name, value); + } else { + throw new SAXNotRecognizedException("Property: " + name); + } } @@ -214,17 +214,17 @@ public class XMLFilterImpl * @exception org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved from the parent. * @exception org.xml.sax.SAXNotSupportedException When the - * parent recognizes the property name but + * parent recognizes the property name but * cannot determine its value at this time. */ public Object getProperty (String name) - throws SAXNotRecognizedException, SAXNotSupportedException + throws SAXNotRecognizedException, SAXNotSupportedException { - if (parent != null) { - return parent.getProperty(name); - } else { - throw new SAXNotRecognizedException("Property: " + name); - } + if (parent != null) { + return parent.getProperty(name); + } else { + throw new SAXNotRecognizedException("Property: " + name); + } } @@ -235,7 +235,7 @@ public class XMLFilterImpl */ public void setEntityResolver (EntityResolver resolver) { - entityResolver = resolver; + entityResolver = resolver; } @@ -246,7 +246,7 @@ public class XMLFilterImpl */ public EntityResolver getEntityResolver () { - return entityResolver; + return entityResolver; } @@ -257,7 +257,7 @@ public class XMLFilterImpl */ public void setDTDHandler (DTDHandler handler) { - dtdHandler = handler; + dtdHandler = handler; } @@ -268,7 +268,7 @@ public class XMLFilterImpl */ public DTDHandler getDTDHandler () { - return dtdHandler; + return dtdHandler; } @@ -279,7 +279,7 @@ public class XMLFilterImpl */ public void setContentHandler (ContentHandler handler) { - contentHandler = handler; + contentHandler = handler; } @@ -290,7 +290,7 @@ public class XMLFilterImpl */ public ContentHandler getContentHandler () { - return contentHandler; + return contentHandler; } @@ -301,7 +301,7 @@ public class XMLFilterImpl */ public void setErrorHandler (ErrorHandler handler) { - errorHandler = handler; + errorHandler = handler; } @@ -312,7 +312,7 @@ public class XMLFilterImpl */ public ErrorHandler getErrorHandler () { - return errorHandler; + return errorHandler; } @@ -327,10 +327,10 @@ public class XMLFilterImpl * supplied by the application. */ public void parse (InputSource input) - throws SAXException, IOException + throws SAXException, IOException { - setupParse(); - parent.parse(input); + setupParse(); + parent.parse(input); } @@ -345,13 +345,13 @@ public class XMLFilterImpl * supplied by the application. */ public void parse (String systemId) - throws SAXException, IOException + throws SAXException, IOException { - parse(new InputSource(systemId)); + parse(new InputSource(systemId)); } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.EntityResolver. //////////////////////////////////////////////////////////////////// @@ -370,22 +370,22 @@ public class XMLFilterImpl * new InputSource. */ public InputSource resolveEntity (String publicId, String systemId) - throws SAXException, IOException + throws SAXException, IOException { - if (entityResolver != null) { - return entityResolver.resolveEntity(publicId, systemId); - } else { - return null; - } + if (entityResolver != null) { + return entityResolver.resolveEntity(publicId, systemId); + } else { + return null; + } } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.DTDHandler. //////////////////////////////////////////////////////////////////// - + /** * Filter a notation declaration event. * @@ -396,14 +396,14 @@ public class XMLFilterImpl * an exception during processing. */ public void notationDecl (String name, String publicId, String systemId) - throws SAXException + throws SAXException { - if (dtdHandler != null) { - dtdHandler.notationDecl(name, publicId, systemId); - } + if (dtdHandler != null) { + dtdHandler.notationDecl(name, publicId, systemId); + } } - + /** * Filter an unparsed entity declaration event. * @@ -415,17 +415,17 @@ public class XMLFilterImpl * an exception during processing. */ public void unparsedEntityDecl (String name, String publicId, - String systemId, String notationName) - throws SAXException + String systemId, String notationName) + throws SAXException { - if (dtdHandler != null) { - dtdHandler.unparsedEntityDecl(name, publicId, systemId, - notationName); - } + if (dtdHandler != null) { + dtdHandler.unparsedEntityDecl(name, publicId, systemId, + notationName); + } } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.ContentHandler. //////////////////////////////////////////////////////////////////// @@ -438,10 +438,10 @@ public class XMLFilterImpl */ public void setDocumentLocator (Locator locator) { - this.locator = locator; - if (contentHandler != null) { - contentHandler.setDocumentLocator(locator); - } + this.locator = locator; + if (contentHandler != null) { + contentHandler.setDocumentLocator(locator); + } } @@ -452,11 +452,11 @@ public class XMLFilterImpl * an exception during processing. */ public void startDocument () - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.startDocument(); - } + if (contentHandler != null) { + contentHandler.startDocument(); + } } @@ -467,11 +467,11 @@ public class XMLFilterImpl * an exception during processing. */ public void endDocument () - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.endDocument(); - } + if (contentHandler != null) { + contentHandler.endDocument(); + } } @@ -484,11 +484,11 @@ public class XMLFilterImpl * an exception during processing. */ public void startPrefixMapping (String prefix, String uri) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.startPrefixMapping(prefix, uri); - } + if (contentHandler != null) { + contentHandler.startPrefixMapping(prefix, uri); + } } @@ -500,11 +500,11 @@ public class XMLFilterImpl * an exception during processing. */ public void endPrefixMapping (String prefix) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.endPrefixMapping(prefix); - } + if (contentHandler != null) { + contentHandler.endPrefixMapping(prefix); + } } @@ -520,12 +520,12 @@ public class XMLFilterImpl * an exception during processing. */ public void startElement (String uri, String localName, String qName, - Attributes atts) - throws SAXException + Attributes atts) + throws SAXException { - if (contentHandler != null) { - contentHandler.startElement(uri, localName, qName, atts); - } + if (contentHandler != null) { + contentHandler.startElement(uri, localName, qName, atts); + } } @@ -540,11 +540,11 @@ public class XMLFilterImpl * an exception during processing. */ public void endElement (String uri, String localName, String qName) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.endElement(uri, localName, qName); - } + if (contentHandler != null) { + contentHandler.endElement(uri, localName, qName); + } } @@ -558,11 +558,11 @@ public class XMLFilterImpl * an exception during processing. */ public void characters (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.characters(ch, start, length); - } + if (contentHandler != null) { + contentHandler.characters(ch, start, length); + } } @@ -576,11 +576,11 @@ public class XMLFilterImpl * an exception during processing. */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.ignorableWhitespace(ch, start, length); - } + if (contentHandler != null) { + contentHandler.ignorableWhitespace(ch, start, length); + } } @@ -593,11 +593,11 @@ public class XMLFilterImpl * an exception during processing. */ public void processingInstruction (String target, String data) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.processingInstruction(target, data); - } + if (contentHandler != null) { + contentHandler.processingInstruction(target, data); + } } @@ -609,15 +609,15 @@ public class XMLFilterImpl * an exception during processing. */ public void skippedEntity (String name) - throws SAXException + throws SAXException { - if (contentHandler != null) { - contentHandler.skippedEntity(name); - } + if (contentHandler != null) { + contentHandler.skippedEntity(name); + } } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.ErrorHandler. //////////////////////////////////////////////////////////////////// @@ -631,11 +631,11 @@ public class XMLFilterImpl * an exception during processing. */ public void warning (SAXParseException e) - throws SAXException + throws SAXException { - if (errorHandler != null) { - errorHandler.warning(e); - } + if (errorHandler != null) { + errorHandler.warning(e); + } } @@ -647,11 +647,11 @@ public class XMLFilterImpl * an exception during processing. */ public void error (SAXParseException e) - throws SAXException + throws SAXException { - if (errorHandler != null) { - errorHandler.error(e); - } + if (errorHandler != null) { + errorHandler.error(e); + } } @@ -663,15 +663,15 @@ public class XMLFilterImpl * an exception during processing. */ public void fatalError (SAXParseException e) - throws SAXException + throws SAXException { - if (errorHandler != null) { - errorHandler.fatalError(e); - } + if (errorHandler != null) { + errorHandler.fatalError(e); + } } - + //////////////////////////////////////////////////////////////////// // Internal methods. //////////////////////////////////////////////////////////////////// @@ -681,22 +681,22 @@ public class XMLFilterImpl * Set up before a parse. * * <p>Before every parse, check whether the parent is - * non-null, and re-register the filter for all of the + * non-null, and re-register the filter for all of the * events.</p> */ private void setupParse () { - if (parent == null) { - throw new NullPointerException("No parent for filter"); - } - parent.setEntityResolver(this); - parent.setDTDHandler(this); - parent.setContentHandler(this); - parent.setErrorHandler(this); + if (parent == null) { + throw new NullPointerException("No parent for filter"); + } + parent.setEntityResolver(this); + parent.setDTDHandler(this); + parent.setContentHandler(this); + parent.setErrorHandler(this); } - + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderAdapter.java b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderAdapter.java index d2214747d74..8ab909a7754 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderAdapter.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderAdapter.java @@ -9,7 +9,7 @@ package org.xml.sax.helpers; import java.io.IOException; import java.util.Locale; -import org.xml.sax.Parser; // deprecated +import org.xml.sax.Parser; // deprecated import org.xml.sax.Locator; import org.xml.sax.InputSource; import org.xml.sax.AttributeList; // deprecated @@ -36,11 +36,11 @@ import org.xml.sax.SAXNotSupportedException; * </blockquote> * * <p>This class wraps a SAX2 {@link org.xml.sax.XMLReader XMLReader} - * and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}. The XMLReader - * must support a true value for the + * and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}. The XMLReader + * must support a true value for the * http://xml.org/sax/features/namespace-prefixes property or parsing will fail - * with a {@link org.xml.sax.SAXException SAXException}; if the XMLReader - * supports a false value for the http://xml.org/sax/features/namespaces + * with a {@link org.xml.sax.SAXException SAXException}; if the XMLReader + * supports a false value for the http://xml.org/sax/features/namespaces * property, that will also be used to improve efficiency.</p> * * @since SAX 2.0 @@ -52,7 +52,7 @@ import org.xml.sax.SAXNotSupportedException; public class XMLReaderAdapter implements Parser, ContentHandler { - + //////////////////////////////////////////////////////////////////// // Constructor. //////////////////////////////////////////////////////////////////// @@ -71,7 +71,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler public XMLReaderAdapter () throws SAXException { - setup(XMLReaderFactory.createXMLReader()); + setup(XMLReaderFactory.createXMLReader()); } @@ -87,7 +87,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public XMLReaderAdapter (XMLReader xmlReader) { - setup(xmlReader); + setup(xmlReader); } @@ -99,11 +99,11 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ private void setup (XMLReader xmlReader) { - if (xmlReader == null) { - throw new NullPointerException("XMLReader must not be null"); - } - this.xmlReader = xmlReader; - qAtts = new AttributesAdapter(); + if (xmlReader == null) { + throw new NullPointerException("XMLReader must not be null"); + } + this.xmlReader = xmlReader; + qAtts = new AttributesAdapter(); } @@ -124,9 +124,9 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @exception org.xml.sax.SAXException Thrown unless overridden. */ public void setLocale (Locale locale) - throws SAXException + throws SAXException { - throw new SAXNotSupportedException("setLocale not supported"); + throw new SAXNotSupportedException("setLocale not supported"); } @@ -138,7 +138,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public void setEntityResolver (EntityResolver resolver) { - xmlReader.setEntityResolver(resolver); + xmlReader.setEntityResolver(resolver); } @@ -150,7 +150,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public void setDTDHandler (DTDHandler handler) { - xmlReader.setDTDHandler(handler); + xmlReader.setDTDHandler(handler); } @@ -165,7 +165,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public void setDocumentHandler (DocumentHandler handler) { - documentHandler = handler; + documentHandler = handler; } @@ -177,7 +177,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public void setErrorHandler (ErrorHandler handler) { - xmlReader.setErrorHandler(handler); + xmlReader.setErrorHandler(handler); } @@ -185,7 +185,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler * Parse the document. * * <p>This method will throw an exception if the embedded - * XMLReader does not support the + * XMLReader does not support the * http://xml.org/sax/features/namespace-prefixes property.</p> * * @param systemId The absolute URL of the document. @@ -197,9 +197,9 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.Parser#parse(java.lang.String) */ public void parse (String systemId) - throws IOException, SAXException + throws IOException, SAXException { - parse(new InputSource(systemId)); + parse(new InputSource(systemId)); } @@ -207,7 +207,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler * Parse the document. * * <p>This method will throw an exception if the embedded - * XMLReader does not support the + * XMLReader does not support the * http://xml.org/sax/features/namespace-prefixes property.</p> * * @param input An input source for the document. @@ -219,10 +219,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.Parser#parse(org.xml.sax.InputSource) */ public void parse (InputSource input) - throws IOException, SAXException + throws IOException, SAXException { - setupXMLReader(); - xmlReader.parse(input); + setupXMLReader(); + xmlReader.parse(input); } @@ -230,20 +230,20 @@ public class XMLReaderAdapter implements Parser, ContentHandler * Set up the XML reader. */ private void setupXMLReader () - throws SAXException + throws SAXException { - xmlReader.setFeature("http://xml.org/sax/features/namespace-prefixes", true); - try { - xmlReader.setFeature("http://xml.org/sax/features/namespaces", - false); - } catch (SAXException e) { - // NO OP: it's just extra information, and we can ignore it - } - xmlReader.setContentHandler(this); + xmlReader.setFeature("http://xml.org/sax/features/namespace-prefixes", true); + try { + xmlReader.setFeature("http://xml.org/sax/features/namespaces", + false); + } catch (SAXException e) { + // NO OP: it's just extra information, and we can ignore it + } + xmlReader.setContentHandler(this); } - + //////////////////////////////////////////////////////////////////// // Implementation of org.xml.sax.ContentHandler. //////////////////////////////////////////////////////////////////// @@ -257,8 +257,8 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ public void setDocumentLocator (Locator locator) { - if (documentHandler != null) - documentHandler.setDocumentLocator(locator); + if (documentHandler != null) + documentHandler.setDocumentLocator(locator); } @@ -270,10 +270,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#startDocument */ public void startDocument () - throws SAXException + throws SAXException { - if (documentHandler != null) - documentHandler.startDocument(); + if (documentHandler != null) + documentHandler.startDocument(); } @@ -285,10 +285,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#endDocument */ public void endDocument () - throws SAXException + throws SAXException { - if (documentHandler != null) - documentHandler.endDocument(); + if (documentHandler != null) + documentHandler.endDocument(); } @@ -327,13 +327,13 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#endDocument */ public void startElement (String uri, String localName, - String qName, Attributes atts) - throws SAXException + String qName, Attributes atts) + throws SAXException { - if (documentHandler != null) { - qAtts.setAttributes(atts); - documentHandler.startElement(qName, qAtts); - } + if (documentHandler != null) { + qAtts.setAttributes(atts); + documentHandler.startElement(qName, qAtts); + } } @@ -348,11 +348,11 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#endElement */ public void endElement (String uri, String localName, - String qName) - throws SAXException + String qName) + throws SAXException { - if (documentHandler != null) - documentHandler.endElement(qName); + if (documentHandler != null) + documentHandler.endElement(qName); } @@ -367,10 +367,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#characters */ public void characters (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (documentHandler != null) - documentHandler.characters(ch, start, length); + if (documentHandler != null) + documentHandler.characters(ch, start, length); } @@ -385,10 +385,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#ignorableWhitespace */ public void ignorableWhitespace (char ch[], int start, int length) - throws SAXException + throws SAXException { - if (documentHandler != null) - documentHandler.ignorableWhitespace(ch, start, length); + if (documentHandler != null) + documentHandler.ignorableWhitespace(ch, start, length); } @@ -402,10 +402,10 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @see org.xml.sax.ContentHandler#processingInstruction */ public void processingInstruction (String target, String data) - throws SAXException + throws SAXException { - if (documentHandler != null) - documentHandler.processingInstruction(target, data); + if (documentHandler != null) + documentHandler.processingInstruction(target, data); } @@ -417,12 +417,12 @@ public class XMLReaderAdapter implements Parser, ContentHandler * @exception org.xml.sax.SAXException Throwable by subclasses. */ public void skippedEntity (String name) - throws SAXException + throws SAXException { } - + //////////////////////////////////////////////////////////////////// // Internal state. //////////////////////////////////////////////////////////////////// @@ -432,7 +432,7 @@ public class XMLReaderAdapter implements Parser, ContentHandler AttributesAdapter qAtts; - + //////////////////////////////////////////////////////////////////// // Internal class. //////////////////////////////////////////////////////////////////// @@ -443,94 +443,94 @@ public class XMLReaderAdapter implements Parser, ContentHandler */ final class AttributesAdapter implements AttributeList { - AttributesAdapter () - { - } - - - /** - * Set the embedded Attributes object. - * - * @param The embedded SAX2 Attributes. - */ - void setAttributes (Attributes attributes) - { - this.attributes = attributes; - } - - - /** - * Return the number of attributes. - * - * @return The length of the attribute list. - * @see org.xml.sax.AttributeList#getLength - */ - public int getLength () - { - return attributes.getLength(); - } - - - /** - * Return the qualified (prefixed) name of an attribute by position. - * - * @return The qualified name. - * @see org.xml.sax.AttributeList#getName - */ - public String getName (int i) - { - return attributes.getQName(i); - } - - - /** - * Return the type of an attribute by position. - * - * @return The type. - * @see org.xml.sax.AttributeList#getType(int) - */ - public String getType (int i) - { - return attributes.getType(i); - } - - - /** - * Return the value of an attribute by position. - * - * @return The value. - * @see org.xml.sax.AttributeList#getValue(int) - */ - public String getValue (int i) - { - return attributes.getValue(i); - } - - - /** - * Return the type of an attribute by qualified (prefixed) name. - * - * @return The type. - * @see org.xml.sax.AttributeList#getType(java.lang.String) - */ - public String getType (String qName) - { - return attributes.getType(qName); - } - - - /** - * Return the value of an attribute by qualified (prefixed) name. - * - * @return The value. - * @see org.xml.sax.AttributeList#getValue(java.lang.String) - */ - public String getValue (String qName) - { - return attributes.getValue(qName); - } - - private Attributes attributes; + AttributesAdapter () + { + } + + + /** + * Set the embedded Attributes object. + * + * @param The embedded SAX2 Attributes. + */ + void setAttributes (Attributes attributes) + { + this.attributes = attributes; + } + + + /** + * Return the number of attributes. + * + * @return The length of the attribute list. + * @see org.xml.sax.AttributeList#getLength + */ + public int getLength () + { + return attributes.getLength(); + } + + + /** + * Return the qualified (prefixed) name of an attribute by position. + * + * @return The qualified name. + * @see org.xml.sax.AttributeList#getName + */ + public String getName (int i) + { + return attributes.getQName(i); + } + + + /** + * Return the type of an attribute by position. + * + * @return The type. + * @see org.xml.sax.AttributeList#getType(int) + */ + public String getType (int i) + { + return attributes.getType(i); + } + + + /** + * Return the value of an attribute by position. + * + * @return The value. + * @see org.xml.sax.AttributeList#getValue(int) + */ + public String getValue (int i) + { + return attributes.getValue(i); + } + + + /** + * Return the type of an attribute by qualified (prefixed) name. + * + * @return The type. + * @see org.xml.sax.AttributeList#getType(java.lang.String) + */ + public String getType (String qName) + { + return attributes.getType(qName); + } + + + /** + * Return the value of an attribute by qualified (prefixed) name. + * + * @return The value. + * @see org.xml.sax.AttributeList#getValue(java.lang.String) + */ + public String getValue (String qName) + { + return attributes.getValue(qName); + } + + private Attributes attributes; } } diff --git a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderFactory.java b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderFactory.java index 304f750b9cc..9a04f9b0dda 100644 --- a/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderFactory.java +++ b/libjava/classpath/external/sax/org/xml/sax/helpers/XMLReaderFactory.java @@ -102,64 +102,64 @@ final public class XMLReaderFactory * @see #createXMLReader(java.lang.String) */ public static XMLReader createXMLReader () - throws SAXException + throws SAXException { - String className = null; - ClassLoader loader = NewInstance.getClassLoader (); - - // 1. try the JVM-instance-wide system property - try { className = System.getProperty (property); } - catch (RuntimeException e) { /* normally fails for applets */ } - - // 2. if that fails, try META-INF/services/ - if (className == null) { - try { - String service = "META-INF/services/" + property; - InputStream in; - BufferedReader reader; - - if (loader == null) - in = ClassLoader.getSystemResourceAsStream (service); - else - in = loader.getResourceAsStream (service); - - if (in != null) { - reader = new BufferedReader ( - new InputStreamReader (in, "UTF8")); - className = reader.readLine (); - in.close (); - } - } catch (Exception e) { - } - } - - // 3. Distro-specific fallback - if (className == null) { + String className = null; + ClassLoader loader = NewInstance.getClassLoader (); + + // 1. try the JVM-instance-wide system property + try { className = System.getProperty (property); } + catch (RuntimeException e) { /* normally fails for applets */ } + + // 2. if that fails, try META-INF/services/ + if (className == null) { + try { + String service = "META-INF/services/" + property; + InputStream in; + BufferedReader reader; + + if (loader == null) + in = ClassLoader.getSystemResourceAsStream (service); + else + in = loader.getResourceAsStream (service); + + if (in != null) { + reader = new BufferedReader ( + new InputStreamReader (in, "UTF8")); + className = reader.readLine (); + in.close (); + } + } catch (Exception e) { + } + } + + // 3. Distro-specific fallback + if (className == null) { // BEGIN DISTRIBUTION-SPECIFIC - // CLASSPATH LOCAL: have to code in the backup. - // Among other things, see PR 31303, and this thread: - // http://gcc.gnu.org/ml/java-patches/2007-q1/msg00661.html - className = "gnu.xml.stream.SAXParser"; + // CLASSPATH LOCAL: have to code in the backup. + // Among other things, see PR 31303, and this thread: + // http://gcc.gnu.org/ml/java-patches/2007-q1/msg00661.html + className = "gnu.xml.stream.SAXParser"; - // EXAMPLE: - // className = "com.example.sax.XmlReader"; - // or a $JAVA_HOME/jre/lib/*properties setting... + // EXAMPLE: + // className = "com.example.sax.XmlReader"; + // or a $JAVA_HOME/jre/lib/*properties setting... // END DISTRIBUTION-SPECIFIC - } - - // do we know the XMLReader implementation class yet? - if (className != null) - return loadClass (loader, className); - - // 4. panic -- adapt any SAX1 parser - try { - return new ParserAdapter (ParserFactory.makeParser ()); - } catch (Exception e) { - throw new SAXException ("Can't create default XMLReader; " - + "is system property org.xml.sax.driver set?"); - } + } + + // do we know the XMLReader implementation class yet? + if (className != null) + return loadClass (loader, className); + + // 4. panic -- adapt any SAX1 parser + try { + return new ParserAdapter (ParserFactory.makeParser ()); + } catch (Exception e) { + throw new SAXException ("Can't create default XMLReader; " + + "is system property org.xml.sax.driver set?"); + } } @@ -179,29 +179,29 @@ final public class XMLReaderFactory * @see #createXMLReader() */ public static XMLReader createXMLReader (String className) - throws SAXException + throws SAXException { - return loadClass (NewInstance.getClassLoader (), className); + return loadClass (NewInstance.getClassLoader (), className); } private static XMLReader loadClass (ClassLoader loader, String className) throws SAXException { - try { - return (XMLReader) NewInstance.newInstance (loader, className); - } catch (ClassNotFoundException e1) { - throw new SAXException("SAX2 driver class " + className + - " not found", e1); - } catch (IllegalAccessException e2) { - throw new SAXException("SAX2 driver class " + className + - " found but cannot be loaded", e2); - } catch (InstantiationException e3) { - throw new SAXException("SAX2 driver class " + className + - " loaded but cannot be instantiated (no empty public constructor?)", - e3); - } catch (ClassCastException e4) { - throw new SAXException("SAX2 driver class " + className + - " does not implement XMLReader", e4); - } + try { + return (XMLReader) NewInstance.newInstance (loader, className); + } catch (ClassNotFoundException e1) { + throw new SAXException("SAX2 driver class " + className + + " not found", e1); + } catch (IllegalAccessException e2) { + throw new SAXException("SAX2 driver class " + className + + " found but cannot be loaded", e2); + } catch (InstantiationException e3) { + throw new SAXException("SAX2 driver class " + className + + " loaded but cannot be instantiated (no empty public constructor?)", + e3); + } catch (ClassCastException e4) { + throw new SAXException("SAX2 driver class " + className + + " does not implement XMLReader", e4); + } } } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Attr.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Attr.java index d9ed6ffe128..94404512993 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Attr.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Attr.java @@ -13,79 +13,79 @@ package org.w3c.dom; /** - * The <code>Attr</code> interface represents an attribute in an - * <code>Element</code> object. Typically the allowable values for the + * The <code>Attr</code> interface represents an attribute in an + * <code>Element</code> object. Typically the allowable values for the * attribute are defined in a schema associated with the document. - * <p><code>Attr</code> objects inherit the <code>Node</code> interface, but - * since they are not actually child nodes of the element they describe, the - * DOM does not consider them part of the document tree. Thus, the - * <code>Node</code> attributes <code>parentNode</code>, - * <code>previousSibling</code>, and <code>nextSibling</code> have a - * <code>null</code> value for <code>Attr</code> objects. The DOM takes the - * view that attributes are properties of elements rather than having a - * separate identity from the elements they are associated with; this should - * make it more efficient to implement such features as default attributes - * associated with all elements of a given type. Furthermore, - * <code>Attr</code> nodes may not be immediate children of a - * <code>DocumentFragment</code>. However, they can be associated with - * <code>Element</code> nodes contained within a - * <code>DocumentFragment</code>. In short, users and implementors of the - * DOM need to be aware that <code>Attr</code> nodes have some things in - * common with other objects inheriting the <code>Node</code> interface, but + * <p><code>Attr</code> objects inherit the <code>Node</code> interface, but + * since they are not actually child nodes of the element they describe, the + * DOM does not consider them part of the document tree. Thus, the + * <code>Node</code> attributes <code>parentNode</code>, + * <code>previousSibling</code>, and <code>nextSibling</code> have a + * <code>null</code> value for <code>Attr</code> objects. The DOM takes the + * view that attributes are properties of elements rather than having a + * separate identity from the elements they are associated with; this should + * make it more efficient to implement such features as default attributes + * associated with all elements of a given type. Furthermore, + * <code>Attr</code> nodes may not be immediate children of a + * <code>DocumentFragment</code>. However, they can be associated with + * <code>Element</code> nodes contained within a + * <code>DocumentFragment</code>. In short, users and implementors of the + * DOM need to be aware that <code>Attr</code> nodes have some things in + * common with other objects inheriting the <code>Node</code> interface, but * they also are quite distinct. - * <p>The attribute's effective value is determined as follows: if this - * attribute has been explicitly assigned any value, that value is the - * attribute's effective value; otherwise, if there is a declaration for - * this attribute, and that declaration includes a default value, then that - * default value is the attribute's effective value; otherwise, the - * attribute does not exist on this element in the structure model until it - * has been explicitly added. Note that the <code>Node.nodeValue</code> - * attribute on the <code>Attr</code> instance can also be used to retrieve + * <p>The attribute's effective value is determined as follows: if this + * attribute has been explicitly assigned any value, that value is the + * attribute's effective value; otherwise, if there is a declaration for + * this attribute, and that declaration includes a default value, then that + * default value is the attribute's effective value; otherwise, the + * attribute does not exist on this element in the structure model until it + * has been explicitly added. Note that the <code>Node.nodeValue</code> + * attribute on the <code>Attr</code> instance can also be used to retrieve * the string version of the attribute's value(s). - * <p> If the attribute was not explicitly given a value in the instance - * document but has a default value provided by the schema associated with - * the document, an attribute node will be created with - * <code>specified</code> set to <code>false</code>. Removing attribute - * nodes for which a default value is defined in the schema generates a new - * attribute node with the default value and <code>specified</code> set to - * <code>false</code>. If validation occurred while invoking - * <code>Document.normalizeDocument()</code>, attribute nodes with - * <code>specified</code> equals to <code>false</code> are recomputed - * according to the default attribute values provided by the schema. If no - * default value is associate with this attribute in the schema, the - * attribute node is discarded. - * <p>In XML, where the value of an attribute can contain entity references, - * the child nodes of the <code>Attr</code> node may be either - * <code>Text</code> or <code>EntityReference</code> nodes (when these are - * in use; see the description of <code>EntityReference</code> for - * discussion). - * <p>The DOM Core represents all attribute values as simple strings, even if - * the DTD or schema associated with the document declares them of some - * specific type such as tokenized. - * <p>The way attribute value normalization is performed by the DOM - * implementation depends on how much the implementation knows about the - * schema in use. Typically, the <code>value</code> and - * <code>nodeValue</code> attributes of an <code>Attr</code> node initially - * returns the normalized value given by the parser. It is also the case - * after <code>Document.normalizeDocument()</code> is called (assuming the - * right options have been set). But this may not be the case after - * mutation, independently of whether the mutation is performed by setting - * the string value directly or by changing the <code>Attr</code> child - * nodes. In particular, this is true when <a href='http://www.w3.org/TR/2004/REC-xml-20040204#dt-charref'>character - * references</a> are involved, given that they are not represented in the DOM and they - * impact attribute value normalization. On the other hand, if the - * implementation knows about the schema in use when the attribute value is - * changed, and it is of a different type than CDATA, it may normalize it - * again at that time. This is especially true of specialized DOM - * implementations, such as SVG DOM implementations, which store attribute + * <p> If the attribute was not explicitly given a value in the instance + * document but has a default value provided by the schema associated with + * the document, an attribute node will be created with + * <code>specified</code> set to <code>false</code>. Removing attribute + * nodes for which a default value is defined in the schema generates a new + * attribute node with the default value and <code>specified</code> set to + * <code>false</code>. If validation occurred while invoking + * <code>Document.normalizeDocument()</code>, attribute nodes with + * <code>specified</code> equals to <code>false</code> are recomputed + * according to the default attribute values provided by the schema. If no + * default value is associate with this attribute in the schema, the + * attribute node is discarded. + * <p>In XML, where the value of an attribute can contain entity references, + * the child nodes of the <code>Attr</code> node may be either + * <code>Text</code> or <code>EntityReference</code> nodes (when these are + * in use; see the description of <code>EntityReference</code> for + * discussion). + * <p>The DOM Core represents all attribute values as simple strings, even if + * the DTD or schema associated with the document declares them of some + * specific type such as tokenized. + * <p>The way attribute value normalization is performed by the DOM + * implementation depends on how much the implementation knows about the + * schema in use. Typically, the <code>value</code> and + * <code>nodeValue</code> attributes of an <code>Attr</code> node initially + * returns the normalized value given by the parser. It is also the case + * after <code>Document.normalizeDocument()</code> is called (assuming the + * right options have been set). But this may not be the case after + * mutation, independently of whether the mutation is performed by setting + * the string value directly or by changing the <code>Attr</code> child + * nodes. In particular, this is true when <a href='http://www.w3.org/TR/2004/REC-xml-20040204#dt-charref'>character + * references</a> are involved, given that they are not represented in the DOM and they + * impact attribute value normalization. On the other hand, if the + * implementation knows about the schema in use when the attribute value is + * changed, and it is of a different type than CDATA, it may normalize it + * again at that time. This is especially true of specialized DOM + * implementations, such as SVG DOM implementations, which store attribute * values in an internal form different from a string. - * <p>The following table gives some examples of the relations between the - * attribute value in the original document (parsed attribute), the value as - * exposed in the DOM, and the serialization of the value: + * <p>The following table gives some examples of the relations between the + * attribute value in the original document (parsed attribute), the value as + * exposed in the DOM, and the serialization of the value: * <table border='1' cellpadding='3'> * <tr> * <th>Examples</th> - * <th>Parsed + * <th>Parsed * attribute value</th> * <th>Initial <code>Attr.value</code></th> * <th>Serialized attribute value</th> @@ -104,7 +104,7 @@ package org.w3c.dom; * </td> * </tr> * <tr> - * <td valign='top' rowspan='1' colspan='1'>Built-in + * <td valign='top' rowspan='1' colspan='1'>Built-in * character entity</td> * <td valign='top' rowspan='1' colspan='1'> * <pre>"y&lt;6"</pre> @@ -132,7 +132,7 @@ package org.w3c.dom; * <tr> * <td valign='top' rowspan='1' colspan='1'>Normalized newline between</td> * <td valign='top' rowspan='1' colspan='1'> - * <pre>"x=5 + * <pre>"x=5 * y=6"</pre> * </td> * <td valign='top' rowspan='1' colspan='1'> @@ -156,51 +156,51 @@ package org.w3c.dom; */ public interface Attr extends Node { /** - * Returns the name of this attribute. If <code>Node.localName</code> is + * Returns the name of this attribute. If <code>Node.localName</code> is * different from <code>null</code>, this attribute is a qualified name. */ public String getName(); /** - * <code>True</code> if this attribute was explicitly given a value in - * the instance document, <code>false</code> otherwise. If the - * application changed the value of this attribute node (even if it ends - * up having the same value as the default value) then it is set to - * <code>true</code>. The implementation may handle attributes with - * default values from other schemas similarly but applications should - * use <code>Document.normalizeDocument()</code> to guarantee this - * information is up-to-date. + * <code>True</code> if this attribute was explicitly given a value in + * the instance document, <code>false</code> otherwise. If the + * application changed the value of this attribute node (even if it ends + * up having the same value as the default value) then it is set to + * <code>true</code>. The implementation may handle attributes with + * default values from other schemas similarly but applications should + * use <code>Document.normalizeDocument()</code> to guarantee this + * information is up-to-date. */ public boolean getSpecified(); /** - * On retrieval, the value of the attribute is returned as a string. - * Character and general entity references are replaced with their - * values. See also the method <code>getAttribute</code> on the + * On retrieval, the value of the attribute is returned as a string. + * Character and general entity references are replaced with their + * values. See also the method <code>getAttribute</code> on the * <code>Element</code> interface. - * <br>On setting, this creates a <code>Text</code> node with the unparsed - * contents of the string, i.e. any characters that an XML processor - * would recognize as markup are instead treated as literal text. See + * <br>On setting, this creates a <code>Text</code> node with the unparsed + * contents of the string, i.e. any characters that an XML processor + * would recognize as markup are instead treated as literal text. See * also the method <code>Element.setAttribute()</code>. - * <br> Some specialized implementations, such as some [<a href='http://www.w3.org/TR/2003/REC-SVG11-20030114/'>SVG 1.1</a>] - * implementations, may do normalization automatically, even after - * mutation; in such case, the value on retrieval may differ from the - * value on setting. + * <br> Some specialized implementations, such as some [<a href='http://www.w3.org/TR/2003/REC-SVG11-20030114/'>SVG 1.1</a>] + * implementations, may do normalization automatically, even after + * mutation; in such case, the value on retrieval may differ from the + * value on setting. */ public String getValue(); /** - * On retrieval, the value of the attribute is returned as a string. - * Character and general entity references are replaced with their - * values. See also the method <code>getAttribute</code> on the + * On retrieval, the value of the attribute is returned as a string. + * Character and general entity references are replaced with their + * values. See also the method <code>getAttribute</code> on the * <code>Element</code> interface. - * <br>On setting, this creates a <code>Text</code> node with the unparsed - * contents of the string, i.e. any characters that an XML processor - * would recognize as markup are instead treated as literal text. See + * <br>On setting, this creates a <code>Text</code> node with the unparsed + * contents of the string, i.e. any characters that an XML processor + * would recognize as markup are instead treated as literal text. See * also the method <code>Element.setAttribute()</code>. - * <br> Some specialized implementations, such as some [<a href='http://www.w3.org/TR/2003/REC-SVG11-20030114/'>SVG 1.1</a>] - * implementations, may do normalization automatically, even after - * mutation; in such case, the value on retrieval may differ from the - * value on setting. + * <br> Some specialized implementations, such as some [<a href='http://www.w3.org/TR/2003/REC-SVG11-20030114/'>SVG 1.1</a>] + * implementations, may do normalization automatically, even after + * mutation; in such case, the value on retrieval may differ from the + * value on setting. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. */ @@ -208,66 +208,66 @@ public interface Attr extends Node { throws DOMException; /** - * The <code>Element</code> node this attribute is attached to or + * The <code>Element</code> node this attribute is attached to or * <code>null</code> if this attribute is not in use. * @since DOM Level 2 */ public Element getOwnerElement(); /** - * The type information associated with this attribute. While the type - * information contained in this attribute is guarantee to be correct - * after loading the document or invoking + * The type information associated with this attribute. While the type + * information contained in this attribute is guarantee to be correct + * after loading the document or invoking * <code>Document.normalizeDocument()</code>, <code>schemaTypeInfo</code> - * may not be reliable if the node was moved. + * may not be reliable if the node was moved. * @since DOM Level 3 */ public TypeInfo getSchemaTypeInfo(); /** - * Returns whether this attribute is known to be of type ID (i.e. to - * contain an identifier for its owner element) or not. When it is and - * its value is unique, the <code>ownerElement</code> of this attribute + * Returns whether this attribute is known to be of type ID (i.e. to + * contain an identifier for its owner element) or not. When it is and + * its value is unique, the <code>ownerElement</code> of this attribute * can be retrieved using the method <code>Document.getElementById</code> - * . The implementation could use several ways to determine if an - * attribute node is known to contain an identifier: + * . The implementation could use several ways to determine if an + * attribute node is known to contain an identifier: * <ul> - * <li> If validation + * <li> If validation * occurred using an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * while loading the document or while invoking - * <code>Document.normalizeDocument()</code>, the post-schema-validation - * infoset contributions (PSVI contributions) values are used to - * determine if this attribute is a schema-determined ID attribute using + * while loading the document or while invoking + * <code>Document.normalizeDocument()</code>, the post-schema-validation + * infoset contributions (PSVI contributions) values are used to + * determine if this attribute is a schema-determined ID attribute using * the <a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/#term-sdi'> * schema-determined ID</a> definition in [<a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/'>XPointer</a>] - * . + * . * </li> - * <li> If validation occurred using a DTD while loading the document or - * while invoking <code>Document.normalizeDocument()</code>, the infoset <b>[type definition]</b> value is used to determine if this attribute is a DTD-determined ID + * <li> If validation occurred using a DTD while loading the document or + * while invoking <code>Document.normalizeDocument()</code>, the infoset <b>[type definition]</b> value is used to determine if this attribute is a DTD-determined ID * attribute using the <a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/#term-ddi'> * DTD-determined ID</a> definition in [<a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/'>XPointer</a>] - * . + * . * </li> - * <li> from the use of the methods <code>Element.setIdAttribute()</code>, - * <code>Element.setIdAttributeNS()</code>, or - * <code>Element.setIdAttributeNode()</code>, i.e. it is an - * user-determined ID attribute; + * <li> from the use of the methods <code>Element.setIdAttribute()</code>, + * <code>Element.setIdAttributeNS()</code>, or + * <code>Element.setIdAttributeNode()</code>, i.e. it is an + * user-determined ID attribute; * <p ><b>Note:</b> XPointer framework (see section 3.2 in [<a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/'>XPointer</a>] - * ) consider the DOM user-determined ID attribute as being part of the - * XPointer externally-determined ID definition. + * ) consider the DOM user-determined ID attribute as being part of the + * XPointer externally-determined ID definition. * </li> - * <li> using mechanisms that - * are outside the scope of this specification, it is then an - * externally-determined ID attribute. This includes using schema - * languages different from XML schema and DTD. + * <li> using mechanisms that + * are outside the scope of this specification, it is then an + * externally-determined ID attribute. This includes using schema + * languages different from XML schema and DTD. * </li> * </ul> - * <br> If validation occurred while invoking - * <code>Document.normalizeDocument()</code>, all user-determined ID - * attributes are reset and all attribute nodes ID information are then - * reevaluated in accordance to the schema used. As a consequence, if - * the <code>Attr.schemaTypeInfo</code> attribute contains an ID type, - * <code>isId</code> will always return true. + * <br> If validation occurred while invoking + * <code>Document.normalizeDocument()</code>, all user-determined ID + * attributes are reset and all attribute nodes ID information are then + * reevaluated in accordance to the schema used. As a consequence, if + * the <code>Attr.schemaTypeInfo</code> attribute contains an ID type, + * <code>isId</code> will always return true. * @since DOM Level 3 */ public boolean isId(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/CDATASection.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/CDATASection.java index 9267227e42d..ce4b346eba3 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/CDATASection.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/CDATASection.java @@ -13,40 +13,40 @@ package org.w3c.dom; /** - * CDATA sections are used to escape blocks of text containing characters that - * would otherwise be regarded as markup. The only delimiter that is - * recognized in a CDATA section is the "]]>" string that ends the CDATA - * section. CDATA sections cannot be nested. Their primary purpose is for - * including material such as XML fragments, without needing to escape all + * CDATA sections are used to escape blocks of text containing characters that + * would otherwise be regarded as markup. The only delimiter that is + * recognized in a CDATA section is the "]]>" string that ends the CDATA + * section. CDATA sections cannot be nested. Their primary purpose is for + * including material such as XML fragments, without needing to escape all * the delimiters. - * <p>The <code>CharacterData.data</code> attribute holds the text that is - * contained by the CDATA section. Note that this <em>may</em> contain characters that need to be escaped outside of CDATA sections and - * that, depending on the character encoding ("charset") chosen for - * serialization, it may be impossible to write out some characters as part + * <p>The <code>CharacterData.data</code> attribute holds the text that is + * contained by the CDATA section. Note that this <em>may</em> contain characters that need to be escaped outside of CDATA sections and + * that, depending on the character encoding ("charset") chosen for + * serialization, it may be impossible to write out some characters as part * of a CDATA section. - * <p>The <code>CDATASection</code> interface inherits from the - * <code>CharacterData</code> interface through the <code>Text</code> - * interface. Adjacent <code>CDATASection</code> nodes are not merged by use + * <p>The <code>CDATASection</code> interface inherits from the + * <code>CharacterData</code> interface through the <code>Text</code> + * interface. Adjacent <code>CDATASection</code> nodes are not merged by use * of the <code>normalize</code> method of the <code>Node</code> interface. - * <p> No lexical check is done on the content of a CDATA section and it is - * therefore possible to have the character sequence <code>"]]>"</code> - * in the content, which is illegal in a CDATA section per section 2.7 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The - * presence of this character sequence must generate a fatal error during - * serialization or the cdata section must be splitted before the - * serialization (see also the parameter <code>"split-cdata-sections"</code> - * in the <code>DOMConfiguration</code> interface). - * <p ><b>Note:</b> Because no markup is recognized within a - * <code>CDATASection</code>, character numeric references cannot be used as - * an escape mechanism when serializing. Therefore, action needs to be taken - * when serializing a <code>CDATASection</code> with a character encoding - * where some of the contained characters cannot be represented. Failure to + * <p> No lexical check is done on the content of a CDATA section and it is + * therefore possible to have the character sequence <code>"]]>"</code> + * in the content, which is illegal in a CDATA section per section 2.7 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The + * presence of this character sequence must generate a fatal error during + * serialization or the cdata section must be splitted before the + * serialization (see also the parameter <code>"split-cdata-sections"</code> + * in the <code>DOMConfiguration</code> interface). + * <p ><b>Note:</b> Because no markup is recognized within a + * <code>CDATASection</code>, character numeric references cannot be used as + * an escape mechanism when serializing. Therefore, action needs to be taken + * when serializing a <code>CDATASection</code> with a character encoding + * where some of the contained characters cannot be represented. Failure to * do so would not produce well-formed XML. - * <p ><b>Note:</b> One potential solution in the serialization process is to - * end the CDATA section before the character, output the character using a - * character reference or entity reference, and open a new CDATA section for - * any further characters in the text node. Note, however, that some code - * conversion libraries at the time of writing do not return an error or - * exception when a character is missing from the encoding, making the task + * <p ><b>Note:</b> One potential solution in the serialization process is to + * end the CDATA section before the character, output the character using a + * character reference or entity reference, and open a new CDATA section for + * any further characters in the text node. Note, however, that some code + * conversion libraries at the time of writing do not return an error or + * exception when a character is missing from the encoding, making the task * of ensuring that data is not corrupted on serialization more difficult. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/CharacterData.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/CharacterData.java index a12dcedfae3..37aa8dffaa0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/CharacterData.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/CharacterData.java @@ -13,42 +13,42 @@ package org.w3c.dom; /** - * The <code>CharacterData</code> interface extends Node with a set of - * attributes and methods for accessing character data in the DOM. For - * clarity this set is defined here rather than on each object that uses - * these attributes and methods. No DOM objects correspond directly to - * <code>CharacterData</code>, though <code>Text</code> and others do - * inherit the interface from it. All <code>offsets</code> in this interface + * The <code>CharacterData</code> interface extends Node with a set of + * attributes and methods for accessing character data in the DOM. For + * clarity this set is defined here rather than on each object that uses + * these attributes and methods. No DOM objects correspond directly to + * <code>CharacterData</code>, though <code>Text</code> and others do + * inherit the interface from it. All <code>offsets</code> in this interface * start from <code>0</code>. - * <p>As explained in the <code>DOMString</code> interface, text strings in - * the DOM are represented in UTF-16, i.e. as a sequence of 16-bit units. In - * the following, the term 16-bit units is used whenever necessary to + * <p>As explained in the <code>DOMString</code> interface, text strings in + * the DOM are represented in UTF-16, i.e. as a sequence of 16-bit units. In + * the following, the term 16-bit units is used whenever necessary to * indicate that indexing on CharacterData is done in 16-bit units. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface CharacterData extends Node { /** - * The character data of the node that implements this interface. The DOM - * implementation may not put arbitrary limits on the amount of data - * that may be stored in a <code>CharacterData</code> node. However, - * implementation limits may mean that the entirety of a node's data may - * not fit into a single <code>DOMString</code>. In such cases, the user - * may call <code>substringData</code> to retrieve the data in + * The character data of the node that implements this interface. The DOM + * implementation may not put arbitrary limits on the amount of data + * that may be stored in a <code>CharacterData</code> node. However, + * implementation limits may mean that the entirety of a node's data may + * not fit into a single <code>DOMString</code>. In such cases, the user + * may call <code>substringData</code> to retrieve the data in * appropriately sized pieces. * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised when it would return more characters than - * fit in a <code>DOMString</code> variable on the implementation + * DOMSTRING_SIZE_ERR: Raised when it would return more characters than + * fit in a <code>DOMString</code> variable on the implementation * platform. */ public String getData() throws DOMException; /** - * The character data of the node that implements this interface. The DOM - * implementation may not put arbitrary limits on the amount of data - * that may be stored in a <code>CharacterData</code> node. However, - * implementation limits may mean that the entirety of a node's data may - * not fit into a single <code>DOMString</code>. In such cases, the user - * may call <code>substringData</code> to retrieve the data in + * The character data of the node that implements this interface. The DOM + * implementation may not put arbitrary limits on the amount of data + * that may be stored in a <code>CharacterData</code> node. However, + * implementation limits may mean that the entirety of a node's data may + * not fit into a single <code>DOMString</code>. In such cases, the user + * may call <code>substringData</code> to retrieve the data in * appropriately sized pieces. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. @@ -57,8 +57,8 @@ public interface CharacterData extends Node { throws DOMException; /** - * The number of 16-bit units that are available through <code>data</code> - * and the <code>substringData</code> method below. This may have the + * The number of 16-bit units that are available through <code>data</code> + * and the <code>substringData</code> method below. This may have the * value zero, i.e., <code>CharacterData</code> nodes may be empty. */ public int getLength(); @@ -67,24 +67,24 @@ public interface CharacterData extends Node { * Extracts a range of data from the node. * @param offset Start offset of substring to extract. * @param count The number of 16-bit units to extract. - * @return The specified substring. If the sum of <code>offset</code> and - * <code>count</code> exceeds the <code>length</code>, then all 16-bit + * @return The specified substring. If the sum of <code>offset</code> and + * <code>count</code> exceeds the <code>length</code>, then all 16-bit * units to the end of the data are returned. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is - * negative or greater than the number of 16-bit units in - * <code>data</code>, or if the specified <code>count</code> is + * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is + * negative or greater than the number of 16-bit units in + * <code>data</code>, or if the specified <code>count</code> is * negative. - * <br>DOMSTRING_SIZE_ERR: Raised if the specified range of text does + * <br>DOMSTRING_SIZE_ERR: Raised if the specified range of text does * not fit into a <code>DOMString</code>. */ - public String substringData(int offset, + public String substringData(int offset, int count) throws DOMException; /** - * Append the string to the end of the character data of the node. Upon - * success, <code>data</code> provides access to the concatenation of + * Append the string to the end of the character data of the node. Upon + * success, <code>data</code> provides access to the concatenation of * <code>data</code> and the <code>DOMString</code> specified. * @param arg The <code>DOMString</code> to append. * @exception DOMException @@ -98,55 +98,55 @@ public interface CharacterData extends Node { * @param offset The character offset at which to insert. * @param arg The <code>DOMString</code> to insert. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is - * negative or greater than the number of 16-bit units in + * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is + * negative or greater than the number of 16-bit units in * <code>data</code>. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ - public void insertData(int offset, + public void insertData(int offset, String arg) throws DOMException; /** - * Remove a range of 16-bit units from the node. Upon success, + * Remove a range of 16-bit units from the node. Upon success, * <code>data</code> and <code>length</code> reflect the change. * @param offset The offset from which to start removing. - * @param count The number of 16-bit units to delete. If the sum of - * <code>offset</code> and <code>count</code> exceeds - * <code>length</code> then all 16-bit units from <code>offset</code> + * @param count The number of 16-bit units to delete. If the sum of + * <code>offset</code> and <code>count</code> exceeds + * <code>length</code> then all 16-bit units from <code>offset</code> * to the end of the data are deleted. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is - * negative or greater than the number of 16-bit units in - * <code>data</code>, or if the specified <code>count</code> is + * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is + * negative or greater than the number of 16-bit units in + * <code>data</code>, or if the specified <code>count</code> is * negative. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ - public void deleteData(int offset, + public void deleteData(int offset, int count) throws DOMException; /** - * Replace the characters starting at the specified 16-bit unit offset + * Replace the characters starting at the specified 16-bit unit offset * with the specified string. * @param offset The offset from which to start replacing. - * @param count The number of 16-bit units to replace. If the sum of - * <code>offset</code> and <code>count</code> exceeds - * <code>length</code>, then all 16-bit units to the end of the data + * @param count The number of 16-bit units to replace. If the sum of + * <code>offset</code> and <code>count</code> exceeds + * <code>length</code>, then all 16-bit units to the end of the data * are replaced; (i.e., the effect is the same as a <code>remove</code> * method call with the same range, followed by an <code>append</code> * method invocation). - * @param arg The <code>DOMString</code> with which the range must be + * @param arg The <code>DOMString</code> with which the range must be * replaced. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is - * negative or greater than the number of 16-bit units in - * <code>data</code>, or if the specified <code>count</code> is + * INDEX_SIZE_ERR: Raised if the specified <code>offset</code> is + * negative or greater than the number of 16-bit units in + * <code>data</code>, or if the specified <code>count</code> is * negative. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ - public void replaceData(int offset, - int count, + public void replaceData(int offset, + int count, String arg) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Comment.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Comment.java index b04ed4d0a5e..40b75274ba2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Comment.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Comment.java @@ -13,17 +13,17 @@ package org.w3c.dom; /** - * This interface inherits from <code>CharacterData</code> and represents the + * This interface inherits from <code>CharacterData</code> and represents the * content of a comment, i.e., all the characters between the starting ' - * <code><!--</code>' and ending '<code>--></code>'. Note that this is - * the definition of a comment in XML, and, in practice, HTML, although some - * HTML tools may implement the full SGML comment structure. - * <p> No lexical check is done on the content of a comment and it is - * therefore possible to have the character sequence <code>"--"</code> - * (double-hyphen) in the content, which is illegal in a comment per section - * 2.5 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The - * presence of this character sequence must generate a fatal error during - * serialization. + * <code><!--</code>' and ending '<code>--></code>'. Note that this is + * the definition of a comment in XML, and, in practice, HTML, although some + * HTML tools may implement the full SGML comment structure. + * <p> No lexical check is done on the content of a comment and it is + * therefore possible to have the character sequence <code>"--"</code> + * (double-hyphen) in the content, which is illegal in a comment per section + * 2.5 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The + * presence of this character sequence must generate a fatal error during + * serialization. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Comment extends CharacterData { diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMConfiguration.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMConfiguration.java index 7cce1609e19..d05257868aa 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMConfiguration.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMConfiguration.java @@ -13,47 +13,47 @@ package org.w3c.dom; /** - * The <code>DOMConfiguration</code> interface represents the configuration - * of a document and maintains a table of recognized parameters. Using the - * configuration, it is possible to change - * <code>Document.normalizeDocument()</code> behavior, such as replacing the - * <code>CDATASection</code> nodes with <code>Text</code> nodes or - * specifying the type of the schema that must be used when the validation - * of the <code>Document</code> is requested. <code>DOMConfiguration</code> + * The <code>DOMConfiguration</code> interface represents the configuration + * of a document and maintains a table of recognized parameters. Using the + * configuration, it is possible to change + * <code>Document.normalizeDocument()</code> behavior, such as replacing the + * <code>CDATASection</code> nodes with <code>Text</code> nodes or + * specifying the type of the schema that must be used when the validation + * of the <code>Document</code> is requested. <code>DOMConfiguration</code> * objects are also used in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>DOM Level 3 Load and Save</a>] - * in the <code>DOMParser</code> and <code>DOMSerializer</code> interfaces. - * <p> The parameter names used by the <code>DOMConfiguration</code> object - * are defined throughout the DOM Level 3 specifications. Names are - * case-insensitive. To avoid possible conflicts, as a convention, names - * referring to parameters defined outside the DOM specification should be - * made unique. Because parameters are exposed as properties in the , names - * are recommended to follow the section 5.16 Identifiers of [Unicode] with the addition of the character '-' (HYPHEN-MINUS) but it is not - * enforced by the DOM implementation. DOM Level 3 Core Implementations are - * required to recognize all parameters defined in this specification. Some - * parameter values may also be required to be supported by the - * implementation. Refer to the definition of the parameter to know if a - * value must be supported or not. - * <p ><b>Note:</b> Parameters are similar to features and properties used in - * SAX2 [<a href='http://www.saxproject.org/'>SAX</a>]. - * <p> The following list of parameters defined in the DOM: + * in the <code>DOMParser</code> and <code>DOMSerializer</code> interfaces. + * <p> The parameter names used by the <code>DOMConfiguration</code> object + * are defined throughout the DOM Level 3 specifications. Names are + * case-insensitive. To avoid possible conflicts, as a convention, names + * referring to parameters defined outside the DOM specification should be + * made unique. Because parameters are exposed as properties in the , names + * are recommended to follow the section 5.16 Identifiers of [Unicode] with the addition of the character '-' (HYPHEN-MINUS) but it is not + * enforced by the DOM implementation. DOM Level 3 Core Implementations are + * required to recognize all parameters defined in this specification. Some + * parameter values may also be required to be supported by the + * implementation. Refer to the definition of the parameter to know if a + * value must be supported or not. + * <p ><b>Note:</b> Parameters are similar to features and properties used in + * SAX2 [<a href='http://www.saxproject.org/'>SAX</a>]. + * <p> The following list of parameters defined in the DOM: * <dl> * <dt> * <code>"canonical-form"</code></dt> * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] Canonicalize the document according to the rules specified in [<a href='http://www.w3.org/TR/2001/REC-xml-c14n-20010315'>Canonical XML</a>], - * such as removing the <code>DocumentType</code> node (if any) from the - * tree, or removing superfluous namespace declarations from each element. - * Note that this is limited to what can be represented in the DOM; in - * particular, there is no way to specify the order of the attributes in the - * DOM. In addition, Setting this parameter to <code>true</code> will also - * set the state of the parameters listed below. Later changes to the state - * of one of those parameters will revert "canonical-form" back to + * <dd>[<em>optional</em>] Canonicalize the document according to the rules specified in [<a href='http://www.w3.org/TR/2001/REC-xml-c14n-20010315'>Canonical XML</a>], + * such as removing the <code>DocumentType</code> node (if any) from the + * tree, or removing superfluous namespace declarations from each element. + * Note that this is limited to what can be represented in the DOM; in + * particular, there is no way to specify the order of the attributes in the + * DOM. In addition, Setting this parameter to <code>true</code> will also + * set the state of the parameters listed below. Later changes to the state + * of one of those parameters will revert "canonical-form" back to * <code>false</code>. Parameters set to <code>false</code>: "entities", " - * normalize-characters", "cdata-sections". Parameters set to - * <code>true</code>: "namespaces", "namespace-declarations", "well-formed", - * "element-content-whitespace". Other parameters are not changed unless + * normalize-characters", "cdata-sections". Parameters set to + * <code>true</code>: "namespaces", "namespace-declarations", "well-formed", + * "element-content-whitespace". Other parameters are not changed unless * explicitly specified in the description of the parameters.</dd> * <dt> * <code>false</code></dt> @@ -66,8 +66,8 @@ package org.w3c.dom; * <code>true</code></dt> * <dd>[<em>required</em>] (<em>default</em>)Keep <code>CDATASection</code> nodes in the document.</dd> * <dt><code>false</code></dt> - * <dd>[<em>required</em>]Transform <code>CDATASection</code> nodes in the document into - * <code>Text</code> nodes. The new <code>Text</code> node is then combined + * <dd>[<em>required</em>]Transform <code>CDATASection</code> nodes in the document into + * <code>Text</code> nodes. The new <code>Text</code> node is then combined * with any adjacent <code>Text</code> node.</dd> * </dl></dd> * <dt> @@ -75,10 +75,10 @@ package org.w3c.dom; * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] Check if the characters in the document are <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully - * normalized</a>, as defined in appendix B of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. When a - * sequence of characters is encountered that fails normalization checking, - * an error with the <code>DOMError.type</code> equals to + * <dd>[<em>optional</em>] Check if the characters in the document are <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully + * normalized</a>, as defined in appendix B of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. When a + * sequence of characters is encountered that fails normalization checking, + * an error with the <code>DOMError.type</code> equals to * "check-character-normalization-failure" is issued. </dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>)Do not check if characters are normalized.</dd> @@ -97,14 +97,14 @@ package org.w3c.dom; * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] Expose schema normalized values in the tree, such as <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-nv'>XML - * Schema normalized values</a> in the case of XML Schema. Since this parameter requires to have schema - * information, the "validate" parameter will also be set to - * <code>true</code>. Having this parameter activated when "validate" is - * <code>false</code> has no effect and no schema-normalization will happen. - * <p ><b>Note:</b> Since the document contains the result of the XML 1.0 - * processing, this parameter does not apply to attribute value - * normalization as defined in section 3.3.3 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] and is only + * <dd>[<em>optional</em>] Expose schema normalized values in the tree, such as <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-nv'>XML + * Schema normalized values</a> in the case of XML Schema. Since this parameter requires to have schema + * information, the "validate" parameter will also be set to + * <code>true</code>. Having this parameter activated when "validate" is + * <code>false</code> has no effect and no schema-normalization will happen. + * <p ><b>Note:</b> Since the document contains the result of the XML 1.0 + * processing, this parameter does not apply to attribute value + * normalization as defined in section 3.3.3 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] and is only * meant for schema languages other than Document Type Definition (DTD). </dd> * <dt> * <code>false</code></dt> @@ -117,10 +117,10 @@ package org.w3c.dom; * <dt><code>true</code></dt> * <dd>[<em>required</em>] (<em>default</em>)Keep all whitespaces in the document.</dd> * <dt><code>false</code></dt> - * <dd>[<em>optional</em>] Discard all <code>Text</code> nodes that contain whitespaces in element + * <dd>[<em>optional</em>] Discard all <code>Text</code> nodes that contain whitespaces in element * content, as described in <a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character'> - * [element content whitespace]</a>. The implementation is expected to use the attribute - * <code>Text.isElementContentWhitespace</code> to determine if a + * [element content whitespace]</a>. The implementation is expected to use the attribute + * <code>Text.isElementContentWhitespace</code> to determine if a * <code>Text</code> node should be discarded or not.</dd> * </dl></dd> * <dt><code>"entities"</code></dt> @@ -131,23 +131,23 @@ package org.w3c.dom; * <dd>[<em>required</em>] (<em>default</em>)Keep <code>EntityReference</code> nodes in the document.</dd> * <dt> * <code>false</code></dt> - * <dd>[<em>required</em>] Remove all <code>EntityReference</code> nodes from the document, - * putting the entity expansions directly in their place. <code>Text</code> + * <dd>[<em>required</em>] Remove all <code>EntityReference</code> nodes from the document, + * putting the entity expansions directly in their place. <code>Text</code> * nodes are normalized, as defined in <code>Node.normalize</code>. Only <a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.rse'> * unexpanded entity references</a> are kept in the document. </dd> * </dl> * <p ><b>Note:</b> This parameter does not affect <code>Entity</code> nodes. </dd> * <dt> * <code>"error-handler"</code></dt> - * <dd>[<em>required</em>] Contains a <code>DOMErrorHandler</code> object. If an error is - * encountered in the document, the implementation will call back the - * <code>DOMErrorHandler</code> registered using this parameter. The - * implementation may provide a default <code>DOMErrorHandler</code> object. - * When called, <code>DOMError.relatedData</code> will contain the closest - * node to where the error occurred. If the implementation is unable to - * determine the node where the error occurs, - * <code>DOMError.relatedData</code> will contain the <code>Document</code> - * node. Mutations to the document from within an error handler will result + * <dd>[<em>required</em>] Contains a <code>DOMErrorHandler</code> object. If an error is + * encountered in the document, the implementation will call back the + * <code>DOMErrorHandler</code> registered using this parameter. The + * implementation may provide a default <code>DOMErrorHandler</code> object. + * When called, <code>DOMError.relatedData</code> will contain the closest + * node to where the error occurred. If the implementation is unable to + * determine the node where the error occurs, + * <code>DOMError.relatedData</code> will contain the <code>Document</code> + * node. Mutations to the document from within an error handler will result * in implementation dependent behavior. </dd> * <dt><code>"infoset"</code></dt> * <dd> @@ -159,13 +159,13 @@ package org.w3c.dom; * validate-if-schema", "entities", "datatype-normalization", "cdata-sections * ".This forces the following parameters to <code>true</code>: " * namespace-declarations", "well-formed", "element-content-whitespace", " - * comments", "namespaces".Other parameters are not changed unless - * explicitly specified in the description of the parameters. Note that - * querying this parameter with <code>getParameter</code> returns - * <code>true</code> only if the individual parameters specified above are + * comments", "namespaces".Other parameters are not changed unless + * explicitly specified in the description of the parameters. Note that + * querying this parameter with <code>getParameter</code> returns + * <code>true</code> only if the individual parameters specified above are * appropriately set.</dd> * <dt><code>false</code></dt> - * <dd>Setting <code>infoset</code> to + * <dd>Setting <code>infoset</code> to * <code>false</code> has no effect.</dd> * </dl></dd> * <dt><code>"namespaces"</code></dt> @@ -179,119 +179,119 @@ package org.w3c.dom; * </dl></dd> * <dt> * <code>"namespace-declarations"</code></dt> - * <dd> This parameter has no effect if the - * parameter "namespaces" is set to <code>false</code>. + * <dd> This parameter has no effect if the + * parameter "namespaces" is set to <code>false</code>. * <dl> * <dt><code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) Include namespace declaration attributes, specified or defaulted from - * the schema, in the document. See also the sections "Declaring Namespaces" + * <dd>[<em>required</em>] (<em>default</em>) Include namespace declaration attributes, specified or defaulted from + * the schema, in the document. See also the sections "Declaring Namespaces" * in [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] * and [<a href='http://www.w3.org/TR/2004/REC-xml-names11-20040204/'>XML Namespaces 1.1</a>] * .</dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>]Discard all namespace declaration attributes. The namespace prefixes ( - * <code>Node.prefix</code>) are retained even if this parameter is set to + * <code>Node.prefix</code>) are retained even if this parameter is set to * <code>false</code>.</dd> * </dl></dd> * <dt><code>"normalize-characters"</code></dt> * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>Fully + * <dd>[<em>optional</em>] <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>Fully * normalized</a> the characters in the document as defined in appendix B of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. </dd> * <dt> * <code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>)Do not perform character normalization.</dd> * </dl></dd> * <dt><code>"schema-location"</code></dt> - * <dd>[<em>optional</em>] Represent a <code>DOMString</code> object containing a list of URIs, - * separated by whitespaces (characters matching the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-S'>nonterminal - * production S</a> defined in section 2.3 [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]), that - * represents the schemas against which validation should occur, i.e. the - * current schema. The types of schemas referenced in this list must match - * the type specified with <code>schema-type</code>, otherwise the behavior - * of an implementation is undefined. The schemas specified using this - * property take precedence to the schema information specified in the - * document itself. For namespace aware schema, if a schema specified using - * this property and a schema specified in the document instance (i.e. using - * the <code>schemaLocation</code> attribute) in a schema document (i.e. - * using schema <code>import</code> mechanisms) share the same - * <code>targetNamespace</code>, the schema specified by the user using this - * property will be used. If two schemas specified using this property share - * the same <code>targetNamespace</code> or have no namespace, the behavior - * is implementation dependent. If no location has been provided, this - * parameter is <code>null</code>. - * <p ><b>Note:</b> The <code>"schema-location"</code> parameter is ignored - * unless the "schema-type" parameter value is set. It is strongly - * recommended that <code>Document.documentURI</code> will be set so that an + * <dd>[<em>optional</em>] Represent a <code>DOMString</code> object containing a list of URIs, + * separated by whitespaces (characters matching the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-S'>nonterminal + * production S</a> defined in section 2.3 [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]), that + * represents the schemas against which validation should occur, i.e. the + * current schema. The types of schemas referenced in this list must match + * the type specified with <code>schema-type</code>, otherwise the behavior + * of an implementation is undefined. The schemas specified using this + * property take precedence to the schema information specified in the + * document itself. For namespace aware schema, if a schema specified using + * this property and a schema specified in the document instance (i.e. using + * the <code>schemaLocation</code> attribute) in a schema document (i.e. + * using schema <code>import</code> mechanisms) share the same + * <code>targetNamespace</code>, the schema specified by the user using this + * property will be used. If two schemas specified using this property share + * the same <code>targetNamespace</code> or have no namespace, the behavior + * is implementation dependent. If no location has been provided, this + * parameter is <code>null</code>. + * <p ><b>Note:</b> The <code>"schema-location"</code> parameter is ignored + * unless the "schema-type" parameter value is set. It is strongly + * recommended that <code>Document.documentURI</code> will be set so that an * implementation can successfully resolve any external entities referenced. </dd> * <dt> * <code>"schema-type"</code></dt> - * <dd>[<em>optional</em>] Represent a <code>DOMString</code> object containing an absolute URI - * and representing the type of the schema language used to validate a - * document against. Note that no lexical checking is done on the absolute - * URI. If this parameter is not set, a default value may be provided by - * the implementation, based on the schema languages supported and on the - * schema language used at load time. If no value is provided, this - * parameter is <code>null</code>. + * <dd>[<em>optional</em>] Represent a <code>DOMString</code> object containing an absolute URI + * and representing the type of the schema language used to validate a + * document against. Note that no lexical checking is done on the absolute + * URI. If this parameter is not set, a default value may be provided by + * the implementation, based on the schema languages supported and on the + * schema language used at load time. If no value is provided, this + * parameter is <code>null</code>. * <p ><b>Note:</b> For XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * , applications must use the value - * <code>"http://www.w3.org/2001/XMLSchema"</code>. For XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], - * applications must use the value - * <code>"http://www.w3.org/TR/REC-xml"</code>. Other schema languages are - * outside the scope of the W3C and therefore should recommend an absolute + * , applications must use the value + * <code>"http://www.w3.org/2001/XMLSchema"</code>. For XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], + * applications must use the value + * <code>"http://www.w3.org/TR/REC-xml"</code>. Other schema languages are + * outside the scope of the W3C and therefore should recommend an absolute * URI in order to use this method. </dd> * <dt><code>"split-cdata-sections"</code></dt> * <dd> * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>)Split CDATA sections containing the CDATA section termination marker - * ']]>'. When a CDATA section is split a warning is issued with a - * <code>DOMError.type</code> equals to - * <code>"cdata-sections-splitted"</code> and - * <code>DOMError.relatedData</code> equals to the first + * <dd>[<em>required</em>] (<em>default</em>)Split CDATA sections containing the CDATA section termination marker + * ']]>'. When a CDATA section is split a warning is issued with a + * <code>DOMError.type</code> equals to + * <code>"cdata-sections-splitted"</code> and + * <code>DOMError.relatedData</code> equals to the first * <code>CDATASection</code> node in document order resulting from the split.</dd> * <dt> * <code>false</code></dt> - * <dd>[<em>required</em>]Signal an error if a <code>CDATASection</code> contains an + * <dd>[<em>required</em>]Signal an error if a <code>CDATASection</code> contains an * unrepresentable character.</dd> * </dl></dd> * <dt><code>"validate"</code></dt> * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] Require the validation against a schema (i.e. XML schema, DTD, any - * other type or representation of schema) of the document as it is being - * normalized as defined by [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. If - * validation errors are found, or no schema was found, the error handler is - * notified. Schema-normalized values will not be exposed according to the - * schema in used unless the parameter "datatype-normalization" is - * <code>true</code>. This parameter will reevaluate: + * <dd>[<em>optional</em>] Require the validation against a schema (i.e. XML schema, DTD, any + * other type or representation of schema) of the document as it is being + * normalized as defined by [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. If + * validation errors are found, or no schema was found, the error handler is + * notified. Schema-normalized values will not be exposed according to the + * schema in used unless the parameter "datatype-normalization" is + * <code>true</code>. This parameter will reevaluate: * <ul> - * <li> Attribute nodes with - * <code>Attr.specified</code> equals to <code>false</code>, as specified in - * the description of the <code>Attr</code> interface; + * <li> Attribute nodes with + * <code>Attr.specified</code> equals to <code>false</code>, as specified in + * the description of the <code>Attr</code> interface; * </li> - * <li> The value of the - * attribute <code>Text.isElementContentWhitespace</code> for all - * <code>Text</code> nodes; + * <li> The value of the + * attribute <code>Text.isElementContentWhitespace</code> for all + * <code>Text</code> nodes; * </li> - * <li> The value of the attribute - * <code>Attr.isId</code> for all <code>Attr</code> nodes; + * <li> The value of the attribute + * <code>Attr.isId</code> for all <code>Attr</code> nodes; * </li> - * <li> The attributes - * <code>Element.schemaTypeInfo</code> and <code>Attr.schemaTypeInfo</code>. + * <li> The attributes + * <code>Element.schemaTypeInfo</code> and <code>Attr.schemaTypeInfo</code>. * </li> * </ul> - * <p ><b>Note:</b> "validate-if-schema" and "validate" are mutually - * exclusive, setting one of them to <code>true</code> will set the other - * one to <code>false</code>. Applications should also consider setting the - * parameter "well-formed" to <code>true</code>, which is the default for + * <p ><b>Note:</b> "validate-if-schema" and "validate" are mutually + * exclusive, setting one of them to <code>true</code> will set the other + * one to <code>false</code>. Applications should also consider setting the + * parameter "well-formed" to <code>true</code>, which is the default for * that option, when validating the document. </dd> * <dt><code>false</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) Do not accomplish schema processing, including the internal subset - * processing. Default attribute values information are kept. Note that + * <dd>[<em>required</em>] (<em>default</em>) Do not accomplish schema processing, including the internal subset + * processing. Default attribute values information are kept. Note that * validation might still happen if "validate-if-schema" is <code>true</code> * . </dd> * </dl></dd> @@ -299,17 +299,17 @@ package org.w3c.dom; * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>]Enable validation only if a declaration for the document element can be - * found in a schema (independently of where it is found, i.e. XML schema, - * DTD, or any other type or representation of schema). If validation is - * enabled, this parameter has the same behavior as the parameter "validate" - * set to <code>true</code>. - * <p ><b>Note:</b> "validate-if-schema" and "validate" are mutually - * exclusive, setting one of them to <code>true</code> will set the other + * <dd>[<em>optional</em>]Enable validation only if a declaration for the document element can be + * found in a schema (independently of where it is found, i.e. XML schema, + * DTD, or any other type or representation of schema). If validation is + * enabled, this parameter has the same behavior as the parameter "validate" + * set to <code>true</code>. + * <p ><b>Note:</b> "validate-if-schema" and "validate" are mutually + * exclusive, setting one of them to <code>true</code> will set the other * one to <code>false</code>. </dd> * <dt><code>false</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) No schema processing should be performed if the document has a schema, - * including internal subset processing. Default attribute values + * <dd>[<em>required</em>] (<em>default</em>) No schema processing should be performed if the document has a schema, + * including internal subset processing. Default attribute values * information are kept. Note that validation must still happen if "validate * " is <code>true</code>. </dd> * </dl></dd> @@ -317,27 +317,27 @@ package org.w3c.dom; * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) Check if all nodes are XML well formed according to the XML version in - * use in <code>Document.xmlVersion</code>: + * <dd>[<em>required</em>] (<em>default</em>) Check if all nodes are XML well formed according to the XML version in + * use in <code>Document.xmlVersion</code>: * <ul> - * <li> check if the attribute - * <code>Node.nodeName</code> contains invalid characters according to its - * node type and generate a <code>DOMError</code> of type - * <code>"wf-invalid-character-in-node-name"</code>, with a - * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; + * <li> check if the attribute + * <code>Node.nodeName</code> contains invalid characters according to its + * node type and generate a <code>DOMError</code> of type + * <code>"wf-invalid-character-in-node-name"</code>, with a + * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; * </li> - * <li> check if - * the text content inside <code>Attr</code>, <code>Element</code>, - * <code>Comment</code>, <code>Text</code>, <code>CDATASection</code> nodes - * for invalid characters and generate a <code>DOMError</code> of type - * <code>"wf-invalid-character"</code>, with a - * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; + * <li> check if + * the text content inside <code>Attr</code>, <code>Element</code>, + * <code>Comment</code>, <code>Text</code>, <code>CDATASection</code> nodes + * for invalid characters and generate a <code>DOMError</code> of type + * <code>"wf-invalid-character"</code>, with a + * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; * </li> - * <li> check if - * the data inside <code>ProcessingInstruction</code> nodes for invalid - * characters and generate a <code>DOMError</code> of type - * <code>"wf-invalid-character"</code>, with a - * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; + * <li> check if + * the data inside <code>ProcessingInstruction</code> nodes for invalid + * characters and generate a <code>DOMError</code> of type + * <code>"wf-invalid-character"</code>, with a + * <code>DOMError.SEVERITY_ERROR</code> severity, if necessary; * </li> * </ul></dd> * <dt> @@ -345,14 +345,14 @@ package org.w3c.dom; * <dd>[<em>optional</em>] Do not check for XML well-formedness. </dd> * </dl></dd> * </dl> - * <p> The resolution of the system identifiers associated with entities is - * done using <code>Document.documentURI</code>. However, when the feature + * <p> The resolution of the system identifiers associated with entities is + * done using <code>Document.documentURI</code>. However, when the feature * "LS" defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>DOM Level 3 Load and Save</a>] - * is supported by the DOM implementation, the parameter - * "resource-resolver" can also be used on <code>DOMConfiguration</code> - * objects attached to <code>Document</code> nodes. If this parameter is - * set, <code>Document.normalizeDocument()</code> will invoke the resource - * resolver instead of using <code>Document.documentURI</code>. + * is supported by the DOM implementation, the parameter + * "resource-resolver" can also be used on <code>DOMConfiguration</code> + * objects attached to <code>Document</code> nodes. If this parameter is + * set, <code>Document.normalizeDocument()</code> will invoke the resource + * resolver instead of using <code>Document.documentURI</code>. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ @@ -360,31 +360,31 @@ public interface DOMConfiguration { /** * Set the value of a parameter. * @param name The name of the parameter to set. - * @param value The new value or <code>null</code> if the user wishes to - * unset the parameter. While the type of the value parameter is - * defined as <code>DOMUserData</code>, the object type must match the - * type defined by the definition of the parameter. For example, if - * the parameter is "error-handler", the value must be of type - * <code>DOMErrorHandler</code>. + * @param value The new value or <code>null</code> if the user wishes to + * unset the parameter. While the type of the value parameter is + * defined as <code>DOMUserData</code>, the object type must match the + * type defined by the definition of the parameter. For example, if + * the parameter is "error-handler", the value must be of type + * <code>DOMErrorHandler</code>. * @exception DOMException - * NOT_FOUND_ERR: Raised when the parameter name is not recognized. - * <br> NOT_SUPPORTED_ERR: Raised when the parameter name is recognized - * but the requested value cannot be set. - * <br> TYPE_MISMATCH_ERR: Raised if the value type for this parameter - * name is incompatible with the expected value type. + * NOT_FOUND_ERR: Raised when the parameter name is not recognized. + * <br> NOT_SUPPORTED_ERR: Raised when the parameter name is recognized + * but the requested value cannot be set. + * <br> TYPE_MISMATCH_ERR: Raised if the value type for this parameter + * name is incompatible with the expected value type. */ - public void setParameter(String name, + public void setParameter(String name, Object value) throws DOMException; /** - * Return the value of a parameter if known. - * @param name The name of the parameter. - * @return The current object associated with the specified parameter or - * <code>null</code> if no object has been associated or if the - * parameter is not supported. + * Return the value of a parameter if known. + * @param name The name of the parameter. + * @return The current object associated with the specified parameter or + * <code>null</code> if no object has been associated or if the + * parameter is not supported. * @exception DOMException - * NOT_FOUND_ERR: Raised when the parameter name is not recognized. + * NOT_FOUND_ERR: Raised when the parameter name is not recognized. */ public Object getParameter(String name) throws DOMException; @@ -392,21 +392,21 @@ public interface DOMConfiguration { /** * Check if setting a parameter to a specific value is supported. * @param name The name of the parameter to check. - * @param value An object. if <code>null</code>, the returned value is - * <code>true</code>. - * @return <code>true</code> if the parameter could be successfully set - * to the specified value, or <code>false</code> if the parameter is - * not recognized or the requested value is not supported. This does - * not change the current value of the parameter itself. + * @param value An object. if <code>null</code>, the returned value is + * <code>true</code>. + * @return <code>true</code> if the parameter could be successfully set + * to the specified value, or <code>false</code> if the parameter is + * not recognized or the requested value is not supported. This does + * not change the current value of the parameter itself. */ - public boolean canSetParameter(String name, + public boolean canSetParameter(String name, Object value); /** - * The list of the parameters supported by this - * <code>DOMConfiguration</code> object and for which at least one value - * can be set by the application. Note that this list can also contain - * parameter names defined outside this specification. + * The list of the parameters supported by this + * <code>DOMConfiguration</code> object and for which at least one value + * can be set by the application. Note that this list can also contain + * parameter names defined outside this specification. */ public DOMStringList getParameterNames(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMError.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMError.java index 37ed7d10d89..2634df37c8e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMError.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMError.java @@ -20,31 +20,31 @@ package org.w3c.dom; public interface DOMError { // ErrorSeverity /** - * The severity of the error described by the <code>DOMError</code> is - * warning. A <code>SEVERITY_WARNING</code> will not cause the - * processing to stop, unless <code>DOMErrorHandler.handleError()</code> + * The severity of the error described by the <code>DOMError</code> is + * warning. A <code>SEVERITY_WARNING</code> will not cause the + * processing to stop, unless <code>DOMErrorHandler.handleError()</code> * returns <code>false</code>. */ public static final short SEVERITY_WARNING = 1; /** - * The severity of the error described by the <code>DOMError</code> is - * error. A <code>SEVERITY_ERROR</code> may not cause the processing to - * stop if the error can be recovered, unless + * The severity of the error described by the <code>DOMError</code> is + * error. A <code>SEVERITY_ERROR</code> may not cause the processing to + * stop if the error can be recovered, unless * <code>DOMErrorHandler.handleError()</code> returns <code>false</code>. */ public static final short SEVERITY_ERROR = 2; /** - * The severity of the error described by the <code>DOMError</code> is - * fatal error. A <code>SEVERITY_FATAL_ERROR</code> will cause the - * normal processing to stop. The return value of - * <code>DOMErrorHandler.handleError()</code> is ignored unless the - * implementation chooses to continue, in which case the behavior + * The severity of the error described by the <code>DOMError</code> is + * fatal error. A <code>SEVERITY_FATAL_ERROR</code> will cause the + * normal processing to stop. The return value of + * <code>DOMErrorHandler.handleError()</code> is ignored unless the + * implementation chooses to continue, in which case the behavior * becomes undefined. */ public static final short SEVERITY_FATAL_ERROR = 3; /** - * The severity of the error, either <code>SEVERITY_WARNING</code>, + * The severity of the error, either <code>SEVERITY_WARNING</code>, * <code>SEVERITY_ERROR</code>, or <code>SEVERITY_FATAL_ERROR</code>. */ public short getSeverity(); @@ -55,17 +55,17 @@ public interface DOMError { public String getMessage(); /** - * A <code>DOMString</code> indicating which related data is expected in - * <code>relatedData</code>. Users should refer to the specification of - * the error in order to find its <code>DOMString</code> type and - * <code>relatedData</code> definitions if any. - * <p ><b>Note:</b> As an example, - * <code>Document.normalizeDocument()</code> does generate warnings when - * the "split-cdata-sections" parameter is in use. Therefore, the method - * generates a <code>SEVERITY_WARNING</code> with <code>type</code> - * <code>"cdata-sections-splitted"</code> and the first - * <code>CDATASection</code> node in document order resulting from the - * split is returned by the <code>relatedData</code> attribute. + * A <code>DOMString</code> indicating which related data is expected in + * <code>relatedData</code>. Users should refer to the specification of + * the error in order to find its <code>DOMString</code> type and + * <code>relatedData</code> definitions if any. + * <p ><b>Note:</b> As an example, + * <code>Document.normalizeDocument()</code> does generate warnings when + * the "split-cdata-sections" parameter is in use. Therefore, the method + * generates a <code>SEVERITY_WARNING</code> with <code>type</code> + * <code>"cdata-sections-splitted"</code> and the first + * <code>CDATASection</code> node in document order resulting from the + * split is returned by the <code>relatedData</code> attribute. */ public String getType(); @@ -75,7 +75,7 @@ public interface DOMError { public Object getRelatedException(); /** - * The related <code>DOMError.type</code> dependent data if any. + * The related <code>DOMError.type</code> dependent data if any. */ public Object getRelatedData(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMErrorHandler.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMErrorHandler.java index 3d4ad2aba58..7dcc9015256 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMErrorHandler.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMErrorHandler.java @@ -13,32 +13,32 @@ package org.w3c.dom; /** - * <code>DOMErrorHandler</code> is a callback interface that the DOM - * implementation can call when reporting errors that happens while - * processing XML data, or when doing some other processing (e.g. validating - * a document). A <code>DOMErrorHandler</code> object can be attached to a - * <code>Document</code> using the "error-handler" on the - * <code>DOMConfiguration</code> interface. If more than one error needs to - * be reported during an operation, the sequence and numbers of the errors - * passed to the error handler are implementation dependent. - * <p> The application that is using the DOM implementation is expected to - * implement this interface. + * <code>DOMErrorHandler</code> is a callback interface that the DOM + * implementation can call when reporting errors that happens while + * processing XML data, or when doing some other processing (e.g. validating + * a document). A <code>DOMErrorHandler</code> object can be attached to a + * <code>Document</code> using the "error-handler" on the + * <code>DOMConfiguration</code> interface. If more than one error needs to + * be reported during an operation, the sequence and numbers of the errors + * passed to the error handler are implementation dependent. + * <p> The application that is using the DOM implementation is expected to + * implement this interface. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface DOMErrorHandler { /** * This method is called on the error handler when an error occurs. - * <br> If an exception is thrown from this method, it is considered to be - * equivalent of returning <code>true</code>. - * @param error The error object that describes the error. This object - * may be reused by the DOM implementation across multiple calls to - * the <code>handleError</code> method. - * @return If the <code>handleError</code> method returns - * <code>false</code>, the DOM implementation should stop the current - * processing when possible. If the method returns <code>true</code>, - * the processing may continue depending on - * <code>DOMError.severity</code>. + * <br> If an exception is thrown from this method, it is considered to be + * equivalent of returning <code>true</code>. + * @param error The error object that describes the error. This object + * may be reused by the DOM implementation across multiple calls to + * the <code>handleError</code> method. + * @return If the <code>handleError</code> method returns + * <code>false</code>, the DOM implementation should stop the current + * processing when possible. If the method returns <code>true</code>, + * the processing may continue depending on + * <code>DOMError.severity</code>. */ public boolean handleError(DOMError error); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMException.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMException.java index 0b2578f92f6..23c70c400de 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMException.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMException.java @@ -13,20 +13,20 @@ package org.w3c.dom; /** - * DOM operations only raise exceptions in "exceptional" circumstances, i.e., - * when an operation is impossible to perform (either for logical reasons, - * because data is lost, or because the implementation has become unstable). - * In general, DOM methods return specific error values in ordinary - * processing situations, such as out-of-bound errors when using + * DOM operations only raise exceptions in "exceptional" circumstances, i.e., + * when an operation is impossible to perform (either for logical reasons, + * because data is lost, or because the implementation has become unstable). + * In general, DOM methods return specific error values in ordinary + * processing situations, such as out-of-bound errors when using * <code>NodeList</code>. - * <p>Implementations should raise other exceptions under other circumstances. - * For example, implementations should raise an implementation-dependent + * <p>Implementations should raise other exceptions under other circumstances. + * For example, implementations should raise an implementation-dependent * exception if a <code>null</code> argument is passed when <code>null</code> * was not expected. - * <p>Some languages and object systems do not support the concept of - * exceptions. For such systems, error conditions may be indicated using - * native error reporting mechanisms. For some bindings, for example, - * methods may return error codes similar to those listed in the + * <p>Some languages and object systems do not support the concept of + * exceptions. For such systems, error conditions may be indicated using + * native error reporting mechanisms. For some bindings, for example, + * methods may return error codes similar to those listed in the * corresponding method descriptions. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ @@ -42,7 +42,7 @@ public class DOMException extends RuntimeException { */ public static final short INDEX_SIZE_ERR = 1; /** - * If the specified range of text does not fit into a + * If the specified range of text does not fit into a * <code>DOMString</code>. */ public static final short DOMSTRING_SIZE_ERR = 2; @@ -51,7 +51,7 @@ public class DOMException extends RuntimeException { */ public static final short HIERARCHY_REQUEST_ERR = 3; /** - * If a <code>Node</code> is used in a different document than the one + * If a <code>Node</code> is used in a different document than the one * that created it (that doesn't support it). */ public static final short WRONG_DOCUMENT_ERR = 4; @@ -60,32 +60,32 @@ public class DOMException extends RuntimeException { */ public static final short INVALID_CHARACTER_ERR = 5; /** - * If data is specified for a <code>Node</code> which does not support + * If data is specified for a <code>Node</code> which does not support * data. */ public static final short NO_DATA_ALLOWED_ERR = 6; /** - * If an attempt is made to modify an object where modifications are not + * If an attempt is made to modify an object where modifications are not * allowed. */ public static final short NO_MODIFICATION_ALLOWED_ERR = 7; /** - * If an attempt is made to reference a <code>Node</code> in a context + * If an attempt is made to reference a <code>Node</code> in a context * where it does not exist. */ public static final short NOT_FOUND_ERR = 8; /** - * If the implementation does not support the requested type of object or + * If the implementation does not support the requested type of object or * operation. */ public static final short NOT_SUPPORTED_ERR = 9; /** - * If an attempt is made to add an attribute that is already in use + * If an attempt is made to add an attribute that is already in use * elsewhere. */ public static final short INUSE_ATTRIBUTE_ERR = 10; /** - * If an attempt is made to use an object that is not, or is no longer, + * If an attempt is made to use an object that is not, or is no longer, * usable. * @since DOM Level 2 */ @@ -101,29 +101,29 @@ public class DOMException extends RuntimeException { */ public static final short INVALID_MODIFICATION_ERR = 13; /** - * If an attempt is made to create or change an object in a way which is + * If an attempt is made to create or change an object in a way which is * incorrect with regard to namespaces. * @since DOM Level 2 */ public static final short NAMESPACE_ERR = 14; /** - * If a parameter or an operation is not supported by the underlying + * If a parameter or an operation is not supported by the underlying * object. * @since DOM Level 2 */ public static final short INVALID_ACCESS_ERR = 15; /** - * If a call to a method such as <code>insertBefore</code> or - * <code>removeChild</code> would make the <code>Node</code> invalid - * with respect to "partial validity", this exception would be raised + * If a call to a method such as <code>insertBefore</code> or + * <code>removeChild</code> would make the <code>Node</code> invalid + * with respect to "partial validity", this exception would be raised * and the operation would not be done. This code is used in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Val-20040127/'>DOM Level 3 Validation</a>] * . Refer to this specification for further information. * @since DOM Level 3 */ public static final short VALIDATION_ERR = 16; /** - * If the type of an object is incompatible with the expected type of the - * parameter associated to the object. + * If the type of an object is incompatible with the expected type of the + * parameter associated to the object. * @since DOM Level 3 */ public static final short TYPE_MISMATCH_ERR = 17; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementation.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementation.java index 5bb71e263a9..9b07574333b 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementation.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementation.java @@ -13,124 +13,124 @@ package org.w3c.dom; /** - * The <code>DOMImplementation</code> interface provides a number of methods - * for performing operations that are independent of any particular instance + * The <code>DOMImplementation</code> interface provides a number of methods + * for performing operations that are independent of any particular instance * of the document object model. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface DOMImplementation { /** - * Test if the DOM implementation implements a specific feature and + * Test if the DOM implementation implements a specific feature and * version, as specified in . - * @param feature The name of the feature to test. - * @param version This is the version number of the feature to test. - * @return <code>true</code> if the feature is implemented in the + * @param feature The name of the feature to test. + * @param version This is the version number of the feature to test. + * @return <code>true</code> if the feature is implemented in the * specified version, <code>false</code> otherwise. */ - public boolean hasFeature(String feature, + public boolean hasFeature(String feature, String version); /** - * Creates an empty <code>DocumentType</code> node. Entity declarations - * and notations are not made available. Entity reference expansions and + * Creates an empty <code>DocumentType</code> node. Entity declarations + * and notations are not made available. Entity reference expansions and * default attribute additions do not occur.. - * @param qualifiedName The qualified name of the document type to be + * @param qualifiedName The qualified name of the document type to be * created. * @param publicId The external subset public identifier. * @param systemId The external subset system identifier. - * @return A new <code>DocumentType</code> node with + * @return A new <code>DocumentType</code> node with * <code>Node.ownerDocument</code> set to <code>null</code>. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not + * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not * an XML name according to [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is * malformed. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature "XML" and the language exposed through the - * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature "XML" and the language exposed through the + * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public DocumentType createDocumentType(String qualifiedName, - String publicId, + public DocumentType createDocumentType(String qualifiedName, + String publicId, String systemId) throws DOMException; /** - * Creates a DOM Document object of the specified type with its document + * Creates a DOM Document object of the specified type with its document * element. - * <br>Note that based on the <code>DocumentType</code> given to create - * the document, the implementation may instantiate specialized - * <code>Document</code> objects that support additional features than + * <br>Note that based on the <code>DocumentType</code> given to create + * the document, the implementation may instantiate specialized + * <code>Document</code> objects that support additional features than * the "Core", such as "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * . On the other hand, setting the <code>DocumentType</code> after the - * document was created makes this very unlikely to happen. - * Alternatively, specialized <code>Document</code> creation methods, + * . On the other hand, setting the <code>DocumentType</code> after the + * document was created makes this very unlikely to happen. + * Alternatively, specialized <code>Document</code> creation methods, * such as <code>createHTMLDocument</code> [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * , can be used to obtain specific types of <code>Document</code> + * , can be used to obtain specific types of <code>Document</code> * objects. - * @param namespaceURI The namespace URI of the document element to + * @param namespaceURI The namespace URI of the document element to * create or <code>null</code>. - * @param qualifiedName The qualified name of the document element to be + * @param qualifiedName The qualified name of the document element to be * created or <code>null</code>. * @param doctype The type of document to be created or <code>null</code>. - * When <code>doctype</code> is not <code>null</code>, its - * <code>Node.ownerDocument</code> attribute is set to the document + * When <code>doctype</code> is not <code>null</code>, its + * <code>Node.ownerDocument</code> attribute is set to the document * being created. - * @return A new <code>Document</code> object with its document element. - * If the <code>NamespaceURI</code>, <code>qualifiedName</code>, and - * <code>doctype</code> are <code>null</code>, the returned + * @return A new <code>Document</code> object with its document element. + * If the <code>NamespaceURI</code>, <code>qualifiedName</code>, and + * <code>doctype</code> are <code>null</code>, the returned * <code>Document</code> is empty with no document element. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not + * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not * an XML name according to [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is - * malformed, if the <code>qualifiedName</code> has a prefix and the - * <code>namespaceURI</code> is <code>null</code>, or if the - * <code>qualifiedName</code> is <code>null</code> and the - * <code>namespaceURI</code> is different from <code>null</code>, or - * if the <code>qualifiedName</code> has a prefix that is "xml" and + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is + * malformed, if the <code>qualifiedName</code> has a prefix and the + * <code>namespaceURI</code> is <code>null</code>, or if the + * <code>qualifiedName</code> is <code>null</code> and the + * <code>namespaceURI</code> is different from <code>null</code>, or + * if the <code>qualifiedName</code> has a prefix that is "xml" and * the <code>namespaceURI</code> is different from "<a href='http://www.w3.org/XML/1998/namespace'> * http://www.w3.org/XML/1998/namespace</a>" [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , or if the DOM implementation does not support the - * <code>"XML"</code> feature but a non-null namespace URI was + * , or if the DOM implementation does not support the + * <code>"XML"</code> feature but a non-null namespace URI was * provided, since namespaces were defined by XML. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already - * been used with a different document or was created from a different + * <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already + * been used with a different document or was created from a different * implementation. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature "XML" and the language exposed through the - * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature "XML" and the language exposed through the + * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public Document createDocument(String namespaceURI, - String qualifiedName, + public Document createDocument(String namespaceURI, + String qualifiedName, DocumentType doctype) throws DOMException; /** - * This method returns a specialized object which implements the - * specialized APIs of the specified feature and version, as specified - * in . The specialized object may also be obtained by using - * binding-specific casting methods but is not necessarily expected to, - * as discussed in . This method also allow the implementation to - * provide specialized objects which do not support the - * <code>DOMImplementation</code> interface. - * @param feature The name of the feature requested. Note that any plus - * sign "+" prepended to the name of the feature will be ignored since - * it is not significant in the context of this method. - * @param version This is the version number of the feature to test. - * @return Returns an object which implements the specialized APIs of - * the specified feature and version, if any, or <code>null</code> if - * there is no object which implements interfaces associated with that - * feature. If the <code>DOMObject</code> returned by this method - * implements the <code>DOMImplementation</code> interface, it must - * delegate to the primary core <code>DOMImplementation</code> and not - * return results inconsistent with the primary core - * <code>DOMImplementation</code> such as <code>hasFeature</code>, - * <code>getFeature</code>, etc. + * This method returns a specialized object which implements the + * specialized APIs of the specified feature and version, as specified + * in . The specialized object may also be obtained by using + * binding-specific casting methods but is not necessarily expected to, + * as discussed in . This method also allow the implementation to + * provide specialized objects which do not support the + * <code>DOMImplementation</code> interface. + * @param feature The name of the feature requested. Note that any plus + * sign "+" prepended to the name of the feature will be ignored since + * it is not significant in the context of this method. + * @param version This is the version number of the feature to test. + * @return Returns an object which implements the specialized APIs of + * the specified feature and version, if any, or <code>null</code> if + * there is no object which implements interfaces associated with that + * feature. If the <code>DOMObject</code> returned by this method + * implements the <code>DOMImplementation</code> interface, it must + * delegate to the primary core <code>DOMImplementation</code> and not + * return results inconsistent with the primary core + * <code>DOMImplementation</code> such as <code>hasFeature</code>, + * <code>getFeature</code>, etc. * @since DOM Level 3 */ - public Object getFeature(String feature, + public Object getFeature(String feature, String version); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationList.java index 18349fdd411..877de6efea0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationList.java @@ -13,30 +13,30 @@ package org.w3c.dom; /** - * The <code>DOMImplementationList</code> interface provides the abstraction - * of an ordered collection of DOM implementations, without defining or - * constraining how this collection is implemented. The items in the - * <code>DOMImplementationList</code> are accessible via an integral index, - * starting from 0. + * The <code>DOMImplementationList</code> interface provides the abstraction + * of an ordered collection of DOM implementations, without defining or + * constraining how this collection is implemented. The items in the + * <code>DOMImplementationList</code> are accessible via an integral index, + * starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface DOMImplementationList { /** - * Returns the <code>index</code>th item in the collection. If - * <code>index</code> is greater than or equal to the number of - * <code>DOMImplementation</code>s in the list, this returns - * <code>null</code>. + * Returns the <code>index</code>th item in the collection. If + * <code>index</code> is greater than or equal to the number of + * <code>DOMImplementation</code>s in the list, this returns + * <code>null</code>. * @param index Index into the collection. * @return The <code>DOMImplementation</code> at the <code>index</code> - * th position in the <code>DOMImplementationList</code>, or - * <code>null</code> if that is not a valid index. + * th position in the <code>DOMImplementationList</code>, or + * <code>null</code> if that is not a valid index. */ public DOMImplementation item(int index); /** - * The number of <code>DOMImplementation</code>s in the list. The range - * of valid child node indices is 0 to <code>length-1</code> inclusive. + * The number of <code>DOMImplementation</code>s in the list. The range + * of valid child node indices is 0 to <code>length-1</code> inclusive. */ public int getLength(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationSource.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationSource.java index 3c32c188378..1c5c0b2feba 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationSource.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMImplementationSource.java @@ -13,44 +13,44 @@ package org.w3c.dom; /** - * This interface permits a DOM implementer to supply one or more - * implementations, based upon requested features and versions, as specified - * in . Each implemented <code>DOMImplementationSource</code> object is - * listed in the binding-specific list of available sources so that its + * This interface permits a DOM implementer to supply one or more + * implementations, based upon requested features and versions, as specified + * in . Each implemented <code>DOMImplementationSource</code> object is + * listed in the binding-specific list of available sources so that its * <code>DOMImplementation</code> objects are made available. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface DOMImplementationSource { /** - * A method to request the first DOM implementation that supports the - * specified features. - * @param features A string that specifies which features and versions - * are required. This is a space separated list in which each feature - * is specified by its name optionally followed by a space and a - * version number. This method returns the first item of the list - * returned by <code>getDOMImplementationList</code>. As an example, - * the string <code>"XML 3.0 Traversal +Events 2.0"</code> will - * request a DOM implementation that supports the module "XML" for its - * 3.0 version, a module that support of the "Traversal" module for - * any version, and the module "Events" for its 2.0 version. The - * module "Events" must be accessible using the method - * <code>Node.getFeature()</code> and - * <code>DOMImplementation.getFeature()</code>. - * @return The first DOM implementation that support the desired + * A method to request the first DOM implementation that supports the + * specified features. + * @param features A string that specifies which features and versions + * are required. This is a space separated list in which each feature + * is specified by its name optionally followed by a space and a + * version number. This method returns the first item of the list + * returned by <code>getDOMImplementationList</code>. As an example, + * the string <code>"XML 3.0 Traversal +Events 2.0"</code> will + * request a DOM implementation that supports the module "XML" for its + * 3.0 version, a module that support of the "Traversal" module for + * any version, and the module "Events" for its 2.0 version. The + * module "Events" must be accessible using the method + * <code>Node.getFeature()</code> and + * <code>DOMImplementation.getFeature()</code>. + * @return The first DOM implementation that support the desired * features, or <code>null</code> if this source has none. */ public DOMImplementation getDOMImplementation(String features); /** - * A method to request a list of DOM implementations that support the + * A method to request a list of DOM implementations that support the * specified features and versions, as specified in . - * @param features A string that specifies which features and versions - * are required. This is a space separated list in which each feature - * is specified by its name optionally followed by a space and a - * version number. This is something like: "XML 3.0 Traversal +Events + * @param features A string that specifies which features and versions + * are required. This is a space separated list in which each feature + * is specified by its name optionally followed by a space and a + * version number. This is something like: "XML 3.0 Traversal +Events * 2.0" - * @return A list of DOM implementations that support the desired + * @return A list of DOM implementations that support the desired * features. */ public DOMImplementationList getDOMImplementationList(String features); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMLocator.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMLocator.java index fcaaa23de87..50cd7d24060 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMLocator.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMLocator.java @@ -13,44 +13,44 @@ package org.w3c.dom; /** - * <code>DOMLocator</code> is an interface that describes a location (e.g. + * <code>DOMLocator</code> is an interface that describes a location (e.g. * where an error occurred). * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface DOMLocator { /** - * The line number this locator is pointing to, or <code>-1</code> if + * The line number this locator is pointing to, or <code>-1</code> if * there is no column number available. */ public int getLineNumber(); /** - * The column number this locator is pointing to, or <code>-1</code> if + * The column number this locator is pointing to, or <code>-1</code> if * there is no column number available. */ public int getColumnNumber(); /** - * The byte offset into the input source this locator is pointing to or + * The byte offset into the input source this locator is pointing to or * <code>-1</code> if there is no byte offset available. */ public int getByteOffset(); /** - * The UTF-16, as defined in [Unicode] and Amendment 1 of [ISO/IEC 10646], offset into the input source this locator is pointing to or + * The UTF-16, as defined in [Unicode] and Amendment 1 of [ISO/IEC 10646], offset into the input source this locator is pointing to or * <code>-1</code> if there is no UTF-16 offset available. */ public int getUtf16Offset(); /** - * The node this locator is pointing to, or <code>null</code> if no node + * The node this locator is pointing to, or <code>null</code> if no node * is available. */ public Node getRelatedNode(); /** - * The URI this locator is pointing to, or <code>null</code> if no URI is + * The URI this locator is pointing to, or <code>null</code> if no URI is * available. */ public String getUri(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMStringList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMStringList.java index e6c348ae8c4..53a40964e1d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMStringList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DOMStringList.java @@ -13,37 +13,37 @@ package org.w3c.dom; /** - * The <code>DOMStringList</code> interface provides the abstraction of an - * ordered collection of <code>DOMString</code> values, without defining or - * constraining how this collection is implemented. The items in the - * <code>DOMStringList</code> are accessible via an integral index, starting - * from 0. + * The <code>DOMStringList</code> interface provides the abstraction of an + * ordered collection of <code>DOMString</code> values, without defining or + * constraining how this collection is implemented. The items in the + * <code>DOMStringList</code> are accessible via an integral index, starting + * from 0. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface DOMStringList { /** - * Returns the <code>index</code>th item in the collection. If - * <code>index</code> is greater than or equal to the number of - * <code>DOMString</code>s in the list, this returns <code>null</code>. + * Returns the <code>index</code>th item in the collection. If + * <code>index</code> is greater than or equal to the number of + * <code>DOMString</code>s in the list, this returns <code>null</code>. * @param index Index into the collection. - * @return The <code>DOMString</code> at the <code>index</code>th - * position in the <code>DOMStringList</code>, or <code>null</code> if - * that is not a valid index. + * @return The <code>DOMString</code> at the <code>index</code>th + * position in the <code>DOMStringList</code>, or <code>null</code> if + * that is not a valid index. */ public String item(int index); /** - * The number of <code>DOMString</code>s in the list. The range of valid + * The number of <code>DOMString</code>s in the list. The range of valid * child node indices is 0 to <code>length-1</code> inclusive. */ public int getLength(); /** - * Test if a string is part of this <code>DOMStringList</code>. - * @param str The string to look for. - * @return <code>true</code> if the string has been found, - * <code>false</code> otherwise. + * Test if a string is part of this <code>DOMStringList</code>. + * @param str The string to look for. + * @return <code>true</code> if the string has been found, + * <code>false</code> otherwise. */ public boolean contains(String str); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Document.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Document.java index 43ebd4ec420..3193fa260fe 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Document.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Document.java @@ -13,73 +13,73 @@ package org.w3c.dom; /** - * The <code>Document</code> interface represents the entire HTML or XML - * document. Conceptually, it is the root of the document tree, and provides + * The <code>Document</code> interface represents the entire HTML or XML + * document. Conceptually, it is the root of the document tree, and provides * the primary access to the document's data. - * <p>Since elements, text nodes, comments, processing instructions, etc. - * cannot exist outside the context of a <code>Document</code>, the - * <code>Document</code> interface also contains the factory methods needed - * to create these objects. The <code>Node</code> objects created have a - * <code>ownerDocument</code> attribute which associates them with the + * <p>Since elements, text nodes, comments, processing instructions, etc. + * cannot exist outside the context of a <code>Document</code>, the + * <code>Document</code> interface also contains the factory methods needed + * to create these objects. The <code>Node</code> objects created have a + * <code>ownerDocument</code> attribute which associates them with the * <code>Document</code> within whose context they were created. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Document extends Node { /** - * The Document Type Declaration (see <code>DocumentType</code>) - * associated with this document. For XML documents without a document - * type declaration this returns <code>null</code>. For HTML documents, - * a <code>DocumentType</code> object may be returned, independently of - * the presence or absence of document type declaration in the HTML + * The Document Type Declaration (see <code>DocumentType</code>) + * associated with this document. For XML documents without a document + * type declaration this returns <code>null</code>. For HTML documents, + * a <code>DocumentType</code> object may be returned, independently of + * the presence or absence of document type declaration in the HTML * document. - * <br>This provides direct access to the <code>DocumentType</code> node, - * child node of this <code>Document</code>. This node can be set at - * document creation time and later changed through the use of child - * nodes manipulation methods, such as <code>Node.insertBefore</code>, - * or <code>Node.replaceChild</code>. Note, however, that while some - * implementations may instantiate different types of - * <code>Document</code> objects supporting additional features than the + * <br>This provides direct access to the <code>DocumentType</code> node, + * child node of this <code>Document</code>. This node can be set at + * document creation time and later changed through the use of child + * nodes manipulation methods, such as <code>Node.insertBefore</code>, + * or <code>Node.replaceChild</code>. Note, however, that while some + * implementations may instantiate different types of + * <code>Document</code> objects supporting additional features than the * "Core", such as "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * , based on the <code>DocumentType</code> specified at creation time, - * changing it afterwards is very unlikely to result in a change of the + * , based on the <code>DocumentType</code> specified at creation time, + * changing it afterwards is very unlikely to result in a change of the * features supported. * @version DOM Level 3 */ public DocumentType getDoctype(); /** - * The <code>DOMImplementation</code> object that handles this document. A + * The <code>DOMImplementation</code> object that handles this document. A * DOM application may use objects from multiple implementations. */ public DOMImplementation getImplementation(); /** - * This is a convenience attribute that allows direct access to the child + * This is a convenience attribute that allows direct access to the child * node that is the document element of the document. */ public Element getDocumentElement(); /** - * Creates an element of the type specified. Note that the instance - * returned implements the <code>Element</code> interface, so attributes + * Creates an element of the type specified. Note that the instance + * returned implements the <code>Element</code> interface, so attributes * can be specified directly on the returned object. - * <br>In addition, if there are known attributes with default values, - * <code>Attr</code> nodes representing them are automatically created + * <br>In addition, if there are known attributes with default values, + * <code>Attr</code> nodes representing them are automatically created * and attached to the element. - * <br>To create an element with a qualified name and namespace URI, use + * <br>To create an element with a qualified name and namespace URI, use * the <code>createElementNS</code> method. - * @param tagName The name of the element type to instantiate. For XML, - * this is case-sensitive, otherwise it depends on the - * case-sensitivity of the markup language in use. In that case, the - * name is mapped to the canonical form of that markup by the DOM + * @param tagName The name of the element type to instantiate. For XML, + * this is case-sensitive, otherwise it depends on the + * case-sensitivity of the markup language in use. In that case, the + * name is mapped to the canonical form of that markup by the DOM * implementation. - * @return A new <code>Element</code> object with the - * <code>nodeName</code> attribute set to <code>tagName</code>, and - * <code>localName</code>, <code>prefix</code>, and + * @return A new <code>Element</code> object with the + * <code>nodeName</code> attribute set to <code>tagName</code>, and + * <code>localName</code>, <code>prefix</code>, and * <code>namespaceURI</code> set to <code>null</code>. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML - * name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML + * name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. */ public Element createElement(String tagName) @@ -106,7 +106,7 @@ public interface Document extends Node { public Comment createComment(String data); /** - * Creates a <code>CDATASection</code> node whose value is the specified + * Creates a <code>CDATASection</code> node whose value is the specified * string. * @param data The data for the <code>CDATASection</code> contents. * @return The new <code>CDATASection</code> object. @@ -117,68 +117,68 @@ public interface Document extends Node { throws DOMException; /** - * Creates a <code>ProcessingInstruction</code> node given the specified + * Creates a <code>ProcessingInstruction</code> node given the specified * name and data strings. - * @param target The target part of the processing instruction.Unlike - * <code>Document.createElementNS</code> or - * <code>Document.createAttributeNS</code>, no namespace well-formed - * checking is done on the target name. Applications should invoke + * @param target The target part of the processing instruction.Unlike + * <code>Document.createElementNS</code> or + * <code>Document.createAttributeNS</code>, no namespace well-formed + * checking is done on the target name. Applications should invoke * <code>Document.normalizeDocument()</code> with the parameter " - * namespaces" set to <code>true</code> in order to ensure that the - * target name is namespace well-formed. + * namespaces" set to <code>true</code> in order to ensure that the + * target name is namespace well-formed. * @param data The data for the node. * @return The new <code>ProcessingInstruction</code> object. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified target is not an XML - * name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified target is not an XML + * name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. * <br>NOT_SUPPORTED_ERR: Raised if this document is an HTML document. */ - public ProcessingInstruction createProcessingInstruction(String target, + public ProcessingInstruction createProcessingInstruction(String target, String data) throws DOMException; /** - * Creates an <code>Attr</code> of the given name. Note that the - * <code>Attr</code> instance can then be set on an <code>Element</code> - * using the <code>setAttributeNode</code> method. - * <br>To create an attribute with a qualified name and namespace URI, use + * Creates an <code>Attr</code> of the given name. Note that the + * <code>Attr</code> instance can then be set on an <code>Element</code> + * using the <code>setAttributeNode</code> method. + * <br>To create an attribute with a qualified name and namespace URI, use * the <code>createAttributeNS</code> method. * @param name The name of the attribute. - * @return A new <code>Attr</code> object with the <code>nodeName</code> - * attribute set to <code>name</code>, and <code>localName</code>, - * <code>prefix</code>, and <code>namespaceURI</code> set to + * @return A new <code>Attr</code> object with the <code>nodeName</code> + * attribute set to <code>name</code>, and <code>localName</code>, + * <code>prefix</code>, and <code>namespaceURI</code> set to * <code>null</code>. The value of the attribute is the empty string. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML - * name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML + * name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. */ public Attr createAttribute(String name) throws DOMException; /** - * Creates an <code>EntityReference</code> object. In addition, if the - * referenced entity is known, the child list of the - * <code>EntityReference</code> node is made the same as that of the + * Creates an <code>EntityReference</code> object. In addition, if the + * referenced entity is known, the child list of the + * <code>EntityReference</code> node is made the same as that of the * corresponding <code>Entity</code> node. - * <p ><b>Note:</b> If any descendant of the <code>Entity</code> node has - * an unbound namespace prefix, the corresponding descendant of the - * created <code>EntityReference</code> node is also unbound; (its - * <code>namespaceURI</code> is <code>null</code>). The DOM Level 2 and - * 3 do not support any mechanism to resolve namespace prefixes in this + * <p ><b>Note:</b> If any descendant of the <code>Entity</code> node has + * an unbound namespace prefix, the corresponding descendant of the + * created <code>EntityReference</code> node is also unbound; (its + * <code>namespaceURI</code> is <code>null</code>). The DOM Level 2 and + * 3 do not support any mechanism to resolve namespace prefixes in this * case. - * @param name The name of the entity to reference.Unlike - * <code>Document.createElementNS</code> or - * <code>Document.createAttributeNS</code>, no namespace well-formed - * checking is done on the entity name. Applications should invoke + * @param name The name of the entity to reference.Unlike + * <code>Document.createElementNS</code> or + * <code>Document.createAttributeNS</code>, no namespace well-formed + * checking is done on the entity name. Applications should invoke * <code>Document.normalizeDocument()</code> with the parameter " - * namespaces" set to <code>true</code> in order to ensure that the - * entity name is namespace well-formed. + * namespaces" set to <code>true</code> in order to ensure that the + * entity name is namespace well-formed. * @return The new <code>EntityReference</code> object. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML - * name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML + * name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. * <br>NOT_SUPPORTED_ERR: Raised if this document is an HTML document. */ @@ -186,142 +186,142 @@ public interface Document extends Node { throws DOMException; /** - * Returns a <code>NodeList</code> of all the <code>Elements</code> in - * document order with a given tag name and are contained in the + * Returns a <code>NodeList</code> of all the <code>Elements</code> in + * document order with a given tag name and are contained in the * document. - * @param tagname The name of the tag to match on. The special value "*" - * matches all tags. For XML, the <code>tagname</code> parameter is - * case-sensitive, otherwise it depends on the case-sensitivity of the - * markup language in use. - * @return A new <code>NodeList</code> object containing all the matched + * @param tagname The name of the tag to match on. The special value "*" + * matches all tags. For XML, the <code>tagname</code> parameter is + * case-sensitive, otherwise it depends on the case-sensitivity of the + * markup language in use. + * @return A new <code>NodeList</code> object containing all the matched * <code>Elements</code>. */ public NodeList getElementsByTagName(String tagname); /** - * Imports a node from another document to this document, without altering - * or removing the source node from the original document; this method - * creates a new copy of the source node. The returned node has no + * Imports a node from another document to this document, without altering + * or removing the source node from the original document; this method + * creates a new copy of the source node. The returned node has no * parent; (<code>parentNode</code> is <code>null</code>). - * <br>For all nodes, importing a node creates a node object owned by the - * importing document, with attribute values identical to the source - * node's <code>nodeName</code> and <code>nodeType</code>, plus the - * attributes related to namespaces (<code>prefix</code>, - * <code>localName</code>, and <code>namespaceURI</code>). As in the - * <code>cloneNode</code> operation, the source node is not altered. - * User data associated to the imported node is not carried over. - * However, if any <code>UserDataHandlers</code> has been specified - * along with the associated data these handlers will be called with the + * <br>For all nodes, importing a node creates a node object owned by the + * importing document, with attribute values identical to the source + * node's <code>nodeName</code> and <code>nodeType</code>, plus the + * attributes related to namespaces (<code>prefix</code>, + * <code>localName</code>, and <code>namespaceURI</code>). As in the + * <code>cloneNode</code> operation, the source node is not altered. + * User data associated to the imported node is not carried over. + * However, if any <code>UserDataHandlers</code> has been specified + * along with the associated data these handlers will be called with the * appropriate parameters before this method returns. - * <br>Additional information is copied as appropriate to the - * <code>nodeType</code>, attempting to mirror the behavior expected if - * a fragment of XML or HTML source was copied from one document to - * another, recognizing that the two documents may have different DTDs - * in the XML case. The following list describes the specifics for each - * type of node. + * <br>Additional information is copied as appropriate to the + * <code>nodeType</code>, attempting to mirror the behavior expected if + * a fragment of XML or HTML source was copied from one document to + * another, recognizing that the two documents may have different DTDs + * in the XML case. The following list describes the specifics for each + * type of node. * <dl> * <dt>ATTRIBUTE_NODE</dt> - * <dd>The <code>ownerElement</code> attribute - * is set to <code>null</code> and the <code>specified</code> flag is - * set to <code>true</code> on the generated <code>Attr</code>. The - * descendants of the source <code>Attr</code> are recursively imported + * <dd>The <code>ownerElement</code> attribute + * is set to <code>null</code> and the <code>specified</code> flag is + * set to <code>true</code> on the generated <code>Attr</code>. The + * descendants of the source <code>Attr</code> are recursively imported * and the resulting nodes reassembled to form the corresponding subtree. - * Note that the <code>deep</code> parameter has no effect on - * <code>Attr</code> nodes; they always carry their children with them + * Note that the <code>deep</code> parameter has no effect on + * <code>Attr</code> nodes; they always carry their children with them * when imported.</dd> * <dt>DOCUMENT_FRAGMENT_NODE</dt> - * <dd>If the <code>deep</code> option - * was set to <code>true</code>, the descendants of the source - * <code>DocumentFragment</code> are recursively imported and the - * resulting nodes reassembled under the imported - * <code>DocumentFragment</code> to form the corresponding subtree. - * Otherwise, this simply generates an empty + * <dd>If the <code>deep</code> option + * was set to <code>true</code>, the descendants of the source + * <code>DocumentFragment</code> are recursively imported and the + * resulting nodes reassembled under the imported + * <code>DocumentFragment</code> to form the corresponding subtree. + * Otherwise, this simply generates an empty * <code>DocumentFragment</code>.</dd> * <dt>DOCUMENT_NODE</dt> - * <dd><code>Document</code> + * <dd><code>Document</code> * nodes cannot be imported.</dd> * <dt>DOCUMENT_TYPE_NODE</dt> - * <dd><code>DocumentType</code> + * <dd><code>DocumentType</code> * nodes cannot be imported.</dd> * <dt>ELEMENT_NODE</dt> - * <dd><em>Specified</em> attribute nodes of the source element are imported, and the generated - * <code>Attr</code> nodes are attached to the generated - * <code>Element</code>. Default attributes are <em>not</em> copied, though if the document being imported into defines default - * attributes for this element name, those are assigned. If the - * <code>importNode</code> <code>deep</code> parameter was set to - * <code>true</code>, the descendants of the source element are - * recursively imported and the resulting nodes reassembled to form the + * <dd><em>Specified</em> attribute nodes of the source element are imported, and the generated + * <code>Attr</code> nodes are attached to the generated + * <code>Element</code>. Default attributes are <em>not</em> copied, though if the document being imported into defines default + * attributes for this element name, those are assigned. If the + * <code>importNode</code> <code>deep</code> parameter was set to + * <code>true</code>, the descendants of the source element are + * recursively imported and the resulting nodes reassembled to form the * corresponding subtree.</dd> * <dt>ENTITY_NODE</dt> - * <dd><code>Entity</code> nodes can be - * imported, however in the current release of the DOM the - * <code>DocumentType</code> is readonly. Ability to add these imported - * nodes to a <code>DocumentType</code> will be considered for addition - * to a future release of the DOM.On import, the <code>publicId</code>, - * <code>systemId</code>, and <code>notationName</code> attributes are - * copied. If a <code>deep</code> import is requested, the descendants - * of the the source <code>Entity</code> are recursively imported and + * <dd><code>Entity</code> nodes can be + * imported, however in the current release of the DOM the + * <code>DocumentType</code> is readonly. Ability to add these imported + * nodes to a <code>DocumentType</code> will be considered for addition + * to a future release of the DOM.On import, the <code>publicId</code>, + * <code>systemId</code>, and <code>notationName</code> attributes are + * copied. If a <code>deep</code> import is requested, the descendants + * of the the source <code>Entity</code> are recursively imported and * the resulting nodes reassembled to form the corresponding subtree.</dd> * <dt> * ENTITY_REFERENCE_NODE</dt> - * <dd>Only the <code>EntityReference</code> itself is - * copied, even if a <code>deep</code> import is requested, since the - * source and destination documents might have defined the entity - * differently. If the document being imported into provides a + * <dd>Only the <code>EntityReference</code> itself is + * copied, even if a <code>deep</code> import is requested, since the + * source and destination documents might have defined the entity + * differently. If the document being imported into provides a * definition for this entity name, its value is assigned.</dd> * <dt>NOTATION_NODE</dt> * <dd> - * <code>Notation</code> nodes can be imported, however in the current - * release of the DOM the <code>DocumentType</code> is readonly. Ability - * to add these imported nodes to a <code>DocumentType</code> will be - * considered for addition to a future release of the DOM.On import, the + * <code>Notation</code> nodes can be imported, however in the current + * release of the DOM the <code>DocumentType</code> is readonly. Ability + * to add these imported nodes to a <code>DocumentType</code> will be + * considered for addition to a future release of the DOM.On import, the * <code>publicId</code> and <code>systemId</code> attributes are copied. - * Note that the <code>deep</code> parameter has no effect on this type + * Note that the <code>deep</code> parameter has no effect on this type * of nodes since they cannot have any children.</dd> * <dt> * PROCESSING_INSTRUCTION_NODE</dt> - * <dd>The imported node copies its - * <code>target</code> and <code>data</code> values from those of the - * source node.Note that the <code>deep</code> parameter has no effect + * <dd>The imported node copies its + * <code>target</code> and <code>data</code> values from those of the + * source node.Note that the <code>deep</code> parameter has no effect * on this type of nodes since they cannot have any children.</dd> - * <dt>TEXT_NODE, + * <dt>TEXT_NODE, * CDATA_SECTION_NODE, COMMENT_NODE</dt> - * <dd>These three types of nodes inheriting - * from <code>CharacterData</code> copy their <code>data</code> and - * <code>length</code> attributes from those of the source node.Note - * that the <code>deep</code> parameter has no effect on these types of + * <dd>These three types of nodes inheriting + * from <code>CharacterData</code> copy their <code>data</code> and + * <code>length</code> attributes from those of the source node.Note + * that the <code>deep</code> parameter has no effect on these types of * nodes since they cannot have any children.</dd> - * </dl> + * </dl> * @param importedNode The node to import. - * @param deep If <code>true</code>, recursively import the subtree under - * the specified node; if <code>false</code>, import only the node - * itself, as explained above. This has no effect on nodes that cannot - * have any children, and on <code>Attr</code>, and + * @param deep If <code>true</code>, recursively import the subtree under + * the specified node; if <code>false</code>, import only the node + * itself, as explained above. This has no effect on nodes that cannot + * have any children, and on <code>Attr</code>, and * <code>EntityReference</code> nodes. * @return The imported node that belongs to this <code>Document</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the type of node being imported is not + * NOT_SUPPORTED_ERR: Raised if the type of node being imported is not * supported. - * <br>INVALID_CHARACTER_ERR: Raised if one of the imported names is not - * an XML name according to the XML version in use specified in the - * <code>Document.xmlVersion</code> attribute. This may happen when - * importing an XML 1.1 [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] element + * <br>INVALID_CHARACTER_ERR: Raised if one of the imported names is not + * an XML name according to the XML version in use specified in the + * <code>Document.xmlVersion</code> attribute. This may happen when + * importing an XML 1.1 [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] element * into an XML 1.0 document, for instance. * @since DOM Level 2 */ - public Node importNode(Node importedNode, + public Node importNode(Node importedNode, boolean deep) throws DOMException; /** * Creates an element of the given qualified name and namespace URI. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the + * , applications must use the value <code>null</code> as the * namespaceURI parameter for methods if they wish to have no namespace. * @param namespaceURI The namespace URI of the element to create. - * @param qualifiedName The qualified name of the element type to + * @param qualifiedName The qualified name of the element type to * instantiate. - * @return A new <code>Element</code> object with the following + * @return A new <code>Element</code> object with the following * attributes: * <table border='1' cellpadding='3'> * <tr> @@ -340,13 +340,13 @@ public interface Document extends Node { * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>Node.prefix</code></td> - * <td valign='top' rowspan='1' colspan='1'>prefix, extracted - * from <code>qualifiedName</code>, or <code>null</code> if there is + * <td valign='top' rowspan='1' colspan='1'>prefix, extracted + * from <code>qualifiedName</code>, or <code>null</code> if there is * no prefix</td> * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td> - * <td valign='top' rowspan='1' colspan='1'>local name, extracted from + * <td valign='top' rowspan='1' colspan='1'>local name, extracted from * <code>qualifiedName</code></td> * </tr> * <tr> @@ -356,35 +356,35 @@ public interface Document extends Node { * </tr> * </table> * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified - * <code>qualifiedName</code> is not an XML name according to the XML - * version in use specified in the <code>Document.xmlVersion</code> + * INVALID_CHARACTER_ERR: Raised if the specified + * <code>qualifiedName</code> is not an XML name according to the XML + * version in use specified in the <code>Document.xmlVersion</code> * attribute. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a - * malformed qualified name, if the <code>qualifiedName</code> has a - * prefix and the <code>namespaceURI</code> is <code>null</code>, or - * if the <code>qualifiedName</code> has a prefix that is "xml" and + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a + * malformed qualified name, if the <code>qualifiedName</code> has a + * prefix and the <code>namespaceURI</code> is <code>null</code>, or + * if the <code>qualifiedName</code> has a prefix that is "xml" and * the <code>namespaceURI</code> is different from "<a href='http://www.w3.org/XML/1998/namespace'> * http://www.w3.org/XML/1998/namespace</a>" [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , or if the <code>qualifiedName</code> or its prefix is "xmlns" and + * , or if the <code>qualifiedName</code> or its prefix is "xmlns" and * the <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if the <code>namespaceURI</code> is "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>" and neither the <code>qualifiedName</code> nor its prefix is "xmlns". - * <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the <code>"XML"</code> feature, since namespaces were + * <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the <code>"XML"</code> feature, since namespaces were * defined by XML. * @since DOM Level 2 */ - public Element createElementNS(String namespaceURI, + public Element createElementNS(String namespaceURI, String qualifiedName) throws DOMException; /** * Creates an attribute of the given qualified name and namespace URI. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param namespaceURI The namespace URI of the attribute to create. - * @param qualifiedName The qualified name of the attribute to + * @param qualifiedName The qualified name of the attribute to * instantiate. * @return A new <code>Attr</code> object with the following attributes: * <table border='1' cellpadding='3'> @@ -405,13 +405,13 @@ public interface Document extends Node { * <tr> * <td valign='top' rowspan='1' colspan='1'> * <code>Node.prefix</code></td> - * <td valign='top' rowspan='1' colspan='1'>prefix, extracted from - * <code>qualifiedName</code>, or <code>null</code> if there is no + * <td valign='top' rowspan='1' colspan='1'>prefix, extracted from + * <code>qualifiedName</code>, or <code>null</code> if there is no * prefix</td> * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td> - * <td valign='top' rowspan='1' colspan='1'>local name, extracted from + * <td valign='top' rowspan='1' colspan='1'>local name, extracted from * <code>qualifiedName</code></td> * </tr> * <tr> @@ -421,53 +421,53 @@ public interface Document extends Node { * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>Node.nodeValue</code></td> - * <td valign='top' rowspan='1' colspan='1'>the empty + * <td valign='top' rowspan='1' colspan='1'>the empty * string</td> * </tr> * </table> * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified - * <code>qualifiedName</code> is not an XML name according to the XML - * version in use specified in the <code>Document.xmlVersion</code> + * INVALID_CHARACTER_ERR: Raised if the specified + * <code>qualifiedName</code> is not an XML name according to the XML + * version in use specified in the <code>Document.xmlVersion</code> * attribute. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a - * malformed qualified name, if the <code>qualifiedName</code> has a - * prefix and the <code>namespaceURI</code> is <code>null</code>, if - * the <code>qualifiedName</code> has a prefix that is "xml" and the + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a + * malformed qualified name, if the <code>qualifiedName</code> has a + * prefix and the <code>namespaceURI</code> is <code>null</code>, if + * the <code>qualifiedName</code> has a prefix that is "xml" and the * <code>namespaceURI</code> is different from "<a href='http://www.w3.org/XML/1998/namespace'> - * http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the + * http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the * <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if the <code>namespaceURI</code> is "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>" and neither the <code>qualifiedName</code> nor its prefix is "xmlns". - * <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the <code>"XML"</code> feature, since namespaces were + * <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the <code>"XML"</code> feature, since namespaces were * defined by XML. * @since DOM Level 2 */ - public Attr createAttributeNS(String namespaceURI, + public Attr createAttributeNS(String namespaceURI, String qualifiedName) throws DOMException; /** - * Returns a <code>NodeList</code> of all the <code>Elements</code> with a + * Returns a <code>NodeList</code> of all the <code>Elements</code> with a * given local name and namespace URI in document order. - * @param namespaceURI The namespace URI of the elements to match on. The + * @param namespaceURI The namespace URI of the elements to match on. The * special value <code>"*"</code> matches all namespaces. - * @param localName The local name of the elements to match on. The + * @param localName The local name of the elements to match on. The * special value "*" matches all local names. - * @return A new <code>NodeList</code> object containing all the matched + * @return A new <code>NodeList</code> object containing all the matched * <code>Elements</code>. * @since DOM Level 2 */ - public NodeList getElementsByTagNameNS(String namespaceURI, + public NodeList getElementsByTagNameNS(String namespaceURI, String localName); /** - * Returns the <code>Element</code> that has an ID attribute with the + * Returns the <code>Element</code> that has an ID attribute with the * given value. If no such element exists, this returns <code>null</code> - * . If more than one element has an ID attribute with that value, what - * is returned is undefined. - * <br> The DOM implementation is expected to use the attribute - * <code>Attr.isId</code> to determine if an attribute is of type ID. - * <p ><b>Note:</b> Attributes with the name "ID" or "id" are not of type + * . If more than one element has an ID attribute with that value, what + * is returned is undefined. + * <br> The DOM implementation is expected to use the attribute + * <code>Attr.isId</code> to determine if an attribute is of type ID. + * <p ><b>Note:</b> Attributes with the name "ID" or "id" are not of type * ID unless so defined. * @param elementId The unique <code>id</code> value for an element. * @return The matching element or <code>null</code> if there is none. @@ -476,179 +476,179 @@ public interface Document extends Node { public Element getElementById(String elementId); /** - * An attribute specifying the encoding used for this document at the time - * of the parsing. This is <code>null</code> when it is not known, such + * An attribute specifying the encoding used for this document at the time + * of the parsing. This is <code>null</code> when it is not known, such * as when the <code>Document</code> was created in memory. * @since DOM Level 3 */ public String getInputEncoding(); /** - * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the encoding of this document. This is <code>null</code> when - * unspecified or when it is not known, such as when the + * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the encoding of this document. This is <code>null</code> when + * unspecified or when it is not known, such as when the * <code>Document</code> was created in memory. * @since DOM Level 3 */ public String getXmlEncoding(); /** - * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, whether this document is standalone. This is <code>false</code> when + * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, whether this document is standalone. This is <code>false</code> when * unspecified. - * <p ><b>Note:</b> No verification is done on the value when setting - * this attribute. Applications should use - * <code>Document.normalizeDocument()</code> with the "validate" - * parameter to verify if the value matches the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd'>validity - * constraint for standalone document declaration</a> as defined in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. + * <p ><b>Note:</b> No verification is done on the value when setting + * this attribute. Applications should use + * <code>Document.normalizeDocument()</code> with the "validate" + * parameter to verify if the value matches the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd'>validity + * constraint for standalone document declaration</a> as defined in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. * @since DOM Level 3 */ public boolean getXmlStandalone(); /** - * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, whether this document is standalone. This is <code>false</code> when + * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, whether this document is standalone. This is <code>false</code> when * unspecified. - * <p ><b>Note:</b> No verification is done on the value when setting - * this attribute. Applications should use - * <code>Document.normalizeDocument()</code> with the "validate" - * parameter to verify if the value matches the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd'>validity - * constraint for standalone document declaration</a> as defined in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. + * <p ><b>Note:</b> No verification is done on the value when setting + * this attribute. Applications should use + * <code>Document.normalizeDocument()</code> with the "validate" + * parameter to verify if the value matches the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd'>validity + * constraint for standalone document declaration</a> as defined in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if this document does not support the - * "XML" feature. + * NOT_SUPPORTED_ERR: Raised if this document does not support the + * "XML" feature. * @since DOM Level 3 */ public void setXmlStandalone(boolean xmlStandalone) throws DOMException; /** - * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the version number of this document. If there is no declaration and if - * this document supports the "XML" feature, the value is - * <code>"1.0"</code>. If this document does not support the "XML" - * feature, the value is always <code>null</code>. Changing this - * attribute will affect methods that check for invalid characters in - * XML names. Application should invoke - * <code>Document.normalizeDocument()</code> in order to check for - * invalid characters in the <code>Node</code>s that are already part of - * this <code>Document</code>. - * <br> DOM applications may use the - * <code>DOMImplementation.hasFeature(feature, version)</code> method - * with parameter values "XMLVersion" and "1.0" (respectively) to - * determine if an implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. DOM - * applications may use the same method with parameter values - * "XMLVersion" and "1.1" (respectively) to determine if an - * implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. In both - * cases, in order to support XML, an implementation must also support + * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the version number of this document. If there is no declaration and if + * this document supports the "XML" feature, the value is + * <code>"1.0"</code>. If this document does not support the "XML" + * feature, the value is always <code>null</code>. Changing this + * attribute will affect methods that check for invalid characters in + * XML names. Application should invoke + * <code>Document.normalizeDocument()</code> in order to check for + * invalid characters in the <code>Node</code>s that are already part of + * this <code>Document</code>. + * <br> DOM applications may use the + * <code>DOMImplementation.hasFeature(feature, version)</code> method + * with parameter values "XMLVersion" and "1.0" (respectively) to + * determine if an implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. DOM + * applications may use the same method with parameter values + * "XMLVersion" and "1.1" (respectively) to determine if an + * implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. In both + * cases, in order to support XML, an implementation must also support * the "XML" feature defined in this specification. <code>Document</code> - * objects supporting a version of the "XMLVersion" feature must not - * raise a <code>NOT_SUPPORTED_ERR</code> exception for the same version - * number when using <code>Document.xmlVersion</code>. + * objects supporting a version of the "XMLVersion" feature must not + * raise a <code>NOT_SUPPORTED_ERR</code> exception for the same version + * number when using <code>Document.xmlVersion</code>. * @since DOM Level 3 */ public String getXmlVersion(); /** - * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the version number of this document. If there is no declaration and if - * this document supports the "XML" feature, the value is - * <code>"1.0"</code>. If this document does not support the "XML" - * feature, the value is always <code>null</code>. Changing this - * attribute will affect methods that check for invalid characters in - * XML names. Application should invoke - * <code>Document.normalizeDocument()</code> in order to check for - * invalid characters in the <code>Node</code>s that are already part of - * this <code>Document</code>. - * <br> DOM applications may use the - * <code>DOMImplementation.hasFeature(feature, version)</code> method - * with parameter values "XMLVersion" and "1.0" (respectively) to - * determine if an implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. DOM - * applications may use the same method with parameter values - * "XMLVersion" and "1.1" (respectively) to determine if an - * implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. In both - * cases, in order to support XML, an implementation must also support + * An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the version number of this document. If there is no declaration and if + * this document supports the "XML" feature, the value is + * <code>"1.0"</code>. If this document does not support the "XML" + * feature, the value is always <code>null</code>. Changing this + * attribute will affect methods that check for invalid characters in + * XML names. Application should invoke + * <code>Document.normalizeDocument()</code> in order to check for + * invalid characters in the <code>Node</code>s that are already part of + * this <code>Document</code>. + * <br> DOM applications may use the + * <code>DOMImplementation.hasFeature(feature, version)</code> method + * with parameter values "XMLVersion" and "1.0" (respectively) to + * determine if an implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. DOM + * applications may use the same method with parameter values + * "XMLVersion" and "1.1" (respectively) to determine if an + * implementation supports [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. In both + * cases, in order to support XML, an implementation must also support * the "XML" feature defined in this specification. <code>Document</code> - * objects supporting a version of the "XMLVersion" feature must not - * raise a <code>NOT_SUPPORTED_ERR</code> exception for the same version - * number when using <code>Document.xmlVersion</code>. + * objects supporting a version of the "XMLVersion" feature must not + * raise a <code>NOT_SUPPORTED_ERR</code> exception for the same version + * number when using <code>Document.xmlVersion</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the version is set to a value that is - * not supported by this <code>Document</code> or if this document - * does not support the "XML" feature. + * NOT_SUPPORTED_ERR: Raised if the version is set to a value that is + * not supported by this <code>Document</code> or if this document + * does not support the "XML" feature. * @since DOM Level 3 */ public void setXmlVersion(String xmlVersion) throws DOMException; /** - * An attribute specifying whether error checking is enforced or not. When - * set to <code>false</code>, the implementation is free to not test - * every possible error case normally defined on DOM operations, and not - * raise any <code>DOMException</code> on DOM operations or report - * errors while using <code>Document.normalizeDocument()</code>. In case - * of error, the behavior is undefined. This attribute is + * An attribute specifying whether error checking is enforced or not. When + * set to <code>false</code>, the implementation is free to not test + * every possible error case normally defined on DOM operations, and not + * raise any <code>DOMException</code> on DOM operations or report + * errors while using <code>Document.normalizeDocument()</code>. In case + * of error, the behavior is undefined. This attribute is * <code>true</code> by default. * @since DOM Level 3 */ public boolean getStrictErrorChecking(); /** - * An attribute specifying whether error checking is enforced or not. When - * set to <code>false</code>, the implementation is free to not test - * every possible error case normally defined on DOM operations, and not - * raise any <code>DOMException</code> on DOM operations or report - * errors while using <code>Document.normalizeDocument()</code>. In case - * of error, the behavior is undefined. This attribute is + * An attribute specifying whether error checking is enforced or not. When + * set to <code>false</code>, the implementation is free to not test + * every possible error case normally defined on DOM operations, and not + * raise any <code>DOMException</code> on DOM operations or report + * errors while using <code>Document.normalizeDocument()</code>. In case + * of error, the behavior is undefined. This attribute is * <code>true</code> by default. * @since DOM Level 3 */ public void setStrictErrorChecking(boolean strictErrorChecking); /** - * The location of the document or <code>null</code> if undefined or if - * the <code>Document</code> was created using - * <code>DOMImplementation.createDocument</code>. No lexical checking is - * performed when setting this attribute; this could result in a + * The location of the document or <code>null</code> if undefined or if + * the <code>Document</code> was created using + * <code>DOMImplementation.createDocument</code>. No lexical checking is + * performed when setting this attribute; this could result in a * <code>null</code> value returned when using <code>Node.baseURI</code> - * . - * <br> Beware that when the <code>Document</code> supports the feature + * . + * <br> Beware that when the <code>Document</code> supports the feature * "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * , the href attribute of the HTML BASE element takes precedence over - * this attribute when computing <code>Node.baseURI</code>. + * , the href attribute of the HTML BASE element takes precedence over + * this attribute when computing <code>Node.baseURI</code>. * @since DOM Level 3 */ public String getDocumentURI(); /** - * The location of the document or <code>null</code> if undefined or if - * the <code>Document</code> was created using - * <code>DOMImplementation.createDocument</code>. No lexical checking is - * performed when setting this attribute; this could result in a + * The location of the document or <code>null</code> if undefined or if + * the <code>Document</code> was created using + * <code>DOMImplementation.createDocument</code>. No lexical checking is + * performed when setting this attribute; this could result in a * <code>null</code> value returned when using <code>Node.baseURI</code> - * . - * <br> Beware that when the <code>Document</code> supports the feature + * . + * <br> Beware that when the <code>Document</code> supports the feature * "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * , the href attribute of the HTML BASE element takes precedence over - * this attribute when computing <code>Node.baseURI</code>. + * , the href attribute of the HTML BASE element takes precedence over + * this attribute when computing <code>Node.baseURI</code>. * @since DOM Level 3 */ public void setDocumentURI(String documentURI); /** - * Attempts to adopt a node from another document to this document. If - * supported, it changes the <code>ownerDocument</code> of the source - * node, its children, as well as the attached attribute nodes if there - * are any. If the source node has a parent it is first removed from the - * child list of its parent. This effectively allows moving a subtree - * from one document to another (unlike <code>importNode()</code> which - * create a copy of the source node instead of moving it). When it - * fails, applications should use <code>Document.importNode()</code> - * instead. Note that if the adopted node is already part of this - * document (i.e. the source and target document are the same), this - * method still has the effect of removing the source node from the - * child list of its parent, if any. The following list describes the - * specifics for each type of node. + * Attempts to adopt a node from another document to this document. If + * supported, it changes the <code>ownerDocument</code> of the source + * node, its children, as well as the attached attribute nodes if there + * are any. If the source node has a parent it is first removed from the + * child list of its parent. This effectively allows moving a subtree + * from one document to another (unlike <code>importNode()</code> which + * create a copy of the source node instead of moving it). When it + * fails, applications should use <code>Document.importNode()</code> + * instead. Note that if the adopted node is already part of this + * document (i.e. the source and target document are the same), this + * method still has the effect of removing the source node from the + * child list of its parent, if any. The following list describes the + * specifics for each type of node. * <dl> * <dt>ATTRIBUTE_NODE</dt> - * <dd>The - * <code>ownerElement</code> attribute is set to <code>null</code> and - * the <code>specified</code> flag is set to <code>true</code> on the - * adopted <code>Attr</code>. The descendants of the source + * <dd>The + * <code>ownerElement</code> attribute is set to <code>null</code> and + * the <code>specified</code> flag is set to <code>true</code> on the + * adopted <code>Attr</code>. The descendants of the source * <code>Attr</code> are recursively adopted.</dd> * <dt>DOCUMENT_FRAGMENT_NODE</dt> - * <dd>The + * <dd>The * descendants of the source node are recursively adopted.</dd> * <dt>DOCUMENT_NODE</dt> * <dd> @@ -657,41 +657,41 @@ public interface Document extends Node { * <dd> * <code>DocumentType</code> nodes cannot be adopted.</dd> * <dt>ELEMENT_NODE</dt> - * <dd><em>Specified</em> attribute nodes of the source element are adopted. Default attributes - * are discarded, though if the document being adopted into defines - * default attributes for this element name, those are assigned. The + * <dd><em>Specified</em> attribute nodes of the source element are adopted. Default attributes + * are discarded, though if the document being adopted into defines + * default attributes for this element name, those are assigned. The * descendants of the source element are recursively adopted.</dd> * <dt>ENTITY_NODE</dt> * <dd> * <code>Entity</code> nodes cannot be adopted.</dd> * <dt>ENTITY_REFERENCE_NODE</dt> - * <dd>Only - * the <code>EntityReference</code> node itself is adopted, the - * descendants are discarded, since the source and destination documents - * might have defined the entity differently. If the document being - * imported into provides a definition for this entity name, its value + * <dd>Only + * the <code>EntityReference</code> node itself is adopted, the + * descendants are discarded, since the source and destination documents + * might have defined the entity differently. If the document being + * imported into provides a definition for this entity name, its value * is assigned.</dd> * <dt>NOTATION_NODE</dt> - * <dd><code>Notation</code> nodes cannot be + * <dd><code>Notation</code> nodes cannot be * adopted.</dd> - * <dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, + * <dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, * COMMENT_NODE</dt> * <dd>These nodes can all be adopted. No specifics.</dd> - * </dl> - * <p ><b>Note:</b> Since it does not create new nodes unlike the - * <code>Document.importNode()</code> method, this method does not raise - * an <code>INVALID_CHARACTER_ERR</code> exception, and applications - * should use the <code>Document.normalizeDocument()</code> method to - * check if an imported name is not an XML name according to the XML - * version in use. + * </dl> + * <p ><b>Note:</b> Since it does not create new nodes unlike the + * <code>Document.importNode()</code> method, this method does not raise + * an <code>INVALID_CHARACTER_ERR</code> exception, and applications + * should use the <code>Document.normalizeDocument()</code> method to + * check if an imported name is not an XML name according to the XML + * version in use. * @param source The node to move into this document. - * @return The adopted node, or <code>null</code> if this operation - * fails, such as when the source node comes from a different + * @return The adopted node, or <code>null</code> if this operation + * fails, such as when the source node comes from a different * implementation. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the source node is of type + * NOT_SUPPORTED_ERR: Raised if the source node is of type * <code>DOCUMENT</code>, <code>DOCUMENT_TYPE</code>. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised when the source node is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised when the source node is * readonly. * @since DOM Level 3 */ @@ -699,115 +699,115 @@ public interface Document extends Node { throws DOMException; /** - * The configuration used when <code>Document.normalizeDocument()</code> - * is invoked. + * The configuration used when <code>Document.normalizeDocument()</code> + * is invoked. * @since DOM Level 3 */ public DOMConfiguration getDomConfig(); /** - * This method acts as if the document was going through a save and load - * cycle, putting the document in a "normal" form. As a consequence, - * this method updates the replacement tree of - * <code>EntityReference</code> nodes and normalizes <code>Text</code> - * nodes, as defined in the method <code>Node.normalize()</code>. - * <br> Otherwise, the actual result depends on the features being set on - * the <code>Document.domConfig</code> object and governing what - * operations actually take place. Noticeably this method could also - * make the document namespace well-formed according to the algorithm - * described in , check the character normalization, remove the - * <code>CDATASection</code> nodes, etc. See - * <code>DOMConfiguration</code> for details. - * <pre>// Keep in the document - * the information defined // in the XML Information Set (Java example) - * DOMConfiguration docConfig = myDocument.getDomConfig(); - * docConfig.setParameter("infoset", Boolean.TRUE); + * This method acts as if the document was going through a save and load + * cycle, putting the document in a "normal" form. As a consequence, + * this method updates the replacement tree of + * <code>EntityReference</code> nodes and normalizes <code>Text</code> + * nodes, as defined in the method <code>Node.normalize()</code>. + * <br> Otherwise, the actual result depends on the features being set on + * the <code>Document.domConfig</code> object and governing what + * operations actually take place. Noticeably this method could also + * make the document namespace well-formed according to the algorithm + * described in , check the character normalization, remove the + * <code>CDATASection</code> nodes, etc. See + * <code>DOMConfiguration</code> for details. + * <pre>// Keep in the document + * the information defined // in the XML Information Set (Java example) + * DOMConfiguration docConfig = myDocument.getDomConfig(); + * docConfig.setParameter("infoset", Boolean.TRUE); * myDocument.normalizeDocument();</pre> - * - * <br>Mutation events, when supported, are generated to reflect the + * + * <br>Mutation events, when supported, are generated to reflect the * changes occurring on the document. - * <br> If errors occur during the invocation of this method, such as an - * attempt to update a read-only node or a <code>Node.nodeName</code> - * contains an invalid character according to the XML version in use, - * errors or warnings (<code>DOMError.SEVERITY_ERROR</code> or - * <code>DOMError.SEVERITY_WARNING</code>) will be reported using the + * <br> If errors occur during the invocation of this method, such as an + * attempt to update a read-only node or a <code>Node.nodeName</code> + * contains an invalid character according to the XML version in use, + * errors or warnings (<code>DOMError.SEVERITY_ERROR</code> or + * <code>DOMError.SEVERITY_WARNING</code>) will be reported using the * <code>DOMErrorHandler</code> object associated with the "error-handler * " parameter. Note this method might also report fatal errors ( - * <code>DOMError.SEVERITY_FATAL_ERROR</code>) if an implementation - * cannot recover from an error. + * <code>DOMError.SEVERITY_FATAL_ERROR</code>) if an implementation + * cannot recover from an error. * @since DOM Level 3 */ public void normalizeDocument(); /** - * Rename an existing node of type <code>ELEMENT_NODE</code> or + * Rename an existing node of type <code>ELEMENT_NODE</code> or * <code>ATTRIBUTE_NODE</code>. - * <br>When possible this simply changes the name of the given node, - * otherwise this creates a new node with the specified name and + * <br>When possible this simply changes the name of the given node, + * otherwise this creates a new node with the specified name and * replaces the existing node with the new node as described below. - * <br>If simply changing the name of the given node is not possible, the - * following operations are performed: a new node is created, any - * registered event listener is registered on the new node, any user - * data attached to the old node is removed from that node, the old node - * is removed from its parent if it has one, the children are moved to - * the new node, if the renamed node is an <code>Element</code> its - * attributes are moved to the new node, the new node is inserted at the - * position the old node used to have in its parent's child nodes list - * if it has one, the user data that was attached to the old node is + * <br>If simply changing the name of the given node is not possible, the + * following operations are performed: a new node is created, any + * registered event listener is registered on the new node, any user + * data attached to the old node is removed from that node, the old node + * is removed from its parent if it has one, the children are moved to + * the new node, if the renamed node is an <code>Element</code> its + * attributes are moved to the new node, the new node is inserted at the + * position the old node used to have in its parent's child nodes list + * if it has one, the user data that was attached to the old node is * attached to the new node. - * <br>When the node being renamed is an <code>Element</code> only the - * specified attributes are moved, default attributes originated from - * the DTD are updated according to the new element name. In addition, - * the implementation may update default attributes from other schemas. - * Applications should use <code>Document.normalizeDocument()</code> to + * <br>When the node being renamed is an <code>Element</code> only the + * specified attributes are moved, default attributes originated from + * the DTD are updated according to the new element name. In addition, + * the implementation may update default attributes from other schemas. + * Applications should use <code>Document.normalizeDocument()</code> to * guarantee these attributes are up-to-date. - * <br>When the node being renamed is an <code>Attr</code> that is - * attached to an <code>Element</code>, the node is first removed from - * the <code>Element</code> attributes map. Then, once renamed, either - * by modifying the existing node or creating a new one as described + * <br>When the node being renamed is an <code>Attr</code> that is + * attached to an <code>Element</code>, the node is first removed from + * the <code>Element</code> attributes map. Then, once renamed, either + * by modifying the existing node or creating a new one as described * above, it is put back. * <br>In addition, * <ul> - * <li> a user data event <code>NODE_RENAMED</code> is fired, + * <li> a user data event <code>NODE_RENAMED</code> is fired, * </li> - * <li> - * when the implementation supports the feature "MutationNameEvents", - * each mutation operation involved in this method fires the appropriate + * <li> + * when the implementation supports the feature "MutationNameEvents", + * each mutation operation involved in this method fires the appropriate * event, and in the end the event { - * <code>http://www.w3.org/2001/xml-events</code>, + * <code>http://www.w3.org/2001/xml-events</code>, * <code>DOMElementNameChanged</code>} or { - * <code>http://www.w3.org/2001/xml-events</code>, - * <code>DOMAttributeNameChanged</code>} is fired. + * <code>http://www.w3.org/2001/xml-events</code>, + * <code>DOMAttributeNameChanged</code>} is fired. * </li> * </ul> * @param n The node to rename. * @param namespaceURI The new namespace URI. * @param qualifiedName The new qualified name. - * @return The renamed node. This is either the specified node or the new + * @return The renamed node. This is either the specified node or the new * node that was created to replace the specified node. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised when the type of the specified node is - * neither <code>ELEMENT_NODE</code> nor <code>ATTRIBUTE_NODE</code>, - * or if the implementation does not support the renaming of the + * NOT_SUPPORTED_ERR: Raised when the type of the specified node is + * neither <code>ELEMENT_NODE</code> nor <code>ATTRIBUTE_NODE</code>, + * or if the implementation does not support the renaming of the * document element. - * <br>INVALID_CHARACTER_ERR: Raised if the new qualified name is not an - * XML name according to the XML version in use specified in the + * <br>INVALID_CHARACTER_ERR: Raised if the new qualified name is not an + * XML name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. - * <br>WRONG_DOCUMENT_ERR: Raised when the specified node was created + * <br>WRONG_DOCUMENT_ERR: Raised when the specified node was created * from a different document than this document. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a - * malformed qualified name, if the <code>qualifiedName</code> has a - * prefix and the <code>namespaceURI</code> is <code>null</code>, or - * if the <code>qualifiedName</code> has a prefix that is "xml" and + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is a + * malformed qualified name, if the <code>qualifiedName</code> has a + * prefix and the <code>namespaceURI</code> is <code>null</code>, or + * if the <code>qualifiedName</code> has a prefix that is "xml" and * the <code>namespaceURI</code> is different from "<a href='http://www.w3.org/XML/1998/namespace'> * http://www.w3.org/XML/1998/namespace</a>" [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * . Also raised, when the node being renamed is an attribute, if the - * <code>qualifiedName</code>, or its prefix, is "xmlns" and the + * . Also raised, when the node being renamed is an attribute, if the + * <code>qualifiedName</code>, or its prefix, is "xmlns" and the * <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>". * @since DOM Level 3 */ - public Node renameNode(Node n, - String namespaceURI, + public Node renameNode(Node n, + String namespaceURI, String qualifiedName) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentFragment.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentFragment.java index 8c4531eff87..68739154e0e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentFragment.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentFragment.java @@ -13,39 +13,39 @@ package org.w3c.dom; /** - * <code>DocumentFragment</code> is a "lightweight" or "minimal" - * <code>Document</code> object. It is very common to want to be able to - * extract a portion of a document's tree or to create a new fragment of a - * document. Imagine implementing a user command like cut or rearranging a - * document by moving fragments around. It is desirable to have an object - * which can hold such fragments and it is quite natural to use a Node for - * this purpose. While it is true that a <code>Document</code> object could - * fulfill this role, a <code>Document</code> object can potentially be a - * heavyweight object, depending on the underlying implementation. What is - * really needed for this is a very lightweight object. + * <code>DocumentFragment</code> is a "lightweight" or "minimal" + * <code>Document</code> object. It is very common to want to be able to + * extract a portion of a document's tree or to create a new fragment of a + * document. Imagine implementing a user command like cut or rearranging a + * document by moving fragments around. It is desirable to have an object + * which can hold such fragments and it is quite natural to use a Node for + * this purpose. While it is true that a <code>Document</code> object could + * fulfill this role, a <code>Document</code> object can potentially be a + * heavyweight object, depending on the underlying implementation. What is + * really needed for this is a very lightweight object. * <code>DocumentFragment</code> is such an object. - * <p>Furthermore, various operations -- such as inserting nodes as children - * of another <code>Node</code> -- may take <code>DocumentFragment</code> - * objects as arguments; this results in all the child nodes of the + * <p>Furthermore, various operations -- such as inserting nodes as children + * of another <code>Node</code> -- may take <code>DocumentFragment</code> + * objects as arguments; this results in all the child nodes of the * <code>DocumentFragment</code> being moved to the child list of this node. - * <p>The children of a <code>DocumentFragment</code> node are zero or more - * nodes representing the tops of any sub-trees defining the structure of - * the document. <code>DocumentFragment</code> nodes do not need to be - * well-formed XML documents (although they do need to follow the rules - * imposed upon well-formed XML parsed entities, which can have multiple top - * nodes). For example, a <code>DocumentFragment</code> might have only one - * child and that child node could be a <code>Text</code> node. Such a - * structure model represents neither an HTML document nor a well-formed XML + * <p>The children of a <code>DocumentFragment</code> node are zero or more + * nodes representing the tops of any sub-trees defining the structure of + * the document. <code>DocumentFragment</code> nodes do not need to be + * well-formed XML documents (although they do need to follow the rules + * imposed upon well-formed XML parsed entities, which can have multiple top + * nodes). For example, a <code>DocumentFragment</code> might have only one + * child and that child node could be a <code>Text</code> node. Such a + * structure model represents neither an HTML document nor a well-formed XML * document. - * <p>When a <code>DocumentFragment</code> is inserted into a - * <code>Document</code> (or indeed any other <code>Node</code> that may - * take children) the children of the <code>DocumentFragment</code> and not - * the <code>DocumentFragment</code> itself are inserted into the - * <code>Node</code>. This makes the <code>DocumentFragment</code> very - * useful when the user wishes to create nodes that are siblings; the - * <code>DocumentFragment</code> acts as the parent of these nodes so that - * the user can use the standard methods from the <code>Node</code> - * interface, such as <code>Node.insertBefore</code> and + * <p>When a <code>DocumentFragment</code> is inserted into a + * <code>Document</code> (or indeed any other <code>Node</code> that may + * take children) the children of the <code>DocumentFragment</code> and not + * the <code>DocumentFragment</code> itself are inserted into the + * <code>Node</code>. This makes the <code>DocumentFragment</code> very + * useful when the user wishes to create nodes that are siblings; the + * <code>DocumentFragment</code> acts as the parent of these nodes so that + * the user can use the standard methods from the <code>Node</code> + * interface, such as <code>Node.insertBefore</code> and * <code>Node.appendChild</code>. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentType.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentType.java index 6221c7b5ef6..785578171b5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentType.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/DocumentType.java @@ -13,45 +13,45 @@ package org.w3c.dom; /** - * Each <code>Document</code> has a <code>doctype</code> attribute whose value - * is either <code>null</code> or a <code>DocumentType</code> object. The - * <code>DocumentType</code> interface in the DOM Core provides an interface - * to the list of entities that are defined for the document, and little - * else because the effect of namespaces and the various XML schema efforts + * Each <code>Document</code> has a <code>doctype</code> attribute whose value + * is either <code>null</code> or a <code>DocumentType</code> object. The + * <code>DocumentType</code> interface in the DOM Core provides an interface + * to the list of entities that are defined for the document, and little + * else because the effect of namespaces and the various XML schema efforts * on DTD representation are not clearly understood as of this writing. - * <p>DOM Level 3 doesn't support editing <code>DocumentType</code> nodes. + * <p>DOM Level 3 doesn't support editing <code>DocumentType</code> nodes. * <code>DocumentType</code> nodes are read-only. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface DocumentType extends Node { /** - * The name of DTD; i.e., the name immediately following the + * The name of DTD; i.e., the name immediately following the * <code>DOCTYPE</code> keyword. */ public String getName(); /** - * A <code>NamedNodeMap</code> containing the general entities, both - * external and internal, declared in the DTD. Parameter entities are - * not contained. Duplicates are discarded. For example in: - * <pre><!DOCTYPE - * ex SYSTEM "ex.dtd" [ <!ENTITY foo "foo"> <!ENTITY bar - * "bar"> <!ENTITY bar "bar2"> <!ENTITY % baz "baz"> + * A <code>NamedNodeMap</code> containing the general entities, both + * external and internal, declared in the DTD. Parameter entities are + * not contained. Duplicates are discarded. For example in: + * <pre><!DOCTYPE + * ex SYSTEM "ex.dtd" [ <!ENTITY foo "foo"> <!ENTITY bar + * "bar"> <!ENTITY bar "bar2"> <!ENTITY % baz "baz"> * ]> <ex/></pre> - * the interface provides access to <code>foo</code> - * and the first declaration of <code>bar</code> but not the second - * declaration of <code>bar</code> or <code>baz</code>. Every node in + * the interface provides access to <code>foo</code> + * and the first declaration of <code>bar</code> but not the second + * declaration of <code>bar</code> or <code>baz</code>. Every node in * this map also implements the <code>Entity</code> interface. - * <br>The DOM Level 2 does not support editing entities, therefore + * <br>The DOM Level 2 does not support editing entities, therefore * <code>entities</code> cannot be altered in any way. */ public NamedNodeMap getEntities(); /** - * A <code>NamedNodeMap</code> containing the notations declared in the - * DTD. Duplicates are discarded. Every node in this map also implements + * A <code>NamedNodeMap</code> containing the notations declared in the + * DTD. Duplicates are discarded. Every node in this map also implements * the <code>Notation</code> interface. - * <br>The DOM Level 2 does not support editing notations, therefore + * <br>The DOM Level 2 does not support editing notations, therefore * <code>notations</code> cannot be altered in any way. */ public NamedNodeMap getNotations(); @@ -63,18 +63,18 @@ public interface DocumentType extends Node { public String getPublicId(); /** - * The system identifier of the external subset. This may be an absolute + * The system identifier of the external subset. This may be an absolute * URI or not. * @since DOM Level 2 */ public String getSystemId(); /** - * The internal subset as a string, or <code>null</code> if there is none. + * The internal subset as a string, or <code>null</code> if there is none. * This is does not contain the delimiting square brackets. - * <p ><b>Note:</b> The actual content returned depends on how much - * information is available to the implementation. This may vary - * depending on various parameters, including the XML processor used to + * <p ><b>Note:</b> The actual content returned depends on how much + * information is available to the implementation. This may vary + * depending on various parameters, including the XML processor used to * build the document. * @since DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Element.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Element.java index 6a7f7e3d0c7..beca7fc8712 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Element.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Element.java @@ -13,33 +13,33 @@ package org.w3c.dom; /** - * The <code>Element</code> interface represents an element in an HTML or XML - * document. Elements may have attributes associated with them; since the - * <code>Element</code> interface inherits from <code>Node</code>, the - * generic <code>Node</code> interface attribute <code>attributes</code> may - * be used to retrieve the set of all attributes for an element. There are - * methods on the <code>Element</code> interface to retrieve either an - * <code>Attr</code> object by name or an attribute value by name. In XML, - * where an attribute value may contain entity references, an - * <code>Attr</code> object should be retrieved to examine the possibly - * fairly complex sub-tree representing the attribute value. On the other - * hand, in HTML, where all attributes have simple string values, methods to + * The <code>Element</code> interface represents an element in an HTML or XML + * document. Elements may have attributes associated with them; since the + * <code>Element</code> interface inherits from <code>Node</code>, the + * generic <code>Node</code> interface attribute <code>attributes</code> may + * be used to retrieve the set of all attributes for an element. There are + * methods on the <code>Element</code> interface to retrieve either an + * <code>Attr</code> object by name or an attribute value by name. In XML, + * where an attribute value may contain entity references, an + * <code>Attr</code> object should be retrieved to examine the possibly + * fairly complex sub-tree representing the attribute value. On the other + * hand, in HTML, where all attributes have simple string values, methods to * directly access an attribute value can safely be used as a convenience. - * <p ><b>Note:</b> In DOM Level 2, the method <code>normalize</code> is + * <p ><b>Note:</b> In DOM Level 2, the method <code>normalize</code> is * inherited from the <code>Node</code> interface where it was moved. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Element extends Node { /** - * The name of the element. If <code>Node.localName</code> is different - * from <code>null</code>, this attribute is a qualified name. For - * example, in: - * <pre> <elementExample id="demo"> ... + * The name of the element. If <code>Node.localName</code> is different + * from <code>null</code>, this attribute is a qualified name. For + * example, in: + * <pre> <elementExample id="demo"> ... * </elementExample> , </pre> - * <code>tagName</code> has the value - * <code>"elementExample"</code>. Note that this is case-preserving in - * XML, as are all of the operations of the DOM. The HTML DOM returns - * the <code>tagName</code> of an HTML element in the canonical + * <code>tagName</code> has the value + * <code>"elementExample"</code>. Note that this is case-preserving in + * XML, as are all of the operations of the DOM. The HTML DOM returns + * the <code>tagName</code> of an HTML element in the canonical * uppercase form, regardless of the case in the source HTML document. */ public String getTagName(); @@ -47,47 +47,47 @@ public interface Element extends Node { /** * Retrieves an attribute value by name. * @param name The name of the attribute to retrieve. - * @return The <code>Attr</code> value as a string, or the empty string + * @return The <code>Attr</code> value as a string, or the empty string * if that attribute does not have a specified or default value. */ public String getAttribute(String name); /** - * Adds a new attribute. If an attribute with that name is already present - * in the element, its value is changed to be that of the value - * parameter. This value is a simple string; it is not parsed as it is - * being set. So any markup (such as syntax to be recognized as an - * entity reference) is treated as literal text, and needs to be - * appropriately escaped by the implementation when it is written out. - * In order to assign an attribute value that contains entity - * references, the user must create an <code>Attr</code> node plus any - * <code>Text</code> and <code>EntityReference</code> nodes, build the - * appropriate subtree, and use <code>setAttributeNode</code> to assign + * Adds a new attribute. If an attribute with that name is already present + * in the element, its value is changed to be that of the value + * parameter. This value is a simple string; it is not parsed as it is + * being set. So any markup (such as syntax to be recognized as an + * entity reference) is treated as literal text, and needs to be + * appropriately escaped by the implementation when it is written out. + * In order to assign an attribute value that contains entity + * references, the user must create an <code>Attr</code> node plus any + * <code>Text</code> and <code>EntityReference</code> nodes, build the + * appropriate subtree, and use <code>setAttributeNode</code> to assign * it as the value of an attribute. - * <br>To set an attribute with a qualified name and namespace URI, use + * <br>To set an attribute with a qualified name and namespace URI, use * the <code>setAttributeNS</code> method. * @param name The name of the attribute to create or alter. * @param value Value to set in string form. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML - * name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified name is not an XML + * name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ - public void setAttribute(String name, + public void setAttribute(String name, String value) throws DOMException; /** - * Removes an attribute by name. If a default value for the removed - * attribute is defined in the DTD, a new attribute immediately appears - * with the default value as well as the corresponding namespace URI, - * local name, and prefix when applicable. The implementation may handle - * default values from other schemas similarly but applications should - * use <code>Document.normalizeDocument()</code> to guarantee this + * Removes an attribute by name. If a default value for the removed + * attribute is defined in the DTD, a new attribute immediately appears + * with the default value as well as the corresponding namespace URI, + * local name, and prefix when applicable. The implementation may handle + * default values from other schemas similarly but applications should + * use <code>Document.normalizeDocument()</code> to guarantee this * information is up-to-date. * <br>If no attribute with this name is found, this method has no effect. - * <br>To remove an attribute by local name and namespace URI, use the + * <br>To remove an attribute by local name and namespace URI, use the * <code>removeAttributeNS</code> method. * @param name The name of the attribute to remove. * @exception DOMException @@ -98,63 +98,63 @@ public interface Element extends Node { /** * Retrieves an attribute node by name. - * <br>To retrieve an attribute node by qualified name and namespace URI, + * <br>To retrieve an attribute node by qualified name and namespace URI, * use the <code>getAttributeNodeNS</code> method. - * @param name The name (<code>nodeName</code>) of the attribute to + * @param name The name (<code>nodeName</code>) of the attribute to * retrieve. * @return The <code>Attr</code> node with the specified name ( - * <code>nodeName</code>) or <code>null</code> if there is no such + * <code>nodeName</code>) or <code>null</code> if there is no such * attribute. */ public Attr getAttributeNode(String name); /** * Adds a new attribute node. If an attribute with that name ( - * <code>nodeName</code>) is already present in the element, it is - * replaced by the new one. Replacing an attribute node by itself has no + * <code>nodeName</code>) is already present in the element, it is + * replaced by the new one. Replacing an attribute node by itself has no * effect. - * <br>To add a new attribute node with a qualified name and namespace + * <br>To add a new attribute node with a qualified name and namespace * URI, use the <code>setAttributeNodeNS</code> method. * @param newAttr The <code>Attr</code> node to add to the attribute list. - * @return If the <code>newAttr</code> attribute replaces an existing - * attribute, the replaced <code>Attr</code> node is returned, + * @return If the <code>newAttr</code> attribute replaces an existing + * attribute, the replaced <code>Attr</code> node is returned, * otherwise <code>null</code> is returned. * @exception DOMException - * WRONG_DOCUMENT_ERR: Raised if <code>newAttr</code> was created from a + * WRONG_DOCUMENT_ERR: Raised if <code>newAttr</code> was created from a * different document than the one that created the element. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>newAttr</code> is already an - * attribute of another <code>Element</code> object. The DOM user must - * explicitly clone <code>Attr</code> nodes to re-use them in other + * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>newAttr</code> is already an + * attribute of another <code>Element</code> object. The DOM user must + * explicitly clone <code>Attr</code> nodes to re-use them in other * elements. */ public Attr setAttributeNode(Attr newAttr) throws DOMException; /** - * Removes the specified attribute node. If a default value for the - * removed <code>Attr</code> node is defined in the DTD, a new node - * immediately appears with the default value as well as the - * corresponding namespace URI, local name, and prefix when applicable. - * The implementation may handle default values from other schemas - * similarly but applications should use - * <code>Document.normalizeDocument()</code> to guarantee this + * Removes the specified attribute node. If a default value for the + * removed <code>Attr</code> node is defined in the DTD, a new node + * immediately appears with the default value as well as the + * corresponding namespace URI, local name, and prefix when applicable. + * The implementation may handle default values from other schemas + * similarly but applications should use + * <code>Document.normalizeDocument()</code> to guarantee this * information is up-to-date. - * @param oldAttr The <code>Attr</code> node to remove from the attribute + * @param oldAttr The <code>Attr</code> node to remove from the attribute * list. * @return The <code>Attr</code> node that was removed. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_FOUND_ERR: Raised if <code>oldAttr</code> is not an attribute + * <br>NOT_FOUND_ERR: Raised if <code>oldAttr</code> is not an attribute * of the element. */ public Attr removeAttributeNode(Attr oldAttr) throws DOMException; /** - * Returns a <code>NodeList</code> of all descendant <code>Elements</code> + * Returns a <code>NodeList</code> of all descendant <code>Elements</code> * with a given tag name, in document order. - * @param name The name of the tag to match on. The special value "*" + * @param name The name of the tag to match on. The special value "*" * matches all tags. * @return A list of matching <code>Element</code> nodes. */ @@ -163,174 +163,174 @@ public interface Element extends Node { /** * Retrieves an attribute value by local name and namespace URI. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. - * @return The <code>Attr</code> value as a string, or the empty string + * @return The <code>Attr</code> value as a string, or the empty string * if that attribute does not have a specified or default value. * @exception DOMException - * NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public String getAttributeNS(String namespaceURI, + public String getAttributeNS(String namespaceURI, String localName) throws DOMException; /** - * Adds a new attribute. If an attribute with the same local name and - * namespace URI is already present on the element, its prefix is - * changed to be the prefix part of the <code>qualifiedName</code>, and - * its value is changed to be the <code>value</code> parameter. This - * value is a simple string; it is not parsed as it is being set. So any - * markup (such as syntax to be recognized as an entity reference) is - * treated as literal text, and needs to be appropriately escaped by the - * implementation when it is written out. In order to assign an - * attribute value that contains entity references, the user must create - * an <code>Attr</code> node plus any <code>Text</code> and - * <code>EntityReference</code> nodes, build the appropriate subtree, - * and use <code>setAttributeNodeNS</code> or - * <code>setAttributeNode</code> to assign it as the value of an + * Adds a new attribute. If an attribute with the same local name and + * namespace URI is already present on the element, its prefix is + * changed to be the prefix part of the <code>qualifiedName</code>, and + * its value is changed to be the <code>value</code> parameter. This + * value is a simple string; it is not parsed as it is being set. So any + * markup (such as syntax to be recognized as an entity reference) is + * treated as literal text, and needs to be appropriately escaped by the + * implementation when it is written out. In order to assign an + * attribute value that contains entity references, the user must create + * an <code>Attr</code> node plus any <code>Text</code> and + * <code>EntityReference</code> nodes, build the appropriate subtree, + * and use <code>setAttributeNodeNS</code> or + * <code>setAttributeNode</code> to assign it as the value of an * attribute. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. - * @param namespaceURI The namespace URI of the attribute to create or + * @param namespaceURI The namespace URI of the attribute to create or * alter. - * @param qualifiedName The qualified name of the attribute to create or + * @param qualifiedName The qualified name of the attribute to create or * alter. * @param value The value to set in string form. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not - * an XML name according to the XML version in use specified in the + * INVALID_CHARACTER_ERR: Raised if the specified qualified name is not + * an XML name according to the XML version in use specified in the * <code>Document.xmlVersion</code> attribute. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is - * malformed per the Namespaces in XML specification, if the - * <code>qualifiedName</code> has a prefix and the - * <code>namespaceURI</code> is <code>null</code>, if the - * <code>qualifiedName</code> has a prefix that is "xml" and the + * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is + * malformed per the Namespaces in XML specification, if the + * <code>qualifiedName</code> has a prefix and the + * <code>namespaceURI</code> is <code>null</code>, if the + * <code>qualifiedName</code> has a prefix that is "xml" and the * <code>namespaceURI</code> is different from "<a href='http://www.w3.org/XML/1998/namespace'> - * http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the + * http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the * <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if the <code>namespaceURI</code> is "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>" and neither the <code>qualifiedName</code> nor its prefix is "xmlns". - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public void setAttributeNS(String namespaceURI, - String qualifiedName, + public void setAttributeNS(String namespaceURI, + String qualifiedName, String value) throws DOMException; /** - * Removes an attribute by local name and namespace URI. If a default - * value for the removed attribute is defined in the DTD, a new - * attribute immediately appears with the default value as well as the - * corresponding namespace URI, local name, and prefix when applicable. - * The implementation may handle default values from other schemas - * similarly but applications should use - * <code>Document.normalizeDocument()</code> to guarantee this + * Removes an attribute by local name and namespace URI. If a default + * value for the removed attribute is defined in the DTD, a new + * attribute immediately appears with the default value as well as the + * corresponding namespace URI, local name, and prefix when applicable. + * The implementation may handle default values from other schemas + * similarly but applications should use + * <code>Document.normalizeDocument()</code> to guarantee this * information is up-to-date. - * <br>If no attribute with this local name and namespace URI is found, + * <br>If no attribute with this local name and namespace URI is found, * this method has no effect. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param namespaceURI The namespace URI of the attribute to remove. * @param localName The local name of the attribute to remove. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public void removeAttributeNS(String namespaceURI, + public void removeAttributeNS(String namespaceURI, String localName) throws DOMException; /** * Retrieves an <code>Attr</code> node by local name and namespace URI. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. - * @return The <code>Attr</code> node with the specified attribute local - * name and namespace URI or <code>null</code> if there is no such + * @return The <code>Attr</code> node with the specified attribute local + * name and namespace URI or <code>null</code> if there is no such * attribute. * @exception DOMException - * NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public Attr getAttributeNodeNS(String namespaceURI, + public Attr getAttributeNodeNS(String namespaceURI, String localName) throws DOMException; /** - * Adds a new attribute. If an attribute with that local name and that - * namespace URI is already present in the element, it is replaced by + * Adds a new attribute. If an attribute with that local name and that + * namespace URI is already present in the element, it is replaced by * the new one. Replacing an attribute node by itself has no effect. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param newAttr The <code>Attr</code> node to add to the attribute list. - * @return If the <code>newAttr</code> attribute replaces an existing - * attribute with the same local name and namespace URI, the replaced - * <code>Attr</code> node is returned, otherwise <code>null</code> is + * @return If the <code>newAttr</code> attribute replaces an existing + * attribute with the same local name and namespace URI, the replaced + * <code>Attr</code> node is returned, otherwise <code>null</code> is * returned. * @exception DOMException - * WRONG_DOCUMENT_ERR: Raised if <code>newAttr</code> was created from a + * WRONG_DOCUMENT_ERR: Raised if <code>newAttr</code> was created from a * different document than the one that created the element. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>newAttr</code> is already an - * attribute of another <code>Element</code> object. The DOM user must - * explicitly clone <code>Attr</code> nodes to re-use them in other + * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>newAttr</code> is already an + * attribute of another <code>Element</code> object. The DOM user must + * explicitly clone <code>Attr</code> nodes to re-use them in other * elements. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ public Attr setAttributeNodeNS(Attr newAttr) throws DOMException; /** - * Returns a <code>NodeList</code> of all the descendant - * <code>Elements</code> with a given local name and namespace URI in + * Returns a <code>NodeList</code> of all the descendant + * <code>Elements</code> with a given local name and namespace URI in * document order. - * @param namespaceURI The namespace URI of the elements to match on. The + * @param namespaceURI The namespace URI of the elements to match on. The * special value "*" matches all namespaces. - * @param localName The local name of the elements to match on. The + * @param localName The local name of the elements to match on. The * special value "*" matches all local names. - * @return A new <code>NodeList</code> object containing all the matched + * @return A new <code>NodeList</code> object containing all the matched * <code>Elements</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public NodeList getElementsByTagNameNS(String namespaceURI, + public NodeList getElementsByTagNameNS(String namespaceURI, String localName) throws DOMException; /** - * Returns <code>true</code> when an attribute with a given name is - * specified on this element or has a default value, <code>false</code> + * Returns <code>true</code> when an attribute with a given name is + * specified on this element or has a default value, <code>false</code> * otherwise. * @param name The name of the attribute to look for. - * @return <code>true</code> if an attribute with the given name is + * @return <code>true</code> if an attribute with the given name is * specified on this element or has a default value, <code>false</code> * otherwise. * @since DOM Level 2 @@ -338,101 +338,101 @@ public interface Element extends Node { public boolean hasAttribute(String name); /** - * Returns <code>true</code> when an attribute with a given local name and - * namespace URI is specified on this element or has a default value, + * Returns <code>true</code> when an attribute with a given local name and + * namespace URI is specified on this element or has a default value, * <code>false</code> otherwise. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value <code>null</code> as the - * <code>namespaceURI</code> parameter for methods if they wish to have + * , applications must use the value <code>null</code> as the + * <code>namespaceURI</code> parameter for methods if they wish to have * no namespace. * @param namespaceURI The namespace URI of the attribute to look for. * @param localName The local name of the attribute to look for. - * @return <code>true</code> if an attribute with the given local name - * and namespace URI is specified or has a default value on this + * @return <code>true</code> if an attribute with the given local name + * and namespace URI is specified or has a default value on this * element, <code>false</code> otherwise. * @exception DOMException - * NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature <code>"XML"</code> and the language exposed - * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature <code>"XML"</code> and the language exposed + * through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public boolean hasAttributeNS(String namespaceURI, + public boolean hasAttributeNS(String namespaceURI, String localName) throws DOMException; /** - * The type information associated with this element. + * The type information associated with this element. * @since DOM Level 3 */ public TypeInfo getSchemaTypeInfo(); /** - * If the parameter <code>isId</code> is <code>true</code>, this method + * If the parameter <code>isId</code> is <code>true</code>, this method * declares the specified attribute to be a user-determined ID attribute - * . This affects the value of <code>Attr.isId</code> and the behavior - * of <code>Document.getElementById</code>, but does not change any - * schema that may be in use, in particular this does not affect the - * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> - * node. Use the value <code>false</code> for the parameter - * <code>isId</code> to undeclare an attribute for being a - * user-determined ID attribute. - * <br> To specify an attribute by local name and namespace URI, use the - * <code>setIdAttributeNS</code> method. + * . This affects the value of <code>Attr.isId</code> and the behavior + * of <code>Document.getElementById</code>, but does not change any + * schema that may be in use, in particular this does not affect the + * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> + * node. Use the value <code>false</code> for the parameter + * <code>isId</code> to undeclare an attribute for being a + * user-determined ID attribute. + * <br> To specify an attribute by local name and namespace URI, use the + * <code>setIdAttributeNS</code> method. * @param name The name of the attribute. * @param isId Whether the attribute is a of type ID. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute + * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute * of this element. * @since DOM Level 3 */ - public void setIdAttribute(String name, + public void setIdAttribute(String name, boolean isId) throws DOMException; /** - * If the parameter <code>isId</code> is <code>true</code>, this method + * If the parameter <code>isId</code> is <code>true</code>, this method * declares the specified attribute to be a user-determined ID attribute - * . This affects the value of <code>Attr.isId</code> and the behavior - * of <code>Document.getElementById</code>, but does not change any - * schema that may be in use, in particular this does not affect the - * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> - * node. Use the value <code>false</code> for the parameter - * <code>isId</code> to undeclare an attribute for being a - * user-determined ID attribute. + * . This affects the value of <code>Attr.isId</code> and the behavior + * of <code>Document.getElementById</code>, but does not change any + * schema that may be in use, in particular this does not affect the + * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> + * node. Use the value <code>false</code> for the parameter + * <code>isId</code> to undeclare an attribute for being a + * user-determined ID attribute. * @param namespaceURI The namespace URI of the attribute. * @param localName The local name of the attribute. * @param isId Whether the attribute is a of type ID. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute + * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute * of this element. * @since DOM Level 3 */ - public void setIdAttributeNS(String namespaceURI, - String localName, + public void setIdAttributeNS(String namespaceURI, + String localName, boolean isId) throws DOMException; /** - * If the parameter <code>isId</code> is <code>true</code>, this method + * If the parameter <code>isId</code> is <code>true</code>, this method * declares the specified attribute to be a user-determined ID attribute - * . This affects the value of <code>Attr.isId</code> and the behavior - * of <code>Document.getElementById</code>, but does not change any - * schema that may be in use, in particular this does not affect the - * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> - * node. Use the value <code>false</code> for the parameter - * <code>isId</code> to undeclare an attribute for being a - * user-determined ID attribute. + * . This affects the value of <code>Attr.isId</code> and the behavior + * of <code>Document.getElementById</code>, but does not change any + * schema that may be in use, in particular this does not affect the + * <code>Attr.schemaTypeInfo</code> of the specified <code>Attr</code> + * node. Use the value <code>false</code> for the parameter + * <code>isId</code> to undeclare an attribute for being a + * user-determined ID attribute. * @param idAttr The attribute node. * @param isId Whether the attribute is a of type ID. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute + * <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute * of this element. * @since DOM Level 3 */ - public void setIdAttributeNode(Attr idAttr, + public void setIdAttributeNode(Attr idAttr, boolean isId) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Entity.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Entity.java index f621c3386b1..fc89248d9d2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Entity.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Entity.java @@ -13,75 +13,75 @@ package org.w3c.dom; /** - * This interface represents a known entity, either parsed or unparsed, in an + * This interface represents a known entity, either parsed or unparsed, in an * XML document. Note that this models the entity itself <em>not</em> the entity declaration. - * <p>The <code>nodeName</code> attribute that is inherited from + * <p>The <code>nodeName</code> attribute that is inherited from * <code>Node</code> contains the name of the entity. - * <p>An XML processor may choose to completely expand entities before the - * structure model is passed to the DOM; in this case there will be no + * <p>An XML processor may choose to completely expand entities before the + * structure model is passed to the DOM; in this case there will be no * <code>EntityReference</code> nodes in the document tree. - * <p>XML does not mandate that a non-validating XML processor read and - * process entity declarations made in the external subset or declared in - * parameter entities. This means that parsed entities declared in the - * external subset need not be expanded by some classes of applications, and + * <p>XML does not mandate that a non-validating XML processor read and + * process entity declarations made in the external subset or declared in + * parameter entities. This means that parsed entities declared in the + * external subset need not be expanded by some classes of applications, and * that the replacement text of the entity may not be available. When the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#intern-replacement'> - * replacement text</a> is available, the corresponding <code>Entity</code> node's child list - * represents the structure of that replacement value. Otherwise, the child + * replacement text</a> is available, the corresponding <code>Entity</code> node's child list + * represents the structure of that replacement value. Otherwise, the child * list is empty. - * <p>DOM Level 3 does not support editing <code>Entity</code> nodes; if a - * user wants to make changes to the contents of an <code>Entity</code>, - * every related <code>EntityReference</code> node has to be replaced in the - * structure model by a clone of the <code>Entity</code>'s contents, and - * then the desired changes must be made to each of those clones instead. + * <p>DOM Level 3 does not support editing <code>Entity</code> nodes; if a + * user wants to make changes to the contents of an <code>Entity</code>, + * every related <code>EntityReference</code> node has to be replaced in the + * structure model by a clone of the <code>Entity</code>'s contents, and + * then the desired changes must be made to each of those clones instead. * <code>Entity</code> nodes and all their descendants are readonly. * <p>An <code>Entity</code> node does not have any parent. - * <p ><b>Note:</b> If the entity contains an unbound namespace prefix, the - * <code>namespaceURI</code> of the corresponding node in the - * <code>Entity</code> node subtree is <code>null</code>. The same is true - * for <code>EntityReference</code> nodes that refer to this entity, when - * they are created using the <code>createEntityReference</code> method of + * <p ><b>Note:</b> If the entity contains an unbound namespace prefix, the + * <code>namespaceURI</code> of the corresponding node in the + * <code>Entity</code> node subtree is <code>null</code>. The same is true + * for <code>EntityReference</code> nodes that refer to this entity, when + * they are created using the <code>createEntityReference</code> method of * the <code>Document</code> interface. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Entity extends Node { /** - * The public identifier associated with the entity if specified, and + * The public identifier associated with the entity if specified, and * <code>null</code> otherwise. */ public String getPublicId(); /** - * The system identifier associated with the entity if specified, and + * The system identifier associated with the entity if specified, and * <code>null</code> otherwise. This may be an absolute URI or not. */ public String getSystemId(); /** - * For unparsed entities, the name of the notation for the entity. For + * For unparsed entities, the name of the notation for the entity. For * parsed entities, this is <code>null</code>. */ public String getNotationName(); /** - * An attribute specifying the encoding used for this entity at the time - * of parsing, when it is an external parsed entity. This is - * <code>null</code> if it an entity from the internal subset or if it + * An attribute specifying the encoding used for this entity at the time + * of parsing, when it is an external parsed entity. This is + * <code>null</code> if it an entity from the internal subset or if it * is not known. * @since DOM Level 3 */ public String getInputEncoding(); /** - * An attribute specifying, as part of the text declaration, the encoding - * of this entity, when it is an external parsed entity. This is + * An attribute specifying, as part of the text declaration, the encoding + * of this entity, when it is an external parsed entity. This is * <code>null</code> otherwise. * @since DOM Level 3 */ public String getXmlEncoding(); /** - * An attribute specifying, as part of the text declaration, the version - * number of this entity, when it is an external parsed entity. This is + * An attribute specifying, as part of the text declaration, the version + * number of this entity, when it is an external parsed entity. This is * <code>null</code> otherwise. * @since DOM Level 3 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/EntityReference.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/EntityReference.java index b42b0913bc8..66cc6616883 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/EntityReference.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/EntityReference.java @@ -13,29 +13,29 @@ package org.w3c.dom; /** - * <code>EntityReference</code> nodes may be used to represent an entity - * reference in the tree. Note that character references and references to - * predefined entities are considered to be expanded by the HTML or XML - * processor so that characters are represented by their Unicode equivalent - * rather than by an entity reference. Moreover, the XML processor may - * completely expand references to entities while building the - * <code>Document</code>, instead of providing <code>EntityReference</code> - * nodes. If it does provide such nodes, then for an - * <code>EntityReference</code> node that represents a reference to a known - * entity an <code>Entity</code> exists, and the subtree of the - * <code>EntityReference</code> node is a copy of the <code>Entity</code> - * node subtree. However, the latter may not be true when an entity contains - * an unbound namespace prefix. In such a case, because the namespace prefix - * resolution depends on where the entity reference is, the descendants of - * the <code>EntityReference</code> node may be bound to different namespace - * URIs. When an <code>EntityReference</code> node represents a reference to - * an unknown entity, the node has no children and its replacement value, + * <code>EntityReference</code> nodes may be used to represent an entity + * reference in the tree. Note that character references and references to + * predefined entities are considered to be expanded by the HTML or XML + * processor so that characters are represented by their Unicode equivalent + * rather than by an entity reference. Moreover, the XML processor may + * completely expand references to entities while building the + * <code>Document</code>, instead of providing <code>EntityReference</code> + * nodes. If it does provide such nodes, then for an + * <code>EntityReference</code> node that represents a reference to a known + * entity an <code>Entity</code> exists, and the subtree of the + * <code>EntityReference</code> node is a copy of the <code>Entity</code> + * node subtree. However, the latter may not be true when an entity contains + * an unbound namespace prefix. In such a case, because the namespace prefix + * resolution depends on where the entity reference is, the descendants of + * the <code>EntityReference</code> node may be bound to different namespace + * URIs. When an <code>EntityReference</code> node represents a reference to + * an unknown entity, the node has no children and its replacement value, * when used by <code>Attr.value</code> for example, is empty. - * <p>As for <code>Entity</code> nodes, <code>EntityReference</code> nodes and + * <p>As for <code>Entity</code> nodes, <code>EntityReference</code> nodes and * all their descendants are readonly. - * <p ><b>Note:</b> <code>EntityReference</code> nodes may cause element - * content and attribute value normalization problems when, such as in XML - * 1.0 and XML Schema, the normalization is performed after entity reference + * <p ><b>Note:</b> <code>EntityReference</code> nodes may cause element + * content and attribute value normalization problems when, such as in XML + * 1.0 and XML Schema, the normalization is performed after entity reference * are expanded. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/NameList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/NameList.java index 10caa90f6a0..e94433f987b 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/NameList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/NameList.java @@ -13,56 +13,56 @@ package org.w3c.dom; /** - * The <code>NameList</code> interface provides the abstraction of an ordered - * collection of parallel pairs of name and namespace values (which could be - * null values), without defining or constraining how this collection is - * implemented. The items in the <code>NameList</code> are accessible via an - * integral index, starting from 0. + * The <code>NameList</code> interface provides the abstraction of an ordered + * collection of parallel pairs of name and namespace values (which could be + * null values), without defining or constraining how this collection is + * implemented. The items in the <code>NameList</code> are accessible via an + * integral index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface NameList { /** - * Returns the <code>index</code>th name item in the collection. + * Returns the <code>index</code>th name item in the collection. * @param index Index into the collection. - * @return The name at the <code>index</code>th position in the - * <code>NameList</code>, or <code>null</code> if there is no name for - * the specified index or if the index is out of range. + * @return The name at the <code>index</code>th position in the + * <code>NameList</code>, or <code>null</code> if there is no name for + * the specified index or if the index is out of range. */ public String getName(int index); /** - * Returns the <code>index</code>th namespaceURI item in the collection. + * Returns the <code>index</code>th namespaceURI item in the collection. * @param index Index into the collection. - * @return The namespace URI at the <code>index</code>th position in the - * <code>NameList</code>, or <code>null</code> if there is no name for - * the specified index or if the index is out of range. + * @return The namespace URI at the <code>index</code>th position in the + * <code>NameList</code>, or <code>null</code> if there is no name for + * the specified index or if the index is out of range. */ public String getNamespaceURI(int index); /** - * The number of pairs (name and namespaceURI) in the list. The range of - * valid child node indices is 0 to <code>length-1</code> inclusive. + * The number of pairs (name and namespaceURI) in the list. The range of + * valid child node indices is 0 to <code>length-1</code> inclusive. */ public int getLength(); /** - * Test if a name is part of this <code>NameList</code>. - * @param str The name to look for. - * @return <code>true</code> if the name has been found, - * <code>false</code> otherwise. + * Test if a name is part of this <code>NameList</code>. + * @param str The name to look for. + * @return <code>true</code> if the name has been found, + * <code>false</code> otherwise. */ public boolean contains(String str); /** - * Test if the pair namespaceURI/name is part of this - * <code>NameList</code>. - * @param namespaceURI The namespace URI to look for. - * @param name The name to look for. - * @return <code>true</code> if the pair namespaceURI/name has been - * found, <code>false</code> otherwise. + * Test if the pair namespaceURI/name is part of this + * <code>NameList</code>. + * @param namespaceURI The namespace URI to look for. + * @param name The name to look for. + * @return <code>true</code> if the pair namespaceURI/name has been + * found, <code>false</code> otherwise. */ - public boolean containsNS(String namespaceURI, + public boolean containsNS(String namespaceURI, String name); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/NamedNodeMap.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/NamedNodeMap.java index ad1e67bcdeb..d74ace7a3e9 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/NamedNodeMap.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/NamedNodeMap.java @@ -13,14 +13,14 @@ package org.w3c.dom; /** - * Objects implementing the <code>NamedNodeMap</code> interface are used to - * represent collections of nodes that can be accessed by name. Note that - * <code>NamedNodeMap</code> does not inherit from <code>NodeList</code>; - * <code>NamedNodeMaps</code> are not maintained in any particular order. - * Objects contained in an object implementing <code>NamedNodeMap</code> may - * also be accessed by an ordinal index, but this is simply to allow - * convenient enumeration of the contents of a <code>NamedNodeMap</code>, - * and does not imply that the DOM specifies an order to these Nodes. + * Objects implementing the <code>NamedNodeMap</code> interface are used to + * represent collections of nodes that can be accessed by name. Note that + * <code>NamedNodeMap</code> does not inherit from <code>NodeList</code>; + * <code>NamedNodeMaps</code> are not maintained in any particular order. + * Objects contained in an object implementing <code>NamedNodeMap</code> may + * also be accessed by an ordinal index, but this is simply to allow + * convenient enumeration of the contents of a <code>NamedNodeMap</code>, + * and does not imply that the DOM specifies an order to these Nodes. * <p><code>NamedNodeMap</code> objects in the DOM are live. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ @@ -28,54 +28,54 @@ public interface NamedNodeMap { /** * Retrieves a node specified by name. * @param name The <code>nodeName</code> of a node to retrieve. - * @return A <code>Node</code> (of any type) with the specified - * <code>nodeName</code>, or <code>null</code> if it does not identify + * @return A <code>Node</code> (of any type) with the specified + * <code>nodeName</code>, or <code>null</code> if it does not identify * any node in this map. */ public Node getNamedItem(String name); /** - * Adds a node using its <code>nodeName</code> attribute. If a node with - * that name is already present in this map, it is replaced by the new + * Adds a node using its <code>nodeName</code> attribute. If a node with + * that name is already present in this map, it is replaced by the new * one. Replacing a node by itself has no effect. - * <br>As the <code>nodeName</code> attribute is used to derive the name - * which the node must be stored under, multiple nodes of certain types - * (those that have a "special" string value) cannot be stored as the - * names would clash. This is seen as preferable to allowing nodes to be + * <br>As the <code>nodeName</code> attribute is used to derive the name + * which the node must be stored under, multiple nodes of certain types + * (those that have a "special" string value) cannot be stored as the + * names would clash. This is seen as preferable to allowing nodes to be * aliased. - * @param arg A node to store in this map. The node will later be + * @param arg A node to store in this map. The node will later be * accessible using the value of its <code>nodeName</code> attribute. - * @return If the new <code>Node</code> replaces an existing node the - * replaced <code>Node</code> is returned, otherwise <code>null</code> + * @return If the new <code>Node</code> replaces an existing node the + * replaced <code>Node</code> is returned, otherwise <code>null</code> * is returned. * @exception DOMException - * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a + * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a * different document than the one that created this map. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly. - * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an - * <code>Attr</code> that is already an attribute of another - * <code>Element</code> object. The DOM user must explicitly clone + * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an + * <code>Attr</code> that is already an attribute of another + * <code>Element</code> object. The DOM user must explicitly clone * <code>Attr</code> nodes to re-use them in other elements. - * <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node - * doesn't belong in this NamedNodeMap. Examples would include trying - * to insert something other than an Attr node into an Element's map - * of attributes, or a non-Entity node into the DocumentType's map of + * <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node + * doesn't belong in this NamedNodeMap. Examples would include trying + * to insert something other than an Attr node into an Element's map + * of attributes, or a non-Entity node into the DocumentType's map of * Entities. */ public Node setNamedItem(Node arg) throws DOMException; /** - * Removes a node specified by name. When this map contains the attributes - * attached to an element, if the removed attribute is known to have a - * default value, an attribute immediately appears containing the - * default value as well as the corresponding namespace URI, local name, + * Removes a node specified by name. When this map contains the attributes + * attached to an element, if the removed attribute is known to have a + * default value, an attribute immediately appears containing the + * default value as well as the corresponding namespace URI, local name, * and prefix when applicable. * @param name The <code>nodeName</code> of the node to remove. - * @return The node removed from this map if a node with such a name + * @return The node removed from this map if a node with such a name * exists. * @exception DOMException - * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in + * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in * this map. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly. */ @@ -83,17 +83,17 @@ public interface NamedNodeMap { throws DOMException; /** - * Returns the <code>index</code>th item in the map. If <code>index</code> - * is greater than or equal to the number of nodes in this map, this + * Returns the <code>index</code>th item in the map. If <code>index</code> + * is greater than or equal to the number of nodes in this map, this * returns <code>null</code>. * @param index Index into this map. - * @return The node at the <code>index</code>th position in the map, or + * @return The node at the <code>index</code>th position in the map, or * <code>null</code> if that is not a valid index. */ public Node item(int index); /** - * The number of nodes in this map. The range of valid child node indices + * The number of nodes in this map. The range of valid child node indices * is <code>0</code> to <code>length-1</code> inclusive. */ public int getLength(); @@ -101,82 +101,82 @@ public interface NamedNodeMap { /** * Retrieves a node specified by local name and namespace URI. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value null as the namespaceURI parameter + * , applications must use the value null as the namespaceURI parameter * for methods if they wish to have no namespace. * @param namespaceURI The namespace URI of the node to retrieve. * @param localName The local name of the node to retrieve. - * @return A <code>Node</code> (of any type) with the specified local - * name and namespace URI, or <code>null</code> if they do not + * @return A <code>Node</code> (of any type) with the specified local + * name and namespace URI, or <code>null</code> if they do not * identify any node in this map. * @exception DOMException - * NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature "XML" and the language exposed through the - * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature "XML" and the language exposed through the + * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public Node getNamedItemNS(String namespaceURI, + public Node getNamedItemNS(String namespaceURI, String localName) throws DOMException; /** - * Adds a node using its <code>namespaceURI</code> and - * <code>localName</code>. If a node with that namespace URI and that - * local name is already present in this map, it is replaced by the new + * Adds a node using its <code>namespaceURI</code> and + * <code>localName</code>. If a node with that namespace URI and that + * local name is already present in this map, it is replaced by the new * one. Replacing a node by itself has no effect. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value null as the namespaceURI parameter + * , applications must use the value null as the namespaceURI parameter * for methods if they wish to have no namespace. - * @param arg A node to store in this map. The node will later be - * accessible using the value of its <code>namespaceURI</code> and + * @param arg A node to store in this map. The node will later be + * accessible using the value of its <code>namespaceURI</code> and * <code>localName</code> attributes. - * @return If the new <code>Node</code> replaces an existing node the - * replaced <code>Node</code> is returned, otherwise <code>null</code> + * @return If the new <code>Node</code> replaces an existing node the + * replaced <code>Node</code> is returned, otherwise <code>null</code> * is returned. * @exception DOMException - * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a + * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a * different document than the one that created this map. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly. - * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an - * <code>Attr</code> that is already an attribute of another - * <code>Element</code> object. The DOM user must explicitly clone + * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an + * <code>Attr</code> that is already an attribute of another + * <code>Element</code> object. The DOM user must explicitly clone * <code>Attr</code> nodes to re-use them in other elements. - * <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node - * doesn't belong in this NamedNodeMap. Examples would include trying - * to insert something other than an Attr node into an Element's map - * of attributes, or a non-Entity node into the DocumentType's map of + * <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node + * doesn't belong in this NamedNodeMap. Examples would include trying + * to insert something other than an Attr node into an Element's map + * of attributes, or a non-Entity node into the DocumentType's map of * Entities. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature "XML" and the language exposed through the - * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature "XML" and the language exposed through the + * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ public Node setNamedItemNS(Node arg) throws DOMException; /** - * Removes a node specified by local name and namespace URI. A removed - * attribute may be known to have a default value when this map contains - * the attributes attached to an element, as returned by the attributes - * attribute of the <code>Node</code> interface. If so, an attribute - * immediately appears containing the default value as well as the + * Removes a node specified by local name and namespace URI. A removed + * attribute may be known to have a default value when this map contains + * the attributes attached to an element, as returned by the attributes + * attribute of the <code>Node</code> interface. If so, an attribute + * immediately appears containing the default value as well as the * corresponding namespace URI, local name, and prefix when applicable. * <br>Per [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * , applications must use the value null as the namespaceURI parameter + * , applications must use the value null as the namespaceURI parameter * for methods if they wish to have no namespace. * @param namespaceURI The namespace URI of the node to remove. * @param localName The local name of the node to remove. - * @return The node removed from this map if a node with such a local + * @return The node removed from this map if a node with such a local * name and namespace URI exists. * @exception DOMException - * NOT_FOUND_ERR: Raised if there is no node with the specified + * NOT_FOUND_ERR: Raised if there is no node with the specified * <code>namespaceURI</code> and <code>localName</code> in this map. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly. - * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not - * support the feature "XML" and the language exposed through the - * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). + * <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not + * support the feature "XML" and the language exposed through the + * Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]). * @since DOM Level 2 */ - public Node removeNamedItemNS(String namespaceURI, + public Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Node.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Node.java index 989d49a2ea0..c9a6d00984e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Node.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Node.java @@ -13,25 +13,25 @@ package org.w3c.dom; /** - * The <code>Node</code> interface is the primary datatype for the entire - * Document Object Model. It represents a single node in the document tree. - * While all objects implementing the <code>Node</code> interface expose - * methods for dealing with children, not all objects implementing the - * <code>Node</code> interface may have children. For example, - * <code>Text</code> nodes may not have children, and adding children to + * The <code>Node</code> interface is the primary datatype for the entire + * Document Object Model. It represents a single node in the document tree. + * While all objects implementing the <code>Node</code> interface expose + * methods for dealing with children, not all objects implementing the + * <code>Node</code> interface may have children. For example, + * <code>Text</code> nodes may not have children, and adding children to * such nodes results in a <code>DOMException</code> being raised. - * <p>The attributes <code>nodeName</code>, <code>nodeValue</code> and - * <code>attributes</code> are included as a mechanism to get at node - * information without casting down to the specific derived interface. In - * cases where there is no obvious mapping of these attributes for a - * specific <code>nodeType</code> (e.g., <code>nodeValue</code> for an + * <p>The attributes <code>nodeName</code>, <code>nodeValue</code> and + * <code>attributes</code> are included as a mechanism to get at node + * information without casting down to the specific derived interface. In + * cases where there is no obvious mapping of these attributes for a + * specific <code>nodeType</code> (e.g., <code>nodeValue</code> for an * <code>Element</code> or <code>attributes</code> for a <code>Comment</code> - * ), this returns <code>null</code>. Note that the specialized interfaces - * may contain additional and more convenient mechanisms to get and set the + * ), this returns <code>null</code>. Note that the specialized interfaces + * may contain additional and more convenient mechanisms to get and set the * relevant information. - * <p>The values of <code>nodeName</code>, - * <code>nodeValue</code>, and <code>attributes</code> vary according to the - * node type as follows: + * <p>The values of <code>nodeName</code>, + * <code>nodeValue</code>, and <code>attributes</code> vary according to the + * node type as follows: * <table border='1' cellpadding='3'> * <tr> * <th>Interface</th> @@ -43,7 +43,7 @@ package org.w3c.dom; * <td valign='top' rowspan='1' colspan='1'> * <code>Attr</code></td> * <td valign='top' rowspan='1' colspan='1'>same as <code>Attr.name</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as + * <td valign='top' rowspan='1' colspan='1'>same as * <code>Attr.value</code></td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * </tr> @@ -51,7 +51,7 @@ package org.w3c.dom; * <td valign='top' rowspan='1' colspan='1'><code>CDATASection</code></td> * <td valign='top' rowspan='1' colspan='1'> * <code>"#cdata-section"</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the + * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the * content of the CDATA Section</td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * </tr> @@ -59,7 +59,7 @@ package org.w3c.dom; * <td valign='top' rowspan='1' colspan='1'><code>Comment</code></td> * <td valign='top' rowspan='1' colspan='1'> * <code>"#comment"</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the + * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the * content of the comment</td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * </tr> @@ -80,7 +80,7 @@ package org.w3c.dom; * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>DocumentType</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as + * <td valign='top' rowspan='1' colspan='1'>same as * <code>DocumentType.name</code></td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> @@ -116,9 +116,9 @@ package org.w3c.dom; * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'><code>ProcessingInstruction</code></td> - * <td valign='top' rowspan='1' colspan='1'>same + * <td valign='top' rowspan='1' colspan='1'>same * as <code>ProcessingInstruction.target</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as + * <td valign='top' rowspan='1' colspan='1'>same as * <code>ProcessingInstruction.data</code></td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * </tr> @@ -126,11 +126,11 @@ package org.w3c.dom; * <td valign='top' rowspan='1' colspan='1'><code>Text</code></td> * <td valign='top' rowspan='1' colspan='1'> * <code>"#text"</code></td> - * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the content + * <td valign='top' rowspan='1' colspan='1'>same as <code>CharacterData.data</code>, the content * of the text node</td> * <td valign='top' rowspan='1' colspan='1'><code>null</code></td> * </tr> - * </table> + * </table> * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Node { @@ -190,22 +190,22 @@ public interface Node { public String getNodeName(); /** - * The value of this node, depending on its type; see the table above. - * When it is defined to be <code>null</code>, setting it has no effect, + * The value of this node, depending on its type; see the table above. + * When it is defined to be <code>null</code>, setting it has no effect, * including if the node is read-only. * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised when it would return more characters than - * fit in a <code>DOMString</code> variable on the implementation + * DOMSTRING_SIZE_ERR: Raised when it would return more characters than + * fit in a <code>DOMString</code> variable on the implementation * platform. */ public String getNodeValue() throws DOMException; /** - * The value of this node, depending on its type; see the table above. - * When it is defined to be <code>null</code>, setting it has no effect, + * The value of this node, depending on its type; see the table above. + * When it is defined to be <code>null</code>, setting it has no effect, * including if the node is read-only. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly and if + * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly and if * it is not defined to be <code>null</code>. */ public void setNodeValue(String nodeValue) @@ -217,148 +217,148 @@ public interface Node { public short getNodeType(); /** - * The parent of this node. All nodes, except <code>Attr</code>, - * <code>Document</code>, <code>DocumentFragment</code>, - * <code>Entity</code>, and <code>Notation</code> may have a parent. - * However, if a node has just been created and not yet added to the - * tree, or if it has been removed from the tree, this is - * <code>null</code>. + * The parent of this node. All nodes, except <code>Attr</code>, + * <code>Document</code>, <code>DocumentFragment</code>, + * <code>Entity</code>, and <code>Notation</code> may have a parent. + * However, if a node has just been created and not yet added to the + * tree, or if it has been removed from the tree, this is + * <code>null</code>. */ public Node getParentNode(); /** - * A <code>NodeList</code> that contains all children of this node. If - * there are no children, this is a <code>NodeList</code> containing no + * A <code>NodeList</code> that contains all children of this node. If + * there are no children, this is a <code>NodeList</code> containing no * nodes. */ public NodeList getChildNodes(); /** - * The first child of this node. If there is no such node, this returns + * The first child of this node. If there is no such node, this returns * <code>null</code>. */ public Node getFirstChild(); /** - * The last child of this node. If there is no such node, this returns + * The last child of this node. If there is no such node, this returns * <code>null</code>. */ public Node getLastChild(); /** - * The node immediately preceding this node. If there is no such node, + * The node immediately preceding this node. If there is no such node, * this returns <code>null</code>. */ public Node getPreviousSibling(); /** - * The node immediately following this node. If there is no such node, + * The node immediately following this node. If there is no such node, * this returns <code>null</code>. */ public Node getNextSibling(); /** - * A <code>NamedNodeMap</code> containing the attributes of this node (if + * A <code>NamedNodeMap</code> containing the attributes of this node (if * it is an <code>Element</code>) or <code>null</code> otherwise. */ public NamedNodeMap getAttributes(); /** - * The <code>Document</code> object associated with this node. This is - * also the <code>Document</code> object used to create new nodes. When - * this node is a <code>Document</code> or a <code>DocumentType</code> - * which is not used with any <code>Document</code> yet, this is + * The <code>Document</code> object associated with this node. This is + * also the <code>Document</code> object used to create new nodes. When + * this node is a <code>Document</code> or a <code>DocumentType</code> + * which is not used with any <code>Document</code> yet, this is * <code>null</code>. * @version DOM Level 2 */ public Document getOwnerDocument(); /** - * Inserts the node <code>newChild</code> before the existing child node - * <code>refChild</code>. If <code>refChild</code> is <code>null</code>, + * Inserts the node <code>newChild</code> before the existing child node + * <code>refChild</code>. If <code>refChild</code> is <code>null</code>, * insert <code>newChild</code> at the end of the list of children. - * <br>If <code>newChild</code> is a <code>DocumentFragment</code> object, - * all of its children are inserted, in the same order, before - * <code>refChild</code>. If the <code>newChild</code> is already in the + * <br>If <code>newChild</code> is a <code>DocumentFragment</code> object, + * all of its children are inserted, in the same order, before + * <code>refChild</code>. If the <code>newChild</code> is already in the * tree, it is first removed. - * <p ><b>Note:</b> Inserting a node before itself is implementation - * dependent. + * <p ><b>Note:</b> Inserting a node before itself is implementation + * dependent. * @param newChild The node to insert. - * @param refChild The reference node, i.e., the node before which the + * @param refChild The reference node, i.e., the node before which the * new node must be inserted. * @return The node being inserted. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not - * allow children of the type of the <code>newChild</code> node, or if - * the node to insert is one of this node's ancestors or this node - * itself, or if this node is of type <code>Document</code> and the - * DOM application attempts to insert a second + * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not + * allow children of the type of the <code>newChild</code> node, or if + * the node to insert is one of this node's ancestors or this node + * itself, or if this node is of type <code>Document</code> and the + * DOM application attempts to insert a second * <code>DocumentType</code> or <code>Element</code> node. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * from a different document than the one that created this node. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or * if the parent of the node being inserted is readonly. - * <br>NOT_FOUND_ERR: Raised if <code>refChild</code> is not a child of + * <br>NOT_FOUND_ERR: Raised if <code>refChild</code> is not a child of * this node. - * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, - * this exception might be raised if the DOM implementation doesn't - * support the insertion of a <code>DocumentType</code> or + * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, + * this exception might be raised if the DOM implementation doesn't + * support the insertion of a <code>DocumentType</code> or * <code>Element</code> node. * @version DOM Level 3 */ - public Node insertBefore(Node newChild, + public Node insertBefore(Node newChild, Node refChild) throws DOMException; /** * Replaces the child node <code>oldChild</code> with <code>newChild</code> * in the list of children, and returns the <code>oldChild</code> node. - * <br>If <code>newChild</code> is a <code>DocumentFragment</code> object, - * <code>oldChild</code> is replaced by all of the - * <code>DocumentFragment</code> children, which are inserted in the - * same order. If the <code>newChild</code> is already in the tree, it + * <br>If <code>newChild</code> is a <code>DocumentFragment</code> object, + * <code>oldChild</code> is replaced by all of the + * <code>DocumentFragment</code> children, which are inserted in the + * same order. If the <code>newChild</code> is already in the tree, it * is first removed. - * <p ><b>Note:</b> Replacing a node with itself is implementation - * dependent. + * <p ><b>Note:</b> Replacing a node with itself is implementation + * dependent. * @param newChild The new node to put in the child list. * @param oldChild The node being replaced in the list. * @return The node replaced. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not - * allow children of the type of the <code>newChild</code> node, or if - * the node to put in is one of this node's ancestors or this node - * itself, or if this node is of type <code>Document</code> and the - * result of the replacement operation would add a second - * <code>DocumentType</code> or <code>Element</code> on the + * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not + * allow children of the type of the <code>newChild</code> node, or if + * the node to put in is one of this node's ancestors or this node + * itself, or if this node is of type <code>Document</code> and the + * result of the replacement operation would add a second + * <code>DocumentType</code> or <code>Element</code> on the * <code>Document</code> node. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * from a different document than the one that created this node. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of * the new node is readonly. - * <br>NOT_FOUND_ERR: Raised if <code>oldChild</code> is not a child of + * <br>NOT_FOUND_ERR: Raised if <code>oldChild</code> is not a child of * this node. - * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, - * this exception might be raised if the DOM implementation doesn't - * support the replacement of the <code>DocumentType</code> child or + * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, + * this exception might be raised if the DOM implementation doesn't + * support the replacement of the <code>DocumentType</code> child or * <code>Element</code> child. * @version DOM Level 3 */ - public Node replaceChild(Node newChild, + public Node replaceChild(Node newChild, Node oldChild) throws DOMException; /** - * Removes the child node indicated by <code>oldChild</code> from the list + * Removes the child node indicated by <code>oldChild</code> from the list * of children, and returns it. * @param oldChild The node being removed. * @return The node removed. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NOT_FOUND_ERR: Raised if <code>oldChild</code> is not a child of + * <br>NOT_FOUND_ERR: Raised if <code>oldChild</code> is not a child of * this node. - * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, - * this exception might be raised if the DOM implementation doesn't - * support the removal of the <code>DocumentType</code> child or the + * <br>NOT_SUPPORTED_ERR: if this node is of type <code>Document</code>, + * this exception might be raised if the DOM implementation doesn't + * support the removal of the <code>DocumentType</code> child or the * <code>Element</code> child. * @version DOM Level 3 */ @@ -366,27 +366,27 @@ public interface Node { throws DOMException; /** - * Adds the node <code>newChild</code> to the end of the list of children - * of this node. If the <code>newChild</code> is already in the tree, it + * Adds the node <code>newChild</code> to the end of the list of children + * of this node. If the <code>newChild</code> is already in the tree, it * is first removed. - * @param newChild The node to add.If it is a - * <code>DocumentFragment</code> object, the entire contents of the + * @param newChild The node to add.If it is a + * <code>DocumentFragment</code> object, the entire contents of the * document fragment are moved into the child list of this node * @return The node added. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not - * allow children of the type of the <code>newChild</code> node, or if - * the node to append is one of this node's ancestors or this node - * itself, or if this node is of type <code>Document</code> and the - * DOM application attempts to append a second + * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not + * allow children of the type of the <code>newChild</code> node, or if + * the node to append is one of this node's ancestors or this node + * itself, or if this node is of type <code>Document</code> and the + * DOM application attempts to append a second * <code>DocumentType</code> or <code>Element</code> node. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * from a different document than the one that created this node. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or * if the previous parent of the node being inserted is readonly. - * <br>NOT_SUPPORTED_ERR: if the <code>newChild</code> node is a child - * of the <code>Document</code> node, this exception might be raised - * if the DOM implementation doesn't support the removal of the + * <br>NOT_SUPPORTED_ERR: if the <code>newChild</code> node is a child + * of the <code>Document</code> node, this exception might be raised + * if the DOM implementation doesn't support the removal of the * <code>DocumentType</code> child or <code>Element</code> child. * @version DOM Level 3 */ @@ -395,154 +395,154 @@ public interface Node { /** * Returns whether this node has any children. - * @return Returns <code>true</code> if this node has any children, + * @return Returns <code>true</code> if this node has any children, * <code>false</code> otherwise. */ public boolean hasChildNodes(); /** - * Returns a duplicate of this node, i.e., serves as a generic copy + * Returns a duplicate of this node, i.e., serves as a generic copy * constructor for nodes. The duplicate node has no parent ( - * <code>parentNode</code> is <code>null</code>) and no user data. User - * data associated to the imported node is not carried over. However, if - * any <code>UserDataHandlers</code> has been specified along with the - * associated data these handlers will be called with the appropriate + * <code>parentNode</code> is <code>null</code>) and no user data. User + * data associated to the imported node is not carried over. However, if + * any <code>UserDataHandlers</code> has been specified along with the + * associated data these handlers will be called with the appropriate * parameters before this method returns. - * <br>Cloning an <code>Element</code> copies all attributes and their - * values, including those generated by the XML processor to represent - * defaulted attributes, but this method does not copy any children it - * contains unless it is a deep clone. This includes text contained in - * an the <code>Element</code> since the text is contained in a child - * <code>Text</code> node. Cloning an <code>Attr</code> directly, as - * opposed to be cloned as part of an <code>Element</code> cloning - * operation, returns a specified attribute (<code>specified</code> is - * <code>true</code>). Cloning an <code>Attr</code> always clones its - * children, since they represent its value, no matter whether this is a - * deep clone or not. Cloning an <code>EntityReference</code> - * automatically constructs its subtree if a corresponding - * <code>Entity</code> is available, no matter whether this is a deep - * clone or not. Cloning any other type of node simply returns a copy of + * <br>Cloning an <code>Element</code> copies all attributes and their + * values, including those generated by the XML processor to represent + * defaulted attributes, but this method does not copy any children it + * contains unless it is a deep clone. This includes text contained in + * an the <code>Element</code> since the text is contained in a child + * <code>Text</code> node. Cloning an <code>Attr</code> directly, as + * opposed to be cloned as part of an <code>Element</code> cloning + * operation, returns a specified attribute (<code>specified</code> is + * <code>true</code>). Cloning an <code>Attr</code> always clones its + * children, since they represent its value, no matter whether this is a + * deep clone or not. Cloning an <code>EntityReference</code> + * automatically constructs its subtree if a corresponding + * <code>Entity</code> is available, no matter whether this is a deep + * clone or not. Cloning any other type of node simply returns a copy of * this node. - * <br>Note that cloning an immutable subtree results in a mutable copy, + * <br>Note that cloning an immutable subtree results in a mutable copy, * but the children of an <code>EntityReference</code> clone are readonly - * . In addition, clones of unspecified <code>Attr</code> nodes are - * specified. And, cloning <code>Document</code>, - * <code>DocumentType</code>, <code>Entity</code>, and + * . In addition, clones of unspecified <code>Attr</code> nodes are + * specified. And, cloning <code>Document</code>, + * <code>DocumentType</code>, <code>Entity</code>, and * <code>Notation</code> nodes is implementation dependent. - * @param deep If <code>true</code>, recursively clone the subtree under - * the specified node; if <code>false</code>, clone only the node + * @param deep If <code>true</code>, recursively clone the subtree under + * the specified node; if <code>false</code>, clone only the node * itself (and its attributes, if it is an <code>Element</code>). * @return The duplicate node. */ public Node cloneNode(boolean deep); /** - * Puts all <code>Text</code> nodes in the full depth of the sub-tree - * underneath this <code>Node</code>, including attribute nodes, into a - * "normal" form where only structure (e.g., elements, comments, - * processing instructions, CDATA sections, and entity references) - * separates <code>Text</code> nodes, i.e., there are neither adjacent - * <code>Text</code> nodes nor empty <code>Text</code> nodes. This can - * be used to ensure that the DOM view of a document is the same as if - * it were saved and re-loaded, and is useful when operations (such as + * Puts all <code>Text</code> nodes in the full depth of the sub-tree + * underneath this <code>Node</code>, including attribute nodes, into a + * "normal" form where only structure (e.g., elements, comments, + * processing instructions, CDATA sections, and entity references) + * separates <code>Text</code> nodes, i.e., there are neither adjacent + * <code>Text</code> nodes nor empty <code>Text</code> nodes. This can + * be used to ensure that the DOM view of a document is the same as if + * it were saved and re-loaded, and is useful when operations (such as * XPointer [<a href='http://www.w3.org/TR/2003/REC-xptr-framework-20030325/'>XPointer</a>] - * lookups) that depend on a particular document tree structure are to - * be used. If the parameter "normalize-characters" of the - * <code>DOMConfiguration</code> object attached to the - * <code>Node.ownerDocument</code> is <code>true</code>, this method - * will also fully normalize the characters of the <code>Text</code> - * nodes. - * <p ><b>Note:</b> In cases where the document contains - * <code>CDATASections</code>, the normalize operation alone may not be - * sufficient, since XPointers do not differentiate between + * lookups) that depend on a particular document tree structure are to + * be used. If the parameter "normalize-characters" of the + * <code>DOMConfiguration</code> object attached to the + * <code>Node.ownerDocument</code> is <code>true</code>, this method + * will also fully normalize the characters of the <code>Text</code> + * nodes. + * <p ><b>Note:</b> In cases where the document contains + * <code>CDATASections</code>, the normalize operation alone may not be + * sufficient, since XPointers do not differentiate between * <code>Text</code> nodes and <code>CDATASection</code> nodes. * @version DOM Level 3 */ public void normalize(); /** - * Tests whether the DOM implementation implements a specific feature and - * that feature is supported by this node, as specified in . - * @param feature The name of the feature to test. - * @param version This is the version number of the feature to test. - * @return Returns <code>true</code> if the specified feature is + * Tests whether the DOM implementation implements a specific feature and + * that feature is supported by this node, as specified in . + * @param feature The name of the feature to test. + * @param version This is the version number of the feature to test. + * @return Returns <code>true</code> if the specified feature is * supported on this node, <code>false</code> otherwise. * @since DOM Level 2 */ - public boolean isSupported(String feature, + public boolean isSupported(String feature, String version); /** - * The namespace URI of this node, or <code>null</code> if it is + * The namespace URI of this node, or <code>null</code> if it is * unspecified (see ). - * <br>This is not a computed value that is the result of a namespace - * lookup based on an examination of the namespace declarations in + * <br>This is not a computed value that is the result of a namespace + * lookup based on an examination of the namespace declarations in * scope. It is merely the namespace URI given at creation time. - * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and - * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 - * method, such as <code>Document.createElement()</code>, this is always + * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and + * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 + * method, such as <code>Document.createElement()</code>, this is always * <code>null</code>. * <p ><b>Note:</b> Per the <em>Namespaces in XML</em> Specification [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] - * an attribute does not inherit its namespace from the element it is - * attached to. If an attribute is not explicitly given a namespace, it + * an attribute does not inherit its namespace from the element it is + * attached to. If an attribute is not explicitly given a namespace, it * simply has no namespace. * @since DOM Level 2 */ public String getNamespaceURI(); /** - * The namespace prefix of this node, or <code>null</code> if it is - * unspecified. When it is defined to be <code>null</code>, setting it + * The namespace prefix of this node, or <code>null</code> if it is + * unspecified. When it is defined to be <code>null</code>, setting it * has no effect, including if the node is read-only. - * <br>Note that setting this attribute, when permitted, changes the - * <code>nodeName</code> attribute, which holds the qualified name, as - * well as the <code>tagName</code> and <code>name</code> attributes of - * the <code>Element</code> and <code>Attr</code> interfaces, when + * <br>Note that setting this attribute, when permitted, changes the + * <code>nodeName</code> attribute, which holds the qualified name, as + * well as the <code>tagName</code> and <code>name</code> attributes of + * the <code>Element</code> and <code>Attr</code> interfaces, when * applicable. - * <br>Setting the prefix to <code>null</code> makes it unspecified, + * <br>Setting the prefix to <code>null</code> makes it unspecified, * setting it to an empty string is implementation dependent. - * <br>Note also that changing the prefix of an attribute that is known to - * have a default value, does not make a new attribute with the default - * value and the original prefix appear, since the + * <br>Note also that changing the prefix of an attribute that is known to + * have a default value, does not make a new attribute with the default + * value and the original prefix appear, since the * <code>namespaceURI</code> and <code>localName</code> do not change. - * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and - * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 - * method, such as <code>createElement</code> from the + * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and + * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 + * method, such as <code>createElement</code> from the * <code>Document</code> interface, this is always <code>null</code>. * @since DOM Level 2 */ public String getPrefix(); /** - * The namespace prefix of this node, or <code>null</code> if it is - * unspecified. When it is defined to be <code>null</code>, setting it + * The namespace prefix of this node, or <code>null</code> if it is + * unspecified. When it is defined to be <code>null</code>, setting it * has no effect, including if the node is read-only. - * <br>Note that setting this attribute, when permitted, changes the - * <code>nodeName</code> attribute, which holds the qualified name, as - * well as the <code>tagName</code> and <code>name</code> attributes of - * the <code>Element</code> and <code>Attr</code> interfaces, when + * <br>Note that setting this attribute, when permitted, changes the + * <code>nodeName</code> attribute, which holds the qualified name, as + * well as the <code>tagName</code> and <code>name</code> attributes of + * the <code>Element</code> and <code>Attr</code> interfaces, when * applicable. - * <br>Setting the prefix to <code>null</code> makes it unspecified, + * <br>Setting the prefix to <code>null</code> makes it unspecified, * setting it to an empty string is implementation dependent. - * <br>Note also that changing the prefix of an attribute that is known to - * have a default value, does not make a new attribute with the default - * value and the original prefix appear, since the + * <br>Note also that changing the prefix of an attribute that is known to + * have a default value, does not make a new attribute with the default + * value and the original prefix appear, since the * <code>namespaceURI</code> and <code>localName</code> do not change. - * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and - * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 - * method, such as <code>createElement</code> from the + * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and + * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 + * method, such as <code>createElement</code> from the * <code>Document</code> interface, this is always <code>null</code>. * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an - * illegal character according to the XML version in use specified in + * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an + * illegal character according to the XML version in use specified in * the <code>Document.xmlVersion</code> attribute. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - * <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is - * malformed per the Namespaces in XML specification, if the - * <code>namespaceURI</code> of this node is <code>null</code>, if the - * specified prefix is "xml" and the <code>namespaceURI</code> of this + * <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is + * malformed per the Namespaces in XML specification, if the + * <code>namespaceURI</code> of this node is <code>null</code>, if the + * specified prefix is "xml" and the <code>namespaceURI</code> of this * node is different from "<a href='http://www.w3.org/XML/1998/namespace'> - * http://www.w3.org/XML/1998/namespace</a>", if this node is an attribute and the specified prefix is "xmlns" and - * the <code>namespaceURI</code> of this node is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if this node is an attribute and the <code>qualifiedName</code> of + * http://www.w3.org/XML/1998/namespace</a>", if this node is an attribute and the specified prefix is "xmlns" and + * the <code>namespaceURI</code> of this node is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if this node is an attribute and the <code>qualifiedName</code> of * this node is "xmlns" [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] * . * @since DOM Level 2 @@ -552,9 +552,9 @@ public interface Node { /** * Returns the local part of the qualified name of this node. - * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and - * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 - * method, such as <code>Document.createElement()</code>, this is always + * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and + * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 + * method, such as <code>Document.createElement()</code>, this is always * <code>null</code>. * @since DOM Level 2 */ @@ -562,20 +562,20 @@ public interface Node { /** * Returns whether this node (if it is an element) has any attributes. - * @return Returns <code>true</code> if this node has any attributes, + * @return Returns <code>true</code> if this node has any attributes, * <code>false</code> otherwise. * @since DOM Level 2 */ public boolean hasAttributes(); /** - * The absolute base URI of this node or <code>null</code> if the - * implementation wasn't able to obtain an absolute URI. This value is - * computed as described in . However, when the <code>Document</code> + * The absolute base URI of this node or <code>null</code> if the + * implementation wasn't able to obtain an absolute URI. This value is + * computed as described in . However, when the <code>Document</code> * supports the feature "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>] - * , the base URI is computed using first the value of the href - * attribute of the HTML BASE element if any, and the value of the - * <code>documentURI</code> attribute from the <code>Document</code> + * , the base URI is computed using first the value of the href + * attribute of the HTML BASE element if any, and the value of the + * <code>documentURI</code> attribute from the <code>Document</code> * interface otherwise. * @since DOM Level 3 */ @@ -583,7 +583,7 @@ public interface Node { // DocumentPosition /** - * The two nodes are disconnected. Order between disconnected nodes is + * The two nodes are disconnected. Order between disconnected nodes is * always implementation-specific. */ public static final short DOCUMENT_POSITION_DISCONNECTED = 0x01; @@ -596,32 +596,32 @@ public interface Node { */ public static final short DOCUMENT_POSITION_FOLLOWING = 0x04; /** - * The node contains the reference node. A node which contains is always + * The node contains the reference node. A node which contains is always * preceding, too. */ public static final short DOCUMENT_POSITION_CONTAINS = 0x08; /** - * The node is contained by the reference node. A node which is contained + * The node is contained by the reference node. A node which is contained * is always following, too. */ public static final short DOCUMENT_POSITION_CONTAINED_BY = 0x10; /** - * The determination of preceding versus following is + * The determination of preceding versus following is * implementation-specific. */ public static final short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20; /** - * Compares the reference node, i.e. the node on which this method is - * being called, with a node, i.e. the one passed as a parameter, with - * regard to their position in the document and according to the + * Compares the reference node, i.e. the node on which this method is + * being called, with a node, i.e. the one passed as a parameter, with + * regard to their position in the document and according to the * document order. * @param other The node to compare against the reference node. - * @return Returns how the node is positioned relatively to the reference + * @return Returns how the node is positioned relatively to the reference * node. * @exception DOMException - * NOT_SUPPORTED_ERR: when the compared nodes are from different DOM - * implementations that do not coordinate to return consistent + * NOT_SUPPORTED_ERR: when the compared nodes are from different DOM + * implementations that do not coordinate to return consistent * implementation-specific results. * @since DOM Level 3 */ @@ -629,21 +629,21 @@ public interface Node { throws DOMException; /** - * This attribute returns the text content of this node and its - * descendants. When it is defined to be <code>null</code>, setting it - * has no effect. On setting, any possible children this node may have - * are removed and, if it the new string is not empty or - * <code>null</code>, replaced by a single <code>Text</code> node - * containing the string this attribute is set to. - * <br> On getting, no serialization is performed, the returned string - * does not contain any markup. No whitespace normalization is performed - * and the returned string does not contain the white spaces in element - * content (see the attribute - * <code>Text.isElementContentWhitespace</code>). Similarly, on setting, - * no parsing is performed either, the input string is taken as pure - * textual content. - * <br>The string returned is made of the text content of this node - * depending on its type, as defined below: + * This attribute returns the text content of this node and its + * descendants. When it is defined to be <code>null</code>, setting it + * has no effect. On setting, any possible children this node may have + * are removed and, if it the new string is not empty or + * <code>null</code>, replaced by a single <code>Text</code> node + * containing the string this attribute is set to. + * <br> On getting, no serialization is performed, the returned string + * does not contain any markup. No whitespace normalization is performed + * and the returned string does not contain the white spaces in element + * content (see the attribute + * <code>Text.isElementContentWhitespace</code>). Similarly, on setting, + * no parsing is performed either, the input string is taken as pure + * textual content. + * <br>The string returned is made of the text content of this node + * depending on its type, as defined below: * <table border='1' cellpadding='3'> * <tr> * <th>Node type</th> @@ -651,48 +651,48 @@ public interface Node { * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'> - * ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, + * ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, * DOCUMENT_FRAGMENT_NODE</td> - * <td valign='top' rowspan='1' colspan='1'>concatenation of the <code>textContent</code> - * attribute value of every child node, excluding COMMENT_NODE and - * PROCESSING_INSTRUCTION_NODE nodes. This is the empty string if the + * <td valign='top' rowspan='1' colspan='1'>concatenation of the <code>textContent</code> + * attribute value of every child node, excluding COMMENT_NODE and + * PROCESSING_INSTRUCTION_NODE nodes. This is the empty string if the * node has no children.</td> * </tr> * <tr> - * <td valign='top' rowspan='1' colspan='1'>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, + * <td valign='top' rowspan='1' colspan='1'>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, * PROCESSING_INSTRUCTION_NODE</td> * <td valign='top' rowspan='1' colspan='1'><code>nodeValue</code></td> * </tr> * <tr> - * <td valign='top' rowspan='1' colspan='1'>DOCUMENT_NODE, + * <td valign='top' rowspan='1' colspan='1'>DOCUMENT_NODE, * DOCUMENT_TYPE_NODE, NOTATION_NODE</td> * <td valign='top' rowspan='1' colspan='1'><em>null</em></td> * </tr> * </table> * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised when it would return more characters than - * fit in a <code>DOMString</code> variable on the implementation + * DOMSTRING_SIZE_ERR: Raised when it would return more characters than + * fit in a <code>DOMString</code> variable on the implementation * platform. * @since DOM Level 3 */ public String getTextContent() throws DOMException; /** - * This attribute returns the text content of this node and its - * descendants. When it is defined to be <code>null</code>, setting it - * has no effect. On setting, any possible children this node may have - * are removed and, if it the new string is not empty or - * <code>null</code>, replaced by a single <code>Text</code> node - * containing the string this attribute is set to. - * <br> On getting, no serialization is performed, the returned string - * does not contain any markup. No whitespace normalization is performed - * and the returned string does not contain the white spaces in element - * content (see the attribute - * <code>Text.isElementContentWhitespace</code>). Similarly, on setting, - * no parsing is performed either, the input string is taken as pure - * textual content. - * <br>The string returned is made of the text content of this node - * depending on its type, as defined below: + * This attribute returns the text content of this node and its + * descendants. When it is defined to be <code>null</code>, setting it + * has no effect. On setting, any possible children this node may have + * are removed and, if it the new string is not empty or + * <code>null</code>, replaced by a single <code>Text</code> node + * containing the string this attribute is set to. + * <br> On getting, no serialization is performed, the returned string + * does not contain any markup. No whitespace normalization is performed + * and the returned string does not contain the white spaces in element + * content (see the attribute + * <code>Text.isElementContentWhitespace</code>). Similarly, on setting, + * no parsing is performed either, the input string is taken as pure + * textual content. + * <br>The string returned is made of the text content of this node + * depending on its type, as defined below: * <table border='1' cellpadding='3'> * <tr> * <th>Node type</th> @@ -700,20 +700,20 @@ public interface Node { * </tr> * <tr> * <td valign='top' rowspan='1' colspan='1'> - * ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, + * ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, * DOCUMENT_FRAGMENT_NODE</td> - * <td valign='top' rowspan='1' colspan='1'>concatenation of the <code>textContent</code> - * attribute value of every child node, excluding COMMENT_NODE and - * PROCESSING_INSTRUCTION_NODE nodes. This is the empty string if the + * <td valign='top' rowspan='1' colspan='1'>concatenation of the <code>textContent</code> + * attribute value of every child node, excluding COMMENT_NODE and + * PROCESSING_INSTRUCTION_NODE nodes. This is the empty string if the * node has no children.</td> * </tr> * <tr> - * <td valign='top' rowspan='1' colspan='1'>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, + * <td valign='top' rowspan='1' colspan='1'>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, * PROCESSING_INSTRUCTION_NODE</td> * <td valign='top' rowspan='1' colspan='1'><code>nodeValue</code></td> * </tr> * <tr> - * <td valign='top' rowspan='1' colspan='1'>DOCUMENT_NODE, + * <td valign='top' rowspan='1' colspan='1'>DOCUMENT_NODE, * DOCUMENT_TYPE_NODE, NOTATION_NODE</td> * <td valign='top' rowspan='1' colspan='1'><em>null</em></td> * </tr> @@ -727,53 +727,53 @@ public interface Node { /** * Returns whether this node is the same node as the given one. - * <br>This method provides a way to determine whether two - * <code>Node</code> references returned by the implementation reference - * the same object. When two <code>Node</code> references are references - * to the same object, even if through a proxy, the references may be - * used completely interchangeably, such that all attributes have the - * same values and calling the same DOM method on either reference + * <br>This method provides a way to determine whether two + * <code>Node</code> references returned by the implementation reference + * the same object. When two <code>Node</code> references are references + * to the same object, even if through a proxy, the references may be + * used completely interchangeably, such that all attributes have the + * same values and calling the same DOM method on either reference * always has exactly the same effect. * @param other The node to test against. - * @return Returns <code>true</code> if the nodes are the same, + * @return Returns <code>true</code> if the nodes are the same, * <code>false</code> otherwise. * @since DOM Level 3 */ public boolean isSameNode(Node other); /** - * Look up the prefix associated to the given namespace URI, starting from - * this node. The default namespace declarations are ignored by this + * Look up the prefix associated to the given namespace URI, starting from + * this node. The default namespace declarations are ignored by this * method. * <br>See for details on the algorithm used by this method. * @param namespaceURI The namespace URI to look for. - * @return Returns an associated namespace prefix if found or - * <code>null</code> if none is found. If more than one prefix are - * associated to the namespace prefix, the returned namespace prefix + * @return Returns an associated namespace prefix if found or + * <code>null</code> if none is found. If more than one prefix are + * associated to the namespace prefix, the returned namespace prefix * is implementation dependent. * @since DOM Level 3 */ public String lookupPrefix(String namespaceURI); /** - * This method checks if the specified <code>namespaceURI</code> is the - * default namespace or not. + * This method checks if the specified <code>namespaceURI</code> is the + * default namespace or not. * @param namespaceURI The namespace URI to look for. - * @return Returns <code>true</code> if the specified - * <code>namespaceURI</code> is the default namespace, - * <code>false</code> otherwise. + * @return Returns <code>true</code> if the specified + * <code>namespaceURI</code> is the default namespace, + * <code>false</code> otherwise. * @since DOM Level 3 */ public boolean isDefaultNamespace(String namespaceURI); /** - * Look up the namespace URI associated to the given prefix, starting from + * Look up the namespace URI associated to the given prefix, starting from * this node. * <br>See for details on the algorithm used by this method. - * @param prefix The prefix to look for. If this parameter is - * <code>null</code>, the method will return the default namespace URI + * @param prefix The prefix to look for. If this parameter is + * <code>null</code>, the method will return the default namespace URI * if any. - * @return Returns the associated namespace URI or <code>null</code> if + * @return Returns the associated namespace URI or <code>null</code> if * none is found. * @since DOM Level 3 */ @@ -781,117 +781,117 @@ public interface Node { /** * Tests whether two nodes are equal. - * <br>This method tests for equality of nodes, not sameness (i.e., - * whether the two nodes are references to the same object) which can be - * tested with <code>Node.isSameNode()</code>. All nodes that are the + * <br>This method tests for equality of nodes, not sameness (i.e., + * whether the two nodes are references to the same object) which can be + * tested with <code>Node.isSameNode()</code>. All nodes that are the * same will also be equal, though the reverse may not be true. - * <br>Two nodes are equal if and only if the following conditions are - * satisfied: + * <br>Two nodes are equal if and only if the following conditions are + * satisfied: * <ul> * <li>The two nodes are of the same type. * </li> - * <li>The following string - * attributes are equal: <code>nodeName</code>, <code>localName</code>, + * <li>The following string + * attributes are equal: <code>nodeName</code>, <code>localName</code>, * <code>namespaceURI</code>, <code>prefix</code>, <code>nodeValue</code> - * . This is: they are both <code>null</code>, or they have the same + * . This is: they are both <code>null</code>, or they have the same * length and are character for character identical. * </li> - * <li>The - * <code>attributes</code> <code>NamedNodeMaps</code> are equal. This - * is: they are both <code>null</code>, or they have the same length and - * for each node that exists in one map there is a node that exists in - * the other map and is equal, although not necessarily at the same + * <li>The + * <code>attributes</code> <code>NamedNodeMaps</code> are equal. This + * is: they are both <code>null</code>, or they have the same length and + * for each node that exists in one map there is a node that exists in + * the other map and is equal, although not necessarily at the same * index. * </li> - * <li>The <code>childNodes</code> <code>NodeLists</code> are equal. - * This is: they are both <code>null</code>, or they have the same - * length and contain equal nodes at the same index. Note that - * normalization can affect equality; to avoid this, nodes should be + * <li>The <code>childNodes</code> <code>NodeLists</code> are equal. + * This is: they are both <code>null</code>, or they have the same + * length and contain equal nodes at the same index. Note that + * normalization can affect equality; to avoid this, nodes should be * normalized before being compared. * </li> - * </ul> - * <br>For two <code>DocumentType</code> nodes to be equal, the following - * conditions must also be satisfied: + * </ul> + * <br>For two <code>DocumentType</code> nodes to be equal, the following + * conditions must also be satisfied: * <ul> - * <li>The following string attributes - * are equal: <code>publicId</code>, <code>systemId</code>, + * <li>The following string attributes + * are equal: <code>publicId</code>, <code>systemId</code>, * <code>internalSubset</code>. * </li> - * <li>The <code>entities</code> + * <li>The <code>entities</code> * <code>NamedNodeMaps</code> are equal. * </li> - * <li>The <code>notations</code> + * <li>The <code>notations</code> * <code>NamedNodeMaps</code> are equal. * </li> - * </ul> - * <br>On the other hand, the following do not affect equality: the - * <code>ownerDocument</code>, <code>baseURI</code>, and - * <code>parentNode</code> attributes, the <code>specified</code> + * </ul> + * <br>On the other hand, the following do not affect equality: the + * <code>ownerDocument</code>, <code>baseURI</code>, and + * <code>parentNode</code> attributes, the <code>specified</code> * attribute for <code>Attr</code> nodes, the <code>schemaTypeInfo</code> - * attribute for <code>Attr</code> and <code>Element</code> nodes, the - * <code>Text.isElementContentWhitespace</code> attribute for - * <code>Text</code> nodes, as well as any user data or event listeners - * registered on the nodes. - * <p ><b>Note:</b> As a general rule, anything not mentioned in the - * description above is not significant in consideration of equality - * checking. Note that future versions of this specification may take - * into account more attributes and implementations conform to this - * specification are expected to be updated accordingly. + * attribute for <code>Attr</code> and <code>Element</code> nodes, the + * <code>Text.isElementContentWhitespace</code> attribute for + * <code>Text</code> nodes, as well as any user data or event listeners + * registered on the nodes. + * <p ><b>Note:</b> As a general rule, anything not mentioned in the + * description above is not significant in consideration of equality + * checking. Note that future versions of this specification may take + * into account more attributes and implementations conform to this + * specification are expected to be updated accordingly. * @param arg The node to compare equality with. - * @return Returns <code>true</code> if the nodes are equal, + * @return Returns <code>true</code> if the nodes are equal, * <code>false</code> otherwise. * @since DOM Level 3 */ public boolean isEqualNode(Node arg); /** - * This method returns a specialized object which implements the - * specialized APIs of the specified feature and version, as specified - * in . The specialized object may also be obtained by using - * binding-specific casting methods but is not necessarily expected to, - * as discussed in . This method also allow the implementation to + * This method returns a specialized object which implements the + * specialized APIs of the specified feature and version, as specified + * in . The specialized object may also be obtained by using + * binding-specific casting methods but is not necessarily expected to, + * as discussed in . This method also allow the implementation to * provide specialized objects which do not support the <code>Node</code> - * interface. - * @param feature The name of the feature requested. Note that any plus - * sign "+" prepended to the name of the feature will be ignored since - * it is not significant in the context of this method. - * @param version This is the version number of the feature to test. - * @return Returns an object which implements the specialized APIs of - * the specified feature and version, if any, or <code>null</code> if - * there is no object which implements interfaces associated with that - * feature. If the <code>DOMObject</code> returned by this method - * implements the <code>Node</code> interface, it must delegate to the - * primary core <code>Node</code> and not return results inconsistent - * with the primary core <code>Node</code> such as attributes, - * childNodes, etc. + * interface. + * @param feature The name of the feature requested. Note that any plus + * sign "+" prepended to the name of the feature will be ignored since + * it is not significant in the context of this method. + * @param version This is the version number of the feature to test. + * @return Returns an object which implements the specialized APIs of + * the specified feature and version, if any, or <code>null</code> if + * there is no object which implements interfaces associated with that + * feature. If the <code>DOMObject</code> returned by this method + * implements the <code>Node</code> interface, it must delegate to the + * primary core <code>Node</code> and not return results inconsistent + * with the primary core <code>Node</code> such as attributes, + * childNodes, etc. * @since DOM Level 3 */ - public Object getFeature(String feature, + public Object getFeature(String feature, String version); /** - * Associate an object to a key on this node. The object can later be - * retrieved from this node by calling <code>getUserData</code> with the + * Associate an object to a key on this node. The object can later be + * retrieved from this node by calling <code>getUserData</code> with the * same key. * @param key The key to associate the object to. - * @param data The object to associate to the given key, or + * @param data The object to associate to the given key, or * <code>null</code> to remove any existing association to that key. - * @param handler The handler to associate to that key, or + * @param handler The handler to associate to that key, or * <code>null</code>. - * @return Returns the <code>DOMUserData</code> previously associated to + * @return Returns the <code>DOMUserData</code> previously associated to * the given key on this node, or <code>null</code> if there was none. * @since DOM Level 3 */ - public Object setUserData(String key, - Object data, + public Object setUserData(String key, + Object data, UserDataHandler handler); /** - * Retrieves the object associated to a key on a this node. The object - * must first have been set to this node by calling + * Retrieves the object associated to a key on a this node. The object + * must first have been set to this node by calling * <code>setUserData</code> with the same key. * @param key The key the object is associated to. - * @return Returns the <code>DOMUserData</code> associated to the given + * @return Returns the <code>DOMUserData</code> associated to the given * key on this node, or <code>null</code> if there was none. * @since DOM Level 3 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/NodeList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/NodeList.java index e4204ec974c..4a98a9030fa 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/NodeList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/NodeList.java @@ -13,27 +13,27 @@ package org.w3c.dom; /** - * The <code>NodeList</code> interface provides the abstraction of an ordered - * collection of nodes, without defining or constraining how this collection + * The <code>NodeList</code> interface provides the abstraction of an ordered + * collection of nodes, without defining or constraining how this collection * is implemented. <code>NodeList</code> objects in the DOM are live. - * <p>The items in the <code>NodeList</code> are accessible via an integral + * <p>The items in the <code>NodeList</code> are accessible via an integral * index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface NodeList { /** - * Returns the <code>index</code>th item in the collection. If - * <code>index</code> is greater than or equal to the number of nodes in + * Returns the <code>index</code>th item in the collection. If + * <code>index</code> is greater than or equal to the number of nodes in * the list, this returns <code>null</code>. * @param index Index into the collection. - * @return The node at the <code>index</code>th position in the - * <code>NodeList</code>, or <code>null</code> if that is not a valid + * @return The node at the <code>index</code>th position in the + * <code>NodeList</code>, or <code>null</code> if that is not a valid * index. */ public Node item(int index); /** - * The number of nodes in the list. The range of valid child node indices + * The number of nodes in the list. The range of valid child node indices * is 0 to <code>length-1</code> inclusive. */ public int getLength(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Notation.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Notation.java index 3739f928443..a7ad40992d5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Notation.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Notation.java @@ -13,26 +13,26 @@ package org.w3c.dom; /** - * This interface represents a notation declared in the DTD. A notation either - * declares, by name, the format of an unparsed entity (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#Notations'>section 4.7</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]), or is - * used for formal declaration of processing instruction targets (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-pi'>section 2.6</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). The - * <code>nodeName</code> attribute inherited from <code>Node</code> is set + * This interface represents a notation declared in the DTD. A notation either + * declares, by name, the format of an unparsed entity (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#Notations'>section 4.7</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]), or is + * used for formal declaration of processing instruction targets (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-pi'>section 2.6</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). The + * <code>nodeName</code> attribute inherited from <code>Node</code> is set * to the declared name of the notation. - * <p>The DOM Core does not support editing <code>Notation</code> nodes; they + * <p>The DOM Core does not support editing <code>Notation</code> nodes; they * are therefore readonly. * <p>A <code>Notation</code> node does not have any parent. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Notation extends Node { /** - * The public identifier of this notation. If the public identifier was + * The public identifier of this notation. If the public identifier was * not specified, this is <code>null</code>. */ public String getPublicId(); /** - * The system identifier of this notation. If the system identifier was - * not specified, this is <code>null</code>. This may be an absolute URI + * The system identifier of this notation. If the system identifier was + * not specified, this is <code>null</code>. This may be an absolute URI * or not. */ public String getSystemId(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ProcessingInstruction.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ProcessingInstruction.java index 0b6825f104c..61b7892311d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ProcessingInstruction.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ProcessingInstruction.java @@ -13,34 +13,34 @@ package org.w3c.dom; /** - * The <code>ProcessingInstruction</code> interface represents a "processing - * instruction", used in XML as a way to keep processor-specific information + * The <code>ProcessingInstruction</code> interface represents a "processing + * instruction", used in XML as a way to keep processor-specific information * in the text of the document. - * <p> No lexical check is done on the content of a processing instruction and - * it is therefore possible to have the character sequence - * <code>"?>"</code> in the content, which is illegal a processing - * instruction per section 2.6 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The - * presence of this character sequence must generate a fatal error during - * serialization. + * <p> No lexical check is done on the content of a processing instruction and + * it is therefore possible to have the character sequence + * <code>"?>"</code> in the content, which is illegal a processing + * instruction per section 2.6 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The + * presence of this character sequence must generate a fatal error during + * serialization. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface ProcessingInstruction extends Node { /** - * The target of this processing instruction. XML defines this as being - * the first token following the markup that begins the processing + * The target of this processing instruction. XML defines this as being + * the first token following the markup that begins the processing * instruction. */ public String getTarget(); /** - * The content of this processing instruction. This is from the first non - * white space character after the target to the character immediately + * The content of this processing instruction. This is from the first non + * white space character after the target to the character immediately * preceding the <code>?></code>. */ public String getData(); /** - * The content of this processing instruction. This is from the first non - * white space character after the target to the character immediately + * The content of this processing instruction. This is from the first non + * white space character after the target to the character immediately * preceding the <code>?></code>. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java index 9c294a4a488..872c5499d24 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java @@ -13,45 +13,45 @@ package org.w3c.dom; /** - * The <code>Text</code> interface inherits from <code>CharacterData</code> - * and represents the textual content (termed <a href='http://www.w3.org/TR/2004/REC-xml-20040204#syntax'>character data</a> in XML) of an <code>Element</code> or <code>Attr</code>. If there is no - * markup inside an element's content, the text is contained in a single - * object implementing the <code>Text</code> interface that is the only - * child of the element. If there is markup, it is parsed into the - * information items (elements, comments, etc.) and <code>Text</code> nodes + * The <code>Text</code> interface inherits from <code>CharacterData</code> + * and represents the textual content (termed <a href='http://www.w3.org/TR/2004/REC-xml-20040204#syntax'>character data</a> in XML) of an <code>Element</code> or <code>Attr</code>. If there is no + * markup inside an element's content, the text is contained in a single + * object implementing the <code>Text</code> interface that is the only + * child of the element. If there is markup, it is parsed into the + * information items (elements, comments, etc.) and <code>Text</code> nodes * that form the list of children of the element. - * <p>When a document is first made available via the DOM, there is only one - * <code>Text</code> node for each block of text. Users may create adjacent - * <code>Text</code> nodes that represent the contents of a given element - * without any intervening markup, but should be aware that there is no way - * to represent the separations between these nodes in XML or HTML, so they - * will not (in general) persist between DOM editing sessions. The - * <code>Node.normalize()</code> method merges any such adjacent + * <p>When a document is first made available via the DOM, there is only one + * <code>Text</code> node for each block of text. Users may create adjacent + * <code>Text</code> nodes that represent the contents of a given element + * without any intervening markup, but should be aware that there is no way + * to represent the separations between these nodes in XML or HTML, so they + * will not (in general) persist between DOM editing sessions. The + * <code>Node.normalize()</code> method merges any such adjacent * <code>Text</code> objects into a single node for each block of text. - * <p> No lexical check is done on the content of a <code>Text</code> node - * and, depending on its position in the document, some characters must be - * escaped during serialization using character references; e.g. the - * characters "<&" if the textual content is part of an element or of - * an attribute, the character sequence "]]>" when part of an element, - * the quotation mark character " or the apostrophe character ' when part of - * an attribute. + * <p> No lexical check is done on the content of a <code>Text</code> node + * and, depending on its position in the document, some characters must be + * escaped during serialization using character references; e.g. the + * characters "<&" if the textual content is part of an element or of + * an attribute, the character sequence "]]>" when part of an element, + * the quotation mark character " or the apostrophe character ' when part of + * an attribute. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. */ public interface Text extends CharacterData { /** - * Breaks this node into two nodes at the specified <code>offset</code>, - * keeping both in the tree as siblings. After being split, this node - * will contain all the content up to the <code>offset</code> point. A - * new node of the same type, which contains all the content at and - * after the <code>offset</code> point, is returned. If the original - * node had a parent node, the new node is inserted as the next sibling - * of the original node. When the <code>offset</code> is equal to the + * Breaks this node into two nodes at the specified <code>offset</code>, + * keeping both in the tree as siblings. After being split, this node + * will contain all the content up to the <code>offset</code> point. A + * new node of the same type, which contains all the content at and + * after the <code>offset</code> point, is returned. If the original + * node had a parent node, the new node is inserted as the next sibling + * of the original node. When the <code>offset</code> is equal to the * length of this node, the new node has no data. - * @param offset The 16-bit unit offset at which to split, starting from + * @param offset The 16-bit unit offset at which to split, starting from * <code>0</code>. * @return The new node, of the same type as this node. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified offset is negative or greater + * INDEX_SIZE_ERR: Raised if the specified offset is negative or greater * than the number of 16-bit units in <code>data</code>. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ @@ -60,63 +60,63 @@ public interface Text extends CharacterData { /** * Returns whether this text node contains <a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character'> - * element content whitespace</a>, often abusively called "ignorable whitespace". The text node is - * determined to contain whitespace in element content during the load - * of the document or if validation occurs while using + * element content whitespace</a>, often abusively called "ignorable whitespace". The text node is + * determined to contain whitespace in element content during the load + * of the document or if validation occurs while using * <code>Document.normalizeDocument()</code>. * @since DOM Level 3 */ public boolean isElementContentWhitespace(); /** - * Returns all text of <code>Text</code> nodes logically-adjacent text + * Returns all text of <code>Text</code> nodes logically-adjacent text * nodes to this node, concatenated in document order. - * <br>For instance, in the example below <code>wholeText</code> on the - * <code>Text</code> node that contains "bar" returns "barfoo", while on - * the <code>Text</code> node that contains "foo" it returns "barfoo". + * <br>For instance, in the example below <code>wholeText</code> on the + * <code>Text</code> node that contains "bar" returns "barfoo", while on + * the <code>Text</code> node that contains "foo" it returns "barfoo". * @since DOM Level 3 */ public String getWholeText(); /** - * Replaces the text of the current node and all logically-adjacent text - * nodes with the specified text. All logically-adjacent text nodes are - * removed including the current node unless it was the recipient of the + * Replaces the text of the current node and all logically-adjacent text + * nodes with the specified text. All logically-adjacent text nodes are + * removed including the current node unless it was the recipient of the * replacement text. - * <br>This method returns the node which received the replacement text. - * The returned node is: + * <br>This method returns the node which received the replacement text. + * The returned node is: * <ul> - * <li><code>null</code>, when the replacement text is + * <li><code>null</code>, when the replacement text is * the empty string; * </li> - * <li>the current node, except when the current node is + * <li>the current node, except when the current node is * read-only; * </li> * <li> a new <code>Text</code> node of the same type ( - * <code>Text</code> or <code>CDATASection</code>) as the current node + * <code>Text</code> or <code>CDATASection</code>) as the current node * inserted at the location of the replacement. * </li> * </ul> - * <br>For instance, in the above example calling - * <code>replaceWholeText</code> on the <code>Text</code> node that - * contains "bar" with "yo" in argument results in the following: - * <br>Where the nodes to be removed are read-only descendants of an - * <code>EntityReference</code>, the <code>EntityReference</code> must - * be removed instead of the read-only nodes. If any - * <code>EntityReference</code> to be removed has descendants that are - * not <code>EntityReference</code>, <code>Text</code>, or - * <code>CDATASection</code> nodes, the <code>replaceWholeText</code> - * method must fail before performing any modification of the document, - * raising a <code>DOMException</code> with the code + * <br>For instance, in the above example calling + * <code>replaceWholeText</code> on the <code>Text</code> node that + * contains "bar" with "yo" in argument results in the following: + * <br>Where the nodes to be removed are read-only descendants of an + * <code>EntityReference</code>, the <code>EntityReference</code> must + * be removed instead of the read-only nodes. If any + * <code>EntityReference</code> to be removed has descendants that are + * not <code>EntityReference</code>, <code>Text</code>, or + * <code>CDATASection</code> nodes, the <code>replaceWholeText</code> + * method must fail before performing any modification of the document, + * raising a <code>DOMException</code> with the code * <code>NO_MODIFICATION_ALLOWED_ERR</code>. - * <br>For instance, in the example below calling - * <code>replaceWholeText</code> on the <code>Text</code> node that - * contains "bar" fails, because the <code>EntityReference</code> node + * <br>For instance, in the example below calling + * <code>replaceWholeText</code> on the <code>Text</code> node that + * contains "bar" fails, because the <code>EntityReference</code> node * "ent" contains an <code>Element</code> node which cannot be removed. * @param content The content of the replacing <code>Text</code> node. * @return The <code>Text</code> node created with the specified content. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if one of the <code>Text</code> + * NO_MODIFICATION_ALLOWED_ERR: Raised if one of the <code>Text</code> * nodes being replaced is readonly. * @since DOM Level 3 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/TypeInfo.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/TypeInfo.java index 054f9907245..d36f3cc3711 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/TypeInfo.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/TypeInfo.java @@ -13,95 +13,95 @@ package org.w3c.dom; /** - * The <code>TypeInfo</code> interface represents a type referenced from - * <code>Element</code> or <code>Attr</code> nodes, specified in the schemas - * associated with the document. The type is a pair of a namespace URI and - * name properties, and depends on the document's schema. - * <p> If the document's schema is an XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], the values - * are computed as follows: + * The <code>TypeInfo</code> interface represents a type referenced from + * <code>Element</code> or <code>Attr</code> nodes, specified in the schemas + * associated with the document. The type is a pair of a namespace URI and + * name properties, and depends on the document's schema. + * <p> If the document's schema is an XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], the values + * are computed as follows: * <ul> - * <li> If this type is referenced from an - * <code>Attr</code> node, <code>typeNamespace</code> is - * <code>"http://www.w3.org/TR/REC-xml"</code> and <code>typeName</code> + * <li> If this type is referenced from an + * <code>Attr</code> node, <code>typeNamespace</code> is + * <code>"http://www.w3.org/TR/REC-xml"</code> and <code>typeName</code> * represents the <b>[attribute type]</b> property in the [<a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204/'>XML Information Set</a>] * . If there is no declaration for the attribute, <code>typeNamespace</code> - * and <code>typeName</code> are <code>null</code>. + * and <code>typeName</code> are <code>null</code>. * </li> - * <li> If this type is - * referenced from an <code>Element</code> node, <code>typeNamespace</code> - * and <code>typeName</code> are <code>null</code>. + * <li> If this type is + * referenced from an <code>Element</code> node, <code>typeNamespace</code> + * and <code>typeName</code> are <code>null</code>. * </li> * </ul> * <p> If the document's schema is an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * , the values are computed as follows using the post-schema-validation - * infoset contributions (also called PSVI contributions): + * , the values are computed as follows using the post-schema-validation + * infoset contributions (also called PSVI contributions): * <ul> - * <li> If the <b>[validity]</b> property exists AND is <em>"invalid"</em> or <em>"notKnown"</em>: the {target namespace} and {name} properties of the declared type if - * available, otherwise <code>null</code>. - * <p ><b>Note:</b> At the time of writing, the XML Schema specification does - * not require exposing the declared type. Thus, DOM implementations might - * choose not to provide type information if validity is not valid. + * <li> If the <b>[validity]</b> property exists AND is <em>"invalid"</em> or <em>"notKnown"</em>: the {target namespace} and {name} properties of the declared type if + * available, otherwise <code>null</code>. + * <p ><b>Note:</b> At the time of writing, the XML Schema specification does + * not require exposing the declared type. Thus, DOM implementations might + * choose not to provide type information if validity is not valid. * </li> - * <li> If the <b>[validity]</b> property exists and is <em>"valid"</em>: + * <li> If the <b>[validity]</b> property exists and is <em>"valid"</em>: * <ol> - * <li> If <b>[member type definition]</b> exists: + * <li> If <b>[member type definition]</b> exists: * <ol> - * <li>If {name} is not absent, then expose {name} and {target + * <li>If {name} is not absent, then expose {name} and {target * namespace} properties of the <b>[member type definition]</b> property; * </li> - * <li>Otherwise, expose the namespace and local name of the + * <li>Otherwise, expose the namespace and local name of the * corresponding anonymous type name. * </li> * </ol> * </li> - * <li> If the <b>[type definition]</b> property exists: + * <li> If the <b>[type definition]</b> property exists: * <ol> - * <li>If {name} is not absent, then expose {name} and {target + * <li>If {name} is not absent, then expose {name} and {target * namespace} properties of the <b>[type definition]</b> property; * </li> - * <li>Otherwise, expose the namespace and local name of the + * <li>Otherwise, expose the namespace and local name of the * corresponding anonymous type name. * </li> - * </ol> + * </ol> * </li> - * <li> If the <b>[member type definition anonymous]</b> exists: + * <li> If the <b>[member type definition anonymous]</b> exists: * <ol> * <li>If it is false, then expose <b>[member type definition name]</b> and <b>[member type definition namespace]</b> properties; * </li> - * <li>Otherwise, expose the namespace and local name of the + * <li>Otherwise, expose the namespace and local name of the * corresponding anonymous type name. * </li> - * </ol> + * </ol> * </li> - * <li> If the <b>[type definition anonymous]</b> exists: + * <li> If the <b>[type definition anonymous]</b> exists: * <ol> * <li>If it is false, then expose <b>[type definition name]</b> and <b>[type definition namespace]</b> properties; * </li> - * <li>Otherwise, expose the namespace and local name of the + * <li>Otherwise, expose the namespace and local name of the * corresponding anonymous type name. * </li> - * </ol> + * </ol> * </li> * </ol> * </li> * </ul> - * <p ><b>Note:</b> Other schema languages are outside the scope of the W3C - * and therefore should define how to represent their type systems using - * <code>TypeInfo</code>. + * <p ><b>Note:</b> Other schema languages are outside the scope of the W3C + * and therefore should define how to represent their type systems using + * <code>TypeInfo</code>. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ public interface TypeInfo { /** - * The name of a type declared for the associated element or attribute, - * or <code>null</code> if unknown. + * The name of a type declared for the associated element or attribute, + * or <code>null</code> if unknown. */ public String getTypeName(); /** - * The namespace of the type declared for the associated element or - * attribute or <code>null</code> if the element does not have - * declaration or if no namespace information is available. + * The namespace of the type declared for the associated element or + * attribute or <code>null</code> if the element does not have + * declaration or if no namespace information is available. */ public String getTypeNamespace(); @@ -110,76 +110,76 @@ public interface TypeInfo { * If the document's schema is an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] * , this constant represents the derivation by <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-typeRestriction'> * restriction</a> if complex types are involved, or a <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#element-restriction'> - * restriction</a> if simple types are involved. - * <br> The reference type definition is derived by restriction from the - * other type definition if the other type definition is the same as the - * reference type definition, or if the other type definition can be - * reached recursively following the {base type definition} property - * from the reference type definition, and all the <em>derivation methods</em> involved are restriction. + * restriction</a> if simple types are involved. + * <br> The reference type definition is derived by restriction from the + * other type definition if the other type definition is the same as the + * reference type definition, or if the other type definition can be + * reached recursively following the {base type definition} property + * from the reference type definition, and all the <em>derivation methods</em> involved are restriction. */ public static final int DERIVATION_RESTRICTION = 0x00000001; /** * If the document's schema is an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] * , this constant represents the derivation by <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-typeExtension'> - * extension</a>. - * <br> The reference type definition is derived by extension from the - * other type definition if the other type definition can be reached - * recursively following the {base type definition} property from the - * reference type definition, and at least one of the <em>derivation methods</em> involved is an extension. + * extension</a>. + * <br> The reference type definition is derived by extension from the + * other type definition if the other type definition can be reached + * recursively following the {base type definition} property from the + * reference type definition, and at least one of the <em>derivation methods</em> involved is an extension. */ public static final int DERIVATION_EXTENSION = 0x00000002; /** * If the document's schema is an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] * , this constant represents the <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#element-union'> - * union</a> if simple types are involved. - * <br> The reference type definition is derived by union from the other - * type definition if there exists two type definitions T1 and T2 such - * as the reference type definition is derived from T1 by - * <code>DERIVATION_RESTRICTION</code> or - * <code>DERIVATION_EXTENSION</code>, T2 is derived from the other type - * definition by <code>DERIVATION_RESTRICTION</code>, T1 has {variety} <em>union</em>, and one of the {member type definitions} is T2. Note that T1 could be - * the same as the reference type definition, and T2 could be the same - * as the other type definition. + * union</a> if simple types are involved. + * <br> The reference type definition is derived by union from the other + * type definition if there exists two type definitions T1 and T2 such + * as the reference type definition is derived from T1 by + * <code>DERIVATION_RESTRICTION</code> or + * <code>DERIVATION_EXTENSION</code>, T2 is derived from the other type + * definition by <code>DERIVATION_RESTRICTION</code>, T1 has {variety} <em>union</em>, and one of the {member type definitions} is T2. Note that T1 could be + * the same as the reference type definition, and T2 could be the same + * as the other type definition. */ public static final int DERIVATION_UNION = 0x00000004; /** * If the document's schema is an XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * , this constant represents the <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#element-list'>list</a>. - * <br> The reference type definition is derived by list from the other - * type definition if there exists two type definitions T1 and T2 such - * as the reference type definition is derived from T1 by - * <code>DERIVATION_RESTRICTION</code> or - * <code>DERIVATION_EXTENSION</code>, T2 is derived from the other type - * definition by <code>DERIVATION_RESTRICTION</code>, T1 has {variety} <em>list</em>, and T2 is the {item type definition}. Note that T1 could be the same as - * the reference type definition, and T2 could be the same as the other - * type definition. + * , this constant represents the <a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#element-list'>list</a>. + * <br> The reference type definition is derived by list from the other + * type definition if there exists two type definitions T1 and T2 such + * as the reference type definition is derived from T1 by + * <code>DERIVATION_RESTRICTION</code> or + * <code>DERIVATION_EXTENSION</code>, T2 is derived from the other type + * definition by <code>DERIVATION_RESTRICTION</code>, T1 has {variety} <em>list</em>, and T2 is the {item type definition}. Note that T1 could be the same as + * the reference type definition, and T2 could be the same as the other + * type definition. */ public static final int DERIVATION_LIST = 0x00000008; /** - * This method returns if there is a derivation between the reference - * type definition, i.e. the <code>TypeInfo</code> on which the method - * is being called, and the other type definition, i.e. the one passed - * as parameters. - * @param typeNamespaceArg the namespace of the other type definition. - * @param typeNameArg the name of the other type definition. - * @param derivationMethod the type of derivation and conditions applied - * between two types, as described in the list of constants provided - * in this interface. - * @return If the document's schema is a DTD or no schema is associated + * This method returns if there is a derivation between the reference + * type definition, i.e. the <code>TypeInfo</code> on which the method + * is being called, and the other type definition, i.e. the one passed + * as parameters. + * @param typeNamespaceArg the namespace of the other type definition. + * @param typeNameArg the name of the other type definition. + * @param derivationMethod the type of derivation and conditions applied + * between two types, as described in the list of constants provided + * in this interface. + * @return If the document's schema is a DTD or no schema is associated * with the document, this method will always return <code>false</code> - * . If the document's schema is an XML Schema, the method will - * <code>true</code> if the reference type definition is derived from - * the other type definition according to the derivation parameter. If - * the value of the parameter is <code>0</code> (no bit is set to - * <code>1</code> for the <code>derivationMethod</code> parameter), - * the method will return <code>true</code> if the other type - * definition can be reached by recursing any combination of {base - * type definition}, {item type definition}, or {member type - * definitions} from the reference type definition. + * . If the document's schema is an XML Schema, the method will + * <code>true</code> if the reference type definition is derived from + * the other type definition according to the derivation parameter. If + * the value of the parameter is <code>0</code> (no bit is set to + * <code>1</code> for the <code>derivationMethod</code> parameter), + * the method will return <code>true</code> if the other type + * definition can be reached by recursing any combination of {base + * type definition}, {item type definition}, or {member type + * definitions} from the reference type definition. */ - public boolean isDerivedFrom(String typeNamespaceArg, - String typeNameArg, + public boolean isDerivedFrom(String typeNamespaceArg, + String typeNameArg, int derivationMethod); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/UserDataHandler.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/UserDataHandler.java index a16ea7308c2..cf6ee5669e6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/UserDataHandler.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/UserDataHandler.java @@ -13,12 +13,12 @@ package org.w3c.dom; /** - * When associating an object to a key on a node using - * <code>Node.setUserData()</code> the application can provide a handler - * that gets called when the node the object is associated to is being - * cloned, imported, or renamed. This can be used by the application to - * implement various behaviors regarding the data it associates to the DOM - * nodes. This interface defines that handler. + * When associating an object to a key on a node using + * <code>Node.setUserData()</code> the application can provide a handler + * that gets called when the node the object is associated to is being + * cloned, imported, or renamed. This can be used by the application to + * implement various behaviors regarding the data it associates to the DOM + * nodes. This interface defines that handler. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. * @since DOM Level 3 */ @@ -34,8 +34,8 @@ public interface UserDataHandler { public static final short NODE_IMPORTED = 2; /** * The node is deleted. - * <p ><b>Note:</b> This may not be supported or may not be reliable in - * certain environments, such as Java, where the implementation has no + * <p ><b>Note:</b> This may not be supported or may not be reliable in + * certain environments, such as Java, where the implementation has no * real control over when objects are actually deleted. */ public static final short NODE_DELETED = 3; @@ -49,24 +49,24 @@ public interface UserDataHandler { public static final short NODE_ADOPTED = 5; /** - * This method is called whenever the node for which this handler is + * This method is called whenever the node for which this handler is * registered is imported or cloned. - * <br> DOM applications must not raise exceptions in a - * <code>UserDataHandler</code>. The effect of throwing exceptions from - * the handler is DOM implementation dependent. - * @param operation Specifies the type of operation that is being + * <br> DOM applications must not raise exceptions in a + * <code>UserDataHandler</code>. The effect of throwing exceptions from + * the handler is DOM implementation dependent. + * @param operation Specifies the type of operation that is being * performed on the node. - * @param key Specifies the key for which this handler is being called. - * @param data Specifies the data for which this handler is being called. - * @param src Specifies the node being cloned, adopted, imported, or + * @param key Specifies the key for which this handler is being called. + * @param data Specifies the data for which this handler is being called. + * @param src Specifies the node being cloned, adopted, imported, or * renamed. This is <code>null</code> when the node is being deleted. - * @param dst Specifies the node newly created if any, or + * @param dst Specifies the node newly created if any, or * <code>null</code>. */ - public void handle(short operation, - String key, - Object data, - Node src, + public void handle(short operation, + String key, + Object data, + Node src, Node dst); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java index be73f396bd8..5be8c3ab1e5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java @@ -58,26 +58,26 @@ public final class DOMImplementationRegistry { * DOMImplementationSource class names. */ public static final String PROPERTY = - "org.w3c.dom.DOMImplementationSourceList"; - + "org.w3c.dom.DOMImplementationSourceList"; + /** * Default columns per line. */ private static final int DEFAULT_LINE_LENGTH = 80; - + /** * The list of DOMImplementationSources. */ private Vector sources; - + /** * Private constructor. * @param srcs Vector List of DOMImplementationSources */ private DOMImplementationRegistry(final Vector srcs) { - sources = srcs; + sources = srcs; } - + /** * Obtain a new instance of a <code>DOMImplementationRegistry</code>. * @@ -106,49 +106,49 @@ public final class DOMImplementationRegistry { * <code>DOMImplementationSource</code> */ public static DOMImplementationRegistry newInstance() - throws - ClassNotFoundException, - InstantiationException, - IllegalAccessException, - ClassCastException { - Vector sources = new Vector(); - - ClassLoader classLoader = getClassLoader(); - // fetch system property: - String p = getSystemProperty(PROPERTY); - - // - // if property is not specified then use contents of + throws + ClassNotFoundException, + InstantiationException, + IllegalAccessException, + ClassCastException { + Vector sources = new Vector(); + + ClassLoader classLoader = getClassLoader(); + // fetch system property: + String p = getSystemProperty(PROPERTY); + + // + // if property is not specified then use contents of // META_INF/org.w3c.dom.DOMImplementationSourceList from classpath - if (p == null) { - p = getServiceValue(classLoader); - } if (p == null) { - // - // DOM Implementations can modify here to add *additional* fallback - // mechanisms to access a list of default DOMImplementationSources. - p = "gnu.xml.dom.ImplementationSource"; - } - if (p != null) { - StringTokenizer st = new StringTokenizer(p); - while (st.hasMoreTokens()) { - String sourceName = st.nextToken(); - // Use context class loader, falling back to Class.forName - // if and only if this fails... - Class sourceClass = null; - if (classLoader != null) { - sourceClass = classLoader.loadClass(sourceName); - } else { - sourceClass = Class.forName(sourceName); - } - DOMImplementationSource source = - (DOMImplementationSource) sourceClass.newInstance(); - sources.addElement(source); - } - } - return new DOMImplementationRegistry(sources); + p = getServiceValue(classLoader); + } + if (p == null) { + // + // DOM Implementations can modify here to add *additional* fallback + // mechanisms to access a list of default DOMImplementationSources. + p = "gnu.xml.dom.ImplementationSource"; + } + if (p != null) { + StringTokenizer st = new StringTokenizer(p); + while (st.hasMoreTokens()) { + String sourceName = st.nextToken(); + // Use context class loader, falling back to Class.forName + // if and only if this fails... + Class sourceClass = null; + if (classLoader != null) { + sourceClass = classLoader.loadClass(sourceName); + } else { + sourceClass = Class.forName(sourceName); + } + DOMImplementationSource source = + (DOMImplementationSource) sourceClass.newInstance(); + sources.addElement(source); + } + } + return new DOMImplementationRegistry(sources); } - + /** * Return the first implementation that has the desired * features, or <code>null</code> if none is found. @@ -162,19 +162,19 @@ public final class DOMImplementationRegistry { * or <code>null</code> if none found. */ public DOMImplementation getDOMImplementation(final String features) { - int size = sources.size(); - String name = null; - for (int i = 0; i < size; i++) { - DOMImplementationSource source = - (DOMImplementationSource) sources.elementAt(i); - DOMImplementation impl = source.getDOMImplementation(features); - if (impl != null) { - return impl; - } - } - return null; + int size = sources.size(); + String name = null; + for (int i = 0; i < size; i++) { + DOMImplementationSource source = + (DOMImplementationSource) sources.elementAt(i); + DOMImplementation impl = source.getDOMImplementation(features); + if (impl != null) { + return impl; + } + } + return null; } - + /** * Return a list of implementations that support the * desired features. @@ -187,51 +187,51 @@ public final class DOMImplementationRegistry { * @return A list of DOMImplementations that support the desired features. */ public DOMImplementationList getDOMImplementationList(final String features) { - final Vector implementations = new Vector(); - int size = sources.size(); - for (int i = 0; i < size; i++) { - DOMImplementationSource source = - (DOMImplementationSource) sources.elementAt(i); - DOMImplementationList impls = - source.getDOMImplementationList(features); - for (int j = 0; j < impls.getLength(); j++) { - DOMImplementation impl = impls.item(j); - implementations.addElement(impl); - } - } - return new DOMImplementationList() { - public DOMImplementation item(final int index) { - if (index >= 0 && index < implementations.size()) { - try { - return (DOMImplementation) - implementations.elementAt(index); - } catch (ArrayIndexOutOfBoundsException e) { - return null; - } - } - return null; - } - - public int getLength() { - return implementations.size(); - } - }; + final Vector implementations = new Vector(); + int size = sources.size(); + for (int i = 0; i < size; i++) { + DOMImplementationSource source = + (DOMImplementationSource) sources.elementAt(i); + DOMImplementationList impls = + source.getDOMImplementationList(features); + for (int j = 0; j < impls.getLength(); j++) { + DOMImplementation impl = impls.item(j); + implementations.addElement(impl); + } + } + return new DOMImplementationList() { + public DOMImplementation item(final int index) { + if (index >= 0 && index < implementations.size()) { + try { + return (DOMImplementation) + implementations.elementAt(index); + } catch (ArrayIndexOutOfBoundsException e) { + return null; + } + } + return null; + } + + public int getLength() { + return implementations.size(); + } + }; } - + /** * Register an implementation. * * @param s The source to be registered, may not be <code>null</code> */ public void addSource(final DOMImplementationSource s) { - if (s == null) { - throw new NullPointerException(); - } - if (!sources.contains(s)) { - sources.addElement(s); - } + if (s == null) { + throw new NullPointerException(); + } + if (!sources.contains(s)) { + sources.addElement(s); + } } - + /** * * Gets a class loader. @@ -239,20 +239,20 @@ public final class DOMImplementationRegistry { * @return A class loader, possibly <code>null</code> */ private static ClassLoader getClassLoader() { - try { - ClassLoader contextClassLoader = getContextClassLoader(); - - if (contextClassLoader != null) { - return contextClassLoader; - } - } catch (Exception e) { - // Assume that the DOM application is in a JRE 1.1, use the - // current ClassLoader - return DOMImplementationRegistry.class.getClassLoader(); - } - return DOMImplementationRegistry.class.getClassLoader(); + try { + ClassLoader contextClassLoader = getContextClassLoader(); + + if (contextClassLoader != null) { + return contextClassLoader; + } + } catch (Exception e) { + // Assume that the DOM application is in a JRE 1.1, use the + // current ClassLoader + return DOMImplementationRegistry.class.getClassLoader(); + } + return DOMImplementationRegistry.class.getClassLoader(); } - + /** * This method attempts to return the first line of the resource * META_INF/services/org.w3c.dom.DOMImplementationSourceList @@ -262,52 +262,52 @@ public final class DOMImplementationRegistry { * @return first line of resource, or <code>null</code> */ private static String getServiceValue(final ClassLoader classLoader) { - String serviceId = "META-INF/services/" + PROPERTY; - // try to find services in CLASSPATH - try { - InputStream is = getResourceAsStream(classLoader, serviceId); - - if (is != null) { - BufferedReader rd; - try { - rd = - new BufferedReader(new InputStreamReader(is, "UTF-8"), - DEFAULT_LINE_LENGTH); - } catch (java.io.UnsupportedEncodingException e) { - rd = - new BufferedReader(new InputStreamReader(is), - DEFAULT_LINE_LENGTH); - } - String serviceValue = rd.readLine(); - rd.close(); - if (serviceValue != null && serviceValue.length() > 0) { - return serviceValue; - } - } - } catch (Exception ex) { - return null; - } - return null; + String serviceId = "META-INF/services/" + PROPERTY; + // try to find services in CLASSPATH + try { + InputStream is = getResourceAsStream(classLoader, serviceId); + + if (is != null) { + BufferedReader rd; + try { + rd = + new BufferedReader(new InputStreamReader(is, "UTF-8"), + DEFAULT_LINE_LENGTH); + } catch (java.io.UnsupportedEncodingException e) { + rd = + new BufferedReader(new InputStreamReader(is), + DEFAULT_LINE_LENGTH); + } + String serviceValue = rd.readLine(); + rd.close(); + if (serviceValue != null && serviceValue.length() > 0) { + return serviceValue; + } + } + } catch (Exception ex) { + return null; + } + return null; } - + /** * A simple JRE (Java Runtime Environment) 1.1 test * - * @return <code>true</code> if JRE 1.1 + * @return <code>true</code> if JRE 1.1 */ private static boolean isJRE11() { - try { - Class c = Class.forName("java.security.AccessController"); - // java.security.AccessController existed since 1.2 so, if no - // exception was thrown, the DOM application is running in a JRE - // 1.2 or higher - return false; - } catch (Exception ex) { - // ignore - } - return true; + try { + Class c = Class.forName("java.security.AccessController"); + // java.security.AccessController existed since 1.2 so, if no + // exception was thrown, the DOM application is running in a JRE + // 1.2 or higher + return false; + } catch (Exception ex) { + // ignore + } + return true; } - + /** * This method returns the ContextClassLoader or <code>null</code> if * running in a JRE 1.1 @@ -315,73 +315,73 @@ public final class DOMImplementationRegistry { * @return The Context Classloader */ private static ClassLoader getContextClassLoader() { - return isJRE11() - ? null - : (ClassLoader) - AccessController.doPrivileged(new PrivilegedAction() { - public Object run() { - ClassLoader classLoader = null; - try { - classLoader = - Thread.currentThread().getContextClassLoader(); - } catch (SecurityException ex) { - } - return classLoader; - } - }); + return isJRE11() + ? null + : (ClassLoader) + AccessController.doPrivileged(new PrivilegedAction() { + public Object run() { + ClassLoader classLoader = null; + try { + classLoader = + Thread.currentThread().getContextClassLoader(); + } catch (SecurityException ex) { + } + return classLoader; + } + }); } - + /** * This method returns the system property indicated by the specified name * after checking access control privileges. For a JRE 1.1, this check is * not done. - * - * @param name the name of the system property + * + * @param name the name of the system property * @return the system property */ private static String getSystemProperty(final String name) { - return isJRE11() - ? (String) System.getProperty(name) - : (String) AccessController.doPrivileged(new PrivilegedAction() { - public Object run() { - return System.getProperty(name); - } - }); + return isJRE11() + ? (String) System.getProperty(name) + : (String) AccessController.doPrivileged(new PrivilegedAction() { + public Object run() { + return System.getProperty(name); + } + }); } - + /** * This method returns an Inputstream for the reading resource * META_INF/services/org.w3c.dom.DOMImplementationSourceList after checking * access control privileges. For a JRE 1.1, this check is not done. * - * @param classLoader classLoader - * @param name the resource + * @param classLoader classLoader + * @param name the resource * @return an Inputstream for the resource specified */ private static InputStream getResourceAsStream(final ClassLoader classLoader, - final String name) { - if (isJRE11()) { - InputStream ris; - if (classLoader == null) { - ris = ClassLoader.getSystemResourceAsStream(name); - } else { - ris = classLoader.getResourceAsStream(name); - } - return ris; - } else { - return (InputStream) - AccessController.doPrivileged(new PrivilegedAction() { - public Object run() { - InputStream ris; - if (classLoader == null) { - ris = - ClassLoader.getSystemResourceAsStream(name); - } else { - ris = classLoader.getResourceAsStream(name); - } - return ris; - } - }); - } + final String name) { + if (isJRE11()) { + InputStream ris; + if (classLoader == null) { + ris = ClassLoader.getSystemResourceAsStream(name); + } else { + ris = classLoader.getResourceAsStream(name); + } + return ris; + } else { + return (InputStream) + AccessController.doPrivileged(new PrivilegedAction() { + public Object run() { + InputStream ris; + if (classLoader == null) { + ris = + ClassLoader.getSystemResourceAsStream(name); + } else { + ris = classLoader.getResourceAsStream(name); + } + return ris; + } + }); + } } } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSS2Properties.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSS2Properties.java index 89ccf5048ef..238eea342d2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSS2Properties.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSS2Properties.java @@ -15,65 +15,65 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSS2Properties</code> interface represents a convenience - * mechanism for retrieving and setting properties within a - * <code>CSSStyleDeclaration</code>. The attributes of this interface - * correspond to all the properties specified in CSS2. Getting an attribute - * of this interface is equivalent to calling the - * <code>getPropertyValue</code> method of the - * <code>CSSStyleDeclaration</code> interface. Setting an attribute of this - * interface is equivalent to calling the <code>setProperty</code> method of - * the <code>CSSStyleDeclaration</code> interface. - * <p> A conformant implementation of the CSS module is not required to - * implement the <code>CSS2Properties</code> interface. If an implementation - * does implement this interface, the expectation is that language-specific - * methods can be used to cast from an instance of the - * <code>CSSStyleDeclaration</code> interface to the - * <code>CSS2Properties</code> interface. - * <p> If an implementation does implement this interface, it is expected to - * understand the specific syntax of the shorthand properties, and apply - * their semantics; when the <code>margin</code> property is set, for - * example, the <code>marginTop</code>, <code>marginRight</code>, - * <code>marginBottom</code> and <code>marginLeft</code> properties are - * actually being set by the underlying implementation. - * <p> When dealing with CSS "shorthand" properties, the shorthand properties - * should be decomposed into their component longhand properties as - * appropriate, and when querying for their value, the form returned should - * be the shortest form exactly equivalent to the declarations made in the - * ruleset. However, if there is no shorthand declaration that could be - * added to the ruleset without changing in any way the rules already - * declared in the ruleset (i.e., by adding longhand rules that were - * previously not declared in the ruleset), then the empty string should be - * returned for the shorthand property. - * <p> For example, querying for the <code>font</code> property should not - * return "normal normal normal 14pt/normal Arial, sans-serif", when "14pt - * Arial, sans-serif" suffices. (The normals are initial values, and are - * implied by use of the longhand property.) - * <p> If the values for all the longhand properties that compose a particular - * string are the initial values, then a string consisting of all the - * initial values should be returned (e.g. a <code>border-width</code> value - * of "medium" should be returned as such, not as ""). - * <p> For some shorthand properties that take missing values from other - * sides, such as the <code>margin</code>, <code>padding</code>, and - * <code>border-[width|style|color]</code> properties, the minimum number of - * sides possible should be used; i.e., "0px 10px" will be returned instead - * of "0px 10px 0px 10px". - * <p> If the value of a shorthand property can not be decomposed into its - * component longhand properties, as is the case for the <code>font</code> - * property with a value of "menu", querying for the values of the component - * longhand properties should return the empty string. + * The <code>CSS2Properties</code> interface represents a convenience + * mechanism for retrieving and setting properties within a + * <code>CSSStyleDeclaration</code>. The attributes of this interface + * correspond to all the properties specified in CSS2. Getting an attribute + * of this interface is equivalent to calling the + * <code>getPropertyValue</code> method of the + * <code>CSSStyleDeclaration</code> interface. Setting an attribute of this + * interface is equivalent to calling the <code>setProperty</code> method of + * the <code>CSSStyleDeclaration</code> interface. + * <p> A conformant implementation of the CSS module is not required to + * implement the <code>CSS2Properties</code> interface. If an implementation + * does implement this interface, the expectation is that language-specific + * methods can be used to cast from an instance of the + * <code>CSSStyleDeclaration</code> interface to the + * <code>CSS2Properties</code> interface. + * <p> If an implementation does implement this interface, it is expected to + * understand the specific syntax of the shorthand properties, and apply + * their semantics; when the <code>margin</code> property is set, for + * example, the <code>marginTop</code>, <code>marginRight</code>, + * <code>marginBottom</code> and <code>marginLeft</code> properties are + * actually being set by the underlying implementation. + * <p> When dealing with CSS "shorthand" properties, the shorthand properties + * should be decomposed into their component longhand properties as + * appropriate, and when querying for their value, the form returned should + * be the shortest form exactly equivalent to the declarations made in the + * ruleset. However, if there is no shorthand declaration that could be + * added to the ruleset without changing in any way the rules already + * declared in the ruleset (i.e., by adding longhand rules that were + * previously not declared in the ruleset), then the empty string should be + * returned for the shorthand property. + * <p> For example, querying for the <code>font</code> property should not + * return "normal normal normal 14pt/normal Arial, sans-serif", when "14pt + * Arial, sans-serif" suffices. (The normals are initial values, and are + * implied by use of the longhand property.) + * <p> If the values for all the longhand properties that compose a particular + * string are the initial values, then a string consisting of all the + * initial values should be returned (e.g. a <code>border-width</code> value + * of "medium" should be returned as such, not as ""). + * <p> For some shorthand properties that take missing values from other + * sides, such as the <code>margin</code>, <code>padding</code>, and + * <code>border-[width|style|color]</code> properties, the minimum number of + * sides possible should be used; i.e., "0px 10px" will be returned instead + * of "0px 10px 0px 10px". + * <p> If the value of a shorthand property can not be decomposed into its + * component longhand properties, as is the case for the <code>font</code> + * property with a value of "menu", querying for the values of the component + * longhand properties should return the empty string. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSS2Properties { /** - * See the azimuth property definition in CSS2. + * See the azimuth property definition in CSS2. */ public String getAzimuth(); /** - * See the azimuth property definition in CSS2. + * See the azimuth property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -81,13 +81,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background property definition in CSS2. + * See the background property definition in CSS2. */ public String getBackground(); /** - * See the background property definition in CSS2. + * See the background property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -95,13 +95,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background-attachment property definition in CSS2. + * See the background-attachment property definition in CSS2. */ public String getBackgroundAttachment(); /** - * See the background-attachment property definition in CSS2. + * See the background-attachment property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -109,13 +109,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background-color property definition in CSS2. + * See the background-color property definition in CSS2. */ public String getBackgroundColor(); /** - * See the background-color property definition in CSS2. + * See the background-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -123,13 +123,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background-image property definition in CSS2. + * See the background-image property definition in CSS2. */ public String getBackgroundImage(); /** - * See the background-image property definition in CSS2. + * See the background-image property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -137,13 +137,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background-position property definition in CSS2. + * See the background-position property definition in CSS2. */ public String getBackgroundPosition(); /** - * See the background-position property definition in CSS2. + * See the background-position property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -151,13 +151,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the background-repeat property definition in CSS2. + * See the background-repeat property definition in CSS2. */ public String getBackgroundRepeat(); /** - * See the background-repeat property definition in CSS2. + * See the background-repeat property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -165,13 +165,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border property definition in CSS2. + * See the border property definition in CSS2. */ public String getBorder(); /** - * See the border property definition in CSS2. + * See the border property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -179,13 +179,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-collapse property definition in CSS2. + * See the border-collapse property definition in CSS2. */ public String getBorderCollapse(); /** - * See the border-collapse property definition in CSS2. + * See the border-collapse property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -193,13 +193,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-color property definition in CSS2. + * See the border-color property definition in CSS2. */ public String getBorderColor(); /** - * See the border-color property definition in CSS2. + * See the border-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -207,13 +207,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-spacing property definition in CSS2. + * See the border-spacing property definition in CSS2. */ public String getBorderSpacing(); /** - * See the border-spacing property definition in CSS2. + * See the border-spacing property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -221,13 +221,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-style property definition in CSS2. + * See the border-style property definition in CSS2. */ public String getBorderStyle(); /** - * See the border-style property definition in CSS2. + * See the border-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -235,13 +235,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-top property definition in CSS2. + * See the border-top property definition in CSS2. */ public String getBorderTop(); /** - * See the border-top property definition in CSS2. + * See the border-top property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -249,13 +249,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-right property definition in CSS2. + * See the border-right property definition in CSS2. */ public String getBorderRight(); /** - * See the border-right property definition in CSS2. + * See the border-right property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -263,13 +263,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-bottom property definition in CSS2. + * See the border-bottom property definition in CSS2. */ public String getBorderBottom(); /** - * See the border-bottom property definition in CSS2. + * See the border-bottom property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -277,13 +277,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-left property definition in CSS2. + * See the border-left property definition in CSS2. */ public String getBorderLeft(); /** - * See the border-left property definition in CSS2. + * See the border-left property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -291,13 +291,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-top-color property definition in CSS2. + * See the border-top-color property definition in CSS2. */ public String getBorderTopColor(); /** - * See the border-top-color property definition in CSS2. + * See the border-top-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -305,13 +305,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-right-color property definition in CSS2. + * See the border-right-color property definition in CSS2. */ public String getBorderRightColor(); /** - * See the border-right-color property definition in CSS2. + * See the border-right-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -319,13 +319,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-bottom-color property definition in CSS2. + * See the border-bottom-color property definition in CSS2. */ public String getBorderBottomColor(); /** - * See the border-bottom-color property definition in CSS2. + * See the border-bottom-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -333,13 +333,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-left-color property definition in CSS2. + * See the border-left-color property definition in CSS2. */ public String getBorderLeftColor(); /** - * See the border-left-color property definition in CSS2. + * See the border-left-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -347,13 +347,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-top-style property definition in CSS2. + * See the border-top-style property definition in CSS2. */ public String getBorderTopStyle(); /** - * See the border-top-style property definition in CSS2. + * See the border-top-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -361,13 +361,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-right-style property definition in CSS2. + * See the border-right-style property definition in CSS2. */ public String getBorderRightStyle(); /** - * See the border-right-style property definition in CSS2. + * See the border-right-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -375,13 +375,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-bottom-style property definition in CSS2. + * See the border-bottom-style property definition in CSS2. */ public String getBorderBottomStyle(); /** - * See the border-bottom-style property definition in CSS2. + * See the border-bottom-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -389,13 +389,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-left-style property definition in CSS2. + * See the border-left-style property definition in CSS2. */ public String getBorderLeftStyle(); /** - * See the border-left-style property definition in CSS2. + * See the border-left-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -403,13 +403,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-top-width property definition in CSS2. + * See the border-top-width property definition in CSS2. */ public String getBorderTopWidth(); /** - * See the border-top-width property definition in CSS2. + * See the border-top-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -417,13 +417,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-right-width property definition in CSS2. + * See the border-right-width property definition in CSS2. */ public String getBorderRightWidth(); /** - * See the border-right-width property definition in CSS2. + * See the border-right-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -431,13 +431,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-bottom-width property definition in CSS2. + * See the border-bottom-width property definition in CSS2. */ public String getBorderBottomWidth(); /** - * See the border-bottom-width property definition in CSS2. + * See the border-bottom-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -445,13 +445,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-left-width property definition in CSS2. + * See the border-left-width property definition in CSS2. */ public String getBorderLeftWidth(); /** - * See the border-left-width property definition in CSS2. + * See the border-left-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -459,13 +459,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the border-width property definition in CSS2. + * See the border-width property definition in CSS2. */ public String getBorderWidth(); /** - * See the border-width property definition in CSS2. + * See the border-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -473,13 +473,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the bottom property definition in CSS2. + * See the bottom property definition in CSS2. */ public String getBottom(); /** - * See the bottom property definition in CSS2. + * See the bottom property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -487,13 +487,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the caption-side property definition in CSS2. + * See the caption-side property definition in CSS2. */ public String getCaptionSide(); /** - * See the caption-side property definition in CSS2. + * See the caption-side property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -501,13 +501,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the clear property definition in CSS2. + * See the clear property definition in CSS2. */ public String getClear(); /** - * See the clear property definition in CSS2. + * See the clear property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -515,13 +515,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the clip property definition in CSS2. + * See the clip property definition in CSS2. */ public String getClip(); /** - * See the clip property definition in CSS2. + * See the clip property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -529,13 +529,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the color property definition in CSS2. + * See the color property definition in CSS2. */ public String getColor(); /** - * See the color property definition in CSS2. + * See the color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -543,13 +543,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the content property definition in CSS2. + * See the content property definition in CSS2. */ public String getContent(); /** - * See the content property definition in CSS2. + * See the content property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -557,13 +557,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the counter-increment property definition in CSS2. + * See the counter-increment property definition in CSS2. */ public String getCounterIncrement(); /** - * See the counter-increment property definition in CSS2. + * See the counter-increment property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -571,13 +571,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the counter-reset property definition in CSS2. + * See the counter-reset property definition in CSS2. */ public String getCounterReset(); /** - * See the counter-reset property definition in CSS2. + * See the counter-reset property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -585,13 +585,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the cue property definition in CSS2. + * See the cue property definition in CSS2. */ public String getCue(); /** - * See the cue property definition in CSS2. + * See the cue property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -599,13 +599,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the cue-after property definition in CSS2. + * See the cue-after property definition in CSS2. */ public String getCueAfter(); /** - * See the cue-after property definition in CSS2. + * See the cue-after property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -613,13 +613,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the cue-before property definition in CSS2. + * See the cue-before property definition in CSS2. */ public String getCueBefore(); /** - * See the cue-before property definition in CSS2. + * See the cue-before property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -627,13 +627,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the cursor property definition in CSS2. + * See the cursor property definition in CSS2. */ public String getCursor(); /** - * See the cursor property definition in CSS2. + * See the cursor property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -641,13 +641,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the direction property definition in CSS2. + * See the direction property definition in CSS2. */ public String getDirection(); /** - * See the direction property definition in CSS2. + * See the direction property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -655,13 +655,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the display property definition in CSS2. + * See the display property definition in CSS2. */ public String getDisplay(); /** - * See the display property definition in CSS2. + * See the display property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -669,13 +669,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the elevation property definition in CSS2. + * See the elevation property definition in CSS2. */ public String getElevation(); /** - * See the elevation property definition in CSS2. + * See the elevation property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -683,13 +683,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the empty-cells property definition in CSS2. + * See the empty-cells property definition in CSS2. */ public String getEmptyCells(); /** - * See the empty-cells property definition in CSS2. + * See the empty-cells property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -697,13 +697,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the float property definition in CSS2. + * See the float property definition in CSS2. */ public String getCssFloat(); /** - * See the float property definition in CSS2. + * See the float property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -711,13 +711,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font property definition in CSS2. + * See the font property definition in CSS2. */ public String getFont(); /** - * See the font property definition in CSS2. + * See the font property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -725,13 +725,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-family property definition in CSS2. + * See the font-family property definition in CSS2. */ public String getFontFamily(); /** - * See the font-family property definition in CSS2. + * See the font-family property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -739,13 +739,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-size property definition in CSS2. + * See the font-size property definition in CSS2. */ public String getFontSize(); /** - * See the font-size property definition in CSS2. + * See the font-size property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -753,13 +753,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-size-adjust property definition in CSS2. + * See the font-size-adjust property definition in CSS2. */ public String getFontSizeAdjust(); /** - * See the font-size-adjust property definition in CSS2. + * See the font-size-adjust property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -767,13 +767,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-stretch property definition in CSS2. + * See the font-stretch property definition in CSS2. */ public String getFontStretch(); /** - * See the font-stretch property definition in CSS2. + * See the font-stretch property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -781,13 +781,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-style property definition in CSS2. + * See the font-style property definition in CSS2. */ public String getFontStyle(); /** - * See the font-style property definition in CSS2. + * See the font-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -795,13 +795,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-variant property definition in CSS2. + * See the font-variant property definition in CSS2. */ public String getFontVariant(); /** - * See the font-variant property definition in CSS2. + * See the font-variant property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -809,13 +809,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the font-weight property definition in CSS2. + * See the font-weight property definition in CSS2. */ public String getFontWeight(); /** - * See the font-weight property definition in CSS2. + * See the font-weight property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -823,13 +823,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the height property definition in CSS2. + * See the height property definition in CSS2. */ public String getHeight(); /** - * See the height property definition in CSS2. + * See the height property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -837,13 +837,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the left property definition in CSS2. + * See the left property definition in CSS2. */ public String getLeft(); /** - * See the left property definition in CSS2. + * See the left property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -851,13 +851,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the letter-spacing property definition in CSS2. + * See the letter-spacing property definition in CSS2. */ public String getLetterSpacing(); /** - * See the letter-spacing property definition in CSS2. + * See the letter-spacing property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -865,13 +865,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the line-height property definition in CSS2. + * See the line-height property definition in CSS2. */ public String getLineHeight(); /** - * See the line-height property definition in CSS2. + * See the line-height property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -879,13 +879,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the list-style property definition in CSS2. + * See the list-style property definition in CSS2. */ public String getListStyle(); /** - * See the list-style property definition in CSS2. + * See the list-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -893,13 +893,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the list-style-image property definition in CSS2. + * See the list-style-image property definition in CSS2. */ public String getListStyleImage(); /** - * See the list-style-image property definition in CSS2. + * See the list-style-image property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -907,13 +907,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the list-style-position property definition in CSS2. + * See the list-style-position property definition in CSS2. */ public String getListStylePosition(); /** - * See the list-style-position property definition in CSS2. + * See the list-style-position property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -921,13 +921,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the list-style-type property definition in CSS2. + * See the list-style-type property definition in CSS2. */ public String getListStyleType(); /** - * See the list-style-type property definition in CSS2. + * See the list-style-type property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -935,13 +935,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the margin property definition in CSS2. + * See the margin property definition in CSS2. */ public String getMargin(); /** - * See the margin property definition in CSS2. + * See the margin property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -949,13 +949,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the margin-top property definition in CSS2. + * See the margin-top property definition in CSS2. */ public String getMarginTop(); /** - * See the margin-top property definition in CSS2. + * See the margin-top property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -963,13 +963,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the margin-right property definition in CSS2. + * See the margin-right property definition in CSS2. */ public String getMarginRight(); /** - * See the margin-right property definition in CSS2. + * See the margin-right property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -977,13 +977,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the margin-bottom property definition in CSS2. + * See the margin-bottom property definition in CSS2. */ public String getMarginBottom(); /** - * See the margin-bottom property definition in CSS2. + * See the margin-bottom property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -991,13 +991,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the margin-left property definition in CSS2. + * See the margin-left property definition in CSS2. */ public String getMarginLeft(); /** - * See the margin-left property definition in CSS2. + * See the margin-left property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1005,13 +1005,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the marker-offset property definition in CSS2. + * See the marker-offset property definition in CSS2. */ public String getMarkerOffset(); /** - * See the marker-offset property definition in CSS2. + * See the marker-offset property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1019,13 +1019,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the marks property definition in CSS2. + * See the marks property definition in CSS2. */ public String getMarks(); /** - * See the marks property definition in CSS2. + * See the marks property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1033,13 +1033,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the max-height property definition in CSS2. + * See the max-height property definition in CSS2. */ public String getMaxHeight(); /** - * See the max-height property definition in CSS2. + * See the max-height property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1047,13 +1047,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the max-width property definition in CSS2. + * See the max-width property definition in CSS2. */ public String getMaxWidth(); /** - * See the max-width property definition in CSS2. + * See the max-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1061,13 +1061,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the min-height property definition in CSS2. + * See the min-height property definition in CSS2. */ public String getMinHeight(); /** - * See the min-height property definition in CSS2. + * See the min-height property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1075,13 +1075,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the min-width property definition in CSS2. + * See the min-width property definition in CSS2. */ public String getMinWidth(); /** - * See the min-width property definition in CSS2. + * See the min-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1089,13 +1089,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the orphans property definition in CSS2. + * See the orphans property definition in CSS2. */ public String getOrphans(); /** - * See the orphans property definition in CSS2. + * See the orphans property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1103,13 +1103,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the outline property definition in CSS2. + * See the outline property definition in CSS2. */ public String getOutline(); /** - * See the outline property definition in CSS2. + * See the outline property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1117,13 +1117,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the outline-color property definition in CSS2. + * See the outline-color property definition in CSS2. */ public String getOutlineColor(); /** - * See the outline-color property definition in CSS2. + * See the outline-color property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1131,13 +1131,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the outline-style property definition in CSS2. + * See the outline-style property definition in CSS2. */ public String getOutlineStyle(); /** - * See the outline-style property definition in CSS2. + * See the outline-style property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1145,13 +1145,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the outline-width property definition in CSS2. + * See the outline-width property definition in CSS2. */ public String getOutlineWidth(); /** - * See the outline-width property definition in CSS2. + * See the outline-width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1159,13 +1159,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the overflow property definition in CSS2. + * See the overflow property definition in CSS2. */ public String getOverflow(); /** - * See the overflow property definition in CSS2. + * See the overflow property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1173,13 +1173,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the padding property definition in CSS2. + * See the padding property definition in CSS2. */ public String getPadding(); /** - * See the padding property definition in CSS2. + * See the padding property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1187,13 +1187,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the padding-top property definition in CSS2. + * See the padding-top property definition in CSS2. */ public String getPaddingTop(); /** - * See the padding-top property definition in CSS2. + * See the padding-top property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1201,13 +1201,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the padding-right property definition in CSS2. + * See the padding-right property definition in CSS2. */ public String getPaddingRight(); /** - * See the padding-right property definition in CSS2. + * See the padding-right property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1215,13 +1215,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the padding-bottom property definition in CSS2. + * See the padding-bottom property definition in CSS2. */ public String getPaddingBottom(); /** - * See the padding-bottom property definition in CSS2. + * See the padding-bottom property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1229,13 +1229,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the padding-left property definition in CSS2. + * See the padding-left property definition in CSS2. */ public String getPaddingLeft(); /** - * See the padding-left property definition in CSS2. + * See the padding-left property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1243,13 +1243,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the page property definition in CSS2. + * See the page property definition in CSS2. */ public String getPage(); /** - * See the page property definition in CSS2. + * See the page property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1257,13 +1257,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the page-break-after property definition in CSS2. + * See the page-break-after property definition in CSS2. */ public String getPageBreakAfter(); /** - * See the page-break-after property definition in CSS2. + * See the page-break-after property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1271,13 +1271,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the page-break-before property definition in CSS2. + * See the page-break-before property definition in CSS2. */ public String getPageBreakBefore(); /** - * See the page-break-before property definition in CSS2. + * See the page-break-before property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1285,13 +1285,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the page-break-inside property definition in CSS2. + * See the page-break-inside property definition in CSS2. */ public String getPageBreakInside(); /** - * See the page-break-inside property definition in CSS2. + * See the page-break-inside property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1299,13 +1299,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the pause property definition in CSS2. + * See the pause property definition in CSS2. */ public String getPause(); /** - * See the pause property definition in CSS2. + * See the pause property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1313,13 +1313,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the pause-after property definition in CSS2. + * See the pause-after property definition in CSS2. */ public String getPauseAfter(); /** - * See the pause-after property definition in CSS2. + * See the pause-after property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1327,13 +1327,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the pause-before property definition in CSS2. + * See the pause-before property definition in CSS2. */ public String getPauseBefore(); /** - * See the pause-before property definition in CSS2. + * See the pause-before property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1341,13 +1341,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the pitch property definition in CSS2. + * See the pitch property definition in CSS2. */ public String getPitch(); /** - * See the pitch property definition in CSS2. + * See the pitch property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1355,13 +1355,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the pitch-range property definition in CSS2. + * See the pitch-range property definition in CSS2. */ public String getPitchRange(); /** - * See the pitch-range property definition in CSS2. + * See the pitch-range property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1369,13 +1369,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the play-during property definition in CSS2. + * See the play-during property definition in CSS2. */ public String getPlayDuring(); /** - * See the play-during property definition in CSS2. + * See the play-during property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1383,13 +1383,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the position property definition in CSS2. + * See the position property definition in CSS2. */ public String getPosition(); /** - * See the position property definition in CSS2. + * See the position property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1397,13 +1397,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the quotes property definition in CSS2. + * See the quotes property definition in CSS2. */ public String getQuotes(); /** - * See the quotes property definition in CSS2. + * See the quotes property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1411,13 +1411,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the richness property definition in CSS2. + * See the richness property definition in CSS2. */ public String getRichness(); /** - * See the richness property definition in CSS2. + * See the richness property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1425,13 +1425,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the right property definition in CSS2. + * See the right property definition in CSS2. */ public String getRight(); /** - * See the right property definition in CSS2. + * See the right property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1439,13 +1439,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the size property definition in CSS2. + * See the size property definition in CSS2. */ public String getSize(); /** - * See the size property definition in CSS2. + * See the size property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1453,13 +1453,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the speak property definition in CSS2. + * See the speak property definition in CSS2. */ public String getSpeak(); /** - * See the speak property definition in CSS2. + * See the speak property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1467,13 +1467,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the speak-header property definition in CSS2. + * See the speak-header property definition in CSS2. */ public String getSpeakHeader(); /** - * See the speak-header property definition in CSS2. + * See the speak-header property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1481,13 +1481,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the speak-numeral property definition in CSS2. + * See the speak-numeral property definition in CSS2. */ public String getSpeakNumeral(); /** - * See the speak-numeral property definition in CSS2. + * See the speak-numeral property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1495,13 +1495,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the speak-punctuation property definition in CSS2. + * See the speak-punctuation property definition in CSS2. */ public String getSpeakPunctuation(); /** - * See the speak-punctuation property definition in CSS2. + * See the speak-punctuation property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1509,13 +1509,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the speech-rate property definition in CSS2. + * See the speech-rate property definition in CSS2. */ public String getSpeechRate(); /** - * See the speech-rate property definition in CSS2. + * See the speech-rate property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1523,13 +1523,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the stress property definition in CSS2. + * See the stress property definition in CSS2. */ public String getStress(); /** - * See the stress property definition in CSS2. + * See the stress property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1537,13 +1537,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the table-layout property definition in CSS2. + * See the table-layout property definition in CSS2. */ public String getTableLayout(); /** - * See the table-layout property definition in CSS2. + * See the table-layout property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1551,13 +1551,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the text-align property definition in CSS2. + * See the text-align property definition in CSS2. */ public String getTextAlign(); /** - * See the text-align property definition in CSS2. + * See the text-align property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1565,13 +1565,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the text-decoration property definition in CSS2. + * See the text-decoration property definition in CSS2. */ public String getTextDecoration(); /** - * See the text-decoration property definition in CSS2. + * See the text-decoration property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1579,13 +1579,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the text-indent property definition in CSS2. + * See the text-indent property definition in CSS2. */ public String getTextIndent(); /** - * See the text-indent property definition in CSS2. + * See the text-indent property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1593,13 +1593,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the text-shadow property definition in CSS2. + * See the text-shadow property definition in CSS2. */ public String getTextShadow(); /** - * See the text-shadow property definition in CSS2. + * See the text-shadow property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1607,13 +1607,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the text-transform property definition in CSS2. + * See the text-transform property definition in CSS2. */ public String getTextTransform(); /** - * See the text-transform property definition in CSS2. + * See the text-transform property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1621,13 +1621,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the top property definition in CSS2. + * See the top property definition in CSS2. */ public String getTop(); /** - * See the top property definition in CSS2. + * See the top property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1635,13 +1635,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the unicode-bidi property definition in CSS2. + * See the unicode-bidi property definition in CSS2. */ public String getUnicodeBidi(); /** - * See the unicode-bidi property definition in CSS2. + * See the unicode-bidi property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1649,13 +1649,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the vertical-align property definition in CSS2. + * See the vertical-align property definition in CSS2. */ public String getVerticalAlign(); /** - * See the vertical-align property definition in CSS2. + * See the vertical-align property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1663,13 +1663,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the visibility property definition in CSS2. + * See the visibility property definition in CSS2. */ public String getVisibility(); /** - * See the visibility property definition in CSS2. + * See the visibility property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1677,13 +1677,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the voice-family property definition in CSS2. + * See the voice-family property definition in CSS2. */ public String getVoiceFamily(); /** - * See the voice-family property definition in CSS2. + * See the voice-family property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1691,13 +1691,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the volume property definition in CSS2. + * See the volume property definition in CSS2. */ public String getVolume(); /** - * See the volume property definition in CSS2. + * See the volume property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1705,13 +1705,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the white-space property definition in CSS2. + * See the white-space property definition in CSS2. */ public String getWhiteSpace(); /** - * See the white-space property definition in CSS2. + * See the white-space property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1719,13 +1719,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the widows property definition in CSS2. + * See the widows property definition in CSS2. */ public String getWidows(); /** - * See the widows property definition in CSS2. + * See the widows property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1733,13 +1733,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the width property definition in CSS2. + * See the width property definition in CSS2. */ public String getWidth(); /** - * See the width property definition in CSS2. + * See the width property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1747,13 +1747,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the word-spacing property definition in CSS2. + * See the word-spacing property definition in CSS2. */ public String getWordSpacing(); /** - * See the word-spacing property definition in CSS2. + * See the word-spacing property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ @@ -1761,13 +1761,13 @@ public interface CSS2Properties { throws DOMException; /** - * See the z-index property definition in CSS2. + * See the z-index property definition in CSS2. */ public String getZIndex(); /** - * See the z-index property definition in CSS2. + * See the z-index property definition in CSS2. * @exception DOMException - * SYNTAX_ERR: Raised if the new value has a syntax error and is + * SYNTAX_ERR: Raised if the new value has a syntax error and is * unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java index 8c0defa4753..55dc6f8ccd0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java @@ -15,34 +15,34 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSCharsetRule</code> interface represents a @charset rule in a - * CSS style sheet. The value of the <code>encoding</code> attribute does - * not affect the encoding of text data in the DOM objects; this encoding is - * always UTF-16. After a stylesheet is loaded, the value of the - * <code>encoding</code> attribute is the value found in the - * <code>@charset</code> rule. If there was no <code>@charset</code> in the - * original document, then no <code>CSSCharsetRule</code> is created. The - * value of the <code>encoding</code> attribute may also be used as a hint - * for the encoding used on serialization of the style sheet. - * <p> The value of the @charset rule (and therefore of the - * <code>CSSCharsetRule</code>) may not correspond to the encoding the - * document actually came in; character encoding information e.g. in an HTTP - * header, has priority (see CSS document representation) but this is not - * reflected in the <code>CSSCharsetRule</code>. + * The <code>CSSCharsetRule</code> interface represents a @charset rule in a + * CSS style sheet. The value of the <code>encoding</code> attribute does + * not affect the encoding of text data in the DOM objects; this encoding is + * always UTF-16. After a stylesheet is loaded, the value of the + * <code>encoding</code> attribute is the value found in the + * <code>@charset</code> rule. If there was no <code>@charset</code> in the + * original document, then no <code>CSSCharsetRule</code> is created. The + * value of the <code>encoding</code> attribute may also be used as a hint + * for the encoding used on serialization of the style sheet. + * <p> The value of the @charset rule (and therefore of the + * <code>CSSCharsetRule</code>) may not correspond to the encoding the + * document actually came in; character encoding information e.g. in an HTTP + * header, has priority (see CSS document representation) but this is not + * reflected in the <code>CSSCharsetRule</code>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSCharsetRule extends CSSRule { /** - * The encoding information used in this <code>@charset</code> rule. + * The encoding information used in this <code>@charset</code> rule. */ public String getEncoding(); /** - * The encoding information used in this <code>@charset</code> rule. + * The encoding information used in this <code>@charset</code> rule. * @exception DOMException - * SYNTAX_ERR: Raised if the specified encoding value has a syntax error + * SYNTAX_ERR: Raised if the specified encoding value has a syntax error * and is unparsable. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is * readonly. */ public void setEncoding(String encoding) diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java index a1795706118..e446ea8c5ab 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java @@ -13,15 +13,15 @@ package org.w3c.dom.css; /** - * The <code>CSSFontFaceRule</code> interface represents a @font-face rule in - * a CSS style sheet. The <code>@font-face</code> rule is used to hold a set - * of font descriptions. + * The <code>CSSFontFaceRule</code> interface represents a @font-face rule in + * a CSS style sheet. The <code>@font-face</code> rule is used to hold a set + * of font descriptions. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSFontFaceRule extends CSSRule { /** - * The declaration-block of this rule. + * The declaration-block of this rule. */ public CSSStyleDeclaration getStyle(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSImportRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSImportRule.java index e18ad569bcb..3dee5d80b37 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSImportRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSImportRule.java @@ -15,29 +15,29 @@ package org.w3c.dom.css; import org.w3c.dom.stylesheets.MediaList; /** - * The <code>CSSImportRule</code> interface represents a @import rule within - * a CSS style sheet. The <code>@import</code> rule is used to import style - * rules from other style sheets. + * The <code>CSSImportRule</code> interface represents a @import rule within + * a CSS style sheet. The <code>@import</code> rule is used to import style + * rules from other style sheets. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSImportRule extends CSSRule { /** - * The location of the style sheet to be imported. The attribute will not - * contain the <code>"url(...)"</code> specifier around the URI. + * The location of the style sheet to be imported. The attribute will not + * contain the <code>"url(...)"</code> specifier around the URI. */ public String getHref(); /** - * A list of media types for which this style sheet may be used. + * A list of media types for which this style sheet may be used. */ public MediaList getMedia(); /** - * The style sheet referred to by this rule, if it has been loaded. The - * value of this attribute is <code>null</code> if the style sheet has - * not yet been loaded or if it will not be loaded (e.g. if the style - * sheet is for a media type not supported by the user agent). + * The style sheet referred to by this rule, if it has been loaded. The + * value of this attribute is <code>null</code> if the style sheet has + * not yet been loaded or if it will not be loaded (e.g. if the style + * sheet is for a media type not supported by the user agent). */ public CSSStyleSheet getStyleSheet(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java index 68a73045ede..6e977923db1 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java @@ -16,58 +16,58 @@ import org.w3c.dom.DOMException; import org.w3c.dom.stylesheets.MediaList; /** - * The <code>CSSMediaRule</code> interface represents a @media rule in a CSS - * style sheet. A <code>@media</code> rule can be used to delimit style - * rules for specific media types. + * The <code>CSSMediaRule</code> interface represents a @media rule in a CSS + * style sheet. A <code>@media</code> rule can be used to delimit style + * rules for specific media types. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSMediaRule extends CSSRule { /** - * A list of media types for this rule. + * A list of media types for this rule. */ public MediaList getMedia(); /** - * A list of all CSS rules contained within the media block. + * A list of all CSS rules contained within the media block. */ public CSSRuleList getCssRules(); /** - * Used to insert a new rule into the media block. - * @param rule The parsable text representing the rule. For rule sets - * this contains both the selector and the style declaration. For - * at-rules, this specifies both the at-identifier and the rule - * content. - * @param index The index within the media block's rule collection of - * the rule before which to insert the specified rule. If the - * specified index is equal to the length of the media blocks's rule - * collection, the rule will be added to the end of the media block. - * @return The index within the media block's rule collection of the - * newly inserted rule. + * Used to insert a new rule into the media block. + * @param rule The parsable text representing the rule. For rule sets + * this contains both the selector and the style declaration. For + * at-rules, this specifies both the at-identifier and the rule + * content. + * @param index The index within the media block's rule collection of + * the rule before which to insert the specified rule. If the + * specified index is equal to the length of the media blocks's rule + * collection, the rule will be added to the end of the media block. + * @return The index within the media block's rule collection of the + * newly inserted rule. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the - * specified index, e.g., if an <code>@import</code> rule is inserted + * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the + * specified index, e.g., if an <code>@import</code> rule is inserted * after a standard rule set or other at-rule. - * <br>INDEX_SIZE_ERR: Raised if the specified index is not a valid + * <br>INDEX_SIZE_ERR: Raised if the specified index is not a valid * insertion point. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media rule is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media rule is * readonly. - * <br>SYNTAX_ERR: Raised if the specified rule has a syntax error and + * <br>SYNTAX_ERR: Raised if the specified rule has a syntax error and * is unparsable. */ - public int insertRule(String rule, + public int insertRule(String rule, int index) throws DOMException; /** - * Used to delete a rule from the media block. - * @param index The index within the media block's rule collection of - * the rule to remove. + * Used to delete a rule from the media block. + * @param index The index within the media block's rule collection of + * the rule to remove. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index does not correspond to + * INDEX_SIZE_ERR: Raised if the specified index does not correspond to * a rule in the media rule list. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media rule is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media rule is * readonly. */ public void deleteRule(int index) diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPageRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPageRule.java index 538626a97e9..eb8f783f5f8 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPageRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPageRule.java @@ -15,21 +15,21 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSPageRule</code> interface represents a @page rule within a - * CSS style sheet. The <code>@page</code> rule is used to specify the - * dimensions, orientation, margins, etc. of a page box for paged media. + * The <code>CSSPageRule</code> interface represents a @page rule within a + * CSS style sheet. The <code>@page</code> rule is used to specify the + * dimensions, orientation, margins, etc. of a page box for paged media. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSPageRule extends CSSRule { /** - * The parsable textual representation of the page selector for the rule. + * The parsable textual representation of the page selector for the rule. */ public String getSelectorText(); /** - * The parsable textual representation of the page selector for the rule. + * The parsable textual representation of the page selector for the rule. * @exception DOMException - * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax * error and is unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. */ @@ -37,7 +37,7 @@ public interface CSSPageRule extends CSSRule { throws DOMException; /** - * The declaration-block of this rule. + * The declaration-block of this rule. */ public CSSStyleDeclaration getStyle(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java index 4131d26cda3..25f906a7068 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java @@ -16,153 +16,153 @@ import org.w3c.dom.DOMException; /** * The <code>CSSPrimitiveValue</code> interface represents a single CSS value - * . This interface may be used to determine the value of a specific style - * property currently set in a block or to set a specific style property - * explicitly within the block. An instance of this interface might be - * obtained from the <code>getPropertyCSSValue</code> method of the - * <code>CSSStyleDeclaration</code> interface. A - * <code>CSSPrimitiveValue</code> object only occurs in a context of a CSS - * property. - * <p> Conversions are allowed between absolute values (from millimeters to - * centimeters, from degrees to radians, and so on) but not between relative - * values. (For example, a pixel value cannot be converted to a centimeter - * value.) Percentage values can't be converted since they are relative to - * the parent value (or another property value). There is one exception for - * color percentage values: since a color percentage value is relative to - * the range 0-255, a color percentage value can be converted to a number; - * (see also the <code>RGBColor</code> interface). + * . This interface may be used to determine the value of a specific style + * property currently set in a block or to set a specific style property + * explicitly within the block. An instance of this interface might be + * obtained from the <code>getPropertyCSSValue</code> method of the + * <code>CSSStyleDeclaration</code> interface. A + * <code>CSSPrimitiveValue</code> object only occurs in a context of a CSS + * property. + * <p> Conversions are allowed between absolute values (from millimeters to + * centimeters, from degrees to radians, and so on) but not between relative + * values. (For example, a pixel value cannot be converted to a centimeter + * value.) Percentage values can't be converted since they are relative to + * the parent value (or another property value). There is one exception for + * color percentage values: since a color percentage value is relative to + * the range 0-255, a color percentage value can be converted to a number; + * (see also the <code>RGBColor</code> interface). * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSPrimitiveValue extends CSSValue { // UnitTypes /** - * The value is not a recognized CSS2 value. The value can only be + * The value is not a recognized CSS2 value. The value can only be * obtained by using the <code>cssText</code> attribute. */ public static final short CSS_UNKNOWN = 0; /** - * The value is a simple number. The value can be obtained by using the + * The value is a simple number. The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_NUMBER = 1; /** - * The value is a percentage. The value can be obtained by using the + * The value is a percentage. The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_PERCENTAGE = 2; /** - * The value is a length (ems). The value can be obtained by using the + * The value is a length (ems). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_EMS = 3; /** - * The value is a length (exs). The value can be obtained by using the + * The value is a length (exs). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_EXS = 4; /** - * The value is a length (px). The value can be obtained by using the + * The value is a length (px). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_PX = 5; /** - * The value is a length (cm). The value can be obtained by using the + * The value is a length (cm). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_CM = 6; /** - * The value is a length (mm). The value can be obtained by using the + * The value is a length (mm). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_MM = 7; /** - * The value is a length (in). The value can be obtained by using the + * The value is a length (in). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_IN = 8; /** - * The value is a length (pt). The value can be obtained by using the + * The value is a length (pt). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_PT = 9; /** - * The value is a length (pc). The value can be obtained by using the + * The value is a length (pc). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_PC = 10; /** - * The value is an angle (deg). The value can be obtained by using the + * The value is an angle (deg). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_DEG = 11; /** - * The value is an angle (rad). The value can be obtained by using the + * The value is an angle (rad). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_RAD = 12; /** - * The value is an angle (grad). The value can be obtained by using the + * The value is an angle (grad). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_GRAD = 13; /** - * The value is a time (ms). The value can be obtained by using the + * The value is a time (ms). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_MS = 14; /** - * The value is a time (s). The value can be obtained by using the + * The value is a time (s). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_S = 15; /** - * The value is a frequency (Hz). The value can be obtained by using the + * The value is a frequency (Hz). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_HZ = 16; /** - * The value is a frequency (kHz). The value can be obtained by using the + * The value is a frequency (kHz). The value can be obtained by using the * <code>getFloatValue</code> method. */ public static final short CSS_KHZ = 17; /** - * The value is a number with an unknown dimension. The value can be + * The value is a number with an unknown dimension. The value can be * obtained by using the <code>getFloatValue</code> method. */ public static final short CSS_DIMENSION = 18; /** - * The value is a STRING. The value can be obtained by using the + * The value is a STRING. The value can be obtained by using the * <code>getStringValue</code> method. */ public static final short CSS_STRING = 19; /** - * The value is a URI. The value can be obtained by using the + * The value is a URI. The value can be obtained by using the * <code>getStringValue</code> method. */ public static final short CSS_URI = 20; /** - * The value is an identifier. The value can be obtained by using the + * The value is an identifier. The value can be obtained by using the * <code>getStringValue</code> method. */ public static final short CSS_IDENT = 21; /** - * The value is a attribute function. The value can be obtained by using + * The value is a attribute function. The value can be obtained by using * the <code>getStringValue</code> method. */ public static final short CSS_ATTR = 22; /** - * The value is a counter or counters function. The value can be obtained + * The value is a counter or counters function. The value can be obtained * by using the <code>getCounterValue</code> method. */ public static final short CSS_COUNTER = 23; /** - * The value is a rect function. The value can be obtained by using the + * The value is a rect function. The value can be obtained by using the * <code>getRectValue</code> method. */ public static final short CSS_RECT = 24; /** - * The value is a RGB color. The value can be obtained by using the + * The value is a RGB color. The value can be obtained by using the * <code>getRGBColorValue</code> method. */ public static final short CSS_RGBCOLOR = 25; @@ -173,122 +173,122 @@ public interface CSSPrimitiveValue extends CSSValue { public short getPrimitiveType(); /** - * A method to set the float value with a specified unit. If the property - * attached with this value can not accept the specified unit or the - * float value, the value will be unchanged and a - * <code>DOMException</code> will be raised. - * @param unitType A unit code as defined above. The unit code can only - * be a float unit type (i.e. <code>CSS_NUMBER</code>, - * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, - * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, - * <code>CSS_MM</code>, <code>CSS_IN</code>, <code>CSS_PT</code>, - * <code>CSS_PC</code>, <code>CSS_DEG</code>, <code>CSS_RAD</code>, - * <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>, - * <code>CSS_HZ</code>, <code>CSS_KHZ</code>, - * <code>CSS_DIMENSION</code>). - * @param floatValue The new float value. + * A method to set the float value with a specified unit. If the property + * attached with this value can not accept the specified unit or the + * float value, the value will be unchanged and a + * <code>DOMException</code> will be raised. + * @param unitType A unit code as defined above. The unit code can only + * be a float unit type (i.e. <code>CSS_NUMBER</code>, + * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, + * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, + * <code>CSS_MM</code>, <code>CSS_IN</code>, <code>CSS_PT</code>, + * <code>CSS_PC</code>, <code>CSS_DEG</code>, <code>CSS_RAD</code>, + * <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>, + * <code>CSS_HZ</code>, <code>CSS_KHZ</code>, + * <code>CSS_DIMENSION</code>). + * @param floatValue The new float value. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the attached property doesn't support + * INVALID_ACCESS_ERR: Raised if the attached property doesn't support * the float value or the unit type. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ - public void setFloatValue(short unitType, + public void setFloatValue(short unitType, float floatValue) throws DOMException; /** - * This method is used to get a float value in a specified unit. If this - * CSS value doesn't contain a float value or can't be converted into - * the specified unit, a <code>DOMException</code> is raised. - * @param unitType A unit code to get the float value. The unit code can - * only be a float unit type (i.e. <code>CSS_NUMBER</code>, - * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, - * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, - * <code>CSS_MM</code>, <code>CSS_IN</code>, <code>CSS_PT</code>, - * <code>CSS_PC</code>, <code>CSS_DEG</code>, <code>CSS_RAD</code>, - * <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>, - * <code>CSS_HZ</code>, <code>CSS_KHZ</code>, - * <code>CSS_DIMENSION</code>). - * @return The float value in the specified unit. + * This method is used to get a float value in a specified unit. If this + * CSS value doesn't contain a float value or can't be converted into + * the specified unit, a <code>DOMException</code> is raised. + * @param unitType A unit code to get the float value. The unit code can + * only be a float unit type (i.e. <code>CSS_NUMBER</code>, + * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, + * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, + * <code>CSS_MM</code>, <code>CSS_IN</code>, <code>CSS_PT</code>, + * <code>CSS_PC</code>, <code>CSS_DEG</code>, <code>CSS_RAD</code>, + * <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>, + * <code>CSS_HZ</code>, <code>CSS_KHZ</code>, + * <code>CSS_DIMENSION</code>). + * @return The float value in the specified unit. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a float - * value or if the float value can't be converted into the specified - * unit. + * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a float + * value or if the float value can't be converted into the specified + * unit. */ public float getFloatValue(short unitType) throws DOMException; /** - * A method to set the string value with the specified unit. If the - * property attached to this value can't accept the specified unit or - * the string value, the value will be unchanged and a - * <code>DOMException</code> will be raised. - * @param stringType A string code as defined above. The string code can - * only be a string unit type (i.e. <code>CSS_STRING</code>, - * <code>CSS_URI</code>, <code>CSS_IDENT</code>, and - * <code>CSS_ATTR</code>). - * @param stringValue The new string value. + * A method to set the string value with the specified unit. If the + * property attached to this value can't accept the specified unit or + * the string value, the value will be unchanged and a + * <code>DOMException</code> will be raised. + * @param stringType A string code as defined above. The string code can + * only be a string unit type (i.e. <code>CSS_STRING</code>, + * <code>CSS_URI</code>, <code>CSS_IDENT</code>, and + * <code>CSS_ATTR</code>). + * @param stringValue The new string value. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string - * value or if the string value can't be converted into the specified + * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string + * value or if the string value can't be converted into the specified * unit. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ - public void setStringValue(short stringType, + public void setStringValue(short stringType, String stringValue) throws DOMException; /** - * This method is used to get the string value. If the CSS value doesn't - * contain a string value, a <code>DOMException</code> is raised. Some - * properties (like 'font-family' or 'voice-family') convert a - * whitespace separated list of idents to a string. - * @return The string value in the current unit. The current - * <code>primitiveType</code> can only be a string unit type (i.e. - * <code>CSS_STRING</code>, <code>CSS_URI</code>, - * <code>CSS_IDENT</code> and <code>CSS_ATTR</code>). + * This method is used to get the string value. If the CSS value doesn't + * contain a string value, a <code>DOMException</code> is raised. Some + * properties (like 'font-family' or 'voice-family') convert a + * whitespace separated list of idents to a string. + * @return The string value in the current unit. The current + * <code>primitiveType</code> can only be a string unit type (i.e. + * <code>CSS_STRING</code>, <code>CSS_URI</code>, + * <code>CSS_IDENT</code> and <code>CSS_ATTR</code>). * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string - * value. + * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string + * value. */ public String getStringValue() throws DOMException; /** - * This method is used to get the Counter value. If this CSS value - * doesn't contain a counter value, a <code>DOMException</code> is - * raised. Modification to the corresponding style property can be - * achieved using the <code>Counter</code> interface. + * This method is used to get the Counter value. If this CSS value + * doesn't contain a counter value, a <code>DOMException</code> is + * raised. Modification to the corresponding style property can be + * achieved using the <code>Counter</code> interface. * @return The Counter value. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a - * Counter value (e.g. this is not <code>CSS_COUNTER</code>). + * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a + * Counter value (e.g. this is not <code>CSS_COUNTER</code>). */ public Counter getCounterValue() throws DOMException; /** - * This method is used to get the Rect value. If this CSS value doesn't - * contain a rect value, a <code>DOMException</code> is raised. - * Modification to the corresponding style property can be achieved - * using the <code>Rect</code> interface. + * This method is used to get the Rect value. If this CSS value doesn't + * contain a rect value, a <code>DOMException</code> is raised. + * Modification to the corresponding style property can be achieved + * using the <code>Rect</code> interface. * @return The Rect value. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a Rect - * value. (e.g. this is not <code>CSS_RECT</code>). + * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a Rect + * value. (e.g. this is not <code>CSS_RECT</code>). */ public Rect getRectValue() throws DOMException; /** - * This method is used to get the RGB color. If this CSS value doesn't - * contain a RGB color value, a <code>DOMException</code> is raised. - * Modification to the corresponding style property can be achieved - * using the <code>RGBColor</code> interface. + * This method is used to get the RGB color. If this CSS value doesn't + * contain a RGB color value, a <code>DOMException</code> is raised. + * Modification to the corresponding style property can be achieved + * using the <code>RGBColor</code> interface. * @return the RGB color value. * @exception DOMException - * INVALID_ACCESS_ERR: Raised if the attached property can't return a - * RGB color value (e.g. this is not <code>CSS_RGBCOLOR</code>). + * INVALID_ACCESS_ERR: Raised if the attached property can't return a + * RGB color value (e.g. this is not <code>CSS_RGBCOLOR</code>). */ public RGBColor getRGBColorValue() throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRule.java index 788f946eca5..dfd98aed901 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRule.java @@ -15,11 +15,11 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSRule</code> interface is the abstract base interface for any - * type of CSS statement. This includes both rule sets and at-rules. An - * implementation is expected to preserve all rules specified in a CSS style - * sheet, even if the rule is not recognized by the parser. Unrecognized - * rules are represented using the <code>CSSUnknownRule</code> interface. + * The <code>CSSRule</code> interface is the abstract base interface for any + * type of CSS statement. This includes both rule sets and at-rules. An + * implementation is expected to preserve all rules specified in a CSS style + * sheet, even if the rule is not recognized by the parser. Unrecognized + * rules are represented using the <code>CSSUnknownRule</code> interface. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ @@ -55,27 +55,27 @@ public interface CSSRule { public static final short PAGE_RULE = 6; /** - * The type of the rule, as defined above. The expectation is that - * binding-specific casting methods can be used to cast down from an - * instance of the <code>CSSRule</code> interface to the specific - * derived interface implied by the <code>type</code>. + * The type of the rule, as defined above. The expectation is that + * binding-specific casting methods can be used to cast down from an + * instance of the <code>CSSRule</code> interface to the specific + * derived interface implied by the <code>type</code>. */ public short getType(); /** - * The parsable textual representation of the rule. This reflects the - * current state of the rule and not its initial value. + * The parsable textual representation of the rule. This reflects the + * current state of the rule and not its initial value. */ public String getCssText(); /** - * The parsable textual representation of the rule. This reflects the - * current state of the rule and not its initial value. + * The parsable textual representation of the rule. This reflects the + * current state of the rule and not its initial value. * @exception DOMException - * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax * error and is unparsable. - * <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string + * <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string * value represents a different type of rule than the current one. - * <br>HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at + * <br>HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at * this point in the style sheet. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly. */ @@ -83,14 +83,14 @@ public interface CSSRule { throws DOMException; /** - * The style sheet that contains this rule. + * The style sheet that contains this rule. */ public CSSStyleSheet getParentStyleSheet(); /** - * If this rule is contained inside another rule (e.g. a style rule - * inside an @media block), this is the containing rule. If this rule is - * not nested inside any other rules, this returns <code>null</code>. + * If this rule is contained inside another rule (e.g. a style rule + * inside an @media block), this is the containing rule. If this rule is + * not nested inside any other rules, this returns <code>null</code>. */ public CSSRule getParentRule(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRuleList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRuleList.java index 41c2c68377c..b875210cccd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRuleList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSRuleList.java @@ -13,30 +13,30 @@ package org.w3c.dom.css; /** - * The <code>CSSRuleList</code> interface provides the abstraction of an - * ordered collection of CSS rules. - * <p> The items in the <code>CSSRuleList</code> are accessible via an - * integral index, starting from 0. + * The <code>CSSRuleList</code> interface provides the abstraction of an + * ordered collection of CSS rules. + * <p> The items in the <code>CSSRuleList</code> are accessible via an + * integral index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSRuleList { /** - * The number of <code>CSSRules</code> in the list. The range of valid - * child rule indices is <code>0</code> to <code>length-1</code> - * inclusive. + * The number of <code>CSSRules</code> in the list. The range of valid + * child rule indices is <code>0</code> to <code>length-1</code> + * inclusive. */ public int getLength(); /** - * Used to retrieve a CSS rule by ordinal index. The order in this - * collection represents the order of the rules in the CSS style sheet. - * If index is greater than or equal to the number of rules in the list, - * this returns <code>null</code>. + * Used to retrieve a CSS rule by ordinal index. The order in this + * collection represents the order of the rules in the CSS style sheet. + * If index is greater than or equal to the number of rules in the list, + * this returns <code>null</code>. * @param index Index into the collection - * @return The style rule at the <code>index</code> position in the - * <code>CSSRuleList</code>, or <code>null</code> if that is not a - * valid index. + * @return The style rule at the <code>index</code> position in the + * <code>CSSRuleList</code>, or <code>null</code> if that is not a + * valid index. */ public CSSRule item(int index); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java index e5e346b0a71..91b9d9adf02 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java @@ -15,147 +15,147 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSStyleDeclaration</code> interface represents a single CSS - * declaration block. This interface may be used to determine the style - * properties currently set in a block or to set style properties explicitly - * within the block. - * <p> While an implementation may not recognize all CSS properties within a - * CSS declaration block, it is expected to provide access to all specified + * The <code>CSSStyleDeclaration</code> interface represents a single CSS + * declaration block. This interface may be used to determine the style + * properties currently set in a block or to set style properties explicitly + * within the block. + * <p> While an implementation may not recognize all CSS properties within a + * CSS declaration block, it is expected to provide access to all specified * properties in the style sheet through the <code>CSSStyleDeclaration</code> - * interface. Furthermore, implementations that support a specific level of - * CSS should correctly handle CSS shorthand properties for that level. For - * a further discussion of shorthand properties, see the - * <code>CSS2Properties</code> interface. - * <p> This interface is also used to provide a read-only access to the - * computed values of an element. See also the <code>ViewCSS</code> - * interface. The CSS Object Model doesn't provide an access to the - * specified or actual values of the CSS cascade. + * interface. Furthermore, implementations that support a specific level of + * CSS should correctly handle CSS shorthand properties for that level. For + * a further discussion of shorthand properties, see the + * <code>CSS2Properties</code> interface. + * <p> This interface is also used to provide a read-only access to the + * computed values of an element. See also the <code>ViewCSS</code> + * interface. The CSS Object Model doesn't provide an access to the + * specified or actual values of the CSS cascade. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSStyleDeclaration { /** - * The parsable textual representation of the declaration block - * (excluding the surrounding curly braces). Setting this attribute will - * result in the parsing of the new value and resetting of all the - * properties in the declaration block including the removal or addition - * of properties. + * The parsable textual representation of the declaration block + * (excluding the surrounding curly braces). Setting this attribute will + * result in the parsing of the new value and resetting of all the + * properties in the declaration block including the removal or addition + * of properties. */ public String getCssText(); /** - * The parsable textual representation of the declaration block - * (excluding the surrounding curly braces). Setting this attribute will - * result in the parsing of the new value and resetting of all the - * properties in the declaration block including the removal or addition - * of properties. + * The parsable textual representation of the declaration block + * (excluding the surrounding curly braces). Setting this attribute will + * result in the parsing of the new value and resetting of all the + * properties in the declaration block including the removal or addition + * of properties. * @exception DOMException - * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax * error and is unparsable. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is * readonly or a property is readonly. */ public void setCssText(String cssText) throws DOMException; /** - * Used to retrieve the value of a CSS property if it has been explicitly - * set within this declaration block. - * @param propertyName The name of the CSS property. See the CSS - * property index. - * @return Returns the value of the property if it has been explicitly - * set for this declaration block. Returns the empty string if the - * property has not been set. + * Used to retrieve the value of a CSS property if it has been explicitly + * set within this declaration block. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @return Returns the value of the property if it has been explicitly + * set for this declaration block. Returns the empty string if the + * property has not been set. */ public String getPropertyValue(String propertyName); /** - * Used to retrieve the object representation of the value of a CSS - * property if it has been explicitly set within this declaration block. - * This method returns <code>null</code> if the property is a shorthand - * property. Shorthand property values can only be accessed and modified - * as strings, using the <code>getPropertyValue</code> and - * <code>setProperty</code> methods. - * @param propertyName The name of the CSS property. See the CSS - * property index. - * @return Returns the value of the property if it has been explicitly - * set for this declaration block. Returns <code>null</code> if the - * property has not been set. + * Used to retrieve the object representation of the value of a CSS + * property if it has been explicitly set within this declaration block. + * This method returns <code>null</code> if the property is a shorthand + * property. Shorthand property values can only be accessed and modified + * as strings, using the <code>getPropertyValue</code> and + * <code>setProperty</code> methods. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @return Returns the value of the property if it has been explicitly + * set for this declaration block. Returns <code>null</code> if the + * property has not been set. */ public CSSValue getPropertyCSSValue(String propertyName); /** - * Used to remove a CSS property if it has been explicitly set within - * this declaration block. - * @param propertyName The name of the CSS property. See the CSS - * property index. - * @return Returns the value of the property if it has been explicitly - * set for this declaration block. Returns the empty string if the - * property has not been set or the property name does not correspond - * to a known CSS property. + * Used to remove a CSS property if it has been explicitly set within + * this declaration block. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @return Returns the value of the property if it has been explicitly + * set for this declaration block. Returns the empty string if the + * property has not been set or the property name does not correspond + * to a known CSS property. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is readonly + * NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is readonly * or the property is readonly. */ public String removeProperty(String propertyName) throws DOMException; /** - * Used to retrieve the priority of a CSS property (e.g. the - * <code>"important"</code> qualifier) if the priority has been - * explicitly set in this declaration block. - * @param propertyName The name of the CSS property. See the CSS - * property index. - * @return A string representing the priority (e.g. - * <code>"important"</code>) if the property has been explicitly set - * in this declaration block and has a priority specified. The empty - * string otherwise. + * Used to retrieve the priority of a CSS property (e.g. the + * <code>"important"</code> qualifier) if the priority has been + * explicitly set in this declaration block. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @return A string representing the priority (e.g. + * <code>"important"</code>) if the property has been explicitly set + * in this declaration block and has a priority specified. The empty + * string otherwise. */ public String getPropertyPriority(String propertyName); /** - * Used to set a property value and priority within this declaration - * block. <code>setProperty</code> permits to modify a property or add a - * new one in the declaration block. Any call to this method may modify + * Used to set a property value and priority within this declaration + * block. <code>setProperty</code> permits to modify a property or add a + * new one in the declaration block. Any call to this method may modify * the order of properties in the <code>item</code> method. - * @param propertyName The name of the CSS property. See the CSS - * property index. - * @param value The new value of the property. - * @param priority The new priority of the property (e.g. - * <code>"important"</code>) or the empty string if none. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @param value The new value of the property. + * @param priority The new priority of the property (e.g. + * <code>"important"</code>) or the empty string if none. * @exception DOMException - * SYNTAX_ERR: Raised if the specified value has a syntax error and is + * SYNTAX_ERR: Raised if the specified value has a syntax error and is * unparsable. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is * readonly or the property is readonly. */ - public void setProperty(String propertyName, - String value, + public void setProperty(String propertyName, + String value, String priority) throws DOMException; /** - * The number of properties that have been explicitly set in this - * declaration block. The range of valid indices is 0 to length-1 - * inclusive. + * The number of properties that have been explicitly set in this + * declaration block. The range of valid indices is 0 to length-1 + * inclusive. */ public int getLength(); /** - * Used to retrieve the properties that have been explicitly set in this - * declaration block. The order of the properties retrieved using this - * method does not have to be the order in which they were set. This - * method can be used to iterate over all properties in this declaration - * block. - * @param index Index of the property name to retrieve. - * @return The name of the property at this ordinal position. The empty - * string if no property exists at this position. + * Used to retrieve the properties that have been explicitly set in this + * declaration block. The order of the properties retrieved using this + * method does not have to be the order in which they were set. This + * method can be used to iterate over all properties in this declaration + * block. + * @param index Index of the property name to retrieve. + * @return The name of the property at this ordinal position. The empty + * string if no property exists at this position. */ public String item(int index); /** - * The CSS rule that contains this declaration block or <code>null</code> - * if this <code>CSSStyleDeclaration</code> is not attached to a - * <code>CSSRule</code>. + * The CSS rule that contains this declaration block or <code>null</code> + * if this <code>CSSStyleDeclaration</code> is not attached to a + * <code>CSSRule</code>. */ public CSSRule getParentRule(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java index 626f3224b4c..e7377dcbee9 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java @@ -15,24 +15,24 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSStyleRule</code> interface represents a single rule set in a - * CSS style sheet. + * The <code>CSSStyleRule</code> interface represents a single rule set in a + * CSS style sheet. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSStyleRule extends CSSRule { /** - * The textual representation of the selector for the rule set. The - * implementation may have stripped out insignificant whitespace while - * parsing the selector. + * The textual representation of the selector for the rule set. The + * implementation may have stripped out insignificant whitespace while + * parsing the selector. */ public String getSelectorText(); /** - * The textual representation of the selector for the rule set. The - * implementation may have stripped out insignificant whitespace while - * parsing the selector. + * The textual representation of the selector for the rule set. The + * implementation may have stripped out insignificant whitespace while + * parsing the selector. * @exception DOMException - * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax * error and is unparsable. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. */ @@ -40,7 +40,7 @@ public interface CSSStyleRule extends CSSRule { throws DOMException; /** - * The declaration-block of this rule set. + * The declaration-block of this rule set. */ public CSSStyleDeclaration getStyle(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java index b529e5db089..c9538e436df 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java @@ -16,67 +16,67 @@ import org.w3c.dom.DOMException; import org.w3c.dom.stylesheets.StyleSheet; /** - * The <code>CSSStyleSheet</code> interface is a concrete interface used to - * represent a CSS style sheet i.e., a style sheet whose content type is - * "text/css". + * The <code>CSSStyleSheet</code> interface is a concrete interface used to + * represent a CSS style sheet i.e., a style sheet whose content type is + * "text/css". * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSStyleSheet extends StyleSheet { /** - * If this style sheet comes from an <code>@import</code> rule, the - * <code>ownerRule</code> attribute will contain the - * <code>CSSImportRule</code>. In that case, the <code>ownerNode</code> - * attribute in the <code>StyleSheet</code> interface will be - * <code>null</code>. If the style sheet comes from an element or a - * processing instruction, the <code>ownerRule</code> attribute will be - * <code>null</code> and the <code>ownerNode</code> attribute will - * contain the <code>Node</code>. + * If this style sheet comes from an <code>@import</code> rule, the + * <code>ownerRule</code> attribute will contain the + * <code>CSSImportRule</code>. In that case, the <code>ownerNode</code> + * attribute in the <code>StyleSheet</code> interface will be + * <code>null</code>. If the style sheet comes from an element or a + * processing instruction, the <code>ownerRule</code> attribute will be + * <code>null</code> and the <code>ownerNode</code> attribute will + * contain the <code>Node</code>. */ public CSSRule getOwnerRule(); /** - * The list of all CSS rules contained within the style sheet. This - * includes both rule sets and at-rules. + * The list of all CSS rules contained within the style sheet. This + * includes both rule sets and at-rules. */ public CSSRuleList getCssRules(); /** - * Used to insert a new rule into the style sheet. The new rule now - * becomes part of the cascade. - * @param rule The parsable text representing the rule. For rule sets - * this contains both the selector and the style declaration. For - * at-rules, this specifies both the at-identifier and the rule - * content. - * @param index The index within the style sheet's rule list of the rule - * before which to insert the specified rule. If the specified index - * is equal to the length of the style sheet's rule collection, the - * rule will be added to the end of the style sheet. - * @return The index within the style sheet's rule collection of the - * newly inserted rule. + * Used to insert a new rule into the style sheet. The new rule now + * becomes part of the cascade. + * @param rule The parsable text representing the rule. For rule sets + * this contains both the selector and the style declaration. For + * at-rules, this specifies both the at-identifier and the rule + * content. + * @param index The index within the style sheet's rule list of the rule + * before which to insert the specified rule. If the specified index + * is equal to the length of the style sheet's rule collection, the + * rule will be added to the end of the style sheet. + * @return The index within the style sheet's rule collection of the + * newly inserted rule. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the - * specified index e.g. if an <code>@import</code> rule is inserted + * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the + * specified index e.g. if an <code>@import</code> rule is inserted * after a standard rule set or other at-rule. - * <br>INDEX_SIZE_ERR: Raised if the specified index is not a valid + * <br>INDEX_SIZE_ERR: Raised if the specified index is not a valid * insertion point. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. - * <br>SYNTAX_ERR: Raised if the specified rule has a syntax error and + * <br>SYNTAX_ERR: Raised if the specified rule has a syntax error and * is unparsable. */ - public int insertRule(String rule, + public int insertRule(String rule, int index) throws DOMException; /** - * Used to delete a rule from the style sheet. - * @param index The index within the style sheet's rule list of the rule - * to remove. + * Used to delete a rule from the style sheet. + * @param index The index within the style sheet's rule list of the rule + * to remove. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index does not correspond to + * INDEX_SIZE_ERR: Raised if the specified index does not correspond to * a rule in the style sheet's rule list. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. */ public void deleteRule(int index) diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java index 763d5f1b61f..d01c1ac2789 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java @@ -13,8 +13,8 @@ package org.w3c.dom.css; /** - * The <code>CSSUnknownRule</code> interface represents an at-rule not - * supported by this user agent. + * The <code>CSSUnknownRule</code> interface represents an at-rule not + * supported by this user agent. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValue.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValue.java index 0285bcc7721..3a43a17f1d2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValue.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValue.java @@ -15,9 +15,9 @@ package org.w3c.dom.css; import org.w3c.dom.DOMException; /** - * The <code>CSSValue</code> interface represents a simple or a complex - * value. A <code>CSSValue</code> object only occurs in a context of a CSS - * property. + * The <code>CSSValue</code> interface represents a simple or a complex + * value. A <code>CSSValue</code> object only occurs in a context of a CSS + * property. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ @@ -28,16 +28,16 @@ public interface CSSValue { */ public static final short CSS_INHERIT = 0; /** - * The value is a primitive value and an instance of the - * <code>CSSPrimitiveValue</code> interface can be obtained by using - * binding-specific casting methods on this instance of the + * The value is a primitive value and an instance of the + * <code>CSSPrimitiveValue</code> interface can be obtained by using + * binding-specific casting methods on this instance of the * <code>CSSValue</code> interface. */ public static final short CSS_PRIMITIVE_VALUE = 1; /** - * The value is a <code>CSSValue</code> list and an instance of the - * <code>CSSValueList</code> interface can be obtained by using - * binding-specific casting methods on this instance of the + * The value is a <code>CSSValue</code> list and an instance of the + * <code>CSSValueList</code> interface can be obtained by using + * binding-specific casting methods on this instance of the * <code>CSSValue</code> interface. */ public static final short CSS_VALUE_LIST = 2; @@ -47,24 +47,24 @@ public interface CSSValue { public static final short CSS_CUSTOM = 3; /** - * A string representation of the current value. + * A string representation of the current value. */ public String getCssText(); /** - * A string representation of the current value. + * A string representation of the current value. * @exception DOMException - * SYNTAX_ERR: Raised if the specified CSS string value has a syntax - * error (according to the attached property) or is unparsable. - * <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string - * value represents a different type of values than the values allowed + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error (according to the attached property) or is unparsable. + * <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string + * value represents a different type of values than the values allowed * by the CSS property. - * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly. + * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly. */ public void setCssText(String cssText) throws DOMException; /** - * A code defining the type of the value as defined above. + * A code defining the type of the value as defined above. */ public short getCssValueType(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValueList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValueList.java index bf15bb3ebfd..4e29bfa3f84 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValueList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/CSSValueList.java @@ -13,32 +13,32 @@ package org.w3c.dom.css; /** - * The <code>CSSValueList</code> interface provides the abstraction of an + * The <code>CSSValueList</code> interface provides the abstraction of an * ordered collection of CSS values. - * <p> Some properties allow an empty list into their syntax. In that case, - * these properties take the <code>none</code> identifier. So, an empty list - * means that the property has the value <code>none</code>. - * <p> The items in the <code>CSSValueList</code> are accessible via an - * integral index, starting from 0. + * <p> Some properties allow an empty list into their syntax. In that case, + * these properties take the <code>none</code> identifier. So, an empty list + * means that the property has the value <code>none</code>. + * <p> The items in the <code>CSSValueList</code> are accessible via an + * integral index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface CSSValueList extends CSSValue { /** - * The number of <code>CSSValues</code> in the list. The range of valid - * values of the indices is <code>0</code> to <code>length-1</code> + * The number of <code>CSSValues</code> in the list. The range of valid + * values of the indices is <code>0</code> to <code>length-1</code> * inclusive. */ public int getLength(); /** - * Used to retrieve a <code>CSSValue</code> by ordinal index. The order in - * this collection represents the order of the values in the CSS style - * property. If index is greater than or equal to the number of values + * Used to retrieve a <code>CSSValue</code> by ordinal index. The order in + * this collection represents the order of the values in the CSS style + * property. If index is greater than or equal to the number of values * in the list, this returns <code>null</code>. * @param index Index into the collection. - * @return The <code>CSSValue</code> at the <code>index</code> position - * in the <code>CSSValueList</code>, or <code>null</code> if that is + * @return The <code>CSSValue</code> at the <code>index</code> position + * in the <code>CSSValueList</code>, or <code>null</code> if that is * not a valid index. */ public CSSValue item(int index); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Counter.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Counter.java index 8cd4967b32d..7bfcc79f8bd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Counter.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Counter.java @@ -13,25 +13,25 @@ package org.w3c.dom.css; /** - * The <code>Counter</code> interface is used to represent any counter or - * counters function value. This interface reflects the values in the - * underlying style property. + * The <code>Counter</code> interface is used to represent any counter or + * counters function value. This interface reflects the values in the + * underlying style property. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface Counter { /** - * This attribute is used for the identifier of the counter. + * This attribute is used for the identifier of the counter. */ public String getIdentifier(); /** - * This attribute is used for the style of the list. + * This attribute is used for the style of the list. */ public String getListStyle(); /** - * This attribute is used for the separator of the nested counters. + * This attribute is used for the separator of the nested counters. */ public String getSeparator(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java index 65c97291ef4..90c6c135d6e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java @@ -16,24 +16,24 @@ import org.w3c.dom.DOMImplementation; import org.w3c.dom.DOMException; /** - * This interface allows the DOM user to create a <code>CSSStyleSheet</code> - * outside the context of a document. There is no way to associate the new - * <code>CSSStyleSheet</code> with a document in DOM Level 2. + * This interface allows the DOM user to create a <code>CSSStyleSheet</code> + * outside the context of a document. There is no way to associate the new + * <code>CSSStyleSheet</code> with a document in DOM Level 2. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface DOMImplementationCSS extends DOMImplementation { /** * Creates a new <code>CSSStyleSheet</code>. - * @param title The advisory title. See also the section. - * @param media The comma-separated list of media associated with the - * new style sheet. See also the section. + * @param title The advisory title. See also the section. + * @param media The comma-separated list of media associated with the + * new style sheet. See also the section. * @return A new CSS style sheet. * @exception DOMException - * SYNTAX_ERR: Raised if the specified media string value has a syntax - * error and is unparsable. + * SYNTAX_ERR: Raised if the specified media string value has a syntax + * error and is unparsable. */ - public CSSStyleSheet createCSSStyleSheet(String title, + public CSSStyleSheet createCSSStyleSheet(String title, String media) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DocumentCSS.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DocumentCSS.java index 8fe93c79a7e..68a91075454 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DocumentCSS.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/DocumentCSS.java @@ -17,34 +17,34 @@ import org.w3c.dom.stylesheets.DocumentStyle; /** * This interface represents a document with a CSS view. - * <p> The <code>getOverrideStyle</code> method provides a mechanism through - * which a DOM author could effect immediate change to the style of an - * element without modifying the explicitly linked style sheets of a - * document or the inline style of elements in the style sheets. This style - * sheet comes after the author style sheet in the cascade algorithm and is - * called override style sheet. The override style sheet takes precedence - * over author style sheets. An "!important" declaration still takes - * precedence over a normal declaration. Override, author, and user style - * sheets all may contain "!important" declarations. User "!important" rules - * take precedence over both override and author "!important" rules, and - * override "!important" rules take precedence over author "!important" - * rules. - * <p> The expectation is that an instance of the <code>DocumentCSS</code> - * interface can be obtained by using binding-specific casting methods on an - * instance of the <code>Document</code> interface. + * <p> The <code>getOverrideStyle</code> method provides a mechanism through + * which a DOM author could effect immediate change to the style of an + * element without modifying the explicitly linked style sheets of a + * document or the inline style of elements in the style sheets. This style + * sheet comes after the author style sheet in the cascade algorithm and is + * called override style sheet. The override style sheet takes precedence + * over author style sheets. An "!important" declaration still takes + * precedence over a normal declaration. Override, author, and user style + * sheets all may contain "!important" declarations. User "!important" rules + * take precedence over both override and author "!important" rules, and + * override "!important" rules take precedence over author "!important" + * rules. + * <p> The expectation is that an instance of the <code>DocumentCSS</code> + * interface can be obtained by using binding-specific casting methods on an + * instance of the <code>Document</code> interface. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface DocumentCSS extends DocumentStyle { /** - * This method is used to retrieve the override style declaration for a - * specified element and a specified pseudo-element. - * @param elt The element whose style is to be modified. This parameter - * cannot be null. - * @param pseudoElt The pseudo-element or <code>null</code> if none. - * @return The override style declaration. + * This method is used to retrieve the override style declaration for a + * specified element and a specified pseudo-element. + * @param elt The element whose style is to be modified. This parameter + * cannot be null. + * @param pseudoElt The pseudo-element or <code>null</code> if none. + * @return The override style declaration. */ - public CSSStyleDeclaration getOverrideStyle(Element elt, + public CSSStyleDeclaration getOverrideStyle(Element elt, String pseudoElt); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java index 98b60bf9ddf..e1f25060c24 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java @@ -13,19 +13,19 @@ package org.w3c.dom.css; /** - * Inline style information attached to elements is exposed through the - * <code>style</code> attribute. This represents the contents of the STYLE - * attribute for HTML elements (or elements in other schemas or DTDs which - * use the STYLE attribute in the same way). The expectation is that an - * instance of the ElementCSSInlineStyle interface can be obtained by using - * binding-specific casting methods on an instance of the Element interface - * when the element supports inline CSS style informations. + * Inline style information attached to elements is exposed through the + * <code>style</code> attribute. This represents the contents of the STYLE + * attribute for HTML elements (or elements in other schemas or DTDs which + * use the STYLE attribute in the same way). The expectation is that an + * instance of the ElementCSSInlineStyle interface can be obtained by using + * binding-specific casting methods on an instance of the Element interface + * when the element supports inline CSS style informations. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface ElementCSSInlineStyle { /** - * The style attribute. + * The style attribute. */ public CSSStyleDeclaration getStyle(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/RGBColor.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/RGBColor.java index cd5daa56703..215e291da86 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/RGBColor.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/RGBColor.java @@ -13,34 +13,34 @@ package org.w3c.dom.css; /** - * The <code>RGBColor</code> interface is used to represent any RGB color - * value. This interface reflects the values in the underlying style - * property. Hence, modifications made to the <code>CSSPrimitiveValue</code> - * objects modify the style property. - * <p> A specified RGB color is not clipped (even if the number is outside the - * range 0-255 or 0%-100%). A computed RGB color is clipped depending on the - * device. - * <p> Even if a style sheet can only contain an integer for a color value, - * the internal storage of this integer is a float, and this can be used as - * a float in the specified or the computed style. - * <p> A color percentage value can always be converted to a number and vice - * versa. + * The <code>RGBColor</code> interface is used to represent any RGB color + * value. This interface reflects the values in the underlying style + * property. Hence, modifications made to the <code>CSSPrimitiveValue</code> + * objects modify the style property. + * <p> A specified RGB color is not clipped (even if the number is outside the + * range 0-255 or 0%-100%). A computed RGB color is clipped depending on the + * device. + * <p> Even if a style sheet can only contain an integer for a color value, + * the internal storage of this integer is a float, and this can be used as + * a float in the specified or the computed style. + * <p> A color percentage value can always be converted to a number and vice + * versa. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface RGBColor { /** - * This attribute is used for the red value of the RGB color. + * This attribute is used for the red value of the RGB color. */ public CSSPrimitiveValue getRed(); /** - * This attribute is used for the green value of the RGB color. + * This attribute is used for the green value of the RGB color. */ public CSSPrimitiveValue getGreen(); /** - * This attribute is used for the blue value of the RGB color. + * This attribute is used for the blue value of the RGB color. */ public CSSPrimitiveValue getBlue(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Rect.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Rect.java index f5efb1084d9..ffbf9654773 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Rect.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/Rect.java @@ -13,31 +13,31 @@ package org.w3c.dom.css; /** - * The <code>Rect</code> interface is used to represent any rect value. This - * interface reflects the values in the underlying style property. Hence, - * modifications made to the <code>CSSPrimitiveValue</code> objects modify - * the style property. + * The <code>Rect</code> interface is used to represent any rect value. This + * interface reflects the values in the underlying style property. Hence, + * modifications made to the <code>CSSPrimitiveValue</code> objects modify + * the style property. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface Rect { /** - * This attribute is used for the top of the rect. + * This attribute is used for the top of the rect. */ public CSSPrimitiveValue getTop(); /** - * This attribute is used for the right of the rect. + * This attribute is used for the right of the rect. */ public CSSPrimitiveValue getRight(); /** - * This attribute is used for the bottom of the rect. + * This attribute is used for the bottom of the rect. */ public CSSPrimitiveValue getBottom(); /** - * This attribute is used for the left of the rect. + * This attribute is used for the left of the rect. */ public CSSPrimitiveValue getLeft(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ViewCSS.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ViewCSS.java index 76b585a54d2..1db9ac44c9f 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ViewCSS.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/css/ViewCSS.java @@ -16,28 +16,28 @@ import org.w3c.dom.Element; import org.w3c.dom.views.AbstractView; /** - * This interface represents a CSS view. The <code>getComputedStyle</code> - * method provides a read only access to the computed values of an element. - * <p> The expectation is that an instance of the <code>ViewCSS</code> - * interface can be obtained by using binding-specific casting methods on an - * instance of the <code>AbstractView</code> interface. - * <p> Since a computed style is related to an <code>Element</code> node, if - * this element is removed from the document, the associated - * <code>CSSStyleDeclaration</code> and <code>CSSValue</code> related to - * this declaration are no longer valid. + * This interface represents a CSS view. The <code>getComputedStyle</code> + * method provides a read only access to the computed values of an element. + * <p> The expectation is that an instance of the <code>ViewCSS</code> + * interface can be obtained by using binding-specific casting methods on an + * instance of the <code>AbstractView</code> interface. + * <p> Since a computed style is related to an <code>Element</code> node, if + * this element is removed from the document, the associated + * <code>CSSStyleDeclaration</code> and <code>CSSValue</code> related to + * this declaration are no longer valid. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface ViewCSS extends AbstractView { /** - * This method is used to get the computed style as it is defined in [<a href='http://www.w3.org/TR/1998/REC-CSS2-19980512'>CSS2</a>]. - * @param elt The element whose style is to be computed. This parameter - * cannot be null. - * @param pseudoElt The pseudo-element or <code>null</code> if none. - * @return The computed style. The <code>CSSStyleDeclaration</code> is - * read-only and contains only absolute values. + * This method is used to get the computed style as it is defined in [<a href='http://www.w3.org/TR/1998/REC-CSS2-19980512'>CSS2</a>]. + * @param elt The element whose style is to be computed. This parameter + * cannot be null. + * @param pseudoElt The pseudo-element or <code>null</code> if none. + * @return The computed style. The <code>CSSStyleDeclaration</code> is + * read-only and contains only absolute values. */ - public CSSStyleDeclaration getComputedStyle(Element elt, + public CSSStyleDeclaration getComputedStyle(Element elt, String pseudoElt); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/DocumentEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/DocumentEvent.java index 76644bc5a3d..55c838603ee 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/DocumentEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/DocumentEvent.java @@ -15,39 +15,39 @@ package org.w3c.dom.events; import org.w3c.dom.DOMException; /** - * The <code>DocumentEvent</code> interface provides a mechanism by which the - * user can create an Event of a type supported by the implementation. It is - * expected that the <code>DocumentEvent</code> interface will be - * implemented on the same object which implements the <code>Document</code> - * interface in an implementation which supports the Event model. + * The <code>DocumentEvent</code> interface provides a mechanism by which the + * user can create an Event of a type supported by the implementation. It is + * expected that the <code>DocumentEvent</code> interface will be + * implemented on the same object which implements the <code>Document</code> + * interface in an implementation which supports the Event model. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ public interface DocumentEvent { /** - * - * @param eventType The <code>eventType</code> parameter specifies the - * type of <code>Event</code> interface to be created. If the - * <code>Event</code> interface specified is supported by the - * implementation this method will return a new <code>Event</code> of - * the interface type requested. If the <code>Event</code> is to be - * dispatched via the <code>dispatchEvent</code> method the - * appropriate event init method must be called after creation in - * order to initialize the <code>Event</code>'s values. As an example, - * a user wishing to synthesize some kind of <code>UIEvent</code> - * would call <code>createEvent</code> with the parameter "UIEvents". - * The <code>initUIEvent</code> method could then be called on the - * newly created <code>UIEvent</code> to set the specific type of - * UIEvent to be dispatched and set its context information.The - * <code>createEvent</code> method is used in creating - * <code>Event</code>s when it is either inconvenient or unnecessary - * for the user to create an <code>Event</code> themselves. In cases - * where the implementation provided <code>Event</code> is - * insufficient, users may supply their own <code>Event</code> + * + * @param eventType The <code>eventType</code> parameter specifies the + * type of <code>Event</code> interface to be created. If the + * <code>Event</code> interface specified is supported by the + * implementation this method will return a new <code>Event</code> of + * the interface type requested. If the <code>Event</code> is to be + * dispatched via the <code>dispatchEvent</code> method the + * appropriate event init method must be called after creation in + * order to initialize the <code>Event</code>'s values. As an example, + * a user wishing to synthesize some kind of <code>UIEvent</code> + * would call <code>createEvent</code> with the parameter "UIEvents". + * The <code>initUIEvent</code> method could then be called on the + * newly created <code>UIEvent</code> to set the specific type of + * UIEvent to be dispatched and set its context information.The + * <code>createEvent</code> method is used in creating + * <code>Event</code>s when it is either inconvenient or unnecessary + * for the user to create an <code>Event</code> themselves. In cases + * where the implementation provided <code>Event</code> is + * insufficient, users may supply their own <code>Event</code> * implementations for use with the <code>dispatchEvent</code> method. * @return The newly created <code>Event</code> * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the implementation does not support the + * NOT_SUPPORTED_ERR: Raised if the implementation does not support the * type of <code>Event</code> interface requested */ public Event createEvent(String eventType) diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/Event.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/Event.java index 14a9239ed76..29a96c50ac2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/Event.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/Event.java @@ -13,14 +13,14 @@ package org.w3c.dom.events; /** - * The <code>Event</code> interface is used to provide contextual information - * about an event to the handler processing the event. An object which - * implements the <code>Event</code> interface is generally passed as the - * first parameter to an event handler. More specific context information is - * passed to event handlers by deriving additional interfaces from - * <code>Event</code> which contain information directly relating to the - * type of event they accompany. These derived interfaces are also - * implemented by the object passed to the event listener. + * The <code>Event</code> interface is used to provide contextual information + * about an event to the handler processing the event. An object which + * implements the <code>Event</code> interface is generally passed as the + * first parameter to an event handler. More specific context information is + * passed to event handlers by deriving additional interfaces from + * <code>Event</code> which contain information directly relating to the + * type of event they accompany. These derived interfaces are also + * implemented by the object passed to the event listener. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ @@ -31,7 +31,7 @@ public interface Event { */ public static final short CAPTURING_PHASE = 1; /** - * The event is currently being evaluated at the target + * The event is currently being evaluated at the target * <code>EventTarget</code>. */ public static final short AT_TARGET = 2; @@ -46,96 +46,96 @@ public interface Event { public String getType(); /** - * Used to indicate the <code>EventTarget</code> to which the event was - * originally dispatched. + * Used to indicate the <code>EventTarget</code> to which the event was + * originally dispatched. */ public EventTarget getTarget(); /** - * Used to indicate the <code>EventTarget</code> whose - * <code>EventListeners</code> are currently being processed. This is - * particularly useful during capturing and bubbling. + * Used to indicate the <code>EventTarget</code> whose + * <code>EventListeners</code> are currently being processed. This is + * particularly useful during capturing and bubbling. */ public EventTarget getCurrentTarget(); /** - * Used to indicate which phase of event flow is currently being - * evaluated. + * Used to indicate which phase of event flow is currently being + * evaluated. */ public short getEventPhase(); /** - * Used to indicate whether or not an event is a bubbling event. If the - * event can bubble the value is true, else the value is false. + * Used to indicate whether or not an event is a bubbling event. If the + * event can bubble the value is true, else the value is false. */ public boolean getBubbles(); /** - * Used to indicate whether or not an event can have its default action - * prevented. If the default action can be prevented the value is true, - * else the value is false. + * Used to indicate whether or not an event can have its default action + * prevented. If the default action can be prevented the value is true, + * else the value is false. */ public boolean getCancelable(); /** - * Used to specify the time (in milliseconds relative to the epoch) at - * which the event was created. Due to the fact that some systems may - * not provide this information the value of <code>timeStamp</code> may - * be not available for all events. When not available, a value of 0 - * will be returned. Examples of epoch time are the time of the system - * start or 0:0:0 UTC 1st January 1970. + * Used to specify the time (in milliseconds relative to the epoch) at + * which the event was created. Due to the fact that some systems may + * not provide this information the value of <code>timeStamp</code> may + * be not available for all events. When not available, a value of 0 + * will be returned. Examples of epoch time are the time of the system + * start or 0:0:0 UTC 1st January 1970. */ public long getTimeStamp(); /** - * The <code>stopPropagation</code> method is used prevent further - * propagation of an event during event flow. If this method is called - * by any <code>EventListener</code> the event will cease propagating - * through the tree. The event will complete dispatch to all listeners - * on the current <code>EventTarget</code> before event flow stops. This + * The <code>stopPropagation</code> method is used prevent further + * propagation of an event during event flow. If this method is called + * by any <code>EventListener</code> the event will cease propagating + * through the tree. The event will complete dispatch to all listeners + * on the current <code>EventTarget</code> before event flow stops. This * method may be used during any stage of event flow. */ public void stopPropagation(); /** - * If an event is cancelable, the <code>preventDefault</code> method is - * used to signify that the event is to be canceled, meaning any default - * action normally taken by the implementation as a result of the event - * will not occur. If, during any stage of event flow, the - * <code>preventDefault</code> method is called the event is canceled. - * Any default action associated with the event will not occur. Calling - * this method for a non-cancelable event has no effect. Once - * <code>preventDefault</code> has been called it will remain in effect - * throughout the remainder of the event's propagation. This method may - * be used during any stage of event flow. + * If an event is cancelable, the <code>preventDefault</code> method is + * used to signify that the event is to be canceled, meaning any default + * action normally taken by the implementation as a result of the event + * will not occur. If, during any stage of event flow, the + * <code>preventDefault</code> method is called the event is canceled. + * Any default action associated with the event will not occur. Calling + * this method for a non-cancelable event has no effect. Once + * <code>preventDefault</code> has been called it will remain in effect + * throughout the remainder of the event's propagation. This method may + * be used during any stage of event flow. */ public void preventDefault(); /** - * The <code>initEvent</code> method is used to initialize the value of an - * <code>Event</code> created through the <code>DocumentEvent</code> - * interface. This method may only be called before the - * <code>Event</code> has been dispatched via the - * <code>dispatchEvent</code> method, though it may be called multiple - * times during that phase if necessary. If called multiple times the - * final invocation takes precedence. If called from a subclass of - * <code>Event</code> interface only the values specified in the - * <code>initEvent</code> method are modified, all other attributes are + * The <code>initEvent</code> method is used to initialize the value of an + * <code>Event</code> created through the <code>DocumentEvent</code> + * interface. This method may only be called before the + * <code>Event</code> has been dispatched via the + * <code>dispatchEvent</code> method, though it may be called multiple + * times during that phase if necessary. If called multiple times the + * final invocation takes precedence. If called from a subclass of + * <code>Event</code> interface only the values specified in the + * <code>initEvent</code> method are modified, all other attributes are * left unchanged. - * @param eventTypeArg Specifies the event type. This type may be any - * event type currently defined in this specification or a new event - * type.. The string must be an XML name. Any new event type must not - * begin with any upper, lower, or mixed case version of the string - * "DOM". This prefix is reserved for future DOM event sets. It is - * also strongly recommended that third parties adding their own - * events use their own prefix to avoid confusion and lessen the + * @param eventTypeArg Specifies the event type. This type may be any + * event type currently defined in this specification or a new event + * type.. The string must be an XML name. Any new event type must not + * begin with any upper, lower, or mixed case version of the string + * "DOM". This prefix is reserved for future DOM event sets. It is + * also strongly recommended that third parties adding their own + * events use their own prefix to avoid confusion and lessen the * probability of conflicts with other new events. * @param canBubbleArg Specifies whether or not the event can bubble. - * @param cancelableArg Specifies whether or not the event's default + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. */ - public void initEvent(String eventTypeArg, - boolean canBubbleArg, + public void initEvent(String eventTypeArg, + boolean canBubbleArg, boolean cancelableArg); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventException.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventException.java index 7a6ff262052..9a62f1fc51d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventException.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventException.java @@ -13,8 +13,8 @@ package org.w3c.dom.events; /** - * Event operations may throw an <code>EventException</code> as specified in - * their method descriptions. + * Event operations may throw an <code>EventException</code> as specified in + * their method descriptions. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ @@ -26,10 +26,10 @@ public class EventException extends RuntimeException { public short code; // EventExceptionCode /** - * If the <code>Event</code>'s type was not specified by initializing the - * event before the method was called. Specification of the Event's type - * as <code>null</code> or an empty string will also trigger this - * exception. + * If the <code>Event</code>'s type was not specified by initializing the + * event before the method was called. Specification of the Event's type + * as <code>null</code> or an empty string will also trigger this + * exception. */ public static final short UNSPECIFIED_EVENT_TYPE_ERR = 0; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventListener.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventListener.java index 1df80202cea..1be3523fb60 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventListener.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventListener.java @@ -13,28 +13,28 @@ package org.w3c.dom.events; /** - * The <code>EventListener</code> interface is the primary method for - * handling events. Users implement the <code>EventListener</code> interface - * and register their listener on an <code>EventTarget</code> using the - * <code>AddEventListener</code> method. The users should also remove their - * <code>EventListener</code> from its <code>EventTarget</code> after they - * have completed using the listener. - * <p> When a <code>Node</code> is copied using the <code>cloneNode</code> - * method the <code>EventListener</code>s attached to the source - * <code>Node</code> are not attached to the copied <code>Node</code>. If - * the user wishes the same <code>EventListener</code>s to be added to the - * newly created copy the user must add them manually. + * The <code>EventListener</code> interface is the primary method for + * handling events. Users implement the <code>EventListener</code> interface + * and register their listener on an <code>EventTarget</code> using the + * <code>AddEventListener</code> method. The users should also remove their + * <code>EventListener</code> from its <code>EventTarget</code> after they + * have completed using the listener. + * <p> When a <code>Node</code> is copied using the <code>cloneNode</code> + * method the <code>EventListener</code>s attached to the source + * <code>Node</code> are not attached to the copied <code>Node</code>. If + * the user wishes the same <code>EventListener</code>s to be added to the + * newly created copy the user must add them manually. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ public interface EventListener { /** - * This method is called whenever an event occurs of the type for which - * the <code> EventListener</code> interface was registered. - * @param evt The <code>Event</code> contains contextual information - * about the event. It also contains the <code>stopPropagation</code> - * and <code>preventDefault</code> methods which are used in - * determining the event's flow and default action. + * This method is called whenever an event occurs of the type for which + * the <code> EventListener</code> interface was registered. + * @param evt The <code>Event</code> contains contextual information + * about the event. It also contains the <code>stopPropagation</code> + * and <code>preventDefault</code> methods which are used in + * determining the event's flow and default action. */ public void handleEvent(Event evt); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventTarget.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventTarget.java index f07663660fd..3b66a8debae 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventTarget.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/EventTarget.java @@ -13,87 +13,87 @@ package org.w3c.dom.events; /** - * The <code>EventTarget</code> interface is implemented by all - * <code>Nodes</code> in an implementation which supports the DOM Event - * Model. Therefore, this interface can be obtained by using - * binding-specific casting methods on an instance of the <code>Node</code> - * interface. The interface allows registration and removal of - * <code>EventListeners</code> on an <code>EventTarget</code> and dispatch + * The <code>EventTarget</code> interface is implemented by all + * <code>Nodes</code> in an implementation which supports the DOM Event + * Model. Therefore, this interface can be obtained by using + * binding-specific casting methods on an instance of the <code>Node</code> + * interface. The interface allows registration and removal of + * <code>EventListeners</code> on an <code>EventTarget</code> and dispatch * of events to that <code>EventTarget</code>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ public interface EventTarget { /** - * This method allows the registration of event listeners on the event - * target. If an <code>EventListener</code> is added to an - * <code>EventTarget</code> while it is processing an event, it will not - * be triggered by the current actions but may be triggered during a - * later stage of event flow, such as the bubbling phase. - * <br> If multiple identical <code>EventListener</code>s are registered - * on the same <code>EventTarget</code> with the same parameters the - * duplicate instances are discarded. They do not cause the - * <code>EventListener</code> to be called twice and since they are - * discarded they do not need to be removed with the - * <code>removeEventListener</code> method. + * This method allows the registration of event listeners on the event + * target. If an <code>EventListener</code> is added to an + * <code>EventTarget</code> while it is processing an event, it will not + * be triggered by the current actions but may be triggered during a + * later stage of event flow, such as the bubbling phase. + * <br> If multiple identical <code>EventListener</code>s are registered + * on the same <code>EventTarget</code> with the same parameters the + * duplicate instances are discarded. They do not cause the + * <code>EventListener</code> to be called twice and since they are + * discarded they do not need to be removed with the + * <code>removeEventListener</code> method. * @param type The event type for which the user is registering - * @param listener The <code>listener</code> parameter takes an interface - * implemented by the user which contains the methods to be called + * @param listener The <code>listener</code> parameter takes an interface + * implemented by the user which contains the methods to be called * when the event occurs. - * @param useCapture If true, <code>useCapture</code> indicates that the - * user wishes to initiate capture. After initiating capture, all - * events of the specified type will be dispatched to the registered - * <code>EventListener</code> before being dispatched to any - * <code>EventTargets</code> beneath them in the tree. Events which - * are bubbling upward through the tree will not trigger an + * @param useCapture If true, <code>useCapture</code> indicates that the + * user wishes to initiate capture. After initiating capture, all + * events of the specified type will be dispatched to the registered + * <code>EventListener</code> before being dispatched to any + * <code>EventTargets</code> beneath them in the tree. Events which + * are bubbling upward through the tree will not trigger an * <code>EventListener</code> designated to use capture. */ - public void addEventListener(String type, - EventListener listener, + public void addEventListener(String type, + EventListener listener, boolean useCapture); /** - * This method allows the removal of event listeners from the event - * target. If an <code>EventListener</code> is removed from an - * <code>EventTarget</code> while it is processing an event, it will not - * be triggered by the current actions. <code>EventListener</code>s can + * This method allows the removal of event listeners from the event + * target. If an <code>EventListener</code> is removed from an + * <code>EventTarget</code> while it is processing an event, it will not + * be triggered by the current actions. <code>EventListener</code>s can * never be invoked after being removed. - * <br>Calling <code>removeEventListener</code> with arguments which do - * not identify any currently registered <code>EventListener</code> on + * <br>Calling <code>removeEventListener</code> with arguments which do + * not identify any currently registered <code>EventListener</code> on * the <code>EventTarget</code> has no effect. - * @param type Specifies the event type of the <code>EventListener</code> - * being removed. - * @param listener The <code>EventListener</code> parameter indicates the - * <code>EventListener </code> to be removed. - * @param useCapture Specifies whether the <code>EventListener</code> - * being removed was registered as a capturing listener or not. If a - * listener was registered twice, one with capture and one without, - * each must be removed separately. Removal of a capturing listener - * does not affect a non-capturing version of the same listener, and - * vice versa. + * @param type Specifies the event type of the <code>EventListener</code> + * being removed. + * @param listener The <code>EventListener</code> parameter indicates the + * <code>EventListener </code> to be removed. + * @param useCapture Specifies whether the <code>EventListener</code> + * being removed was registered as a capturing listener or not. If a + * listener was registered twice, one with capture and one without, + * each must be removed separately. Removal of a capturing listener + * does not affect a non-capturing version of the same listener, and + * vice versa. */ - public void removeEventListener(String type, - EventListener listener, + public void removeEventListener(String type, + EventListener listener, boolean useCapture); /** - * This method allows the dispatch of events into the implementations - * event model. Events dispatched in this manner will have the same - * capturing and bubbling behavior as events dispatched directly by the - * implementation. The target of the event is the - * <code> EventTarget</code> on which <code>dispatchEvent</code> is - * called. - * @param evt Specifies the event type, behavior, and contextual + * This method allows the dispatch of events into the implementations + * event model. Events dispatched in this manner will have the same + * capturing and bubbling behavior as events dispatched directly by the + * implementation. The target of the event is the + * <code> EventTarget</code> on which <code>dispatchEvent</code> is + * called. + * @param evt Specifies the event type, behavior, and contextual * information to be used in processing the event. - * @return The return value of <code>dispatchEvent</code> indicates - * whether any of the listeners which handled the event called - * <code>preventDefault</code>. If <code>preventDefault</code> was - * called the value is false, else the value is true. + * @return The return value of <code>dispatchEvent</code> indicates + * whether any of the listeners which handled the event called + * <code>preventDefault</code>. If <code>preventDefault</code> was + * called the value is false, else the value is true. * @exception EventException - * UNSPECIFIED_EVENT_TYPE_ERR: Raised if the <code>Event</code>'s type - * was not specified by initializing the event before - * <code>dispatchEvent</code> was called. Specification of the - * <code>Event</code>'s type as <code>null</code> or an empty string + * UNSPECIFIED_EVENT_TYPE_ERR: Raised if the <code>Event</code>'s type + * was not specified by initializing the event before + * <code>dispatchEvent</code> was called. Specification of the + * <code>Event</code>'s type as <code>null</code> or an empty string * will also trigger this exception. */ public boolean dispatchEvent(Event evt) diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MouseEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MouseEvent.java index be780357a88..67e20572f16 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MouseEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MouseEvent.java @@ -15,142 +15,142 @@ package org.w3c.dom.events; import org.w3c.dom.views.AbstractView; /** - * The <code>MouseEvent</code> interface provides specific contextual + * The <code>MouseEvent</code> interface provides specific contextual * information associated with Mouse events. - * <p>The <code>detail</code> attribute inherited from <code>UIEvent</code> - * indicates the number of times a mouse button has been pressed and - * released over the same screen location during a user action. The - * attribute value is 1 when the user begins this action and increments by 1 - * for each full sequence of pressing and releasing. If the user moves the - * mouse between the mousedown and mouseup the value will be set to 0, + * <p>The <code>detail</code> attribute inherited from <code>UIEvent</code> + * indicates the number of times a mouse button has been pressed and + * released over the same screen location during a user action. The + * attribute value is 1 when the user begins this action and increments by 1 + * for each full sequence of pressing and releasing. If the user moves the + * mouse between the mousedown and mouseup the value will be set to 0, * indicating that no click is occurring. - * <p>In the case of nested elements mouse events are always targeted at the - * most deeply nested element. Ancestors of the targeted element may use - * bubbling to obtain notification of mouse events which occur within its + * <p>In the case of nested elements mouse events are always targeted at the + * most deeply nested element. Ancestors of the targeted element may use + * bubbling to obtain notification of mouse events which occur within its * descendent elements. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ public interface MouseEvent extends UIEvent { /** - * The horizontal coordinate at which the event occurred relative to the + * The horizontal coordinate at which the event occurred relative to the * origin of the screen coordinate system. */ public int getScreenX(); /** - * The vertical coordinate at which the event occurred relative to the + * The vertical coordinate at which the event occurred relative to the * origin of the screen coordinate system. */ public int getScreenY(); /** - * The horizontal coordinate at which the event occurred relative to the + * The horizontal coordinate at which the event occurred relative to the * DOM implementation's client area. */ public int getClientX(); /** - * The vertical coordinate at which the event occurred relative to the DOM + * The vertical coordinate at which the event occurred relative to the DOM * implementation's client area. */ public int getClientY(); /** - * Used to indicate whether the 'ctrl' key was depressed during the firing + * Used to indicate whether the 'ctrl' key was depressed during the firing * of the event. */ public boolean getCtrlKey(); /** - * Used to indicate whether the 'shift' key was depressed during the + * Used to indicate whether the 'shift' key was depressed during the * firing of the event. */ public boolean getShiftKey(); /** - * Used to indicate whether the 'alt' key was depressed during the firing - * of the event. On some platforms this key may map to an alternative + * Used to indicate whether the 'alt' key was depressed during the firing + * of the event. On some platforms this key may map to an alternative * key name. */ public boolean getAltKey(); /** - * Used to indicate whether the 'meta' key was depressed during the firing - * of the event. On some platforms this key may map to an alternative + * Used to indicate whether the 'meta' key was depressed during the firing + * of the event. On some platforms this key may map to an alternative * key name. */ public boolean getMetaKey(); /** - * During mouse events caused by the depression or release of a mouse - * button, <code>button</code> is used to indicate which mouse button - * changed state. The values for <code>button</code> range from zero to - * indicate the left button of the mouse, one to indicate the middle - * button if present, and two to indicate the right button. For mice - * configured for left handed use in which the button actions are + * During mouse events caused by the depression or release of a mouse + * button, <code>button</code> is used to indicate which mouse button + * changed state. The values for <code>button</code> range from zero to + * indicate the left button of the mouse, one to indicate the middle + * button if present, and two to indicate the right button. For mice + * configured for left handed use in which the button actions are * reversed the values are instead read from right to left. */ public short getButton(); /** - * Used to identify a secondary <code>EventTarget</code> related to a UI - * event. Currently this attribute is used with the mouseover event to - * indicate the <code>EventTarget</code> which the pointing device - * exited and with the mouseout event to indicate the + * Used to identify a secondary <code>EventTarget</code> related to a UI + * event. Currently this attribute is used with the mouseover event to + * indicate the <code>EventTarget</code> which the pointing device + * exited and with the mouseout event to indicate the * <code>EventTarget</code> which the pointing device entered. */ public EventTarget getRelatedTarget(); /** - * The <code>initMouseEvent</code> method is used to initialize the value - * of a <code>MouseEvent</code> created through the - * <code>DocumentEvent</code> interface. This method may only be called - * before the <code>MouseEvent</code> has been dispatched via the - * <code>dispatchEvent</code> method, though it may be called multiple - * times during that phase if necessary. If called multiple times, the + * The <code>initMouseEvent</code> method is used to initialize the value + * of a <code>MouseEvent</code> created through the + * <code>DocumentEvent</code> interface. This method may only be called + * before the <code>MouseEvent</code> has been dispatched via the + * <code>dispatchEvent</code> method, though it may be called multiple + * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. * @param typeArg Specifies the event type. * @param canBubbleArg Specifies whether or not the event can bubble. - * @param cancelableArg Specifies whether or not the event's default + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. - * @param viewArg Specifies the <code>Event</code>'s + * @param viewArg Specifies the <code>Event</code>'s * <code>AbstractView</code>. * @param detailArg Specifies the <code>Event</code>'s mouse click count. - * @param screenXArg Specifies the <code>Event</code>'s screen x + * @param screenXArg Specifies the <code>Event</code>'s screen x * coordinate - * @param screenYArg Specifies the <code>Event</code>'s screen y + * @param screenYArg Specifies the <code>Event</code>'s screen y * coordinate - * @param clientXArg Specifies the <code>Event</code>'s client x + * @param clientXArg Specifies the <code>Event</code>'s client x * coordinate - * @param clientYArg Specifies the <code>Event</code>'s client y + * @param clientYArg Specifies the <code>Event</code>'s client y * coordinate - * @param ctrlKeyArg Specifies whether or not control key was depressed + * @param ctrlKeyArg Specifies whether or not control key was depressed * during the <code>Event</code>. - * @param altKeyArg Specifies whether or not alt key was depressed during + * @param altKeyArg Specifies whether or not alt key was depressed during * the <code>Event</code>. - * @param shiftKeyArg Specifies whether or not shift key was depressed + * @param shiftKeyArg Specifies whether or not shift key was depressed * during the <code>Event</code>. - * @param metaKeyArg Specifies whether or not meta key was depressed + * @param metaKeyArg Specifies whether or not meta key was depressed * during the <code>Event</code>. * @param buttonArg Specifies the <code>Event</code>'s mouse button. - * @param relatedTargetArg Specifies the <code>Event</code>'s related + * @param relatedTargetArg Specifies the <code>Event</code>'s related * <code>EventTarget</code>. */ - public void initMouseEvent(String typeArg, - boolean canBubbleArg, - boolean cancelableArg, - AbstractView viewArg, - int detailArg, - int screenXArg, - int screenYArg, - int clientXArg, - int clientYArg, - boolean ctrlKeyArg, - boolean altKeyArg, - boolean shiftKeyArg, - boolean metaKeyArg, - short buttonArg, + public void initMouseEvent(String typeArg, + boolean canBubbleArg, + boolean cancelableArg, + AbstractView viewArg, + int detailArg, + int screenXArg, + int screenYArg, + int clientXArg, + int clientYArg, + boolean ctrlKeyArg, + boolean altKeyArg, + boolean shiftKeyArg, + boolean metaKeyArg, + short buttonArg, EventTarget relatedTargetArg); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MutationEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MutationEvent.java index 3db40038e93..2cbedb76894 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MutationEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/MutationEvent.java @@ -15,8 +15,8 @@ package org.w3c.dom.events; import org.w3c.dom.Node; /** - * The <code>MutationEvent</code> interface provides specific contextual - * information associated with Mutation events. + * The <code>MutationEvent</code> interface provides specific contextual + * information associated with Mutation events. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 */ @@ -36,73 +36,73 @@ public interface MutationEvent extends Event { public static final short REMOVAL = 3; /** - * <code>relatedNode</code> is used to identify a secondary node related - * to a mutation event. For example, if a mutation event is dispatched - * to a node indicating that its parent has changed, the - * <code>relatedNode</code> is the changed parent. If an event is - * instead dispatched to a subtree indicating a node was changed within - * it, the <code>relatedNode</code> is the changed node. In the case of - * the DOMAttrModified event it indicates the <code>Attr</code> node - * which was modified, added, or removed. + * <code>relatedNode</code> is used to identify a secondary node related + * to a mutation event. For example, if a mutation event is dispatched + * to a node indicating that its parent has changed, the + * <code>relatedNode</code> is the changed parent. If an event is + * instead dispatched to a subtree indicating a node was changed within + * it, the <code>relatedNode</code> is the changed node. In the case of + * the DOMAttrModified event it indicates the <code>Attr</code> node + * which was modified, added, or removed. */ public Node getRelatedNode(); /** - * <code>prevValue</code> indicates the previous value of the - * <code>Attr</code> node in DOMAttrModified events, and of the - * <code>CharacterData</code> node in DOMCharacterDataModified events. + * <code>prevValue</code> indicates the previous value of the + * <code>Attr</code> node in DOMAttrModified events, and of the + * <code>CharacterData</code> node in DOMCharacterDataModified events. */ public String getPrevValue(); /** - * <code>newValue</code> indicates the new value of the <code>Attr</code> - * node in DOMAttrModified events, and of the <code>CharacterData</code> - * node in DOMCharacterDataModified events. + * <code>newValue</code> indicates the new value of the <code>Attr</code> + * node in DOMAttrModified events, and of the <code>CharacterData</code> + * node in DOMCharacterDataModified events. */ public String getNewValue(); /** - * <code>attrName</code> indicates the name of the changed - * <code>Attr</code> node in a DOMAttrModified event. + * <code>attrName</code> indicates the name of the changed + * <code>Attr</code> node in a DOMAttrModified event. */ public String getAttrName(); /** - * <code>attrChange</code> indicates the type of change which triggered + * <code>attrChange</code> indicates the type of change which triggered * the DOMAttrModified event. The values can be <code>MODIFICATION</code> - * , <code>ADDITION</code>, or <code>REMOVAL</code>. + * , <code>ADDITION</code>, or <code>REMOVAL</code>. */ public short getAttrChange(); /** - * The <code>initMutationEvent</code> method is used to initialize the - * value of a <code>MutationEvent</code> created through the - * <code>DocumentEvent</code> interface. This method may only be called - * before the <code>MutationEvent</code> has been dispatched via the - * <code>dispatchEvent</code> method, though it may be called multiple - * times during that phase if necessary. If called multiple times, the + * The <code>initMutationEvent</code> method is used to initialize the + * value of a <code>MutationEvent</code> created through the + * <code>DocumentEvent</code> interface. This method may only be called + * before the <code>MutationEvent</code> has been dispatched via the + * <code>dispatchEvent</code> method, though it may be called multiple + * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. * @param typeArg Specifies the event type. * @param canBubbleArg Specifies whether or not the event can bubble. - * @param cancelableArg Specifies whether or not the event's default + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. * @param relatedNodeArg Specifies the <code>Event</code>'s related Node. - * @param prevValueArg Specifies the <code>Event</code>'s + * @param prevValueArg Specifies the <code>Event</code>'s * <code>prevValue</code> attribute. This value may be null. - * @param newValueArg Specifies the <code>Event</code>'s + * @param newValueArg Specifies the <code>Event</code>'s * <code>newValue</code> attribute. This value may be null. - * @param attrNameArg Specifies the <code>Event</code>'s + * @param attrNameArg Specifies the <code>Event</code>'s * <code>attrName</code> attribute. This value may be null. - * @param attrChangeArg Specifies the <code>Event</code>'s + * @param attrChangeArg Specifies the <code>Event</code>'s * <code>attrChange</code> attribute */ - public void initMutationEvent(String typeArg, - boolean canBubbleArg, - boolean cancelableArg, - Node relatedNodeArg, - String prevValueArg, - String newValueArg, - String attrNameArg, + public void initMutationEvent(String typeArg, + boolean canBubbleArg, + boolean cancelableArg, + Node relatedNodeArg, + String prevValueArg, + String newValueArg, + String attrNameArg, short attrChangeArg); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/UIEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/UIEvent.java index 15affe8791e..e3617c0268d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/events/UIEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/events/UIEvent.java @@ -15,7 +15,7 @@ package org.w3c.dom.events; import org.w3c.dom.views.AbstractView; /** - * The <code>UIEvent</code> interface provides specific contextual information + * The <code>UIEvent</code> interface provides specific contextual information * associated with User Interface events. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>. * @since DOM Level 2 @@ -28,31 +28,31 @@ public interface UIEvent extends Event { public AbstractView getView(); /** - * Specifies some detail information about the <code>Event</code>, + * Specifies some detail information about the <code>Event</code>, * depending on the type of event. */ public int getDetail(); /** - * The <code>initUIEvent</code> method is used to initialize the value of - * a <code>UIEvent</code> created through the <code>DocumentEvent</code> - * interface. This method may only be called before the - * <code>UIEvent</code> has been dispatched via the - * <code>dispatchEvent</code> method, though it may be called multiple - * times during that phase if necessary. If called multiple times, the + * The <code>initUIEvent</code> method is used to initialize the value of + * a <code>UIEvent</code> created through the <code>DocumentEvent</code> + * interface. This method may only be called before the + * <code>UIEvent</code> has been dispatched via the + * <code>dispatchEvent</code> method, though it may be called multiple + * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. * @param typeArg Specifies the event type. * @param canBubbleArg Specifies whether or not the event can bubble. - * @param cancelableArg Specifies whether or not the event's default + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. - * @param viewArg Specifies the <code>Event</code>'s + * @param viewArg Specifies the <code>Event</code>'s * <code>AbstractView</code>. * @param detailArg Specifies the <code>Event</code>'s detail. */ - public void initUIEvent(String typeArg, - boolean canBubbleArg, - boolean cancelableArg, - AbstractView viewArg, + public void initUIEvent(String typeArg, + boolean canBubbleArg, + boolean cancelableArg, + AbstractView viewArg, int detailArg); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java index eaac35c8a76..a3ec0b5040e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java @@ -18,58 +18,58 @@ package org.w3c.dom.html2; */ public interface HTMLAnchorElement extends HTMLElement { /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * The character encoding of the linked resource. See the charset + * The character encoding of the linked resource. See the charset * attribute definition in HTML 4.01. */ public String getCharset(); /** - * The character encoding of the linked resource. See the charset + * The character encoding of the linked resource. See the charset * attribute definition in HTML 4.01. */ public void setCharset(String charset); /** - * Comma-separated list of lengths, defining an active region geometry. - * See also <code>shape</code> for the shape of the region. See the + * Comma-separated list of lengths, defining an active region geometry. + * See also <code>shape</code> for the shape of the region. See the * coords attribute definition in HTML 4.01. */ public String getCoords(); /** - * Comma-separated list of lengths, defining an active region geometry. - * See also <code>shape</code> for the shape of the region. See the + * Comma-separated list of lengths, defining an active region geometry. + * See also <code>shape</code> for the shape of the region. See the * coords attribute definition in HTML 4.01. */ public void setCoords(String coords); /** - * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute + * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute * definition in HTML 4.01. */ public String getHref(); /** - * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute + * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute * definition in HTML 4.01. */ public void setHref(String href); /** - * Language code of the linked resource. See the hreflang attribute + * Language code of the linked resource. See the hreflang attribute * definition in HTML 4.01. */ public String getHreflang(); /** - * Language code of the linked resource. See the hreflang attribute + * Language code of the linked resource. See the hreflang attribute * definition in HTML 4.01. */ public void setHreflang(String hreflang); @@ -102,34 +102,34 @@ public interface HTMLAnchorElement extends HTMLElement { public void setRev(String rev); /** - * The shape of the active area. The coordinates are given by + * The shape of the active area. The coordinates are given by * <code>coords</code>. See the shape attribute definition in HTML 4.01. */ public String getShape(); /** - * The shape of the active area. The coordinates are given by + * The shape of the active area. The coordinates are given by * <code>coords</code>. See the shape attribute definition in HTML 4.01. */ public void setShape(String shape); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public String getTarget(); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public void setTarget(String target); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java index f27b51afb7a..2e0fc153c21 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java @@ -13,142 +13,142 @@ package org.w3c.dom.html2; /** - * An embedded Java applet. See the APPLET element definition in HTML 4.01. + * An embedded Java applet. See the APPLET element definition in HTML 4.01. * This element is deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLAppletElement extends HTMLElement { /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Alternate text for user agents not rendering the normal content of this - * element. See the alt attribute definition in HTML 4.01. This + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getAlt(); /** - * Alternate text for user agents not rendering the normal content of this - * element. See the alt attribute definition in HTML 4.01. This + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setAlt(String alt); /** - * Comma-separated archive list. See the archive attribute definition in + * Comma-separated archive list. See the archive attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getArchive(); /** - * Comma-separated archive list. See the archive attribute definition in + * Comma-separated archive list. See the archive attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setArchive(String archive); /** - * Applet class file. See the code attribute definition in HTML 4.01. This + * Applet class file. See the code attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getCode(); /** - * Applet class file. See the code attribute definition in HTML 4.01. This + * Applet class file. See the code attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setCode(String code); /** - * Optional base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for applet. See the codebase attribute definition in + * Optional base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for applet. See the codebase attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getCodeBase(); /** - * Optional base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for applet. See the codebase attribute definition in + * Optional base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for applet. See the codebase attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCodeBase(String codeBase); /** - * Override height. See the height attribute definition in HTML 4.01. This + * Override height. See the height attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getHeight(); /** - * Override height. See the height attribute definition in HTML 4.01. This + * Override height. See the height attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setHeight(String height); /** - * Horizontal space, in pixels, to the left and right of this image, - * applet, or object. See the hspace attribute definition in HTML 4.01. + * Horizontal space, in pixels, to the left and right of this image, + * applet, or object. See the hspace attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public int getHspace(); /** - * Horizontal space, in pixels, to the left and right of this image, - * applet, or object. See the hspace attribute definition in HTML 4.01. + * Horizontal space, in pixels, to the left and right of this image, + * applet, or object. See the hspace attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public void setHspace(int hspace); /** - * The name of the applet. See the name attribute definition in HTML 4.01. + * The name of the applet. See the name attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getName(); /** - * The name of the applet. See the name attribute definition in HTML 4.01. + * The name of the applet. See the name attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setName(String name); /** * The value of the "object" attribute. See the object attribute definition - * in HTML 4.01. This attribute is deprecated in HTML 4.01. + * in HTML 4.01. This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public String getObject(); /** * The value of the "object" attribute. See the object attribute definition - * in HTML 4.01. This attribute is deprecated in HTML 4.01. + * in HTML 4.01. This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public void setObject(String object); /** - * Vertical space, in pixels, above and below this image, applet, or - * object. See the vspace attribute definition in HTML 4.01. This + * Vertical space, in pixels, above and below this image, applet, or + * object. See the vspace attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public int getVspace(); /** - * Vertical space, in pixels, above and below this image, applet, or - * object. See the vspace attribute definition in HTML 4.01. This + * Vertical space, in pixels, above and below this image, applet, or + * object. See the vspace attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public void setVspace(int vspace); /** - * Override width. See the width attribute definition in HTML 4.01. This + * Override width. See the width attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getWidth(); /** - * Override width. See the width attribute definition in HTML 4.01. This + * Override width. See the width attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setWidth(String width); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java index 75d1dc5cfa9..403b94d50b0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java @@ -13,97 +13,97 @@ package org.w3c.dom.html2; /** - * Client-side image map area definition. See the AREA element definition in + * Client-side image map area definition. See the AREA element definition in * HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLAreaElement extends HTMLElement { /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public String getAlt(); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public void setAlt(String alt); /** - * Comma-separated list of lengths, defining an active region geometry. - * See also <code>shape</code> for the shape of the region. See the + * Comma-separated list of lengths, defining an active region geometry. + * See also <code>shape</code> for the shape of the region. See the * coords attribute definition in HTML 4.01. */ public String getCoords(); /** - * Comma-separated list of lengths, defining an active region geometry. - * See also <code>shape</code> for the shape of the region. See the + * Comma-separated list of lengths, defining an active region geometry. + * See also <code>shape</code> for the shape of the region. See the * coords attribute definition in HTML 4.01. */ public void setCoords(String coords); /** - * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in + * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in * HTML 4.01. */ public String getHref(); /** - * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in + * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in * HTML 4.01. */ public void setHref(String href); /** - * Specifies that this area is inactive, i.e., has no associated action. + * Specifies that this area is inactive, i.e., has no associated action. * See the nohref attribute definition in HTML 4.01. */ public boolean getNoHref(); /** - * Specifies that this area is inactive, i.e., has no associated action. + * Specifies that this area is inactive, i.e., has no associated action. * See the nohref attribute definition in HTML 4.01. */ public void setNoHref(boolean noHref); /** - * The shape of the active area. The coordinates are given by + * The shape of the active area. The coordinates are given by * <code>coords</code>. See the shape attribute definition in HTML 4.01. */ public String getShape(); /** - * The shape of the active area. The coordinates are given by + * The shape of the active area. The coordinates are given by * <code>coords</code>. See the shape attribute definition in HTML 4.01. */ public void setShape(String shape); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public String getTarget(); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public void setTarget(String target); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java index a865d282d41..74dbe1f3f81 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLBRElement extends HTMLElement { /** - * Control flow of text around floats. See the clear attribute definition + * Control flow of text around floats. See the clear attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getClear(); /** - * Control flow of text around floats. See the clear attribute definition + * Control flow of text around floats. See the clear attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setClear(String clear); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java index 7b52dbcc209..9dde9b3da57 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java @@ -27,12 +27,12 @@ public interface HTMLBaseElement extends HTMLElement { public void setHref(String href); /** - * The default target frame. See the target attribute definition in HTML + * The default target frame. See the target attribute definition in HTML * 4.01. */ public String getTarget(); /** - * The default target frame. See the target attribute definition in HTML + * The default target frame. See the target attribute definition in HTML * 4.01. */ public void setTarget(String target); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java index 5a3c5c93cee..1ae8834d7ec 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java @@ -13,41 +13,41 @@ package org.w3c.dom.html2; /** - * Base font. See the BASEFONT element definition in HTML 4.01. This element + * Base font. See the BASEFONT element definition in HTML 4.01. This element * is deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLBaseFontElement extends HTMLElement { /** - * Font color. See the color attribute definition in HTML 4.01. This + * Font color. See the color attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getColor(); /** - * Font color. See the color attribute definition in HTML 4.01. This + * Font color. See the color attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setColor(String color); /** - * Font face identifier. See the face attribute definition in HTML 4.01. + * Font face identifier. See the face attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getFace(); /** - * Font face identifier. See the face attribute definition in HTML 4.01. + * Font face identifier. See the face attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setFace(String face); /** - * Computed font size. See the size attribute definition in HTML 4.01. + * Computed font size. See the size attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ public int getSize(); /** - * Computed font size. See the size attribute definition in HTML 4.01. + * Computed font size. See the size attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. * @version DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java index 8898c5de030..7e1aabe1fe6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java @@ -13,80 +13,80 @@ package org.w3c.dom.html2; /** - * The HTML document body. This element is always present in the DOM API, even - * if the tags are not present in the source document. See the BODY element + * The HTML document body. This element is always present in the DOM API, even + * if the tags are not present in the source document. See the BODY element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLBodyElement extends HTMLElement { /** - * Color of active links (after mouse-button down, but before mouse-button - * up). See the alink attribute definition in HTML 4.01. This attribute + * Color of active links (after mouse-button down, but before mouse-button + * up). See the alink attribute definition in HTML 4.01. This attribute * is deprecated in HTML 4.01. */ public String getALink(); /** - * Color of active links (after mouse-button down, but before mouse-button - * up). See the alink attribute definition in HTML 4.01. This attribute + * Color of active links (after mouse-button down, but before mouse-button + * up). See the alink attribute definition in HTML 4.01. This attribute * is deprecated in HTML 4.01. */ public void setALink(String aLink); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the background texture tile image. See the background attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the background texture tile image. See the background attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getBackground(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the background texture tile image. See the background attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the background texture tile image. See the background attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setBackground(String background); /** - * Document background color. See the bgcolor attribute definition in HTML + * Document background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getBgColor(); /** - * Document background color. See the bgcolor attribute definition in HTML + * Document background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setBgColor(String bgColor); /** - * Color of links that are not active and unvisited. See the link - * attribute definition in HTML 4.01. This attribute is deprecated in + * Color of links that are not active and unvisited. See the link + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public String getLink(); /** - * Color of links that are not active and unvisited. See the link - * attribute definition in HTML 4.01. This attribute is deprecated in + * Color of links that are not active and unvisited. See the link + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public void setLink(String link); /** - * Document text color. See the text attribute definition in HTML 4.01. + * Document text color. See the text attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getText(); /** - * Document text color. See the text attribute definition in HTML 4.01. + * Document text color. See the text attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setText(String text); /** - * Color of links that have been visited by the user. See the vlink - * attribute definition in HTML 4.01. This attribute is deprecated in + * Color of links that have been visited by the user. See the vlink + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public String getVLink(); /** - * Color of links that have been visited by the user. See the vlink - * attribute definition in HTML 4.01. This attribute is deprecated in + * Color of links that have been visited by the user. See the vlink + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public void setVLink(String vLink); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java index 7efe1834c26..8e31b103ce2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java @@ -18,69 +18,69 @@ package org.w3c.dom.html2; */ public interface HTMLButtonElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public void setName(String name); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * The type of button (all lower case). See the type attribute definition + * The type of button (all lower case). See the type attribute definition * in HTML 4.01. */ public String getType(); /** - * The current form control value. See the value attribute definition in + * The current form control value. See the value attribute definition in * HTML 4.01. */ public String getValue(); /** - * The current form control value. See the value attribute definition in + * The current form control value. See the value attribute definition in * HTML 4.01. */ public void setValue(String value); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java index 6b6751783fe..d6ec5473f70 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java @@ -15,43 +15,43 @@ package org.w3c.dom.html2; import org.w3c.dom.Node; /** - * An <code>HTMLCollection</code> is a list of nodes. An individual node may - * be accessed by either ordinal index or the node's <code>name</code> or - * <code>id</code> attributes. Collections in the HTML DOM are assumed to be - * live meaning that they are automatically updated when the underlying - * document is changed. + * An <code>HTMLCollection</code> is a list of nodes. An individual node may + * be accessed by either ordinal index or the node's <code>name</code> or + * <code>id</code> attributes. Collections in the HTML DOM are assumed to be + * live meaning that they are automatically updated when the underlying + * document is changed. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLCollection { /** - * This attribute specifies the length or size of the list. + * This attribute specifies the length or size of the list. */ public int getLength(); /** - * This method retrieves a node specified by ordinal index. Nodes are + * This method retrieves a node specified by ordinal index. Nodes are * numbered in tree order (depth-first traversal order). - * @param index The index of the node to be fetched. The index origin is + * @param index The index of the node to be fetched. The index origin is * <code>0</code>. - * @return The <code>Node</code> at the corresponding position upon - * success. A value of <code>null</code> is returned if the index is - * out of range. + * @return The <code>Node</code> at the corresponding position upon + * success. A value of <code>null</code> is returned if the index is + * out of range. */ public Node item(int index); /** - * This method retrieves a <code>Node</code> using a name. With [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] - * documents, it first searches for a <code>Node</code> with a matching - * <code>id</code> attribute. If it doesn't find one, it then searches - * for a <code>Node</code> with a matching <code>name</code> attribute, - * but only on those elements that are allowed a name attribute. With [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>] - * documents, this method only searches for <code>Nodes</code> with a - * matching <code>id</code> attribute. This method is case insensitive + * This method retrieves a <code>Node</code> using a name. With [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] + * documents, it first searches for a <code>Node</code> with a matching + * <code>id</code> attribute. If it doesn't find one, it then searches + * for a <code>Node</code> with a matching <code>name</code> attribute, + * but only on those elements that are allowed a name attribute. With [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>] + * documents, this method only searches for <code>Nodes</code> with a + * matching <code>id</code> attribute. This method is case insensitive * in HTML documents and case sensitive in XHTML documents. * @param name The name of the <code>Node</code> to be fetched. - * @return The <code>Node</code> with a <code>name</code> or - * <code>id</code> attribute whose value corresponds to the specified - * string. Upon failure (e.g., no node with this name exists), returns + * @return The <code>Node</code> with a <code>name</code> or + * <code>id</code> attribute whose value corresponds to the specified + * string. Upon failure (e.g., no node with this name exists), returns * <code>null</code>. */ public Node namedItem(String name); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java index e8a3bb4a064..e6f17b6ad80 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLDListElement extends HTMLElement { /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getCompact(); /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCompact(boolean compact); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java index 5a405c80432..b66de037c81 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java @@ -13,18 +13,18 @@ package org.w3c.dom.html2; /** - * Directory list. See the DIR element definition in HTML 4.01. This element + * Directory list. See the DIR element definition in HTML 4.01. This element * is deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLDirectoryElement extends HTMLElement { /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getCompact(); /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCompact(boolean compact); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java index 31107c5f168..5f5c0dc88f6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLDivElement extends HTMLElement { /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java index 79ad1b3363f..b038783f671 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java @@ -17,218 +17,218 @@ import org.w3c.dom.NodeList; import org.w3c.dom.DOMException; /** - * An <code>HTMLDocument</code> is the root of the HTML hierarchy and holds - * the entire content. Besides providing access to the hierarchy, it also - * provides some convenience methods for accessing certain sets of + * An <code>HTMLDocument</code> is the root of the HTML hierarchy and holds + * the entire content. Besides providing access to the hierarchy, it also + * provides some convenience methods for accessing certain sets of * information from the document. - * <p>The following properties have been deprecated in favor of the + * <p>The following properties have been deprecated in favor of the * corresponding ones for the <code>BODY</code> element:alinkColorbackground - * bgColorfgColorlinkColorvlinkColorIn DOM Level 2, the method - * <code>getElementById</code> is inherited from the <code>Document</code> + * bgColorfgColorlinkColorvlinkColorIn DOM Level 2, the method + * <code>getElementById</code> is inherited from the <code>Document</code> * interface where it was moved to. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLDocument extends Document { /** - * The title of a document as specified by the <code>TITLE</code> element - * in the head of the document. + * The title of a document as specified by the <code>TITLE</code> element + * in the head of the document. */ public String getTitle(); /** - * The title of a document as specified by the <code>TITLE</code> element - * in the head of the document. + * The title of a document as specified by the <code>TITLE</code> element + * in the head of the document. */ public void setTitle(String title); /** - * Returns the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the page that linked to this page. The value is an - * empty string if the user navigated to the page directly (not through - * a link, but, for example, via a bookmark). + * Returns the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the page that linked to this page. The value is an + * empty string if the user navigated to the page directly (not through + * a link, but, for example, via a bookmark). */ public String getReferrer(); /** - * The domain name of the server that served the document, or - * <code>null</code> if the server cannot be identified by a domain - * name. + * The domain name of the server that served the document, or + * <code>null</code> if the server cannot be identified by a domain + * name. */ public String getDomain(); /** - * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the document. + * The absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the document. */ public String getURL(); /** - * The element that contains the content for the document. In documents - * with <code>BODY</code> contents, returns the <code>BODY</code> - * element. In frameset documents, this returns the outermost - * <code>FRAMESET</code> element. + * The element that contains the content for the document. In documents + * with <code>BODY</code> contents, returns the <code>BODY</code> + * element. In frameset documents, this returns the outermost + * <code>FRAMESET</code> element. */ public HTMLElement getBody(); /** - * The element that contains the content for the document. In documents - * with <code>BODY</code> contents, returns the <code>BODY</code> - * element. In frameset documents, this returns the outermost - * <code>FRAMESET</code> element. + * The element that contains the content for the document. In documents + * with <code>BODY</code> contents, returns the <code>BODY</code> + * element. In frameset documents, this returns the outermost + * <code>FRAMESET</code> element. */ public void setBody(HTMLElement body); /** - * A collection of all the <code>IMG</code> elements in a document. The - * behavior is limited to <code>IMG</code> elements for backwards - * compatibility. As suggested by [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>], to include images, authors may use - * the <code>OBJECT</code> element or the <code>IMG</code> element. - * Therefore, it is recommended not to use this attribute to find the - * images in the document but <code>getElementsByTagName</code> with + * A collection of all the <code>IMG</code> elements in a document. The + * behavior is limited to <code>IMG</code> elements for backwards + * compatibility. As suggested by [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>], to include images, authors may use + * the <code>OBJECT</code> element or the <code>IMG</code> element. + * Therefore, it is recommended not to use this attribute to find the + * images in the document but <code>getElementsByTagName</code> with * HTML 4.01 or <code>getElementsByTagNameNS</code> with XHTML 1.0. */ public HTMLCollection getImages(); /** - * A collection of all the <code>OBJECT</code> elements that include - * applets and <code>APPLET</code> (deprecated) elements in a document. + * A collection of all the <code>OBJECT</code> elements that include + * applets and <code>APPLET</code> (deprecated) elements in a document. */ public HTMLCollection getApplets(); /** * A collection of all <code>AREA</code> elements and anchor ( - * <code>A</code>) elements in a document with a value for the - * <code>href</code> attribute. + * <code>A</code>) elements in a document with a value for the + * <code>href</code> attribute. */ public HTMLCollection getLinks(); /** - * A collection of all the forms of a document. + * A collection of all the forms of a document. */ public HTMLCollection getForms(); /** - * A collection of all the anchor (<code>A</code>) elements in a document - * with a value for the <code>name</code> attribute. For reasons of - * backward compatibility, the returned set of anchors only contains - * those anchors created with the <code>name</code> attribute, not those - * created with the <code>id</code> attribute. Note that in [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>], the - * <code>name</code> attribute (see section 4.10) has no semantics and - * is only present for legacy user agents: the <code>id</code> attribute - * is used instead. Users should prefer the iterator mechanisms provided - * by [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal</a>] instead. + * A collection of all the anchor (<code>A</code>) elements in a document + * with a value for the <code>name</code> attribute. For reasons of + * backward compatibility, the returned set of anchors only contains + * those anchors created with the <code>name</code> attribute, not those + * created with the <code>id</code> attribute. Note that in [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>], the + * <code>name</code> attribute (see section 4.10) has no semantics and + * is only present for legacy user agents: the <code>id</code> attribute + * is used instead. Users should prefer the iterator mechanisms provided + * by [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal</a>] instead. */ public HTMLCollection getAnchors(); /** - * This mutable string attribute denotes persistent state information - * that (1) is associated with the current frame or document and (2) is - * composed of information described by the <code>cookies</code> - * non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>], Section 4.2.2. - * <br> If no persistent state information is available for the current - * frame or document document, then this property's value is an empty - * string. - * <br> When this attribute is read, all cookies are returned as a single - * string, with each cookie's name-value pair concatenated into a list - * of name-value pairs, each list item being separated by a ';' - * (semicolon). - * <br> When this attribute is set, the value it is set to should be a - * string that adheres to the <code>cookie</code> non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]; that - * is, it should be a single name-value pair followed by zero or more - * cookie attribute values. If no domain attribute is specified, then - * the domain attribute for the new value defaults to the host portion - * of an absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current frame or document. If no path - * attribute is specified, then the path attribute for the new value - * defaults to the absolute path portion of the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current - * frame or document. If no max-age attribute is specified, then the - * max-age attribute for the new value defaults to a user agent defined - * value. If a cookie with the specified name is already associated with - * the current frame or document, then the new value as well as the new - * attributes replace the old value and attributes. If a max-age - * attribute of 0 is specified for the new value, then any existing - * cookies of the specified name are removed from the cookie storage. - * See [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>] for the semantics of persistent state item attribute value - * pairs. The precise nature of a user agent session is not defined by - * this specification. + * This mutable string attribute denotes persistent state information + * that (1) is associated with the current frame or document and (2) is + * composed of information described by the <code>cookies</code> + * non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>], Section 4.2.2. + * <br> If no persistent state information is available for the current + * frame or document document, then this property's value is an empty + * string. + * <br> When this attribute is read, all cookies are returned as a single + * string, with each cookie's name-value pair concatenated into a list + * of name-value pairs, each list item being separated by a ';' + * (semicolon). + * <br> When this attribute is set, the value it is set to should be a + * string that adheres to the <code>cookie</code> non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]; that + * is, it should be a single name-value pair followed by zero or more + * cookie attribute values. If no domain attribute is specified, then + * the domain attribute for the new value defaults to the host portion + * of an absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current frame or document. If no path + * attribute is specified, then the path attribute for the new value + * defaults to the absolute path portion of the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current + * frame or document. If no max-age attribute is specified, then the + * max-age attribute for the new value defaults to a user agent defined + * value. If a cookie with the specified name is already associated with + * the current frame or document, then the new value as well as the new + * attributes replace the old value and attributes. If a max-age + * attribute of 0 is specified for the new value, then any existing + * cookies of the specified name are removed from the cookie storage. + * See [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>] for the semantics of persistent state item attribute value + * pairs. The precise nature of a user agent session is not defined by + * this specification. */ public String getCookie(); /** - * This mutable string attribute denotes persistent state information - * that (1) is associated with the current frame or document and (2) is - * composed of information described by the <code>cookies</code> - * non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>], Section 4.2.2. - * <br> If no persistent state information is available for the current - * frame or document document, then this property's value is an empty - * string. - * <br> When this attribute is read, all cookies are returned as a single - * string, with each cookie's name-value pair concatenated into a list - * of name-value pairs, each list item being separated by a ';' - * (semicolon). - * <br> When this attribute is set, the value it is set to should be a - * string that adheres to the <code>cookie</code> non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]; that - * is, it should be a single name-value pair followed by zero or more - * cookie attribute values. If no domain attribute is specified, then - * the domain attribute for the new value defaults to the host portion - * of an absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current frame or document. If no path - * attribute is specified, then the path attribute for the new value - * defaults to the absolute path portion of the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current - * frame or document. If no max-age attribute is specified, then the - * max-age attribute for the new value defaults to a user agent defined - * value. If a cookie with the specified name is already associated with - * the current frame or document, then the new value as well as the new - * attributes replace the old value and attributes. If a max-age - * attribute of 0 is specified for the new value, then any existing - * cookies of the specified name are removed from the cookie storage. - * See [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>] for the semantics of persistent state item attribute value - * pairs. The precise nature of a user agent session is not defined by - * this specification. + * This mutable string attribute denotes persistent state information + * that (1) is associated with the current frame or document and (2) is + * composed of information described by the <code>cookies</code> + * non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>], Section 4.2.2. + * <br> If no persistent state information is available for the current + * frame or document document, then this property's value is an empty + * string. + * <br> When this attribute is read, all cookies are returned as a single + * string, with each cookie's name-value pair concatenated into a list + * of name-value pairs, each list item being separated by a ';' + * (semicolon). + * <br> When this attribute is set, the value it is set to should be a + * string that adheres to the <code>cookie</code> non-terminal of [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]; that + * is, it should be a single name-value pair followed by zero or more + * cookie attribute values. If no domain attribute is specified, then + * the domain attribute for the new value defaults to the host portion + * of an absolute URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current frame or document. If no path + * attribute is specified, then the path attribute for the new value + * defaults to the absolute path portion of the URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the current + * frame or document. If no max-age attribute is specified, then the + * max-age attribute for the new value defaults to a user agent defined + * value. If a cookie with the specified name is already associated with + * the current frame or document, then the new value as well as the new + * attributes replace the old value and attributes. If a max-age + * attribute of 0 is specified for the new value, then any existing + * cookies of the specified name are removed from the cookie storage. + * See [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>] for the semantics of persistent state item attribute value + * pairs. The precise nature of a user agent session is not defined by + * this specification. * @exception DOMException - * SYNTAX_ERR: If the new value does not adhere to the cookie syntax - * specified by [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]. + * SYNTAX_ERR: If the new value does not adhere to the cookie syntax + * specified by [<a href='http://www.ietf.org/rfc/rfc2965.txt'>IETF RFC 2965</a>]. */ public void setCookie(String cookie) throws DOMException; /** - * Open a document stream for writing. If a document exists in the target, - * this method clears it. This method and the ones following allow a - * user to add to or replace the structure model of a document using - * strings of unparsed HTML. At the time of writing alternate methods - * for providing similar functionality for both HTML and XML documents + * Open a document stream for writing. If a document exists in the target, + * this method clears it. This method and the ones following allow a + * user to add to or replace the structure model of a document using + * strings of unparsed HTML. At the time of writing alternate methods + * for providing similar functionality for both HTML and XML documents * were being considered (see [<a href='http://www.w3.org/TR/2002/WD-DOM-Level-3-LS-20020725'>DOM Level 3 Load and Save</a>]). */ public void open(); /** - * Closes a document stream opened by <code>open()</code> and forces + * Closes a document stream opened by <code>open()</code> and forces * rendering. */ public void close(); /** - * Write a string of text to a document stream opened by - * <code>open()</code>. Note that the function will produce a document - * which is not necessarily driven by a DTD and therefore might be + * Write a string of text to a document stream opened by + * <code>open()</code>. Note that the function will produce a document + * which is not necessarily driven by a DTD and therefore might be * produce an invalid result in the context of the document. - * @param text The string to be parsed into some structure in the + * @param text The string to be parsed into some structure in the * document structure model. */ public void write(String text); /** - * Write a string of text followed by a newline character to a document - * stream opened by <code>open()</code>. Note that the function will - * produce a document which is not necessarily driven by a DTD and - * therefore might be produce an invalid result in the context of the + * Write a string of text followed by a newline character to a document + * stream opened by <code>open()</code>. Note that the function will + * produce a document which is not necessarily driven by a DTD and + * therefore might be produce an invalid result in the context of the * document - * @param text The string to be parsed into some structure in the + * @param text The string to be parsed into some structure in the * document structure model. */ public void writeln(String text); /** - * With [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] documents, this method returns the (possibly empty) collection - * of elements whose <code>name</code> value is given by - * <code>elementName</code>. In [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>] documents, this methods only return the - * (possibly empty) collection of form controls with matching name. This - * method is case sensitive. - * @param elementName The <code>name</code> attribute value for an + * With [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] documents, this method returns the (possibly empty) collection + * of elements whose <code>name</code> value is given by + * <code>elementName</code>. In [<a href='http://www.w3.org/TR/2002/REC-xhtml1-20020801'>XHTML 1.0</a>] documents, this methods only return the + * (possibly empty) collection of form controls with matching name. This + * method is case sensitive. + * @param elementName The <code>name</code> attribute value for an * element. * @return The matching elements. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLElement.java index ed37419d3bc..c6450301b8f 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLElement.java @@ -15,15 +15,15 @@ package org.w3c.dom.html2; import org.w3c.dom.Element; /** - * All HTML element interfaces derive from this class. Elements that only - * expose the HTML core attributes are represented by the base - * <code>HTMLElement</code> interface. These elements are as follows: + * All HTML element interfaces derive from this class. Elements that only + * expose the HTML core attributes are represented by the base + * <code>HTMLElement</code> interface. These elements are as follows: * special: SUB, SUP, SPAN, BDOfont: TT, I, B, U, S, STRIKE, BIG, SMALL - * phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBRlist: - * DD, DTNOFRAMES, NOSCRIPTADDRESS, CENTERThe <code>style</code> attribute - * of an HTML element is accessible through the - * <code>ElementCSSInlineStyle</code> interface which is defined in the CSS - * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>]. + * phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBRlist: + * DD, DTNOFRAMES, NOSCRIPTADDRESS, CENTERThe <code>style</code> attribute + * of an HTML element is accessible through the + * <code>ElementCSSInlineStyle</code> interface which is defined in the CSS + * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>]. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLElement extends Element { @@ -37,49 +37,49 @@ public interface HTMLElement extends Element { public void setId(String id); /** - * The element's advisory title. See the title attribute definition in + * The element's advisory title. See the title attribute definition in * HTML 4.01. */ public String getTitle(); /** - * The element's advisory title. See the title attribute definition in + * The element's advisory title. See the title attribute definition in * HTML 4.01. */ public void setTitle(String title); /** - * Language code defined in RFC 1766. See the lang attribute definition in + * Language code defined in RFC 1766. See the lang attribute definition in * HTML 4.01. */ public String getLang(); /** - * Language code defined in RFC 1766. See the lang attribute definition in + * Language code defined in RFC 1766. See the lang attribute definition in * HTML 4.01. */ public void setLang(String lang); /** - * Specifies the base direction of directionally neutral text and the - * directionality of tables. See the dir attribute definition in HTML + * Specifies the base direction of directionally neutral text and the + * directionality of tables. See the dir attribute definition in HTML * 4.01. */ public String getDir(); /** - * Specifies the base direction of directionally neutral text and the - * directionality of tables. See the dir attribute definition in HTML + * Specifies the base direction of directionally neutral text and the + * directionality of tables. See the dir attribute definition in HTML * 4.01. */ public void setDir(String dir); /** - * The class attribute of the element. This attribute has been renamed due - * to conflicts with the "class" keyword exposed by many languages. See + * The class attribute of the element. This attribute has been renamed due + * to conflicts with the "class" keyword exposed by many languages. See * the class attribute definition in HTML 4.01. */ public String getClassName(); /** - * The class attribute of the element. This attribute has been renamed due - * to conflicts with the "class" keyword exposed by many languages. See + * The class attribute of the element. This attribute has been renamed due + * to conflicts with the "class" keyword exposed by many languages. See * the class attribute definition in HTML 4.01. */ public void setClassName(String className); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java index c962a567d1b..f3bcb7df7e5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java @@ -13,15 +13,15 @@ package org.w3c.dom.html2; /** - * Organizes form controls into logical groups. See the FIELDSET element + * Organizes form controls into logical groups. See the FIELDSET element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLFieldSetElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java index 8fa25893c35..aa6a2847bd1 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java @@ -13,40 +13,40 @@ package org.w3c.dom.html2; /** - * Local change to font. See the FONT element definition in HTML 4.01. This + * Local change to font. See the FONT element definition in HTML 4.01. This * element is deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLFontElement extends HTMLElement { /** - * Font color. See the color attribute definition in HTML 4.01. This + * Font color. See the color attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getColor(); /** - * Font color. See the color attribute definition in HTML 4.01. This + * Font color. See the color attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setColor(String color); /** - * Font face identifier. See the face attribute definition in HTML 4.01. + * Font face identifier. See the face attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getFace(); /** - * Font face identifier. See the face attribute definition in HTML 4.01. + * Font face identifier. See the face attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setFace(String face); /** - * Font size. See the size attribute definition in HTML 4.01. This + * Font size. See the size attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getSize(); /** - * Font size. See the size attribute definition in HTML 4.01. This + * Font size. See the size attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setSize(String size); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java index 109f31a57dd..60ec7736fbb 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java @@ -13,15 +13,15 @@ package org.w3c.dom.html2; /** - * The <code>FORM</code> element encompasses behavior similar to a collection - * and an element. It provides direct access to the contained form controls - * as well as the attributes of the form element. See the FORM element + * The <code>FORM</code> element encompasses behavior similar to a collection + * and an element. It provides direct access to the contained form controls + * as well as the attributes of the form element. See the FORM element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLFormElement extends HTMLElement { /** - * Returns a collection of all form control elements in the form. + * Returns a collection of all form control elements in the form. */ public HTMLCollection getElements(); @@ -31,73 +31,73 @@ public interface HTMLFormElement extends HTMLElement { public int getLength(); /** - * Names the form. + * Names the form. */ public String getName(); /** - * Names the form. + * Names the form. */ public void setName(String name); /** - * List of character sets supported by the server. See the accept-charset + * List of character sets supported by the server. See the accept-charset * attribute definition in HTML 4.01. */ public String getAcceptCharset(); /** - * List of character sets supported by the server. See the accept-charset + * List of character sets supported by the server. See the accept-charset * attribute definition in HTML 4.01. */ public void setAcceptCharset(String acceptCharset); /** - * Server-side form handler. See the action attribute definition in HTML + * Server-side form handler. See the action attribute definition in HTML * 4.01. */ public String getAction(); /** - * Server-side form handler. See the action attribute definition in HTML + * Server-side form handler. See the action attribute definition in HTML * 4.01. */ public void setAction(String action); /** - * The content type of the submitted form, generally - * "application/x-www-form-urlencoded". See the enctype attribute - * definition in HTML 4.01. The onsubmit even handler is not guaranteed - * to be triggered when invoking this method. The behavior is - * inconsistent for historical reasons and authors should not rely on a - * particular one. + * The content type of the submitted form, generally + * "application/x-www-form-urlencoded". See the enctype attribute + * definition in HTML 4.01. The onsubmit even handler is not guaranteed + * to be triggered when invoking this method. The behavior is + * inconsistent for historical reasons and authors should not rely on a + * particular one. */ public String getEnctype(); /** - * The content type of the submitted form, generally - * "application/x-www-form-urlencoded". See the enctype attribute - * definition in HTML 4.01. The onsubmit even handler is not guaranteed - * to be triggered when invoking this method. The behavior is - * inconsistent for historical reasons and authors should not rely on a - * particular one. + * The content type of the submitted form, generally + * "application/x-www-form-urlencoded". See the enctype attribute + * definition in HTML 4.01. The onsubmit even handler is not guaranteed + * to be triggered when invoking this method. The behavior is + * inconsistent for historical reasons and authors should not rely on a + * particular one. */ public void setEnctype(String enctype); /** - * HTTP method [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] used to submit form. See the method attribute definition + * HTTP method [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] used to submit form. See the method attribute definition * in HTML 4.01. */ public String getMethod(); /** - * HTTP method [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] used to submit form. See the method attribute definition + * HTTP method [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] used to submit form. See the method attribute definition * in HTML 4.01. */ public void setMethod(String method); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public String getTarget(); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public void setTarget(String target); @@ -108,7 +108,7 @@ public interface HTMLFormElement extends HTMLElement { public void submit(); /** - * Restores a form element's default values. It performs the same action + * Restores a form element's default values. It performs the same action * as a reset button. */ public void reset(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java index d6100815f5a..dfe877f152e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java @@ -20,95 +20,95 @@ import org.w3c.dom.Document; */ public interface HTMLFrameElement extends HTMLElement { /** - * Request frame borders. See the frameborder attribute definition in HTML + * Request frame borders. See the frameborder attribute definition in HTML * 4.01. */ public String getFrameBorder(); /** - * Request frame borders. See the frameborder attribute definition in HTML + * Request frame borders. See the frameborder attribute definition in HTML * 4.01. */ public void setFrameBorder(String frameBorder); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public String getLongDesc(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public void setLongDesc(String longDesc); /** - * Frame margin height, in pixels. See the marginheight attribute + * Frame margin height, in pixels. See the marginheight attribute * definition in HTML 4.01. */ public String getMarginHeight(); /** - * Frame margin height, in pixels. See the marginheight attribute + * Frame margin height, in pixels. See the marginheight attribute * definition in HTML 4.01. */ public void setMarginHeight(String marginHeight); /** - * Frame margin width, in pixels. See the marginwidth attribute definition + * Frame margin width, in pixels. See the marginwidth attribute definition * in HTML 4.01. */ public String getMarginWidth(); /** - * Frame margin width, in pixels. See the marginwidth attribute definition + * Frame margin width, in pixels. See the marginwidth attribute definition * in HTML 4.01. */ public void setMarginWidth(String marginWidth); /** - * The frame name (object of the <code>target</code> attribute). See the + * The frame name (object of the <code>target</code> attribute). See the * name attribute definition in HTML 4.01. */ public String getName(); /** - * The frame name (object of the <code>target</code> attribute). See the + * The frame name (object of the <code>target</code> attribute). See the * name attribute definition in HTML 4.01. */ public void setName(String name); /** - * When true, forbid user from resizing frame. See the noresize attribute + * When true, forbid user from resizing frame. See the noresize attribute * definition in HTML 4.01. */ public boolean getNoResize(); /** - * When true, forbid user from resizing frame. See the noresize attribute + * When true, forbid user from resizing frame. See the noresize attribute * definition in HTML 4.01. */ public void setNoResize(boolean noResize); /** - * Specify whether or not the frame should have scrollbars. See the + * Specify whether or not the frame should have scrollbars. See the * scrolling attribute definition in HTML 4.01. */ public String getScrolling(); /** - * Specify whether or not the frame should have scrollbars. See the + * Specify whether or not the frame should have scrollbars. See the * scrolling attribute definition in HTML 4.01. */ public void setScrolling(String scrolling); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute * definition in HTML 4.01. */ public String getSrc(); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute * definition in HTML 4.01. */ public void setSrc(String src); /** - * The document this frame contains, if there is any and it is available, + * The document this frame contains, if there is any and it is available, * or <code>null</code> otherwise. * @since DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java index 4e5d75bde1b..d2b9c34e96c 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java @@ -18,23 +18,23 @@ package org.w3c.dom.html2; */ public interface HTMLFrameSetElement extends HTMLElement { /** - * The number of columns of frames in the frameset. See the cols attribute + * The number of columns of frames in the frameset. See the cols attribute * definition in HTML 4.01. */ public String getCols(); /** - * The number of columns of frames in the frameset. See the cols attribute + * The number of columns of frames in the frameset. See the cols attribute * definition in HTML 4.01. */ public void setCols(String cols); /** - * The number of rows of frames in the frameset. See the rows attribute + * The number of rows of frames in the frameset. See the rows attribute * definition in HTML 4.01. */ public String getRows(); /** - * The number of rows of frames in the frameset. See the rows attribute + * The number of rows of frames in the frameset. See the rows attribute * definition in HTML 4.01. */ public void setRows(String rows); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java index b09ec0f3fb1..d832bc3f032 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java @@ -18,47 +18,47 @@ package org.w3c.dom.html2; */ public interface HTMLHRElement extends HTMLElement { /** - * Align the rule on the page. See the align attribute definition in HTML + * Align the rule on the page. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Align the rule on the page. See the align attribute definition in HTML + * Align the rule on the page. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Indicates to the user agent that there should be no shading in the - * rendering of this element. See the noshade attribute definition in + * Indicates to the user agent that there should be no shading in the + * rendering of this element. See the noshade attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getNoShade(); /** - * Indicates to the user agent that there should be no shading in the - * rendering of this element. See the noshade attribute definition in + * Indicates to the user agent that there should be no shading in the + * rendering of this element. See the noshade attribute definition in * HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setNoShade(boolean noShade); /** - * The height of the rule. See the size attribute definition in HTML 4.01. + * The height of the rule. See the size attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getSize(); /** - * The height of the rule. See the size attribute definition in HTML 4.01. + * The height of the rule. See the size attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setSize(String size); /** - * The width of the rule. See the width attribute definition in HTML 4.01. + * The width of the rule. See the width attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getWidth(); /** - * The width of the rule. See the width attribute definition in HTML 4.01. + * The width of the rule. See the width attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setWidth(String width); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java index c4550a50711..85617a7ee20 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLHeadElement extends HTMLElement { /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a metadata profile. See the profile attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a metadata profile. See the profile attribute * definition in HTML 4.01. */ public String getProfile(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a metadata profile. See the profile attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a metadata profile. See the profile attribute * definition in HTML 4.01. */ public void setProfile(String profile); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java index 149752507e3..291f5d87a30 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java @@ -13,18 +13,18 @@ package org.w3c.dom.html2; /** - * For the <code>H1</code> to <code>H6</code> elements. See the H1 element + * For the <code>H1</code> to <code>H6</code> elements. See the H1 element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLHeadingElement extends HTMLElement { /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java index 5ba30fe3177..3601d7eb360 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLHtmlElement extends HTMLElement { /** - * Version information about the document's DTD. See the version attribute + * Version information about the document's DTD. See the version attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getVersion(); /** - * Version information about the document's DTD. See the version attribute + * Version information about the document's DTD. See the version attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setVersion(String version); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java index 7cac12f89e5..6106e62a26a 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java @@ -20,25 +20,25 @@ import org.w3c.dom.Document; */ public interface HTMLIFrameElement extends HTMLElement { /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Request frame borders. See the frameborder attribute definition in HTML + * Request frame borders. See the frameborder attribute definition in HTML * 4.01. */ public String getFrameBorder(); /** - * Request frame borders. See the frameborder attribute definition in HTML + * Request frame borders. See the frameborder attribute definition in HTML * 4.01. */ public void setFrameBorder(String frameBorder); @@ -53,67 +53,67 @@ public interface HTMLIFrameElement extends HTMLElement { public void setHeight(String height); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public String getLongDesc(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public void setLongDesc(String longDesc); /** - * Frame margin height, in pixels. See the marginheight attribute + * Frame margin height, in pixels. See the marginheight attribute * definition in HTML 4.01. */ public String getMarginHeight(); /** - * Frame margin height, in pixels. See the marginheight attribute + * Frame margin height, in pixels. See the marginheight attribute * definition in HTML 4.01. */ public void setMarginHeight(String marginHeight); /** - * Frame margin width, in pixels. See the marginwidth attribute definition + * Frame margin width, in pixels. See the marginwidth attribute definition * in HTML 4.01. */ public String getMarginWidth(); /** - * Frame margin width, in pixels. See the marginwidth attribute definition + * Frame margin width, in pixels. See the marginwidth attribute definition * in HTML 4.01. */ public void setMarginWidth(String marginWidth); /** - * The frame name (object of the <code>target</code> attribute). See the + * The frame name (object of the <code>target</code> attribute). See the * name attribute definition in HTML 4.01. */ public String getName(); /** - * The frame name (object of the <code>target</code> attribute). See the + * The frame name (object of the <code>target</code> attribute). See the * name attribute definition in HTML 4.01. */ public void setName(String name); /** - * Specify whether or not the frame should have scrollbars. See the + * Specify whether or not the frame should have scrollbars. See the * scrolling attribute definition in HTML 4.01. */ public String getScrolling(); /** - * Specify whether or not the frame should have scrollbars. See the + * Specify whether or not the frame should have scrollbars. See the * scrolling attribute definition in HTML 4.01. */ public void setScrolling(String scrolling); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute * definition in HTML 4.01. */ public String getSrc(); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the initial frame contents. See the src attribute * definition in HTML 4.01. */ public void setSrc(String src); @@ -128,7 +128,7 @@ public interface HTMLIFrameElement extends HTMLElement { public void setWidth(String width); /** - * The document this frame contains, if there is any and it is available, + * The document this frame contains, if there is any and it is available, * or <code>null</code> otherwise. * @since DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java index 8e8142184d4..0a1d4b72279 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java @@ -18,156 +18,156 @@ package org.w3c.dom.html2; */ public interface HTMLImageElement extends HTMLElement { /** - * The name of the element (for backwards compatibility). + * The name of the element (for backwards compatibility). */ public String getName(); /** - * The name of the element (for backwards compatibility). + * The name of the element (for backwards compatibility). */ public void setName(String name); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public String getAlt(); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public void setAlt(String alt); /** - * Width of border around image. See the border attribute definition in - * HTML 4.01. This attribute is deprecated in HTML 4.01. Note that the + * Width of border around image. See the border attribute definition in + * HTML 4.01. This attribute is deprecated in HTML 4.01. Note that the * type of this attribute was <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>] * . */ public String getBorder(); /** - * Width of border around image. See the border attribute definition in - * HTML 4.01. This attribute is deprecated in HTML 4.01. Note that the + * Width of border around image. See the border attribute definition in + * HTML 4.01. This attribute is deprecated in HTML 4.01. Note that the * type of this attribute was <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>] * . */ public void setBorder(String border); /** - * Height of the image in pixels. See the height attribute definition in - * HTML 4.01. Note that the type of this attribute was + * Height of the image in pixels. See the height attribute definition in + * HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public int getHeight(); /** - * Height of the image in pixels. See the height attribute definition in - * HTML 4.01. Note that the type of this attribute was + * Height of the image in pixels. See the height attribute definition in + * HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public void setHeight(int height); /** - * Horizontal space to the left and right of this image in pixels. See the - * hspace attribute definition in HTML 4.01. This attribute is - * deprecated in HTML 4.01. Note that the type of this attribute was + * Horizontal space to the left and right of this image in pixels. See the + * hspace attribute definition in HTML 4.01. This attribute is + * deprecated in HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public int getHspace(); /** - * Horizontal space to the left and right of this image in pixels. See the - * hspace attribute definition in HTML 4.01. This attribute is - * deprecated in HTML 4.01. Note that the type of this attribute was + * Horizontal space to the left and right of this image in pixels. See the + * hspace attribute definition in HTML 4.01. This attribute is + * deprecated in HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public void setHspace(int hspace); /** - * Use server-side image map. See the ismap attribute definition in HTML + * Use server-side image map. See the ismap attribute definition in HTML * 4.01. */ public boolean getIsMap(); /** - * Use server-side image map. See the ismap attribute definition in HTML + * Use server-side image map. See the ismap attribute definition in HTML * 4.01. */ public void setIsMap(boolean isMap); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public String getLongDesc(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a long description of this image or frame. See the * longdesc attribute definition in HTML 4.01. */ public void setLongDesc(String longDesc); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the source of this image. See the src attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the source of this image. See the src attribute * definition in HTML 4.01. */ public String getSrc(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the source of this image. See the src attribute + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating the source of this image. See the src attribute * definition in HTML 4.01. */ public void setSrc(String src); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public String getUseMap(); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public void setUseMap(String useMap); /** - * Vertical space above and below this image in pixels. See the vspace - * attribute definition in HTML 4.01. This attribute is deprecated in - * HTML 4.01. Note that the type of this attribute was "DOMString" in + * Vertical space above and below this image in pixels. See the vspace + * attribute definition in HTML 4.01. This attribute is deprecated in + * HTML 4.01. Note that the type of this attribute was "DOMString" in * DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public int getVspace(); /** - * Vertical space above and below this image in pixels. See the vspace - * attribute definition in HTML 4.01. This attribute is deprecated in - * HTML 4.01. Note that the type of this attribute was "DOMString" in + * Vertical space above and below this image in pixels. See the vspace + * attribute definition in HTML 4.01. This attribute is deprecated in + * HTML 4.01. Note that the type of this attribute was "DOMString" in * DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public void setVspace(int vspace); /** - * The width of the image in pixels. See the width attribute definition in - * HTML 4.01. Note that the type of this attribute was + * The width of the image in pixels. See the width attribute definition in + * HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ public int getWidth(); /** - * The width of the image in pixels. See the width attribute definition in - * HTML 4.01. Note that the type of this attribute was + * The width of the image in pixels. See the width attribute definition in + * HTML 4.01. Note that the type of this attribute was * <code>DOMString</code> in DOM Level 1 HTML [<a href='http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001'>DOM Level 1</a>]. * @version DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java index b0d0d9d091b..c557e0bcec6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java @@ -13,265 +13,265 @@ package org.w3c.dom.html2; /** - * Form control.Depending upon the environment in which the page is being - * viewed, the value property may be read-only for the file upload input - * type. For the "password" input type, the actual value returned may be + * Form control.Depending upon the environment in which the page is being + * viewed, the value property may be read-only for the file upload input + * type. For the "password" input type, the actual value returned may be * masked to prevent unauthorized use. See the INPUT element definition in [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>]. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLInputElement extends HTMLElement { /** - * When the <code>type</code> attribute of the element has the value - * "text", "file" or "password", this represents the HTML value - * attribute of the element. The value of this attribute does not change - * if the contents of the corresponding form control, in an interactive + * When the <code>type</code> attribute of the element has the value + * "text", "file" or "password", this represents the HTML value + * attribute of the element. The value of this attribute does not change + * if the contents of the corresponding form control, in an interactive * user agent, changes. See the value attribute definition in HTML 4.01. */ public String getDefaultValue(); /** - * When the <code>type</code> attribute of the element has the value - * "text", "file" or "password", this represents the HTML value - * attribute of the element. The value of this attribute does not change - * if the contents of the corresponding form control, in an interactive + * When the <code>type</code> attribute of the element has the value + * "text", "file" or "password", this represents the HTML value + * attribute of the element. The value of this attribute does not change + * if the contents of the corresponding form control, in an interactive * user agent, changes. See the value attribute definition in HTML 4.01. */ public void setDefaultValue(String defaultValue); /** - * When <code>type</code> has the value "radio" or "checkbox", this - * represents the HTML checked attribute of the element. The value of - * this attribute does not change if the state of the corresponding form - * control, in an interactive user agent, changes. See the checked + * When <code>type</code> has the value "radio" or "checkbox", this + * represents the HTML checked attribute of the element. The value of + * this attribute does not change if the state of the corresponding form + * control, in an interactive user agent, changes. See the checked * attribute definition in HTML 4.01. */ public boolean getDefaultChecked(); /** - * When <code>type</code> has the value "radio" or "checkbox", this - * represents the HTML checked attribute of the element. The value of - * this attribute does not change if the state of the corresponding form - * control, in an interactive user agent, changes. See the checked + * When <code>type</code> has the value "radio" or "checkbox", this + * represents the HTML checked attribute of the element. The value of + * this attribute does not change if the state of the corresponding form + * control, in an interactive user agent, changes. See the checked * attribute definition in HTML 4.01. */ public void setDefaultChecked(boolean defaultChecked); /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * A comma-separated list of content types that a server processing this - * form will handle correctly. See the accept attribute definition in + * A comma-separated list of content types that a server processing this + * form will handle correctly. See the accept attribute definition in * HTML 4.01. */ public String getAccept(); /** - * A comma-separated list of content types that a server processing this - * form will handle correctly. See the accept attribute definition in + * A comma-separated list of content types that a server processing this + * form will handle correctly. See the accept attribute definition in * HTML 4.01. */ public void setAccept(String accept); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public String getAlt(); /** - * Alternate text for user agents not rendering the normal content of this + * Alternate text for user agents not rendering the normal content of this * element. See the alt attribute definition in HTML 4.01. */ public void setAlt(String alt); /** - * When the <code>type</code> attribute of the element has the value - * "radio" or "checkbox", this represents the current state of the form - * control, in an interactive user agent. Changes to this attribute - * change the state of the form control, but do not change the value of - * the HTML checked attribute of the INPUT element.During the handling - * of a click event on an input element with a type attribute that has - * the value "radio" or "checkbox", some implementations may change the - * value of this property before the event is being dispatched in the - * document. If the default action of the event is canceled, the value - * of the property may be changed back to its original value. This means - * that the value of this property during the handling of click events + * When the <code>type</code> attribute of the element has the value + * "radio" or "checkbox", this represents the current state of the form + * control, in an interactive user agent. Changes to this attribute + * change the state of the form control, but do not change the value of + * the HTML checked attribute of the INPUT element.During the handling + * of a click event on an input element with a type attribute that has + * the value "radio" or "checkbox", some implementations may change the + * value of this property before the event is being dispatched in the + * document. If the default action of the event is canceled, the value + * of the property may be changed back to its original value. This means + * that the value of this property during the handling of click events * is implementation dependent. */ public boolean getChecked(); /** - * When the <code>type</code> attribute of the element has the value - * "radio" or "checkbox", this represents the current state of the form - * control, in an interactive user agent. Changes to this attribute - * change the state of the form control, but do not change the value of - * the HTML checked attribute of the INPUT element.During the handling - * of a click event on an input element with a type attribute that has - * the value "radio" or "checkbox", some implementations may change the - * value of this property before the event is being dispatched in the - * document. If the default action of the event is canceled, the value - * of the property may be changed back to its original value. This means - * that the value of this property during the handling of click events + * When the <code>type</code> attribute of the element has the value + * "radio" or "checkbox", this represents the current state of the form + * control, in an interactive user agent. Changes to this attribute + * change the state of the form control, but do not change the value of + * the HTML checked attribute of the INPUT element.During the handling + * of a click event on an input element with a type attribute that has + * the value "radio" or "checkbox", some implementations may change the + * value of this property before the event is being dispatched in the + * document. If the default action of the event is canceled, the value + * of the property may be changed back to its original value. This means + * that the value of this property during the handling of click events * is implementation dependent. */ public void setChecked(boolean checked); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); /** - * Maximum number of characters for text fields, when <code>type</code> - * has the value "text" or "password". See the maxlength attribute + * Maximum number of characters for text fields, when <code>type</code> + * has the value "text" or "password". See the maxlength attribute * definition in HTML 4.01. */ public int getMaxLength(); /** - * Maximum number of characters for text fields, when <code>type</code> - * has the value "text" or "password". See the maxlength attribute + * Maximum number of characters for text fields, when <code>type</code> + * has the value "text" or "password". See the maxlength attribute * definition in HTML 4.01. */ public void setMaxLength(int maxLength); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public void setName(String name); /** - * This control is read-only. Relevant only when <code>type</code> has the - * value "text" or "password". See the readonly attribute definition in + * This control is read-only. Relevant only when <code>type</code> has the + * value "text" or "password". See the readonly attribute definition in * HTML 4.01. */ public boolean getReadOnly(); /** - * This control is read-only. Relevant only when <code>type</code> has the - * value "text" or "password". See the readonly attribute definition in + * This control is read-only. Relevant only when <code>type</code> has the + * value "text" or "password". See the readonly attribute definition in * HTML 4.01. */ public void setReadOnly(boolean readOnly); /** - * Size information. The precise meaning is specific to each type of + * Size information. The precise meaning is specific to each type of * field. See the size attribute definition in HTML 4.01. * @version DOM Level 2 */ public int getSize(); /** - * Size information. The precise meaning is specific to each type of + * Size information. The precise meaning is specific to each type of * field. See the size attribute definition in HTML 4.01. * @version DOM Level 2 */ public void setSize(int size); /** - * When the <code>type</code> attribute has the value "image", this - * attribute specifies the location of the image to be used to decorate - * the graphical submit button. See the src attribute definition in HTML + * When the <code>type</code> attribute has the value "image", this + * attribute specifies the location of the image to be used to decorate + * the graphical submit button. See the src attribute definition in HTML * 4.01. */ public String getSrc(); /** - * When the <code>type</code> attribute has the value "image", this - * attribute specifies the location of the image to be used to decorate - * the graphical submit button. See the src attribute definition in HTML + * When the <code>type</code> attribute has the value "image", this + * attribute specifies the location of the image to be used to decorate + * the graphical submit button. See the src attribute definition in HTML * 4.01. */ public void setSrc(String src); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * The type of control created (all lower case). See the type attribute + * The type of control created (all lower case). See the type attribute * definition in HTML 4.01. * @version DOM Level 2 */ public String getType(); /** - * The type of control created (all lower case). See the type attribute + * The type of control created (all lower case). See the type attribute * definition in HTML 4.01. * @version DOM Level 2 */ public void setType(String type); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public String getUseMap(); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public void setUseMap(String useMap); /** - * When the <code>type</code> attribute of the element has the value - * "text", "file" or "password", this represents the current contents of - * the corresponding form control, in an interactive user agent. - * Changing this attribute changes the contents of the form control, but - * does not change the value of the HTML value attribute of the element. - * When the <code>type</code> attribute of the element has the value - * "button", "hidden", "submit", "reset", "image", "checkbox" or - * "radio", this represents the HTML value attribute of the element. See + * When the <code>type</code> attribute of the element has the value + * "text", "file" or "password", this represents the current contents of + * the corresponding form control, in an interactive user agent. + * Changing this attribute changes the contents of the form control, but + * does not change the value of the HTML value attribute of the element. + * When the <code>type</code> attribute of the element has the value + * "button", "hidden", "submit", "reset", "image", "checkbox" or + * "radio", this represents the HTML value attribute of the element. See * the value attribute definition in HTML 4.01. */ public String getValue(); /** - * When the <code>type</code> attribute of the element has the value - * "text", "file" or "password", this represents the current contents of - * the corresponding form control, in an interactive user agent. - * Changing this attribute changes the contents of the form control, but - * does not change the value of the HTML value attribute of the element. - * When the <code>type</code> attribute of the element has the value - * "button", "hidden", "submit", "reset", "image", "checkbox" or - * "radio", this represents the HTML value attribute of the element. See + * When the <code>type</code> attribute of the element has the value + * "text", "file" or "password", this represents the current contents of + * the corresponding form control, in an interactive user agent. + * Changing this attribute changes the contents of the form control, but + * does not change the value of the HTML value attribute of the element. + * When the <code>type</code> attribute of the element has the value + * "button", "hidden", "submit", "reset", "image", "checkbox" or + * "radio", this represents the HTML value attribute of the element. See * the value attribute definition in HTML 4.01. */ public void setValue(String value); @@ -287,15 +287,15 @@ public interface HTMLInputElement extends HTMLElement { public void focus(); /** - * Select the contents of the text area. For <code>INPUT</code> elements - * whose <code>type</code> attribute has one of the following values: + * Select the contents of the text area. For <code>INPUT</code> elements + * whose <code>type</code> attribute has one of the following values: * "text", "file", or "password". */ public void select(); /** - * Simulate a mouse-click. For <code>INPUT</code> elements whose - * <code>type</code> attribute has one of the following values: + * Simulate a mouse-click. For <code>INPUT</code> elements whose + * <code>type</code> attribute has one of the following values: * "button", "checkbox", "radio", "reset", or "submit". */ public void click(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java index 898b9e46a01..f1b4b7478ce 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java @@ -13,25 +13,25 @@ package org.w3c.dom.html2; /** - * This element is used for single-line text input. See the ISINDEX element + * This element is used for single-line text input. See the ISINDEX element * definition in HTML 4.01. This element is deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLIsIndexElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * The prompt message. See the prompt attribute definition in HTML 4.01. + * The prompt message. See the prompt attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getPrompt(); /** - * The prompt message. See the prompt attribute definition in HTML 4.01. + * The prompt message. See the prompt attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setPrompt(String prompt); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java index df20c000ac2..3a69f5e9ec2 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java @@ -18,25 +18,25 @@ package org.w3c.dom.html2; */ public interface HTMLLIElement extends HTMLElement { /** - * List item bullet style. See the type attribute definition in HTML 4.01. + * List item bullet style. See the type attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getType(); /** - * List item bullet style. See the type attribute definition in HTML 4.01. + * List item bullet style. See the type attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setType(String type); /** - * Reset sequence number when used in <code>OL</code>. See the value - * attribute definition in HTML 4.01. This attribute is deprecated in + * Reset sequence number when used in <code>OL</code>. See the value + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public int getValue(); /** - * Reset sequence number when used in <code>OL</code>. See the value - * attribute definition in HTML 4.01. This attribute is deprecated in + * Reset sequence number when used in <code>OL</code>. See the value + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public void setValue(int value); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java index 69a104053c2..ef1a10aea57 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java @@ -18,32 +18,32 @@ package org.w3c.dom.html2; */ public interface HTMLLabelElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * This attribute links this label with another form control by - * <code>id</code> attribute. See the for attribute definition in HTML + * This attribute links this label with another form control by + * <code>id</code> attribute. See the for attribute definition in HTML * 4.01. */ public String getHtmlFor(); /** - * This attribute links this label with another form control by - * <code>id</code> attribute. See the for attribute definition in HTML + * This attribute links this label with another form control by + * <code>id</code> attribute. See the for attribute definition in HTML * 4.01. */ public void setHtmlFor(String htmlFor); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java index b976d099a6a..774a11640dd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java @@ -13,38 +13,38 @@ package org.w3c.dom.html2; /** - * Provides a caption for a <code>FIELDSET</code> grouping. See the LEGEND + * Provides a caption for a <code>FIELDSET</code> grouping. See the LEGEND * element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLLegendElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * Text alignment relative to <code>FIELDSET</code>. See the align - * attribute definition in HTML 4.01. This attribute is deprecated in + * Text alignment relative to <code>FIELDSET</code>. See the align + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public String getAlign(); /** - * Text alignment relative to <code>FIELDSET</code>. See the align - * attribute definition in HTML 4.01. This attribute is deprecated in + * Text alignment relative to <code>FIELDSET</code>. See the align + * attribute definition in HTML 4.01. This attribute is deprecated in * HTML 4.01. */ public void setAlign(String align); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java index 4ed72ca9483..8210a4a3535 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java @@ -13,64 +13,64 @@ package org.w3c.dom.html2; /** - * The <code>LINK</code> element specifies a link to an external resource, and - * defines this document's relationship to that resource (or vice versa). - * See the LINK element definition in HTML 4.01 (see also the + * The <code>LINK</code> element specifies a link to an external resource, and + * defines this document's relationship to that resource (or vice versa). + * See the LINK element definition in HTML 4.01 (see also the * <code>LinkStyle</code> interface in the StyleSheet module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>]). * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLLinkElement extends HTMLElement { /** - * Enables/disables the link. This is currently only used for style sheet - * links, and may be used to activate or deactivate style sheets. + * Enables/disables the link. This is currently only used for style sheet + * links, and may be used to activate or deactivate style sheets. */ public boolean getDisabled(); /** - * Enables/disables the link. This is currently only used for style sheet - * links, and may be used to activate or deactivate style sheets. + * Enables/disables the link. This is currently only used for style sheet + * links, and may be used to activate or deactivate style sheets. */ public void setDisabled(boolean disabled); /** - * The character encoding of the resource being linked to. See the charset + * The character encoding of the resource being linked to. See the charset * attribute definition in HTML 4.01. */ public String getCharset(); /** - * The character encoding of the resource being linked to. See the charset + * The character encoding of the resource being linked to. See the charset * attribute definition in HTML 4.01. */ public void setCharset(String charset); /** - * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in + * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in * HTML 4.01. */ public String getHref(); /** - * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in + * The URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] of the linked resource. See the href attribute definition in * HTML 4.01. */ public void setHref(String href); /** - * Language code of the linked resource. See the hreflang attribute + * Language code of the linked resource. See the hreflang attribute * definition in HTML 4.01. */ public String getHreflang(); /** - * Language code of the linked resource. See the hreflang attribute + * Language code of the linked resource. See the hreflang attribute * definition in HTML 4.01. */ public void setHreflang(String hreflang); /** - * Designed for use with one or more target media. See the media attribute + * Designed for use with one or more target media. See the media attribute * definition in HTML 4.01. */ public String getMedia(); /** - * Designed for use with one or more target media. See the media attribute + * Designed for use with one or more target media. See the media attribute * definition in HTML 4.01. */ public void setMedia(String media); @@ -94,12 +94,12 @@ public interface HTMLLinkElement extends HTMLElement { public void setRev(String rev); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public String getTarget(); /** - * Frame to render the resource in. See the target attribute definition in + * Frame to render the resource in. See the target attribute definition in * HTML 4.01. */ public void setTarget(String target); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java index e413727ab4d..b1f78682a1a 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java @@ -18,17 +18,17 @@ package org.w3c.dom.html2; */ public interface HTMLMapElement extends HTMLElement { /** - * The list of areas defined for the image map. + * The list of areas defined for the image map. */ public HTMLCollection getAreas(); /** - * Names the map (for use with <code>usemap</code>). See the name + * Names the map (for use with <code>usemap</code>). See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Names the map (for use with <code>usemap</code>). See the name + * Names the map (for use with <code>usemap</code>). See the name * attribute definition in HTML 4.01. */ public void setName(String name); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java index 7c8ec62d0eb..17e81c597e0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java @@ -13,18 +13,18 @@ package org.w3c.dom.html2; /** - * Menu list. See the MENU element definition in HTML 4.01. This element is + * Menu list. See the MENU element definition in HTML 4.01. This element is * deprecated in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLMenuElement extends HTMLElement { /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getCompact(); /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCompact(boolean compact); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java index b6bf05d40c7..a56fed5fc6d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java @@ -13,29 +13,29 @@ package org.w3c.dom.html2; /** - * This contains generic meta-information about the document. See the META + * This contains generic meta-information about the document. See the META * element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLMetaElement extends HTMLElement { /** - * Associated information. See the content attribute definition in HTML + * Associated information. See the content attribute definition in HTML * 4.01. */ public String getContent(); /** - * Associated information. See the content attribute definition in HTML + * Associated information. See the content attribute definition in HTML * 4.01. */ public void setContent(String content); /** - * HTTP response header name [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. See the http-equiv attribute definition in + * HTTP response header name [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. See the http-equiv attribute definition in * HTML 4.01. */ public String getHttpEquiv(); /** - * HTTP response header name [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. See the http-equiv attribute definition in + * HTTP response header name [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. See the http-equiv attribute definition in * HTML 4.01. */ public void setHttpEquiv(String httpEquiv); @@ -50,12 +50,12 @@ public interface HTMLMetaElement extends HTMLElement { public void setName(String name); /** - * Select form of content. See the scheme attribute definition in HTML + * Select form of content. See the scheme attribute definition in HTML * 4.01. */ public String getScheme(); /** - * Select form of content. See the scheme attribute definition in HTML + * Select form of content. See the scheme attribute definition in HTML * 4.01. */ public void setScheme(String scheme); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java index 006ba69c4bd..f7659f0921f 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java @@ -13,29 +13,29 @@ package org.w3c.dom.html2; /** - * Notice of modification to part of a document. See the INS and DEL element - * definitions in HTML 4.01. + * Notice of modification to part of a document. See the INS and DEL element + * definitions in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLModElement extends HTMLElement { /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a document that describes the reason for the change. + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a document that describes the reason for the change. * See the cite attribute definition in HTML 4.01. */ public String getCite(); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a document that describes the reason for the change. + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a document that describes the reason for the change. * See the cite attribute definition in HTML 4.01. */ public void setCite(String cite); /** - * The date and time of the change. See the datetime attribute definition + * The date and time of the change. See the datetime attribute definition * in HTML 4.01. */ public String getDateTime(); /** - * The date and time of the change. See the datetime attribute definition + * The date and time of the change. See the datetime attribute definition * in HTML 4.01. */ public void setDateTime(String dateTime); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java index 13041c8a106..298d474397a 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java @@ -18,34 +18,34 @@ package org.w3c.dom.html2; */ public interface HTMLOListElement extends HTMLElement { /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getCompact(); /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCompact(boolean compact); /** - * Starting sequence number. See the start attribute definition in HTML + * Starting sequence number. See the start attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public int getStart(); /** - * Starting sequence number. See the start attribute definition in HTML + * Starting sequence number. See the start attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setStart(int start); /** - * Numbering style. See the type attribute definition in HTML 4.01. This + * Numbering style. See the type attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getType(); /** - * Numbering style. See the type attribute definition in HTML 4.01. This + * Numbering style. See the type attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setType(String type); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java index 11795468d77..e49af5f03a8 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java @@ -15,108 +15,108 @@ package org.w3c.dom.html2; import org.w3c.dom.Document; /** - * Generic embedded object.In principle, all properties on the object element - * are read-write but in some environments some properties may be read-only - * once the underlying object is instantiated. See the OBJECT element + * Generic embedded object.In principle, all properties on the object element + * are read-write but in some environments some properties may be read-only + * once the underlying object is instantiated. See the OBJECT element * definition in [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>]. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLObjectElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * Applet class file. See the <code>code</code> attribute for - * HTMLAppletElement. + * Applet class file. See the <code>code</code> attribute for + * HTMLAppletElement. */ public String getCode(); /** - * Applet class file. See the <code>code</code> attribute for - * HTMLAppletElement. + * Applet class file. See the <code>code</code> attribute for + * HTMLAppletElement. */ public void setCode(String code); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Aligns this object (vertically or horizontally) with respect to its - * surrounding text. See the align attribute definition in HTML 4.01. + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Space-separated list of archives. See the archive attribute definition + * Space-separated list of archives. See the archive attribute definition * in HTML 4.01. */ public String getArchive(); /** - * Space-separated list of archives. See the archive attribute definition + * Space-separated list of archives. See the archive attribute definition * in HTML 4.01. */ public void setArchive(String archive); /** - * Width of border around the object. See the border attribute definition + * Width of border around the object. See the border attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getBorder(); /** - * Width of border around the object. See the border attribute definition + * Width of border around the object. See the border attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setBorder(String border); /** - * Base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for <code>classid</code>, <code>data</code>, and + * Base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for <code>classid</code>, <code>data</code>, and * <code>archive</code> attributes. See the codebase attribute definition * in HTML 4.01. */ public String getCodeBase(); /** - * Base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for <code>classid</code>, <code>data</code>, and + * Base URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] for <code>classid</code>, <code>data</code>, and * <code>archive</code> attributes. See the codebase attribute definition * in HTML 4.01. */ public void setCodeBase(String codeBase); /** - * Content type for data downloaded via <code>classid</code> attribute. + * Content type for data downloaded via <code>classid</code> attribute. * See the codetype attribute definition in HTML 4.01. */ public String getCodeType(); /** - * Content type for data downloaded via <code>classid</code> attribute. + * Content type for data downloaded via <code>classid</code> attribute. * See the codetype attribute definition in HTML 4.01. */ public void setCodeType(String codeType); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] specifying the location of the object's data. See the data + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] specifying the location of the object's data. See the data * attribute definition in HTML 4.01. */ public String getData(); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] specifying the location of the object's data. See the data + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] specifying the location of the object's data. See the data * attribute definition in HTML 4.01. */ public void setData(String data); /** - * Declare (for future reference), but do not instantiate, this object. + * Declare (for future reference), but do not instantiate, this object. * See the declare attribute definition in HTML 4.01. */ public boolean getDeclare(); /** - * Declare (for future reference), but do not instantiate, this object. + * Declare (for future reference), but do not instantiate, this object. * See the declare attribute definition in HTML 4.01. */ public void setDeclare(boolean declare); @@ -131,82 +131,82 @@ public interface HTMLObjectElement extends HTMLElement { public void setHeight(String height); /** - * Horizontal space, in pixels, to the left and right of this image, - * applet, or object. See the hspace attribute definition in HTML 4.01. + * Horizontal space, in pixels, to the left and right of this image, + * applet, or object. See the hspace attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public int getHspace(); /** - * Horizontal space, in pixels, to the left and right of this image, - * applet, or object. See the hspace attribute definition in HTML 4.01. + * Horizontal space, in pixels, to the left and right of this image, + * applet, or object. See the hspace attribute definition in HTML 4.01. * This attribute is deprecated in HTML 4.01. */ public void setHspace(int hspace); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public void setName(String name); /** - * Message to render while loading the object. See the standby attribute + * Message to render while loading the object. See the standby attribute * definition in HTML 4.01. */ public String getStandby(); /** - * Message to render while loading the object. See the standby attribute + * Message to render while loading the object. See the standby attribute * definition in HTML 4.01. */ public void setStandby(String standby); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * Content type for data downloaded via <code>data</code> attribute. See + * Content type for data downloaded via <code>data</code> attribute. See * the type attribute definition in HTML 4.01. */ public String getType(); /** - * Content type for data downloaded via <code>data</code> attribute. See + * Content type for data downloaded via <code>data</code> attribute. See * the type attribute definition in HTML 4.01. */ public void setType(String type); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public String getUseMap(); /** - * Use client-side image map. See the usemap attribute definition in HTML + * Use client-side image map. See the usemap attribute definition in HTML * 4.01. */ public void setUseMap(String useMap); /** - * Vertical space, in pixels, above and below this image, applet, or - * object. See the vspace attribute definition in HTML 4.01. This + * Vertical space, in pixels, above and below this image, applet, or + * object. See the vspace attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public int getVspace(); /** - * Vertical space, in pixels, above and below this image, applet, or - * object. See the vspace attribute definition in HTML 4.01. This + * Vertical space, in pixels, above and below this image, applet, or + * object. See the vspace attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setVspace(int vspace); @@ -221,7 +221,7 @@ public interface HTMLObjectElement extends HTMLElement { public void setWidth(String width); /** - * The document this object contains, if there is any and it is available, + * The document this object contains, if there is any and it is available, * or <code>null</code> otherwise. * @since DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java index 8bd606a7126..8e680a23cf3 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java @@ -13,18 +13,18 @@ package org.w3c.dom.html2; /** - * Group options together in logical subdivisions. See the OPTGROUP element + * Group options together in logical subdivisions. See the OPTGROUP element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLOptGroupElement extends HTMLElement { /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java index f3b38a6019c..fe932ca87f5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java @@ -18,31 +18,31 @@ package org.w3c.dom.html2; */ public interface HTMLOptionElement extends HTMLElement { /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * Represents the value of the HTML selected attribute. The value of this - * attribute does not change if the state of the corresponding form - * control, in an interactive user agent, changes. See the selected + * Represents the value of the HTML selected attribute. The value of this + * attribute does not change if the state of the corresponding form + * control, in an interactive user agent, changes. See the selected * attribute definition in HTML 4.01. * @version DOM Level 2 */ public boolean getDefaultSelected(); /** - * Represents the value of the HTML selected attribute. The value of this - * attribute does not change if the state of the corresponding form - * control, in an interactive user agent, changes. See the selected + * Represents the value of the HTML selected attribute. The value of this + * attribute does not change if the state of the corresponding form + * control, in an interactive user agent, changes. See the selected * attribute definition in HTML 4.01. * @version DOM Level 2 */ public void setDefaultSelected(boolean defaultSelected); /** - * The text contained within the option element. + * The text contained within the option element. */ public String getText(); @@ -54,49 +54,49 @@ public interface HTMLOptionElement extends HTMLElement { public int getIndex(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); /** - * Option label for use in hierarchical menus. See the label attribute + * Option label for use in hierarchical menus. See the label attribute * definition in HTML 4.01. */ public String getLabel(); /** - * Option label for use in hierarchical menus. See the label attribute + * Option label for use in hierarchical menus. See the label attribute * definition in HTML 4.01. */ public void setLabel(String label); /** - * Represents the current state of the corresponding form control, in an - * interactive user agent. Changing this attribute changes the state of - * the form control, but does not change the value of the HTML selected + * Represents the current state of the corresponding form control, in an + * interactive user agent. Changing this attribute changes the state of + * the form control, but does not change the value of the HTML selected * attribute of the element. */ public boolean getSelected(); /** - * Represents the current state of the corresponding form control, in an - * interactive user agent. Changing this attribute changes the state of - * the form control, but does not change the value of the HTML selected + * Represents the current state of the corresponding form control, in an + * interactive user agent. Changing this attribute changes the state of + * the form control, but does not change the value of the HTML selected * attribute of the element. */ public void setSelected(boolean selected); /** - * The current form control value. See the value attribute definition in + * The current form control value. See the value attribute definition in * HTML 4.01. */ public String getValue(); /** - * The current form control value. See the value attribute definition in + * The current form control value. See the value attribute definition in * HTML 4.01. */ public void setValue(String value); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java index d70d92d73e2..a28c5ac274c 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java @@ -16,51 +16,51 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * An <code>HTMLOptionsCollection</code> is a list of nodes representing HTML - * option element. An individual node may be accessed by either ordinal - * index or the node's <code>name</code> or <code>id</code> attributes. - * Collections in the HTML DOM are assumed to be live meaning that they are - * automatically updated when the underlying document is changed. + * An <code>HTMLOptionsCollection</code> is a list of nodes representing HTML + * option element. An individual node may be accessed by either ordinal + * index or the node's <code>name</code> or <code>id</code> attributes. + * Collections in the HTML DOM are assumed to be live meaning that they are + * automatically updated when the underlying document is changed. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. * @since DOM Level 2 */ public interface HTMLOptionsCollection { /** - * This attribute specifies the length or size of the list. + * This attribute specifies the length or size of the list. */ public int getLength(); /** - * This attribute specifies the length or size of the list. + * This attribute specifies the length or size of the list. * @exception DOMException - * NOT_SUPPORTED_ERR: if setting the length is not allowed by the - * implementation. + * NOT_SUPPORTED_ERR: if setting the length is not allowed by the + * implementation. */ public void setLength(int length) throws DOMException; /** - * This method retrieves a node specified by ordinal index. Nodes are - * numbered in tree order (depth-first traversal order). - * @param index The index of the node to be fetched. The index origin is + * This method retrieves a node specified by ordinal index. Nodes are + * numbered in tree order (depth-first traversal order). + * @param index The index of the node to be fetched. The index origin is * 0. - * @return The <code>Node</code> at the corresponding position upon - * success. A value of <code>null</code> is returned if the index is - * out of range. + * @return The <code>Node</code> at the corresponding position upon + * success. A value of <code>null</code> is returned if the index is + * out of range. */ public Node item(int index); /** - * This method retrieves a <code>Node</code> using a name. It first - * searches for a <code>Node</code> with a matching <code>id</code> - * attribute. If it doesn't find one, it then searches for a - * <code>Node</code> with a matching <code>name</code> attribute, but - * only on those elements that are allowed a name attribute. This method - * is case insensitive in HTML documents and case sensitive in XHTML + * This method retrieves a <code>Node</code> using a name. It first + * searches for a <code>Node</code> with a matching <code>id</code> + * attribute. If it doesn't find one, it then searches for a + * <code>Node</code> with a matching <code>name</code> attribute, but + * only on those elements that are allowed a name attribute. This method + * is case insensitive in HTML documents and case sensitive in XHTML * documents. * @param name The name of the <code>Node</code> to be fetched. - * @return The <code>Node</code> with a <code>name</code> or - * <code>id</code> attribute whose value corresponds to the specified - * string. Upon failure (e.g., no node with this name exists), returns + * @return The <code>Node</code> with a <code>name</code> or + * <code>id</code> attribute whose value corresponds to the specified + * string. Upon failure (e.g., no node with this name exists), returns * <code>null</code>. */ public Node namedItem(String name); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java index 1cb8e04203b..b59f505f930 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLParagraphElement extends HTMLElement { /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Horizontal text alignment. See the align attribute definition in HTML + * Horizontal text alignment. See the align attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java index ecf91c287d3..33f5f7788c4 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java @@ -13,53 +13,53 @@ package org.w3c.dom.html2; /** - * Parameters fed to the <code>OBJECT</code> element. See the PARAM element + * Parameters fed to the <code>OBJECT</code> element. See the PARAM element * definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLParamElement extends HTMLElement { /** - * The name of a run-time parameter. See the name attribute definition in + * The name of a run-time parameter. See the name attribute definition in * HTML 4.01. */ public String getName(); /** - * The name of a run-time parameter. See the name attribute definition in + * The name of a run-time parameter. See the name attribute definition in * HTML 4.01. */ public void setName(String name); /** - * Content type for the <code>value</code> attribute when - * <code>valuetype</code> has the value "ref". See the type attribute + * Content type for the <code>value</code> attribute when + * <code>valuetype</code> has the value "ref". See the type attribute * definition in HTML 4.01. */ public String getType(); /** - * Content type for the <code>value</code> attribute when - * <code>valuetype</code> has the value "ref". See the type attribute + * Content type for the <code>value</code> attribute when + * <code>valuetype</code> has the value "ref". See the type attribute * definition in HTML 4.01. */ public void setType(String type); /** - * The value of a run-time parameter. See the value attribute definition + * The value of a run-time parameter. See the value attribute definition * in HTML 4.01. */ public String getValue(); /** - * The value of a run-time parameter. See the value attribute definition + * The value of a run-time parameter. See the value attribute definition * in HTML 4.01. */ public void setValue(String value); /** - * Information about the meaning of the <code>value</code> attribute + * Information about the meaning of the <code>value</code> attribute * value. See the valuetype attribute definition in HTML 4.01. */ public String getValueType(); /** - * Information about the meaning of the <code>value</code> attribute + * Information about the meaning of the <code>value</code> attribute * value. See the valuetype attribute definition in HTML 4.01. */ public void setValueType(String valueType); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java index bab7358a730..2d39837ed97 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLPreElement extends HTMLElement { /** - * Fixed width for content. See the width attribute definition in HTML + * Fixed width for content. See the width attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public int getWidth(); /** - * Fixed width for content. See the width attribute definition in HTML + * Fixed width for content. See the width attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setWidth(int width); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java index c7cc666f417..aba49746e3a 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java @@ -13,18 +13,18 @@ package org.w3c.dom.html2; /** - * For the <code>Q</code> and <code>BLOCKQUOTE</code> elements. See the Q + * For the <code>Q</code> and <code>BLOCKQUOTE</code> elements. See the Q * element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLQuoteElement extends HTMLElement { /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a source document or message. See the cite attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a source document or message. See the cite attribute * definition in HTML 4.01. */ public String getCite(); /** - * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a source document or message. See the cite attribute + * A URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating a source document or message. See the cite attribute * definition in HTML 4.01. */ public void setCite(String cite); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java index a35f7ddc1cb..226b394a926 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java @@ -18,72 +18,72 @@ package org.w3c.dom.html2; */ public interface HTMLScriptElement extends HTMLElement { /** - * The script content of the element. + * The script content of the element. */ public String getText(); /** - * The script content of the element. + * The script content of the element. */ public void setText(String text); /** - * Reserved for future use. + * Reserved for future use. */ public String getHtmlFor(); /** - * Reserved for future use. + * Reserved for future use. */ public void setHtmlFor(String htmlFor); /** - * Reserved for future use. + * Reserved for future use. */ public String getEvent(); /** - * Reserved for future use. + * Reserved for future use. */ public void setEvent(String event); /** - * The character encoding of the linked resource. See the charset + * The character encoding of the linked resource. See the charset * attribute definition in HTML 4.01. */ public String getCharset(); /** - * The character encoding of the linked resource. See the charset + * The character encoding of the linked resource. See the charset * attribute definition in HTML 4.01. */ public void setCharset(String charset); /** - * Indicates that the user agent can defer processing of the script. See + * Indicates that the user agent can defer processing of the script. See * the defer attribute definition in HTML 4.01. */ public boolean getDefer(); /** - * Indicates that the user agent can defer processing of the script. See + * Indicates that the user agent can defer processing of the script. See * the defer attribute definition in HTML 4.01. */ public void setDefer(boolean defer); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating an external script. See the src attribute definition + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating an external script. See the src attribute definition * in HTML 4.01. */ public String getSrc(); /** - * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating an external script. See the src attribute definition + * URI [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>] designating an external script. See the src attribute definition * in HTML 4.01. */ public void setSrc(String src); /** - * The content type of the script language. See the type attribute + * The content type of the script language. See the type attribute * definition in HTML 4.01. */ public String getType(); /** - * The content type of the script language. See the type attribute + * The content type of the script language. See the type attribute * definition in HTML 4.01. */ public void setType(String type); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java index c5d83b05182..98dbc836d94 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java @@ -15,105 +15,105 @@ package org.w3c.dom.html2; import org.w3c.dom.DOMException; /** - * The select element allows the selection of an option. The contained options - * can be directly accessed through the select element as a collection. See + * The select element allows the selection of an option. The contained options + * can be directly accessed through the select element as a collection. See * the SELECT element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLSelectElement extends HTMLElement { /** - * The type of this form control. This is the string "select-multiple" - * when the multiple attribute is <code>true</code> and the string + * The type of this form control. This is the string "select-multiple" + * when the multiple attribute is <code>true</code> and the string * "select-one" when <code>false</code>. */ public String getType(); /** - * The ordinal index of the selected option, starting from 0. The value -1 - * is returned if no element is selected. If multiple options are - * selected, the index of the first selected option is returned. + * The ordinal index of the selected option, starting from 0. The value -1 + * is returned if no element is selected. If multiple options are + * selected, the index of the first selected option is returned. */ public int getSelectedIndex(); /** - * The ordinal index of the selected option, starting from 0. The value -1 - * is returned if no element is selected. If multiple options are - * selected, the index of the first selected option is returned. + * The ordinal index of the selected option, starting from 0. The value -1 + * is returned if no element is selected. If multiple options are + * selected, the index of the first selected option is returned. */ public void setSelectedIndex(int selectedIndex); /** - * The current form control value (i.e. the value of the currently - * selected option), if multiple options are selected this is the value - * of the first selected option. + * The current form control value (i.e. the value of the currently + * selected option), if multiple options are selected this is the value + * of the first selected option. */ public String getValue(); /** - * The current form control value (i.e. the value of the currently - * selected option), if multiple options are selected this is the value - * of the first selected option. + * The current form control value (i.e. the value of the currently + * selected option), if multiple options are selected this is the value + * of the first selected option. */ public void setValue(String value); /** - * The number of options in this <code>SELECT</code>. + * The number of options in this <code>SELECT</code>. * @version DOM Level 2 */ public int getLength(); /** - * The number of options in this <code>SELECT</code>. + * The number of options in this <code>SELECT</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: if setting the length is not allowed by the - * implementation. + * NOT_SUPPORTED_ERR: if setting the length is not allowed by the + * implementation. * @version DOM Level 2 */ public void setLength(int length) throws DOMException; /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * The collection of <code>OPTION</code> elements contained by this - * element. + * The collection of <code>OPTION</code> elements contained by this + * element. * @version DOM Level 2 */ public HTMLOptionsCollection getOptions(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); /** - * If true, multiple <code>OPTION</code> elements may be selected in this - * <code>SELECT</code>. See the multiple attribute definition in HTML + * If true, multiple <code>OPTION</code> elements may be selected in this + * <code>SELECT</code>. See the multiple attribute definition in HTML * 4.01. */ public boolean getMultiple(); /** - * If true, multiple <code>OPTION</code> elements may be selected in this - * <code>SELECT</code>. See the multiple attribute definition in HTML + * If true, multiple <code>OPTION</code> elements may be selected in this + * <code>SELECT</code>. See the multiple attribute definition in HTML * 4.01. */ public void setMultiple(boolean multiple); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public void setName(String name); @@ -128,39 +128,39 @@ public interface HTMLSelectElement extends HTMLElement { public void setSize(int size); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); /** - * Add a new element to the collection of <code>OPTION</code> elements for - * this <code>SELECT</code>. This method is the equivalent of the - * <code>appendChild</code> method of the <code>Node</code> interface if - * the <code>before</code> parameter is <code>null</code>. It is - * equivalent to the <code>insertBefore</code> method on the parent of - * <code>before</code> in all other cases. This method may have no - * effect if the new element is not an <code>OPTION</code> or an + * Add a new element to the collection of <code>OPTION</code> elements for + * this <code>SELECT</code>. This method is the equivalent of the + * <code>appendChild</code> method of the <code>Node</code> interface if + * the <code>before</code> parameter is <code>null</code>. It is + * equivalent to the <code>insertBefore</code> method on the parent of + * <code>before</code> in all other cases. This method may have no + * effect if the new element is not an <code>OPTION</code> or an * <code>OPTGROUP</code>. * @param element The element to add. - * @param before The element to insert before, or <code>null</code> for + * @param before The element to insert before, or <code>null</code> for * the tail of the list. * @exception DOMException - * NOT_FOUND_ERR: Raised if <code>before</code> is not a descendant of - * the <code>SELECT</code> element. + * NOT_FOUND_ERR: Raised if <code>before</code> is not a descendant of + * the <code>SELECT</code> element. */ - public void add(HTMLElement element, + public void add(HTMLElement element, HTMLElement before) throws DOMException; /** - * Remove an element from the collection of <code>OPTION</code> elements - * for this <code>SELECT</code>. Does nothing if no element has the + * Remove an element from the collection of <code>OPTION</code> elements + * for this <code>SELECT</code>. Does nothing if no element has the * given index. * @param index The index of the item to remove, starting from 0. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java index 148bcda1cf2..2512d63a6bc 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java @@ -13,39 +13,39 @@ package org.w3c.dom.html2; /** - * Style information. See the STYLE element definition in HTML 4.01, the CSS - * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>] and the <code>LinkStyle</code> interface in the StyleSheets - * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>]. + * Style information. See the STYLE element definition in HTML 4.01, the CSS + * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>] and the <code>LinkStyle</code> interface in the StyleSheets + * module [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>DOM Level 2 Style Sheets and CSS</a>]. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLStyleElement extends HTMLElement { /** - * Enables/disables the style sheet. + * Enables/disables the style sheet. */ public boolean getDisabled(); /** - * Enables/disables the style sheet. + * Enables/disables the style sheet. */ public void setDisabled(boolean disabled); /** - * Designed for use with one or more target media. See the media attribute + * Designed for use with one or more target media. See the media attribute * definition in HTML 4.01. */ public String getMedia(); /** - * Designed for use with one or more target media. See the media attribute + * Designed for use with one or more target media. See the media attribute * definition in HTML 4.01. */ public void setMedia(String media); /** - * The content type of the style sheet language. See the type attribute + * The content type of the style sheet language. See the type attribute * definition in HTML 4.01. */ public String getType(); /** - * The content type of the style sheet language. See the type attribute + * The content type of the style sheet language. See the type attribute * definition in HTML 4.01. */ public void setType(String type); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java index 6c0d872e541..47466e9e977 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java @@ -18,12 +18,12 @@ package org.w3c.dom.html2; */ public interface HTMLTableCaptionElement extends HTMLElement { /** - * Caption alignment with respect to the table. See the align attribute + * Caption alignment with respect to the table. See the align attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Caption alignment with respect to the table. See the align attribute + * Caption alignment with respect to the table. See the align attribute * definition in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setAlign(String align); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java index 1e8dc3d4738..2e4db709551 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java @@ -13,24 +13,24 @@ package org.w3c.dom.html2; /** - * The object used to represent the <code>TH</code> and <code>TD</code> + * The object used to represent the <code>TH</code> and <code>TD</code> * elements. See the TD element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLTableCellElement extends HTMLElement { /** - * The index of this cell in the row, starting from 0. This index is in + * The index of this cell in the row, starting from 0. This index is in * document tree order and not display order. */ public int getCellIndex(); /** - * Abbreviation for header cells. See the abbr attribute definition in + * Abbreviation for header cells. See the abbr attribute definition in * HTML 4.01. */ public String getAbbr(); /** - * Abbreviation for header cells. See the abbr attribute definition in + * Abbreviation for header cells. See the abbr attribute definition in * HTML 4.01. */ public void setAbbr(String abbr); @@ -47,133 +47,133 @@ public interface HTMLTableCellElement extends HTMLElement { public void setAlign(String align); /** - * Names group of related headers. See the axis attribute definition in + * Names group of related headers. See the axis attribute definition in * HTML 4.01. */ public String getAxis(); /** - * Names group of related headers. See the axis attribute definition in + * Names group of related headers. See the axis attribute definition in * HTML 4.01. */ public void setAxis(String axis); /** - * Cell background color. See the bgcolor attribute definition in HTML + * Cell background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getBgColor(); /** - * Cell background color. See the bgcolor attribute definition in HTML + * Cell background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setBgColor(String bgColor); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public String getCh(); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public void setCh(String ch); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public String getChOff(); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public void setChOff(String chOff); /** - * Number of columns spanned by cell. See the colspan attribute definition + * Number of columns spanned by cell. See the colspan attribute definition * in HTML 4.01. */ public int getColSpan(); /** - * Number of columns spanned by cell. See the colspan attribute definition + * Number of columns spanned by cell. See the colspan attribute definition * in HTML 4.01. */ public void setColSpan(int colSpan); /** - * List of <code>id</code> attribute values for header cells. See the + * List of <code>id</code> attribute values for header cells. See the * headers attribute definition in HTML 4.01. */ public String getHeaders(); /** - * List of <code>id</code> attribute values for header cells. See the + * List of <code>id</code> attribute values for header cells. See the * headers attribute definition in HTML 4.01. */ public void setHeaders(String headers); /** - * Cell height. See the height attribute definition in HTML 4.01. This + * Cell height. See the height attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getHeight(); /** - * Cell height. See the height attribute definition in HTML 4.01. This + * Cell height. See the height attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setHeight(String height); /** - * Suppress word wrapping. See the nowrap attribute definition in HTML + * Suppress word wrapping. See the nowrap attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getNoWrap(); /** - * Suppress word wrapping. See the nowrap attribute definition in HTML + * Suppress word wrapping. See the nowrap attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setNoWrap(boolean noWrap); /** - * Number of rows spanned by cell. See the rowspan attribute definition in + * Number of rows spanned by cell. See the rowspan attribute definition in * HTML 4.01. */ public int getRowSpan(); /** - * Number of rows spanned by cell. See the rowspan attribute definition in + * Number of rows spanned by cell. See the rowspan attribute definition in * HTML 4.01. */ public void setRowSpan(int rowSpan); /** - * Scope covered by header cells. See the scope attribute definition in + * Scope covered by header cells. See the scope attribute definition in * HTML 4.01. */ public String getScope(); /** - * Scope covered by header cells. See the scope attribute definition in + * Scope covered by header cells. See the scope attribute definition in * HTML 4.01. */ public void setScope(String scope); /** - * Vertical alignment of data in cell. See the valign attribute definition + * Vertical alignment of data in cell. See the valign attribute definition * in HTML 4.01. */ public String getVAlign(); /** - * Vertical alignment of data in cell. See the valign attribute definition + * Vertical alignment of data in cell. See the valign attribute definition * in HTML 4.01. */ public void setVAlign(String vAlign); /** - * Cell width. See the width attribute definition in HTML 4.01. This + * Cell width. See the width attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getWidth(); /** - * Cell width. See the width attribute definition in HTML 4.01. This + * Cell width. See the width attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setWidth(String width); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java index 85a42ddd2bb..57bb35cfcb9 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java @@ -13,62 +13,62 @@ package org.w3c.dom.html2; /** - * Regroups the <code>COL</code> and <code>COLGROUP</code> elements. See the + * Regroups the <code>COL</code> and <code>COLGROUP</code> elements. See the * COL element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLTableColElement extends HTMLElement { /** - * Horizontal alignment of cell data in column. See the align attribute + * Horizontal alignment of cell data in column. See the align attribute * definition in HTML 4.01. */ public String getAlign(); /** - * Horizontal alignment of cell data in column. See the align attribute + * Horizontal alignment of cell data in column. See the align attribute * definition in HTML 4.01. */ public void setAlign(String align); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public String getCh(); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public void setCh(String ch); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public String getChOff(); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public void setChOff(String chOff); /** - * Indicates the number of columns in a group or affected by a grouping. + * Indicates the number of columns in a group or affected by a grouping. * See the span attribute definition in HTML 4.01. */ public int getSpan(); /** - * Indicates the number of columns in a group or affected by a grouping. + * Indicates the number of columns in a group or affected by a grouping. * See the span attribute definition in HTML 4.01. */ public void setSpan(int span); /** - * Vertical alignment of cell data in column. See the valign attribute + * Vertical alignment of cell data in column. See the valign attribute * definition in HTML 4.01. */ public String getVAlign(); /** - * Vertical alignment of cell data in column. See the valign attribute + * Vertical alignment of cell data in column. See the valign attribute * definition in HTML 4.01. */ public void setVAlign(String vAlign); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java index d36b19cfa78..ae15deb77d1 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java @@ -15,65 +15,65 @@ package org.w3c.dom.html2; import org.w3c.dom.DOMException; /** - * The create* and delete* methods on the table allow authors to construct and - * modify tables. [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] specifies that only one of each of the - * <code>CAPTION</code>, <code>THEAD</code>, and <code>TFOOT</code> elements - * may exist in a table. Therefore, if one exists, and the createTHead() or - * createTFoot() method is called, the method returns the existing THead or + * The create* and delete* methods on the table allow authors to construct and + * modify tables. [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>] specifies that only one of each of the + * <code>CAPTION</code>, <code>THEAD</code>, and <code>TFOOT</code> elements + * may exist in a table. Therefore, if one exists, and the createTHead() or + * createTFoot() method is called, the method returns the existing THead or * TFoot element. See the TABLE element definition in HTML 4.01. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLTableElement extends HTMLElement { /** - * Returns the table's <code>CAPTION</code>, or void if none exists. + * Returns the table's <code>CAPTION</code>, or void if none exists. * @version DOM Level 2 */ public HTMLTableCaptionElement getCaption(); /** - * Returns the table's <code>CAPTION</code>, or void if none exists. + * Returns the table's <code>CAPTION</code>, or void if none exists. * @exception DOMException - * HIERARCHY_REQUEST_ERR: if the element is not a <code>CAPTION</code>. + * HIERARCHY_REQUEST_ERR: if the element is not a <code>CAPTION</code>. * @version DOM Level 2 */ public void setCaption(HTMLTableCaptionElement caption) throws DOMException; /** - * Returns the table's <code>THEAD</code>, or <code>null</code> if none - * exists. + * Returns the table's <code>THEAD</code>, or <code>null</code> if none + * exists. * @version DOM Level 2 */ public HTMLTableSectionElement getTHead(); /** - * Returns the table's <code>THEAD</code>, or <code>null</code> if none - * exists. + * Returns the table's <code>THEAD</code>, or <code>null</code> if none + * exists. * @exception DOMException - * HIERARCHY_REQUEST_ERR: if the element is not a <code>THEAD</code>. + * HIERARCHY_REQUEST_ERR: if the element is not a <code>THEAD</code>. * @version DOM Level 2 */ public void setTHead(HTMLTableSectionElement tHead) throws DOMException; /** - * Returns the table's <code>TFOOT</code>, or <code>null</code> if none - * exists. + * Returns the table's <code>TFOOT</code>, or <code>null</code> if none + * exists. * @version DOM Level 2 */ public HTMLTableSectionElement getTFoot(); /** - * Returns the table's <code>TFOOT</code>, or <code>null</code> if none - * exists. + * Returns the table's <code>TFOOT</code>, or <code>null</code> if none + * exists. * @exception DOMException - * HIERARCHY_REQUEST_ERR: if the element is not a <code>TFOOT</code>. + * HIERARCHY_REQUEST_ERR: if the element is not a <code>TFOOT</code>. * @version DOM Level 2 */ public void setTFoot(HTMLTableSectionElement tFoot) throws DOMException; /** - * Returns a collection of all the rows in the table, including all in - * <code>THEAD</code>, <code>TFOOT</code>, all <code>TBODY</code> - * elements. + * Returns a collection of all the rows in the table, including all in + * <code>THEAD</code>, <code>TFOOT</code>, all <code>TBODY</code> + * elements. */ public HTMLCollection getRows(); @@ -83,102 +83,102 @@ public interface HTMLTableElement extends HTMLElement { public HTMLCollection getTBodies(); /** - * Specifies the table's position with respect to the rest of the - * document. See the align attribute definition in HTML 4.01. This + * Specifies the table's position with respect to the rest of the + * document. See the align attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getAlign(); /** - * Specifies the table's position with respect to the rest of the - * document. See the align attribute definition in HTML 4.01. This + * Specifies the table's position with respect to the rest of the + * document. See the align attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setAlign(String align); /** - * Cell background color. See the bgcolor attribute definition in HTML + * Cell background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getBgColor(); /** - * Cell background color. See the bgcolor attribute definition in HTML + * Cell background color. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setBgColor(String bgColor); /** - * The width of the border around the table. See the border attribute + * The width of the border around the table. See the border attribute * definition in HTML 4.01. */ public String getBorder(); /** - * The width of the border around the table. See the border attribute + * The width of the border around the table. See the border attribute * definition in HTML 4.01. */ public void setBorder(String border); /** - * Specifies the horizontal and vertical space between cell content and + * Specifies the horizontal and vertical space between cell content and * cell borders. See the cellpadding attribute definition in HTML 4.01. */ public String getCellPadding(); /** - * Specifies the horizontal and vertical space between cell content and + * Specifies the horizontal and vertical space between cell content and * cell borders. See the cellpadding attribute definition in HTML 4.01. */ public void setCellPadding(String cellPadding); /** - * Specifies the horizontal and vertical separation between cells. See the + * Specifies the horizontal and vertical separation between cells. See the * cellspacing attribute definition in HTML 4.01. */ public String getCellSpacing(); /** - * Specifies the horizontal and vertical separation between cells. See the + * Specifies the horizontal and vertical separation between cells. See the * cellspacing attribute definition in HTML 4.01. */ public void setCellSpacing(String cellSpacing); /** - * Specifies which external table borders to render. See the frame + * Specifies which external table borders to render. See the frame * attribute definition in HTML 4.01. */ public String getFrame(); /** - * Specifies which external table borders to render. See the frame + * Specifies which external table borders to render. See the frame * attribute definition in HTML 4.01. */ public void setFrame(String frame); /** - * Specifies which internal table borders to render. See the rules + * Specifies which internal table borders to render. See the rules * attribute definition in HTML 4.01. */ public String getRules(); /** - * Specifies which internal table borders to render. See the rules + * Specifies which internal table borders to render. See the rules * attribute definition in HTML 4.01. */ public void setRules(String rules); /** - * Description about the purpose or structure of a table. See the summary + * Description about the purpose or structure of a table. See the summary * attribute definition in HTML 4.01. */ public String getSummary(); /** - * Description about the purpose or structure of a table. See the summary + * Description about the purpose or structure of a table. See the summary * attribute definition in HTML 4.01. */ public void setSummary(String summary); /** - * Specifies the desired table width. See the width attribute definition + * Specifies the desired table width. See the width attribute definition * in HTML 4.01. */ public String getWidth(); /** - * Specifies the desired table width. See the width attribute definition + * Specifies the desired table width. See the width attribute definition * in HTML 4.01. */ public void setWidth(String width); @@ -217,19 +217,19 @@ public interface HTMLTableElement extends HTMLElement { public void deleteCaption(); /** - * Insert a new empty row in the table. The new row is inserted - * immediately before and in the same section as the current - * <code>index</code>th row in the table. If <code>index</code> is -1 or - * equal to the number of rows, the new row is appended. In addition, - * when the table is empty the row is inserted into a <code>TBODY</code> - * which is created and inserted into the table.A table row cannot be + * Insert a new empty row in the table. The new row is inserted + * immediately before and in the same section as the current + * <code>index</code>th row in the table. If <code>index</code> is -1 or + * equal to the number of rows, the new row is appended. In addition, + * when the table is empty the row is inserted into a <code>TBODY</code> + * which is created and inserted into the table.A table row cannot be * empty according to [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>]. - * @param index The row number where to insert a new row. This index - * starts from 0 and is relative to the logical order (not document + * @param index The row number where to insert a new row. This index + * starts from 0 and is relative to the logical order (not document * order) of all the rows contained inside the table. * @return The newly created row. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than the + * INDEX_SIZE_ERR: Raised if the specified index is greater than the * number of rows or if the index is a negative number other than -1. * @version DOM Level 2 */ @@ -238,13 +238,13 @@ public interface HTMLTableElement extends HTMLElement { /** * Delete a table row. - * @param index The index of the row to be deleted. This index starts - * from 0 and is relative to the logical order (not document order) of - * all the rows contained inside the table. If the index is -1 the + * @param index The index of the row to be deleted. This index starts + * from 0 and is relative to the logical order (not document order) of + * all the rows contained inside the table. If the index is -1 the * last row in the table is deleted. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than or - * equal to the number of rows or if the index is a negative number + * INDEX_SIZE_ERR: Raised if the specified index is greater than or + * equal to the number of rows or if the index is a negative number * other than -1. * @version DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java index 9f4fbf96c67..8c3618f397e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java @@ -20,11 +20,11 @@ import org.w3c.dom.DOMException; */ public interface HTMLTableRowElement extends HTMLElement { /** - * This is in logical order and not in document order. The + * This is in logical order and not in document order. The * <code>rowIndex</code> does take into account sections ( - * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>) within - * the table, placing <code>THEAD</code> rows first in the index, - * followed by <code>TBODY</code> rows, followed by <code>TFOOT</code> + * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>) within + * the table, placing <code>THEAD</code> rows first in the index, + * followed by <code>TBODY</code> rows, followed by <code>TFOOT</code> * rows. * @version DOM Level 2 */ @@ -32,82 +32,82 @@ public interface HTMLTableRowElement extends HTMLElement { /** * The index of this row, relative to the current section ( - * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>), + * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>), * starting from 0. * @version DOM Level 2 */ public int getSectionRowIndex(); /** - * The collection of cells in this row. + * The collection of cells in this row. * @version DOM Level 2 */ public HTMLCollection getCells(); /** - * Horizontal alignment of data within cells of this row. See the align + * Horizontal alignment of data within cells of this row. See the align * attribute definition in HTML 4.01. */ public String getAlign(); /** - * Horizontal alignment of data within cells of this row. See the align + * Horizontal alignment of data within cells of this row. See the align * attribute definition in HTML 4.01. */ public void setAlign(String align); /** - * Background color for rows. See the bgcolor attribute definition in HTML + * Background color for rows. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public String getBgColor(); /** - * Background color for rows. See the bgcolor attribute definition in HTML + * Background color for rows. See the bgcolor attribute definition in HTML * 4.01. This attribute is deprecated in HTML 4.01. */ public void setBgColor(String bgColor); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public String getCh(); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public void setCh(String ch); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public String getChOff(); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public void setChOff(String chOff); /** - * Vertical alignment of data within cells of this row. See the valign + * Vertical alignment of data within cells of this row. See the valign * attribute definition in HTML 4.01. */ public String getVAlign(); /** - * Vertical alignment of data within cells of this row. See the valign + * Vertical alignment of data within cells of this row. See the valign * attribute definition in HTML 4.01. */ public void setVAlign(String vAlign); /** - * Insert an empty <code>TD</code> cell into this row. If - * <code>index</code> is -1 or equal to the number of cells, the new + * Insert an empty <code>TD</code> cell into this row. If + * <code>index</code> is -1 or equal to the number of cells, the new * cell is appended. * @param index The place to insert the cell, starting from 0. * @return The newly created cell. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater - * than the number of cells or if the index is a negative number other + * INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater + * than the number of cells or if the index is a negative number other * than -1. * @version DOM Level 2 */ @@ -116,11 +116,11 @@ public interface HTMLTableRowElement extends HTMLElement { /** * Delete a cell from the current row. - * @param index The index of the cell to delete, starting from 0. If the + * @param index The index of the cell to delete, starting from 0. If the * index is -1 the last cell in the row is deleted. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater - * than or equal to the number of cells or if the index is a negative + * INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater + * than or equal to the number of cells or if the index is a negative * number other than -1. * @version DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java index 5aa6ce4402d..5e3d6e53ff1 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java @@ -15,71 +15,71 @@ package org.w3c.dom.html2; import org.w3c.dom.DOMException; /** - * The <code>THEAD</code>, <code>TFOOT</code>, and <code>TBODY</code> - * elements. + * The <code>THEAD</code>, <code>TFOOT</code>, and <code>TBODY</code> + * elements. * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. */ public interface HTMLTableSectionElement extends HTMLElement { /** - * Horizontal alignment of data in cells. See the <code>align</code> - * attribute for HTMLTheadElement for details. + * Horizontal alignment of data in cells. See the <code>align</code> + * attribute for HTMLTheadElement for details. */ public String getAlign(); /** - * Horizontal alignment of data in cells. See the <code>align</code> - * attribute for HTMLTheadElement for details. + * Horizontal alignment of data in cells. See the <code>align</code> + * attribute for HTMLTheadElement for details. */ public void setAlign(String align); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public String getCh(); /** - * Alignment character for cells in a column. See the char attribute + * Alignment character for cells in a column. See the char attribute * definition in HTML 4.01. */ public void setCh(String ch); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public String getChOff(); /** - * Offset of alignment character. See the charoff attribute definition in + * Offset of alignment character. See the charoff attribute definition in * HTML 4.01. */ public void setChOff(String chOff); /** - * Vertical alignment of data in cells. See the <code>valign</code> - * attribute for HTMLTheadElement for details. + * Vertical alignment of data in cells. See the <code>valign</code> + * attribute for HTMLTheadElement for details. */ public String getVAlign(); /** - * Vertical alignment of data in cells. See the <code>valign</code> - * attribute for HTMLTheadElement for details. + * Vertical alignment of data in cells. See the <code>valign</code> + * attribute for HTMLTheadElement for details. */ public void setVAlign(String vAlign); /** - * The collection of rows in this table section. + * The collection of rows in this table section. */ public HTMLCollection getRows(); /** - * Insert a row into this section. The new row is inserted immediately - * before the current <code>index</code>th row in this section. If - * <code>index</code> is -1 or equal to the number of rows in this + * Insert a row into this section. The new row is inserted immediately + * before the current <code>index</code>th row in this section. If + * <code>index</code> is -1 or equal to the number of rows in this * section, the new row is appended. - * @param index The row number where to insert a new row. This index - * starts from 0 and is relative only to the rows contained inside + * @param index The row number where to insert a new row. This index + * starts from 0 and is relative only to the rows contained inside * this section, not all the rows in the table. * @return The newly created row. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than the + * INDEX_SIZE_ERR: Raised if the specified index is greater than the * number of rows of if the index is a negative number other than -1. * @version DOM Level 2 */ @@ -88,12 +88,12 @@ public interface HTMLTableSectionElement extends HTMLElement { /** * Delete a row from this section. - * @param index The index of the row to be deleted, or -1 to delete the - * last row. This index starts from 0 and is relative only to the rows + * @param index The index of the row to be deleted, or -1 to delete the + * last row. This index starts from 0 and is relative only to the rows * contained inside this section, not all the rows in the table. * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than or - * equal to the number of rows or if the index is a negative number + * INDEX_SIZE_ERR: Raised if the specified index is greater than or + * equal to the number of rows or if the index is a negative number * other than -1. * @version DOM Level 2 */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java index ed5c6c978d6..caabe4a19af 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java @@ -18,78 +18,78 @@ package org.w3c.dom.html2; */ public interface HTMLTextAreaElement extends HTMLElement { /** - * Represents the contents of the element. The value of this attribute - * does not change if the contents of the corresponding form control, in + * Represents the contents of the element. The value of this attribute + * does not change if the contents of the corresponding form control, in * an interactive user agent, changes. * @version DOM Level 2 */ public String getDefaultValue(); /** - * Represents the contents of the element. The value of this attribute - * does not change if the contents of the corresponding form control, in + * Represents the contents of the element. The value of this attribute + * does not change if the contents of the corresponding form control, in * an interactive user agent, changes. * @version DOM Level 2 */ public void setDefaultValue(String defaultValue); /** - * Returns the <code>FORM</code> element containing this control. Returns - * <code>null</code> if this control is not within the context of a - * form. + * Returns the <code>FORM</code> element containing this control. Returns + * <code>null</code> if this control is not within the context of a + * form. */ public HTMLFormElement getForm(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public String getAccessKey(); /** - * A single character access key to give access to the form control. See + * A single character access key to give access to the form control. See * the accesskey attribute definition in HTML 4.01. */ public void setAccessKey(String accessKey); /** - * Width of control (in characters). See the cols attribute definition in + * Width of control (in characters). See the cols attribute definition in * HTML 4.01. */ public int getCols(); /** - * Width of control (in characters). See the cols attribute definition in + * Width of control (in characters). See the cols attribute definition in * HTML 4.01. */ public void setCols(int cols); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public boolean getDisabled(); /** - * The control is unavailable in this context. See the disabled attribute + * The control is unavailable in this context. See the disabled attribute * definition in HTML 4.01. */ public void setDisabled(boolean disabled); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public String getName(); /** - * Form control or object name when submitted with a form. See the name + * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.01. */ public void setName(String name); /** - * This control is read-only. See the readonly attribute definition in + * This control is read-only. See the readonly attribute definition in * HTML 4.01. */ public boolean getReadOnly(); /** - * This control is read-only. See the readonly attribute definition in + * This control is read-only. See the readonly attribute definition in * HTML 4.01. */ public void setReadOnly(boolean readOnly); @@ -104,12 +104,12 @@ public interface HTMLTextAreaElement extends HTMLElement { public void setRows(int rows); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public int getTabIndex(); /** - * Index that represents the element's position in the tabbing order. See + * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.01. */ public void setTabIndex(int tabIndex); @@ -120,18 +120,18 @@ public interface HTMLTextAreaElement extends HTMLElement { public String getType(); /** - * Represents the current contents of the corresponding form control, in - * an interactive user agent. Changing this attribute changes the - * contents of the form control, but does not change the contents of the - * element. If the entirety of the data can not fit into a single + * Represents the current contents of the corresponding form control, in + * an interactive user agent. Changing this attribute changes the + * contents of the form control, but does not change the contents of the + * element. If the entirety of the data can not fit into a single * <code>DOMString</code>, the implementation may truncate the data. */ public String getValue(); /** - * Represents the current contents of the corresponding form control, in - * an interactive user agent. Changing this attribute changes the - * contents of the form control, but does not change the contents of the - * element. If the entirety of the data can not fit into a single + * Represents the current contents of the corresponding form control, in + * an interactive user agent. Changing this attribute changes the + * contents of the form control, but does not change the contents of the + * element. If the entirety of the data can not fit into a single * <code>DOMString</code>, the implementation may truncate the data. */ public void setValue(String value); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java index 67122bb0a71..a86b3a92650 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java @@ -18,11 +18,11 @@ package org.w3c.dom.html2; */ public interface HTMLTitleElement extends HTMLElement { /** - * The specified title as a string. + * The specified title as a string. */ public String getText(); /** - * The specified title as a string. + * The specified title as a string. */ public void setText(String text); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java index 61ccb322f45..e5828fd39ee 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java @@ -18,23 +18,23 @@ package org.w3c.dom.html2; */ public interface HTMLUListElement extends HTMLElement { /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public boolean getCompact(); /** - * Reduce spacing between list items. See the compact attribute definition + * Reduce spacing between list items. See the compact attribute definition * in HTML 4.01. This attribute is deprecated in HTML 4.01. */ public void setCompact(boolean compact); /** - * Bullet style. See the type attribute definition in HTML 4.01. This + * Bullet style. See the type attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public String getType(); /** - * Bullet style. See the type attribute definition in HTML 4.01. This + * Bullet style. See the type attribute definition in HTML 4.01. This * attribute is deprecated in HTML 4.01. */ public void setType(String type); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java index c94fc8e4651..4d1b0971d45 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java @@ -15,17 +15,17 @@ package org.w3c.dom.ls; import org.w3c.dom.DOMException; /** - * <code>DOMImplementationLS</code> contains the factory methods for creating - * Load and Save objects. - * <p> The expectation is that an instance of the - * <code>DOMImplementationLS</code> interface can be obtained by using - * binding-specific casting methods on an instance of the - * <code>DOMImplementation</code> interface or, if the <code>Document</code> - * supports the feature <code>"Core"</code> version <code>"3.0"</code> + * <code>DOMImplementationLS</code> contains the factory methods for creating + * Load and Save objects. + * <p> The expectation is that an instance of the + * <code>DOMImplementationLS</code> interface can be obtained by using + * binding-specific casting methods on an instance of the + * <code>DOMImplementation</code> interface or, if the <code>Document</code> + * supports the feature <code>"Core"</code> version <code>"3.0"</code> * defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , by using the method <code>DOMImplementation.getFeature</code> with - * parameter values <code>"LS"</code> (or <code>"LS-Async"</code>) and - * <code>"3.0"</code> (respectively). + * , by using the method <code>DOMImplementation.getFeature</code> with + * parameter values <code>"LS"</code> (or <code>"LS-Async"</code>) and + * <code>"3.0"</code> (respectively). * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ @@ -41,81 +41,81 @@ public interface DOMImplementationLS { public static final short MODE_ASYNCHRONOUS = 2; /** - * Create a new <code>LSParser</code>. The newly constructed parser may - * then be configured by means of its <code>DOMConfiguration</code> + * Create a new <code>LSParser</code>. The newly constructed parser may + * then be configured by means of its <code>DOMConfiguration</code> * object, and used to parse documents by means of its <code>parse</code> - * method. - * @param mode The <code>mode</code> argument is either - * <code>MODE_SYNCHRONOUS</code> or <code>MODE_ASYNCHRONOUS</code>, if - * <code>mode</code> is <code>MODE_SYNCHRONOUS</code> then the - * <code>LSParser</code> that is created will operate in synchronous - * mode, if it's <code>MODE_ASYNCHRONOUS</code> then the - * <code>LSParser</code> that is created will operate in asynchronous - * mode. - * @param schemaType An absolute URI representing the type of the schema - * language used during the load of a <code>Document</code> using the - * newly created <code>LSParser</code>. Note that no lexical checking - * is done on the absolute URI. In order to create a - * <code>LSParser</code> for any kind of schema types (i.e. the - * LSParser will be free to use any schema found), use the value - * <code>null</code>. + * method. + * @param mode The <code>mode</code> argument is either + * <code>MODE_SYNCHRONOUS</code> or <code>MODE_ASYNCHRONOUS</code>, if + * <code>mode</code> is <code>MODE_SYNCHRONOUS</code> then the + * <code>LSParser</code> that is created will operate in synchronous + * mode, if it's <code>MODE_ASYNCHRONOUS</code> then the + * <code>LSParser</code> that is created will operate in asynchronous + * mode. + * @param schemaType An absolute URI representing the type of the schema + * language used during the load of a <code>Document</code> using the + * newly created <code>LSParser</code>. Note that no lexical checking + * is done on the absolute URI. In order to create a + * <code>LSParser</code> for any kind of schema types (i.e. the + * LSParser will be free to use any schema found), use the value + * <code>null</code>. * <p ><b>Note:</b> For W3C XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * , applications must use the value - * <code>"http://www.w3.org/2001/XMLSchema"</code>. For XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], - * applications must use the value - * <code>"http://www.w3.org/TR/REC-xml"</code>. Other Schema languages - * are outside the scope of the W3C and therefore should recommend an - * absolute URI in order to use this method. - * @return The newly created <code>LSParser</code> object. This - * <code>LSParser</code> is either synchronous or asynchronous - * depending on the value of the <code>mode</code> argument. - * <p ><b>Note:</b> By default, the newly created <code>LSParser</code> - * does not contain a <code>DOMErrorHandler</code>, i.e. the value of + * , applications must use the value + * <code>"http://www.w3.org/2001/XMLSchema"</code>. For XML DTD [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], + * applications must use the value + * <code>"http://www.w3.org/TR/REC-xml"</code>. Other Schema languages + * are outside the scope of the W3C and therefore should recommend an + * absolute URI in order to use this method. + * @return The newly created <code>LSParser</code> object. This + * <code>LSParser</code> is either synchronous or asynchronous + * depending on the value of the <code>mode</code> argument. + * <p ><b>Note:</b> By default, the newly created <code>LSParser</code> + * does not contain a <code>DOMErrorHandler</code>, i.e. the value of * the "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" configuration parameter is <code>null</code>. However, implementations - * may provide a default error handler at creation time. In that case, - * the initial value of the <code>"error-handler"</code> configuration - * parameter on the new <code>LSParser</code> object contains a - * reference to the default error handler. + * error-handler</a>" configuration parameter is <code>null</code>. However, implementations + * may provide a default error handler at creation time. In that case, + * the initial value of the <code>"error-handler"</code> configuration + * parameter on the new <code>LSParser</code> object contains a + * reference to the default error handler. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is - * not supported. + * NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is + * not supported. */ - public LSParser createLSParser(short mode, + public LSParser createLSParser(short mode, String schemaType) throws DOMException; /** - * Create a new <code>LSSerializer</code> object. + * Create a new <code>LSSerializer</code> object. * @return The newly created <code>LSSerializer</code> object. - * <p ><b>Note:</b> By default, the newly created - * <code>LSSerializer</code> has no <code>DOMErrorHandler</code>, i.e. - * the value of the <code>"error-handler"</code> configuration - * parameter is <code>null</code>. However, implementations may - * provide a default error handler at creation time. In that case, the - * initial value of the <code>"error-handler"</code> configuration - * parameter on the new <code>LSSerializer</code> object contains a - * reference to the default error handler. + * <p ><b>Note:</b> By default, the newly created + * <code>LSSerializer</code> has no <code>DOMErrorHandler</code>, i.e. + * the value of the <code>"error-handler"</code> configuration + * parameter is <code>null</code>. However, implementations may + * provide a default error handler at creation time. In that case, the + * initial value of the <code>"error-handler"</code> configuration + * parameter on the new <code>LSSerializer</code> object contains a + * reference to the default error handler. */ public LSSerializer createLSSerializer(); /** - * Create a new empty input source object where + * Create a new empty input source object where * <code>LSInput.characterStream</code>, <code>LSInput.byteStream</code> - * , <code>LSInput.stringData</code> <code>LSInput.systemId</code>, - * <code>LSInput.publicId</code>, <code>LSInput.baseURI</code>, and - * <code>LSInput.encoding</code> are null, and - * <code>LSInput.certifiedText</code> is false. - * @return The newly created input object. + * , <code>LSInput.stringData</code> <code>LSInput.systemId</code>, + * <code>LSInput.publicId</code>, <code>LSInput.baseURI</code>, and + * <code>LSInput.encoding</code> are null, and + * <code>LSInput.certifiedText</code> is false. + * @return The newly created input object. */ public LSInput createLSInput(); /** - * Create a new empty output destination object where - * <code>LSOutput.characterStream</code>, - * <code>LSOutput.byteStream</code>, <code>LSOutput.systemId</code>, - * <code>LSOutput.encoding</code> are null. - * @return The newly created output object. + * Create a new empty output destination object where + * <code>LSOutput.characterStream</code>, + * <code>LSOutput.byteStream</code>, <code>LSOutput.systemId</code>, + * <code>LSOutput.encoding</code> are null. + * @return The newly created output object. */ public LSOutput createLSOutput(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSException.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSException.java index 65a83f0ded1..677ad385c64 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSException.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSException.java @@ -13,16 +13,16 @@ package org.w3c.dom.ls; /** - * Parser or write operations may throw an <code>LSException</code> if the - * processing is stopped. The processing can be stopped due to a - * <code>DOMError</code> with a severity of - * <code>DOMError.SEVERITY_FATAL_ERROR</code> or a non recovered - * <code>DOMError.SEVERITY_ERROR</code>, or if - * <code>DOMErrorHandler.handleError()</code> returned <code>false</code>. - * <p ><b>Note:</b> As suggested in the definition of the constants in the - * <code>DOMError</code> interface, a DOM implementation may choose to - * continue after a fatal error, but the resulting DOM tree is then - * implementation dependent. + * Parser or write operations may throw an <code>LSException</code> if the + * processing is stopped. The processing can be stopped due to a + * <code>DOMError</code> with a severity of + * <code>DOMError.SEVERITY_FATAL_ERROR</code> or a non recovered + * <code>DOMError.SEVERITY_ERROR</code>, or if + * <code>DOMErrorHandler.handleError()</code> returned <code>false</code>. + * <p ><b>Note:</b> As suggested in the definition of the constants in the + * <code>DOMError</code> interface, a DOM implementation may choose to + * continue after a fatal error, but the resulting DOM tree is then + * implementation dependent. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ @@ -34,13 +34,13 @@ public class LSException extends RuntimeException { public short code; // LSExceptionCode /** - * If an attempt was made to load a document, or an XML Fragment, using - * <code>LSParser</code> and the processing has been stopped. + * If an attempt was made to load a document, or an XML Fragment, using + * <code>LSParser</code> and the processing has been stopped. */ public static final short PARSE_ERR = 81; /** - * If an attempt was made to serialize a <code>Node</code> using - * <code>LSSerializer</code> and the processing has been stopped. + * If an attempt was made to serialize a <code>Node</code> using + * <code>LSSerializer</code> and the processing has been stopped. */ public static final short SERIALIZE_ERR = 82; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSInput.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSInput.java index 862bf7703b7..bba1792cd08 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSInput.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSInput.java @@ -13,205 +13,205 @@ package org.w3c.dom.ls; /** - * This interface represents an input source for data. - * <p> This interface allows an application to encapsulate information about - * an input source in a single object, which may include a public - * identifier, a system identifier, a byte stream (possibly with a specified - * encoding), a base URI, and/or a character stream. - * <p> The exact definitions of a byte stream and a character stream are - * binding dependent. - * <p> The application is expected to provide objects that implement this - * interface whenever such objects are needed. The application can either - * provide its own objects that implement this interface, or it can use the - * generic factory method <code>DOMImplementationLS.createLSInput()</code> - * to create objects that implement this interface. - * <p> The <code>LSParser</code> will use the <code>LSInput</code> object to - * determine how to read data. The <code>LSParser</code> will look at the - * different inputs specified in the <code>LSInput</code> in the following - * order to know which one to read from, the first one that is not null and - * not an empty string will be used: + * This interface represents an input source for data. + * <p> This interface allows an application to encapsulate information about + * an input source in a single object, which may include a public + * identifier, a system identifier, a byte stream (possibly with a specified + * encoding), a base URI, and/or a character stream. + * <p> The exact definitions of a byte stream and a character stream are + * binding dependent. + * <p> The application is expected to provide objects that implement this + * interface whenever such objects are needed. The application can either + * provide its own objects that implement this interface, or it can use the + * generic factory method <code>DOMImplementationLS.createLSInput()</code> + * to create objects that implement this interface. + * <p> The <code>LSParser</code> will use the <code>LSInput</code> object to + * determine how to read data. The <code>LSParser</code> will look at the + * different inputs specified in the <code>LSInput</code> in the following + * order to know which one to read from, the first one that is not null and + * not an empty string will be used: * <ol> - * <li> <code>LSInput.characterStream</code> + * <li> <code>LSInput.characterStream</code> * </li> - * <li> - * <code>LSInput.byteStream</code> + * <li> + * <code>LSInput.byteStream</code> * </li> - * <li> <code>LSInput.stringData</code> + * <li> <code>LSInput.stringData</code> * </li> - * <li> - * <code>LSInput.systemId</code> + * <li> + * <code>LSInput.systemId</code> * </li> - * <li> <code>LSInput.publicId</code> + * <li> <code>LSInput.publicId</code> * </li> - * </ol> - * <p> If all inputs are null, the <code>LSParser</code> will report a - * <code>DOMError</code> with its <code>DOMError.type</code> set to - * <code>"no-input-specified"</code> and its <code>DOMError.severity</code> - * set to <code>DOMError.SEVERITY_FATAL_ERROR</code>. - * <p> <code>LSInput</code> objects belong to the application. The DOM - * implementation will never modify them (though it may make copies and - * modify the copies, if necessary). + * </ol> + * <p> If all inputs are null, the <code>LSParser</code> will report a + * <code>DOMError</code> with its <code>DOMError.type</code> set to + * <code>"no-input-specified"</code> and its <code>DOMError.severity</code> + * set to <code>DOMError.SEVERITY_FATAL_ERROR</code>. + * <p> <code>LSInput</code> objects belong to the application. The DOM + * implementation will never modify them (though it may make copies and + * modify the copies, if necessary). * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSInput { /** - * An attribute of a language and binding dependent type that represents - * a stream of 16-bit units. The application must encode the stream - * using UTF-16 (defined in [Unicode] and in [ISO/IEC 10646]). It is not a requirement to have an XML declaration when - * using character streams. If an XML declaration is present, the value - * of the encoding attribute will be ignored. + * An attribute of a language and binding dependent type that represents + * a stream of 16-bit units. The application must encode the stream + * using UTF-16 (defined in [Unicode] and in [ISO/IEC 10646]). It is not a requirement to have an XML declaration when + * using character streams. If an XML declaration is present, the value + * of the encoding attribute will be ignored. */ public java.io.Reader getCharacterStream(); /** - * An attribute of a language and binding dependent type that represents - * a stream of 16-bit units. The application must encode the stream - * using UTF-16 (defined in [Unicode] and in [ISO/IEC 10646]). It is not a requirement to have an XML declaration when - * using character streams. If an XML declaration is present, the value - * of the encoding attribute will be ignored. + * An attribute of a language and binding dependent type that represents + * a stream of 16-bit units. The application must encode the stream + * using UTF-16 (defined in [Unicode] and in [ISO/IEC 10646]). It is not a requirement to have an XML declaration when + * using character streams. If an XML declaration is present, the value + * of the encoding attribute will be ignored. */ public void setCharacterStream(java.io.Reader characterStream); /** - * An attribute of a language and binding dependent type that represents - * a stream of bytes. - * <br> If the application knows the character encoding of the byte - * stream, it should set the encoding attribute. Setting the encoding in - * this way will override any encoding specified in an XML declaration - * in the data. + * An attribute of a language and binding dependent type that represents + * a stream of bytes. + * <br> If the application knows the character encoding of the byte + * stream, it should set the encoding attribute. Setting the encoding in + * this way will override any encoding specified in an XML declaration + * in the data. */ public java.io.InputStream getByteStream(); /** - * An attribute of a language and binding dependent type that represents - * a stream of bytes. - * <br> If the application knows the character encoding of the byte - * stream, it should set the encoding attribute. Setting the encoding in - * this way will override any encoding specified in an XML declaration - * in the data. + * An attribute of a language and binding dependent type that represents + * a stream of bytes. + * <br> If the application knows the character encoding of the byte + * stream, it should set the encoding attribute. Setting the encoding in + * this way will override any encoding specified in an XML declaration + * in the data. */ public void setByteStream(java.io.InputStream byteStream); /** - * String data to parse. If provided, this will always be treated as a - * sequence of 16-bit units (UTF-16 encoded characters). It is not a - * requirement to have an XML declaration when using - * <code>stringData</code>. If an XML declaration is present, the value - * of the encoding attribute will be ignored. + * String data to parse. If provided, this will always be treated as a + * sequence of 16-bit units (UTF-16 encoded characters). It is not a + * requirement to have an XML declaration when using + * <code>stringData</code>. If an XML declaration is present, the value + * of the encoding attribute will be ignored. */ public String getStringData(); /** - * String data to parse. If provided, this will always be treated as a - * sequence of 16-bit units (UTF-16 encoded characters). It is not a - * requirement to have an XML declaration when using - * <code>stringData</code>. If an XML declaration is present, the value - * of the encoding attribute will be ignored. + * String data to parse. If provided, this will always be treated as a + * sequence of 16-bit units (UTF-16 encoded characters). It is not a + * requirement to have an XML declaration when using + * <code>stringData</code>. If an XML declaration is present, the value + * of the encoding attribute will be ignored. */ public void setStringData(String stringData); /** - * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this - * input source. The system identifier is optional if there is a byte - * stream, a character stream, or string data. It is still useful to - * provide one, since the application will use it to resolve any - * relative URIs and can include it in error messages and warnings. (The - * LSParser will only attempt to fetch the resource identified by the - * URI reference if there is no other input available in the input - * source.) - * <br> If the application knows the character encoding of the object - * pointed to by the system identifier, it can set the encoding using - * the <code>encoding</code> attribute. - * <br> If the specified system ID is a relative URI reference (see - * section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the DOM - * implementation will attempt to resolve the relative URI with the - * <code>baseURI</code> as the base, if that fails, the behavior is - * implementation dependent. + * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this + * input source. The system identifier is optional if there is a byte + * stream, a character stream, or string data. It is still useful to + * provide one, since the application will use it to resolve any + * relative URIs and can include it in error messages and warnings. (The + * LSParser will only attempt to fetch the resource identified by the + * URI reference if there is no other input available in the input + * source.) + * <br> If the application knows the character encoding of the object + * pointed to by the system identifier, it can set the encoding using + * the <code>encoding</code> attribute. + * <br> If the specified system ID is a relative URI reference (see + * section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the DOM + * implementation will attempt to resolve the relative URI with the + * <code>baseURI</code> as the base, if that fails, the behavior is + * implementation dependent. */ public String getSystemId(); /** - * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this - * input source. The system identifier is optional if there is a byte - * stream, a character stream, or string data. It is still useful to - * provide one, since the application will use it to resolve any - * relative URIs and can include it in error messages and warnings. (The - * LSParser will only attempt to fetch the resource identified by the - * URI reference if there is no other input available in the input - * source.) - * <br> If the application knows the character encoding of the object - * pointed to by the system identifier, it can set the encoding using - * the <code>encoding</code> attribute. - * <br> If the specified system ID is a relative URI reference (see - * section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the DOM - * implementation will attempt to resolve the relative URI with the - * <code>baseURI</code> as the base, if that fails, the behavior is - * implementation dependent. + * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this + * input source. The system identifier is optional if there is a byte + * stream, a character stream, or string data. It is still useful to + * provide one, since the application will use it to resolve any + * relative URIs and can include it in error messages and warnings. (The + * LSParser will only attempt to fetch the resource identified by the + * URI reference if there is no other input available in the input + * source.) + * <br> If the application knows the character encoding of the object + * pointed to by the system identifier, it can set the encoding using + * the <code>encoding</code> attribute. + * <br> If the specified system ID is a relative URI reference (see + * section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the DOM + * implementation will attempt to resolve the relative URI with the + * <code>baseURI</code> as the base, if that fails, the behavior is + * implementation dependent. */ public void setSystemId(String systemId); /** - * The public identifier for this input source. This may be mapped to an - * input source using an implementation dependent mechanism (such as - * catalogues or other mappings). The public identifier, if specified, - * may also be reported as part of the location information when errors - * are reported. + * The public identifier for this input source. This may be mapped to an + * input source using an implementation dependent mechanism (such as + * catalogues or other mappings). The public identifier, if specified, + * may also be reported as part of the location information when errors + * are reported. */ public String getPublicId(); /** - * The public identifier for this input source. This may be mapped to an - * input source using an implementation dependent mechanism (such as - * catalogues or other mappings). The public identifier, if specified, - * may also be reported as part of the location information when errors - * are reported. + * The public identifier for this input source. This may be mapped to an + * input source using an implementation dependent mechanism (such as + * catalogues or other mappings). The public identifier, if specified, + * may also be reported as part of the location information when errors + * are reported. */ public void setPublicId(String publicId); /** - * The base URI to be used (see section 5.1.4 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]) for - * resolving a relative <code>systemId</code> to an absolute URI. - * <br> If, when used, the base URI is itself a relative URI, an empty - * string, or null, the behavior is implementation dependent. + * The base URI to be used (see section 5.1.4 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]) for + * resolving a relative <code>systemId</code> to an absolute URI. + * <br> If, when used, the base URI is itself a relative URI, an empty + * string, or null, the behavior is implementation dependent. */ public String getBaseURI(); /** - * The base URI to be used (see section 5.1.4 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]) for - * resolving a relative <code>systemId</code> to an absolute URI. - * <br> If, when used, the base URI is itself a relative URI, an empty - * string, or null, the behavior is implementation dependent. + * The base URI to be used (see section 5.1.4 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]) for + * resolving a relative <code>systemId</code> to an absolute URI. + * <br> If, when used, the base URI is itself a relative URI, an empty + * string, or null, the behavior is implementation dependent. */ public void setBaseURI(String baseURI); /** - * The character encoding, if known. The encoding must be a string - * acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section - * 4.3.3 "Character Encoding in Entities"). - * <br> This attribute has no effect when the application provides a - * character stream or string data. For other sources of input, an - * encoding specified by means of this attribute will override any - * encoding specified in the XML declaration or the Text declaration, or - * an encoding obtained from a higher level protocol, such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. + * The character encoding, if known. The encoding must be a string + * acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section + * 4.3.3 "Character Encoding in Entities"). + * <br> This attribute has no effect when the application provides a + * character stream or string data. For other sources of input, an + * encoding specified by means of this attribute will override any + * encoding specified in the XML declaration or the Text declaration, or + * an encoding obtained from a higher level protocol, such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. */ public String getEncoding(); /** - * The character encoding, if known. The encoding must be a string - * acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section - * 4.3.3 "Character Encoding in Entities"). - * <br> This attribute has no effect when the application provides a - * character stream or string data. For other sources of input, an - * encoding specified by means of this attribute will override any - * encoding specified in the XML declaration or the Text declaration, or - * an encoding obtained from a higher level protocol, such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. + * The character encoding, if known. The encoding must be a string + * acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section + * 4.3.3 "Character Encoding in Entities"). + * <br> This attribute has no effect when the application provides a + * character stream or string data. For other sources of input, an + * encoding specified by means of this attribute will override any + * encoding specified in the XML declaration or the Text declaration, or + * an encoding obtained from a higher level protocol, such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>]. */ public void setEncoding(String encoding); /** - * If set to true, assume that the input is certified (see section 2.13 - * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]) when - * parsing [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. + * If set to true, assume that the input is certified (see section 2.13 + * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]) when + * parsing [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. */ public boolean getCertifiedText(); /** - * If set to true, assume that the input is certified (see section 2.13 - * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]) when - * parsing [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. + * If set to true, assume that the input is certified (see section 2.13 + * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]) when + * parsing [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>]. */ public void setCertifiedText(boolean certifiedText); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java index 601a5be11b7..0140b4123e0 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java @@ -16,8 +16,8 @@ import org.w3c.dom.Document; import org.w3c.dom.events.Event; /** - * This interface represents a load event object that signals the completion - * of a document load. + * This interface represents a load event object that signals the completion + * of a document load. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSOutput.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSOutput.java index 2f8675c571e..789b95a936c 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSOutput.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSOutput.java @@ -13,93 +13,93 @@ package org.w3c.dom.ls; /** - * This interface represents an output destination for data. - * <p> This interface allows an application to encapsulate information about - * an output destination in a single object, which may include a URI, a byte - * stream (possibly with a specified encoding), a base URI, and/or a - * character stream. - * <p> The exact definitions of a byte stream and a character stream are - * binding dependent. - * <p> The application is expected to provide objects that implement this - * interface whenever such objects are needed. The application can either - * provide its own objects that implement this interface, or it can use the - * generic factory method <code>DOMImplementationLS.createLSOutput()</code> - * to create objects that implement this interface. - * <p> The <code>LSSerializer</code> will use the <code>LSOutput</code> object - * to determine where to serialize the output to. The - * <code>LSSerializer</code> will look at the different outputs specified in - * the <code>LSOutput</code> in the following order to know which one to - * output to, the first one that is not null and not an empty string will be - * used: + * This interface represents an output destination for data. + * <p> This interface allows an application to encapsulate information about + * an output destination in a single object, which may include a URI, a byte + * stream (possibly with a specified encoding), a base URI, and/or a + * character stream. + * <p> The exact definitions of a byte stream and a character stream are + * binding dependent. + * <p> The application is expected to provide objects that implement this + * interface whenever such objects are needed. The application can either + * provide its own objects that implement this interface, or it can use the + * generic factory method <code>DOMImplementationLS.createLSOutput()</code> + * to create objects that implement this interface. + * <p> The <code>LSSerializer</code> will use the <code>LSOutput</code> object + * to determine where to serialize the output to. The + * <code>LSSerializer</code> will look at the different outputs specified in + * the <code>LSOutput</code> in the following order to know which one to + * output to, the first one that is not null and not an empty string will be + * used: * <ol> - * <li> <code>LSOutput.characterStream</code> + * <li> <code>LSOutput.characterStream</code> * </li> - * <li> - * <code>LSOutput.byteStream</code> + * <li> + * <code>LSOutput.byteStream</code> * </li> - * <li> <code>LSOutput.systemId</code> + * <li> <code>LSOutput.systemId</code> * </li> - * </ol> - * <p> <code>LSOutput</code> objects belong to the application. The DOM - * implementation will never modify them (though it may make copies and - * modify the copies, if necessary). + * </ol> + * <p> <code>LSOutput</code> objects belong to the application. The DOM + * implementation will never modify them (though it may make copies and + * modify the copies, if necessary). * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSOutput { /** - * An attribute of a language and binding dependent type that represents - * a writable stream to which 16-bit units can be output. + * An attribute of a language and binding dependent type that represents + * a writable stream to which 16-bit units can be output. */ public java.io.Writer getCharacterStream(); /** - * An attribute of a language and binding dependent type that represents - * a writable stream to which 16-bit units can be output. + * An attribute of a language and binding dependent type that represents + * a writable stream to which 16-bit units can be output. */ public void setCharacterStream(java.io.Writer characterStream); /** - * An attribute of a language and binding dependent type that represents - * a writable stream of bytes. + * An attribute of a language and binding dependent type that represents + * a writable stream of bytes. */ public java.io.OutputStream getByteStream(); /** - * An attribute of a language and binding dependent type that represents - * a writable stream of bytes. + * An attribute of a language and binding dependent type that represents + * a writable stream of bytes. */ public void setByteStream(java.io.OutputStream byteStream); /** - * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this - * output destination. - * <br> If the system ID is a relative URI reference (see section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the - * behavior is implementation dependent. + * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this + * output destination. + * <br> If the system ID is a relative URI reference (see section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the + * behavior is implementation dependent. */ public String getSystemId(); /** - * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this - * output destination. - * <br> If the system ID is a relative URI reference (see section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the - * behavior is implementation dependent. + * The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], for this + * output destination. + * <br> If the system ID is a relative URI reference (see section 5 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the + * behavior is implementation dependent. */ public void setSystemId(String systemId); /** - * The character encoding to use for the output. The encoding must be a - * string acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section - * 4.3.3 "Character Encoding in Entities"), it is recommended that - * character encodings registered (as charsets) with the Internet + * The character encoding to use for the output. The encoding must be a + * string acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section + * 4.3.3 "Character Encoding in Entities"), it is recommended that + * character encodings registered (as charsets) with the Internet * Assigned Numbers Authority [<a href='ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets'>IANA-CHARSETS</a>] - * should be referred to using their registered names. + * should be referred to using their registered names. */ public String getEncoding(); /** - * The character encoding to use for the output. The encoding must be a - * string acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section - * 4.3.3 "Character Encoding in Entities"), it is recommended that - * character encodings registered (as charsets) with the Internet + * The character encoding to use for the output. The encoding must be a + * string acceptable for an XML encoding declaration ([<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] section + * 4.3.3 "Character Encoding in Entities"), it is recommended that + * character encodings registered (as charsets) with the Internet * Assigned Numbers Authority [<a href='ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets'>IANA-CHARSETS</a>] - * should be referred to using their registered names. + * should be referred to using their registered names. */ public void setEncoding(String encoding); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParser.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParser.java index ee918e0dce7..41781fa33ea 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParser.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParser.java @@ -18,156 +18,156 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * An interface to an object that is able to build, or augment, a DOM tree - * from various input sources. - * <p> <code>LSParser</code> provides an API for parsing XML and building the - * corresponding DOM document structure. A <code>LSParser</code> instance - * can be obtained by invoking the - * <code>DOMImplementationLS.createLSParser()</code> method. + * An interface to an object that is able to build, or augment, a DOM tree + * from various input sources. + * <p> <code>LSParser</code> provides an API for parsing XML and building the + * corresponding DOM document structure. A <code>LSParser</code> instance + * can be obtained by invoking the + * <code>DOMImplementationLS.createLSParser()</code> method. * <p> As specified in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , when a document is first made available via the LSParser: + * , when a document is first made available via the LSParser: * <ul> - * <li> there will - * never be two adjacent nodes of type NODE_TEXT, and there will never be - * empty text nodes. + * <li> there will + * never be two adjacent nodes of type NODE_TEXT, and there will never be + * empty text nodes. * </li> - * <li> it is expected that the <code>value</code> and - * <code>nodeValue</code> attributes of an <code>Attr</code> node initially - * return the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#AVNormalize'>XML 1.0 + * <li> it is expected that the <code>value</code> and + * <code>nodeValue</code> attributes of an <code>Attr</code> node initially + * return the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#AVNormalize'>XML 1.0 * normalized value</a>. However, if the parameters "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate-if-schema'> * validate-if-schema</a>" and "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-datatype-normalization'> - * datatype-normalization</a>" are set to <code>true</code>, depending on the attribute normalization - * used, the attribute values may differ from the ones obtained by the XML + * datatype-normalization</a>" are set to <code>true</code>, depending on the attribute normalization + * used, the attribute values may differ from the ones obtained by the XML * 1.0 attribute normalization. If the parameters "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-datatype-normalization'> - * datatype-normalization</a>" is set to <code>false</code>, the XML 1.0 attribute normalization is - * guaranteed to occur, and if the attributes list does not contain - * namespace declarations, the <code>attributes</code> attribute on + * datatype-normalization</a>" is set to <code>false</code>, the XML 1.0 attribute normalization is + * guaranteed to occur, and if the attributes list does not contain + * namespace declarations, the <code>attributes</code> attribute on * <code>Element</code> node represents the property <b>[attributes]</b> defined in [<a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204/'>XML Information Set</a>] - * . + * . * </li> * </ul> - * <p> Asynchronous <code>LSParser</code> objects are expected to also - * implement the <code>events::EventTarget</code> interface so that event - * listeners can be registered on asynchronous <code>LSParser</code> - * objects. - * <p> Events supported by asynchronous <code>LSParser</code> objects are: + * <p> Asynchronous <code>LSParser</code> objects are expected to also + * implement the <code>events::EventTarget</code> interface so that event + * listeners can be registered on asynchronous <code>LSParser</code> + * objects. + * <p> Events supported by asynchronous <code>LSParser</code> objects are: * <dl> * <dt>load</dt> * <dd> - * The <code>LSParser</code> finishes to load the document. See also the + * The <code>LSParser</code> finishes to load the document. See also the * definition of the <code>LSLoadEvent</code> interface. </dd> * <dt>progress</dt> - * <dd> The - * <code>LSParser</code> signals progress as data is parsed. This - * specification does not attempt to define exactly when progress events - * should be dispatched. That is intentionally left as - * implementation-dependent. Here is one example of how an application might - * dispatch progress events: Once the parser starts receiving data, a - * progress event is dispatched to indicate that the parsing starts. From - * there on, a progress event is dispatched for every 4096 bytes of data - * that is received and processed. This is only one example, though, and - * implementations can choose to dispatch progress events at any time while - * parsing, or not dispatch them at all. See also the definition of the + * <dd> The + * <code>LSParser</code> signals progress as data is parsed. This + * specification does not attempt to define exactly when progress events + * should be dispatched. That is intentionally left as + * implementation-dependent. Here is one example of how an application might + * dispatch progress events: Once the parser starts receiving data, a + * progress event is dispatched to indicate that the parsing starts. From + * there on, a progress event is dispatched for every 4096 bytes of data + * that is received and processed. This is only one example, though, and + * implementations can choose to dispatch progress events at any time while + * parsing, or not dispatch them at all. See also the definition of the * <code>LSProgressEvent</code> interface. </dd> * </dl> - * <p ><b>Note:</b> All events defined in this specification use the - * namespace URI <code>"http://www.w3.org/2002/DOMLS"</code>. - * <p> While parsing an input source, errors are reported to the application + * <p ><b>Note:</b> All events defined in this specification use the + * namespace URI <code>"http://www.w3.org/2002/DOMLS"</code>. + * <p> While parsing an input source, errors are reported to the application * through the error handler (<code>LSParser.domConfig</code>'s "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" parameter). This specification does in no way try to define all possible - * errors that can occur while parsing XML, or any other markup, but some - * common error cases are defined. The types (<code>DOMError.type</code>) of - * errors and warnings defined by this specification are: + * error-handler</a>" parameter). This specification does in no way try to define all possible + * errors that can occur while parsing XML, or any other markup, but some + * common error cases are defined. The types (<code>DOMError.type</code>) of + * errors and warnings defined by this specification are: * <dl> - * <dt> + * <dt> * <code>"check-character-normalization-failure" [error]</code> </dt> - * <dd> Raised if + * <dd> Raised if * the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-check-character-normalization'> - * check-character-normalization</a>" is set to true and a string is encountered that fails normalization + * check-character-normalization</a>" is set to true and a string is encountered that fails normalization * checking. </dd> * <dt><code>"doctype-not-allowed" [fatal]</code></dt> - * <dd> Raised if the - * configuration parameter "disallow-doctype" is set to <code>true</code> + * <dd> Raised if the + * configuration parameter "disallow-doctype" is set to <code>true</code> * and a doctype is encountered. </dd> * <dt><code>"no-input-specified" [fatal]</code></dt> - * <dd> - * Raised when loading a document and no input is specified in the + * <dd> + * Raised when loading a document and no input is specified in the * <code>LSInput</code> object. </dd> * <dt> * <code>"pi-base-uri-not-preserved" [warning]</code></dt> - * <dd> Raised if a processing - * instruction is encountered in a location where the base URI of the - * processing instruction can not be preserved. One example of a case where + * <dd> Raised if a processing + * instruction is encountered in a location where the base URI of the + * processing instruction can not be preserved. One example of a case where * this warning will be raised is if the configuration parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> - * entities</a>" is set to <code>false</code> and the following XML file is parsed: + * entities</a>" is set to <code>false</code> and the following XML file is parsed: * <pre> - * <!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]> + * <!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]> * <root> &e; </root></pre> - * And <code>subdir/myentity.ent</code> - * contains: - * <pre><one> <two/> </one> <?pi 3.14159?> + * And <code>subdir/myentity.ent</code> + * contains: + * <pre><one> <two/> </one> <?pi 3.14159?> * <more/></pre> * </dd> * <dt><code>"unbound-prefix-in-entity" [warning]</code></dt> - * <dd> An - * implementation dependent warning that may be raised if the configuration + * <dd> An + * implementation dependent warning that may be raised if the configuration * parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-namespaces'> - * namespaces</a>" is set to <code>true</code> and an unbound namespace prefix is - * encountered in an entity's replacement text. Raising this warning is not - * enforced since some existing parsers may not recognize unbound namespace + * namespaces</a>" is set to <code>true</code> and an unbound namespace prefix is + * encountered in an entity's replacement text. Raising this warning is not + * enforced since some existing parsers may not recognize unbound namespace * prefixes in the replacement text of entities. </dd> * <dt> * <code>"unknown-character-denormalization" [fatal]</code></dt> - * <dd> Raised if the - * configuration parameter "ignore-unknown-character-denormalizations" is - * set to <code>false</code> and a character is encountered for which the + * <dd> Raised if the + * configuration parameter "ignore-unknown-character-denormalizations" is + * set to <code>false</code> and a character is encountered for which the * processor cannot determine the normalization properties. </dd> * <dt> * <code>"unsupported-encoding" [fatal]</code></dt> - * <dd> Raised if an unsupported + * <dd> Raised if an unsupported * encoding is encountered. </dd> * <dt><code>"unsupported-media-type" [fatal]</code></dt> - * <dd> - * Raised if the configuration parameter "supported-media-types-only" is set + * <dd> + * Raised if the configuration parameter "supported-media-types-only" is set * to <code>true</code> and an unsupported media type is encountered. </dd> - * </dl> - * <p> In addition to raising the defined errors and warnings, implementations - * are expected to raise implementation specific errors and warnings for any - * other error and warning cases such as IO errors (file not found, - * permission denied,...), XML well-formedness errors, and so on. + * </dl> + * <p> In addition to raising the defined errors and warnings, implementations + * are expected to raise implementation specific errors and warnings for any + * other error and warning cases such as IO errors (file not found, + * permission denied,...), XML well-formedness errors, and so on. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSParser { /** - * The <code>DOMConfiguration</code> object used when parsing an input - * source. This <code>DOMConfiguration</code> is specific to the parse + * The <code>DOMConfiguration</code> object used when parsing an input + * source. This <code>DOMConfiguration</code> is specific to the parse * operation. No parameter values from this <code>DOMConfiguration</code> - * object are passed automatically to the <code>DOMConfiguration</code> - * object on the <code>Document</code> that is created, or used, by the - * parse operation. The DOM application is responsible for passing any - * needed parameter values from this <code>DOMConfiguration</code> - * object to the <code>DOMConfiguration</code> object referenced by the - * <code>Document</code> object. + * object are passed automatically to the <code>DOMConfiguration</code> + * object on the <code>Document</code> that is created, or used, by the + * parse operation. The DOM application is responsible for passing any + * needed parameter values from this <code>DOMConfiguration</code> + * object to the <code>DOMConfiguration</code> object referenced by the + * <code>Document</code> object. * <br> In addition to the parameters recognized in on the <a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMConfiguration'> * DOMConfiguration</a> interface defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , the <code>DOMConfiguration</code> objects for <code>LSParser</code> - * add or modify the following parameters: + * , the <code>DOMConfiguration</code> objects for <code>LSParser</code> + * add or modify the following parameters: * <dl> * <dt> * <code>"charset-overrides-xml-encoding"</code></dt> * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] (<em>default</em>) If a higher level protocol such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] provides an - * indication of the character encoding of the input stream being - * processed, that will override any encoding specified in the XML - * declaration or the Text declaration (see also section 4.3.3, - * "Character Encoding in Entities", in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). - * Explicitly setting an encoding in the <code>LSInput</code> overrides + * <dd>[<em>optional</em>] (<em>default</em>) If a higher level protocol such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] provides an + * indication of the character encoding of the input stream being + * processed, that will override any encoding specified in the XML + * declaration or the Text declaration (see also section 4.3.3, + * "Character Encoding in Entities", in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). + * Explicitly setting an encoding in the <code>LSInput</code> overrides * any encoding from the protocol. </dd> * <dt><code>false</code></dt> - * <dd>[<em>required</em>] The parser ignores any character set encoding information from + * <dd>[<em>required</em>] The parser ignores any character set encoding information from * higher-level protocols. </dd> * </dl></dd> * <dt><code>"disallow-doctype"</code></dt> @@ -175,8 +175,8 @@ public interface LSParser { * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>optional</em>] Throw a fatal <b>"doctype-not-allowed"</b> error if a doctype node is found while parsing the document. This is - * useful when dealing with things like SOAP envelopes where doctype + * <dd>[<em>optional</em>] Throw a fatal <b>"doctype-not-allowed"</b> error if a doctype node is found while parsing the document. This is + * useful when dealing with things like SOAP envelopes where doctype * nodes are not allowed. </dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>) Allow doctype nodes in the document. </dd> @@ -187,21 +187,21 @@ public interface LSParser { * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) If, while verifying full normalization when [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] is - * supported, a processor encounters characters for which it cannot - * determine the normalization properties, then the processor will - * ignore any possible denormalizations caused by these characters. + * <dd>[<em>required</em>] (<em>default</em>) If, while verifying full normalization when [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] is + * supported, a processor encounters characters for which it cannot + * determine the normalization properties, then the processor will + * ignore any possible denormalizations caused by these characters. * This parameter is ignored for [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. </dd> * <dt> * <code>false</code></dt> - * <dd>[<em>optional</em>] Report an fatal <b>"unknown-character-denormalization"</b> error if a character is encountered for which the processor cannot + * <dd>[<em>optional</em>] Report an fatal <b>"unknown-character-denormalization"</b> error if a character is encountered for which the processor cannot * determine the normalization properties. </dd> * </dl></dd> * <dt><code>"infoset"</code></dt> - * <dd> See - * the definition of <code>DOMConfiguration</code> for a description of + * <dd> See + * the definition of <code>DOMConfiguration</code> for a description of * this parameter. Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , this parameter will default to <code>true</code> for + * , this parameter will default to <code>true</code> for * <code>LSParser</code>. </dd> * <dt><code>"namespaces"</code></dt> * <dd> @@ -215,41 +215,41 @@ public interface LSParser { * </dl></dd> * <dt> * <code>"resource-resolver"</code></dt> - * <dd>[<em>required</em>] A reference to a <code>LSResourceResolver</code> object, or null. If - * the value of this parameter is not null when an external resource - * (such as an external XML entity or an XML schema location) is - * encountered, the implementation will request that the - * <code>LSResourceResolver</code> referenced in this parameter resolves + * <dd>[<em>required</em>] A reference to a <code>LSResourceResolver</code> object, or null. If + * the value of this parameter is not null when an external resource + * (such as an external XML entity or an XML schema location) is + * encountered, the implementation will request that the + * <code>LSResourceResolver</code> referenced in this parameter resolves * the resource. </dd> * <dt><code>"supported-media-types-only"</code></dt> * <dd> * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>optional</em>] Check that the media type of the parsed resource is a supported media - * type. If an unsupported media type is encountered, a fatal error of - * type <b>"unsupported-media-type"</b> will be raised. The media types defined in [<a href='http://www.ietf.org/rfc/rfc3023.txt'>IETF RFC 3023</a>] must always + * <dd>[<em>optional</em>] Check that the media type of the parsed resource is a supported media + * type. If an unsupported media type is encountered, a fatal error of + * type <b>"unsupported-media-type"</b> will be raised. The media types defined in [<a href='http://www.ietf.org/rfc/rfc3023.txt'>IETF RFC 3023</a>] must always * be accepted. </dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>) Accept any media type. </dd> * </dl></dd> * <dt><code>"validate"</code></dt> - * <dd> See the definition of - * <code>DOMConfiguration</code> for a description of this parameter. + * <dd> See the definition of + * <code>DOMConfiguration</code> for a description of this parameter. * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , the processing of the internal subset is always accomplished, even + * , the processing of the internal subset is always accomplished, even * if this parameter is set to <code>false</code>. </dd> * <dt> * <code>"validate-if-schema"</code></dt> - * <dd> See the definition of - * <code>DOMConfiguration</code> for a description of this parameter. + * <dd> See the definition of + * <code>DOMConfiguration</code> for a description of this parameter. * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , the processing of the internal subset is always accomplished, even + * , the processing of the internal subset is always accomplished, even * if this parameter is set to <code>false</code>. </dd> * <dt> * <code>"well-formed"</code></dt> - * <dd> See the definition of - * <code>DOMConfiguration</code> for a description of this parameter. + * <dd> See the definition of + * <code>DOMConfiguration</code> for a description of this parameter. * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] * , this parameter cannot be set to <code>false</code>. </dd> * </dl> @@ -257,209 +257,209 @@ public interface LSParser { public DOMConfiguration getDomConfig(); /** - * When a filter is provided, the implementation will call out to the - * filter as it is constructing the DOM tree structure. The filter can - * choose to remove elements from the document being constructed, or to - * terminate the parsing early. - * <br> The filter is invoked after the operations requested by the - * <code>DOMConfiguration</code> parameters have been applied. For + * When a filter is provided, the implementation will call out to the + * filter as it is constructing the DOM tree structure. The filter can + * choose to remove elements from the document being constructed, or to + * terminate the parsing early. + * <br> The filter is invoked after the operations requested by the + * <code>DOMConfiguration</code> parameters have been applied. For * example, if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> - * validate</a>" is set to <code>true</code>, the validation is done before invoking the - * filter. + * validate</a>" is set to <code>true</code>, the validation is done before invoking the + * filter. */ public LSParserFilter getFilter(); /** - * When a filter is provided, the implementation will call out to the - * filter as it is constructing the DOM tree structure. The filter can - * choose to remove elements from the document being constructed, or to - * terminate the parsing early. - * <br> The filter is invoked after the operations requested by the - * <code>DOMConfiguration</code> parameters have been applied. For + * When a filter is provided, the implementation will call out to the + * filter as it is constructing the DOM tree structure. The filter can + * choose to remove elements from the document being constructed, or to + * terminate the parsing early. + * <br> The filter is invoked after the operations requested by the + * <code>DOMConfiguration</code> parameters have been applied. For * example, if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> - * validate</a>" is set to <code>true</code>, the validation is done before invoking the - * filter. + * validate</a>" is set to <code>true</code>, the validation is done before invoking the + * filter. */ public void setFilter(LSParserFilter filter); /** - * <code>true</code> if the <code>LSParser</code> is asynchronous, - * <code>false</code> if it is synchronous. + * <code>true</code> if the <code>LSParser</code> is asynchronous, + * <code>false</code> if it is synchronous. */ public boolean getAsync(); /** - * <code>true</code> if the <code>LSParser</code> is currently busy - * loading a document, otherwise <code>false</code>. + * <code>true</code> if the <code>LSParser</code> is currently busy + * loading a document, otherwise <code>false</code>. */ public boolean getBusy(); /** - * Parse an XML document from a resource identified by a + * Parse an XML document from a resource identified by a * <code>LSInput</code>. - * @param input The <code>LSInput</code> from which the source of the - * document is to be read. - * @return If the <code>LSParser</code> is a synchronous - * <code>LSParser</code>, the newly created and populated - * <code>Document</code> is returned. If the <code>LSParser</code> is - * asynchronous, <code>null</code> is returned since the document - * object may not yet be constructed when this method returns. + * @param input The <code>LSInput</code> from which the source of the + * document is to be read. + * @return If the <code>LSParser</code> is a synchronous + * <code>LSParser</code>, the newly created and populated + * <code>Document</code> is returned. If the <code>LSParser</code> is + * asynchronous, <code>null</code> is returned since the document + * object may not yet be constructed when this method returns. * @exception DOMException - * INVALID_STATE_ERR: Raised if the <code>LSParser</code>'s - * <code>LSParser.busy</code> attribute is <code>true</code>. + * INVALID_STATE_ERR: Raised if the <code>LSParser</code>'s + * <code>LSParser.busy</code> attribute is <code>true</code>. * @exception LSException - * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load - * the XML document. DOM applications should attach a + * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load + * the XML document. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ public Document parse(LSInput input) throws DOMException, LSException; /** - * Parse an XML document from a location identified by a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]. If the URI - * contains a fragment identifier (see section 4.1 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the - * behavior is not defined by this specification, future versions of - * this specification may define the behavior. + * Parse an XML document from a location identified by a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]. If the URI + * contains a fragment identifier (see section 4.1 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the + * behavior is not defined by this specification, future versions of + * this specification may define the behavior. * @param uri The location of the XML document to be read. - * @return If the <code>LSParser</code> is a synchronous - * <code>LSParser</code>, the newly created and populated - * <code>Document</code> is returned, or <code>null</code> if an error - * occured. If the <code>LSParser</code> is asynchronous, - * <code>null</code> is returned since the document object may not yet - * be constructed when this method returns. + * @return If the <code>LSParser</code> is a synchronous + * <code>LSParser</code>, the newly created and populated + * <code>Document</code> is returned, or <code>null</code> if an error + * occured. If the <code>LSParser</code> is asynchronous, + * <code>null</code> is returned since the document object may not yet + * be constructed when this method returns. * @exception DOMException - * INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> - * attribute is <code>true</code>. + * INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> + * attribute is <code>true</code>. * @exception LSException - * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load - * the XML document. DOM applications should attach a + * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load + * the XML document. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ public Document parseURI(String uri) throws DOMException, LSException; // ACTION_TYPES /** - * Append the result of the parse operation as children of the context - * node. For this action to work, the context node must be an - * <code>Element</code> or a <code>DocumentFragment</code>. + * Append the result of the parse operation as children of the context + * node. For this action to work, the context node must be an + * <code>Element</code> or a <code>DocumentFragment</code>. */ public static final short ACTION_APPEND_AS_CHILDREN = 1; /** - * Replace all the children of the context node with the result of the - * parse operation. For this action to work, the context node must be an - * <code>Element</code>, a <code>Document</code>, or a - * <code>DocumentFragment</code>. + * Replace all the children of the context node with the result of the + * parse operation. For this action to work, the context node must be an + * <code>Element</code>, a <code>Document</code>, or a + * <code>DocumentFragment</code>. */ public static final short ACTION_REPLACE_CHILDREN = 2; /** - * Insert the result of the parse operation as the immediately preceding - * sibling of the context node. For this action to work the context - * node's parent must be an <code>Element</code> or a - * <code>DocumentFragment</code>. + * Insert the result of the parse operation as the immediately preceding + * sibling of the context node. For this action to work the context + * node's parent must be an <code>Element</code> or a + * <code>DocumentFragment</code>. */ public static final short ACTION_INSERT_BEFORE = 3; /** - * Insert the result of the parse operation as the immediately following - * sibling of the context node. For this action to work the context - * node's parent must be an <code>Element</code> or a - * <code>DocumentFragment</code>. + * Insert the result of the parse operation as the immediately following + * sibling of the context node. For this action to work the context + * node's parent must be an <code>Element</code> or a + * <code>DocumentFragment</code>. */ public static final short ACTION_INSERT_AFTER = 4; /** - * Replace the context node with the result of the parse operation. For - * this action to work, the context node must have a parent, and the - * parent must be an <code>Element</code> or a - * <code>DocumentFragment</code>. + * Replace the context node with the result of the parse operation. For + * this action to work, the context node must have a parent, and the + * parent must be an <code>Element</code> or a + * <code>DocumentFragment</code>. */ public static final short ACTION_REPLACE = 5; /** - * Parse an XML fragment from a resource identified by a - * <code>LSInput</code> and insert the content into an existing document - * at the position specified with the <code>context</code> and - * <code>action</code> arguments. When parsing the input stream, the - * context node (or its parent, depending on where the result will be - * inserted) is used for resolving unbound namespace prefixes. The - * context node's <code>ownerDocument</code> node (or the node itself if - * the node of type <code>DOCUMENT_NODE</code>) is used to resolve - * default attributes and entity references. - * <br> As the new data is inserted into the document, at least one - * mutation event is fired per new immediate child or sibling of the - * context node. - * <br> If the context node is a <code>Document</code> node and the action - * is <code>ACTION_REPLACE_CHILDREN</code>, then the document that is - * passed as the context node will be changed such that its - * <code>xmlEncoding</code>, <code>documentURI</code>, - * <code>xmlVersion</code>, <code>inputEncoding</code>, - * <code>xmlStandalone</code>, and all other such attributes are set to - * what they would be set to if the input source was parsed using - * <code>LSParser.parse()</code>. - * <br> This method is always synchronous, even if the - * <code>LSParser</code> is asynchronous (<code>LSParser.async</code> is - * <code>true</code>). - * <br> If an error occurs while parsing, the caller is notified through + * Parse an XML fragment from a resource identified by a + * <code>LSInput</code> and insert the content into an existing document + * at the position specified with the <code>context</code> and + * <code>action</code> arguments. When parsing the input stream, the + * context node (or its parent, depending on where the result will be + * inserted) is used for resolving unbound namespace prefixes. The + * context node's <code>ownerDocument</code> node (or the node itself if + * the node of type <code>DOCUMENT_NODE</code>) is used to resolve + * default attributes and entity references. + * <br> As the new data is inserted into the document, at least one + * mutation event is fired per new immediate child or sibling of the + * context node. + * <br> If the context node is a <code>Document</code> node and the action + * is <code>ACTION_REPLACE_CHILDREN</code>, then the document that is + * passed as the context node will be changed such that its + * <code>xmlEncoding</code>, <code>documentURI</code>, + * <code>xmlVersion</code>, <code>inputEncoding</code>, + * <code>xmlStandalone</code>, and all other such attributes are set to + * what they would be set to if the input source was parsed using + * <code>LSParser.parse()</code>. + * <br> This method is always synchronous, even if the + * <code>LSParser</code> is asynchronous (<code>LSParser.async</code> is + * <code>true</code>). + * <br> If an error occurs while parsing, the caller is notified through * the <code>ErrorHandler</code> instance associated with the "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" parameter of the <code>DOMConfiguration</code>. - * <br> When calling <code>parseWithContext</code>, the values of the - * following configuration parameters will be ignored and their default + * error-handler</a>" parameter of the <code>DOMConfiguration</code>. + * <br> When calling <code>parseWithContext</code>, the values of the + * following configuration parameters will be ignored and their default * values will always be used instead: "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> * validate</a>", "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate-if-schema'> * validate-if-schema</a>", and "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-element-content-whitespace'> - * element-content-whitespace</a>". Other parameters will be treated normally, and the parser is expected - * to call the <code>LSParserFilter</code> just as if a whole document - * was parsed. - * @param input The <code>LSInput</code> from which the source document - * is to be read. The source document must be an XML fragment, i.e. - * anything except a complete XML document (except in the case where - * the context node of type <code>DOCUMENT_NODE</code>, and the action - * is <code>ACTION_REPLACE_CHILDREN</code>), a DOCTYPE (internal - * subset), entity declaration(s), notation declaration(s), or XML or - * text declaration(s). - * @param contextArg The node that is used as the context for the data - * that is being parsed. This node must be a <code>Document</code> - * node, a <code>DocumentFragment</code> node, or a node of a type - * that is allowed as a child of an <code>Element</code> node, e.g. it - * cannot be an <code>Attribute</code> node. - * @param action This parameter describes which action should be taken - * between the new set of nodes being inserted and the existing - * children of the context node. The set of possible actions is - * defined in <code>ACTION_TYPES</code> above. - * @return Return the node that is the result of the parse operation. If - * the result is more than one top-level node, the first one is - * returned. + * element-content-whitespace</a>". Other parameters will be treated normally, and the parser is expected + * to call the <code>LSParserFilter</code> just as if a whole document + * was parsed. + * @param input The <code>LSInput</code> from which the source document + * is to be read. The source document must be an XML fragment, i.e. + * anything except a complete XML document (except in the case where + * the context node of type <code>DOCUMENT_NODE</code>, and the action + * is <code>ACTION_REPLACE_CHILDREN</code>), a DOCTYPE (internal + * subset), entity declaration(s), notation declaration(s), or XML or + * text declaration(s). + * @param contextArg The node that is used as the context for the data + * that is being parsed. This node must be a <code>Document</code> + * node, a <code>DocumentFragment</code> node, or a node of a type + * that is allowed as a child of an <code>Element</code> node, e.g. it + * cannot be an <code>Attribute</code> node. + * @param action This parameter describes which action should be taken + * between the new set of nodes being inserted and the existing + * children of the context node. The set of possible actions is + * defined in <code>ACTION_TYPES</code> above. + * @return Return the node that is the result of the parse operation. If + * the result is more than one top-level node, the first one is + * returned. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if the content cannot replace, be - * inserted before, after, or as a child of the context node (see also + * HIERARCHY_REQUEST_ERR: Raised if the content cannot replace, be + * inserted before, after, or as a child of the context node (see also * <code>Node.insertBefore</code> or <code>Node.replaceChild</code> in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] * ). - * <br> NOT_SUPPORTED_ERR: Raised if the <code>LSParser</code> doesn't - * support this method, or if the context node is of type - * <code>Document</code> and the DOM implementation doesn't support - * the replacement of the <code>DocumentType</code> child or - * <code>Element</code> child. - * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if the context node is a - * read only node and the content is being appended to its child list, - * or if the parent node of the context node is read only node and the + * <br> NOT_SUPPORTED_ERR: Raised if the <code>LSParser</code> doesn't + * support this method, or if the context node is of type + * <code>Document</code> and the DOM implementation doesn't support + * the replacement of the <code>DocumentType</code> child or + * <code>Element</code> child. + * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if the context node is a + * read only node and the content is being appended to its child list, + * or if the parent node of the context node is read only node and the * content is being inserted in its child list. - * <br> INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> - * attribute is <code>true</code>. + * <br> INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> + * attribute is <code>true</code>. * @exception LSException - * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load - * the XML fragment. DOM applications should attach a + * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load + * the XML fragment. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ - public Node parseWithContext(LSInput input, - Node contextArg, + public Node parseWithContext(LSInput input, + Node contextArg, short action) throws DOMException, LSException; /** - * Abort the loading of the document that is currently being loaded by - * the <code>LSParser</code>. If the <code>LSParser</code> is currently - * not busy, a call to this method does nothing. + * Abort the loading of the document that is currently being loaded by + * the <code>LSParser</code>. If the <code>LSParser</code> is currently + * not busy, a call to this method does nothing. */ public void abort(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java index 4e612945e95..00db4d3c230 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java @@ -16,32 +16,32 @@ import org.w3c.dom.Node; import org.w3c.dom.Element; /** - * <code>LSParserFilter</code>s provide applications the ability to examine - * nodes as they are being constructed while parsing. As each node is - * examined, it may be modified or removed, or the entire parse may be - * terminated early. - * <p> At the time any of the filter methods are called by the parser, the - * owner Document and DOMImplementation objects exist and are accessible. - * The document element is never passed to the <code>LSParserFilter</code> - * methods, i.e. it is not possible to filter out the document element. - * <code>Document</code>, <code>DocumentType</code>, <code>Notation</code>, - * <code>Entity</code>, and <code>Attr</code> nodes are never passed to the - * <code>acceptNode</code> method on the filter. The child nodes of an - * <code>EntityReference</code> node are passed to the filter if the + * <code>LSParserFilter</code>s provide applications the ability to examine + * nodes as they are being constructed while parsing. As each node is + * examined, it may be modified or removed, or the entire parse may be + * terminated early. + * <p> At the time any of the filter methods are called by the parser, the + * owner Document and DOMImplementation objects exist and are accessible. + * The document element is never passed to the <code>LSParserFilter</code> + * methods, i.e. it is not possible to filter out the document element. + * <code>Document</code>, <code>DocumentType</code>, <code>Notation</code>, + * <code>Entity</code>, and <code>Attr</code> nodes are never passed to the + * <code>acceptNode</code> method on the filter. The child nodes of an + * <code>EntityReference</code> node are passed to the filter if the * parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> * entities</a>" is set to <code>false</code>. Note that, as described by the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> - * entities</a>", unexpanded entity reference nodes are never discarded and are always - * passed to the filter. - * <p> All validity checking while parsing a document occurs on the source - * document as it appears on the input stream, not on the DOM document as it - * is built in memory. With filters, the document in memory may be a subset - * of the document on the stream, and its validity may have been affected by - * the filtering. - * <p> All default attributes must be present on elements when the elements - * are passed to the filter methods. All other default content must be - * passed to the filter methods. - * <p> DOM applications must not raise exceptions in a filter. The effect of - * throwing exceptions from a filter is DOM implementation dependent. + * entities</a>", unexpanded entity reference nodes are never discarded and are always + * passed to the filter. + * <p> All validity checking while parsing a document occurs on the source + * document as it appears on the input stream, not on the DOM document as it + * is built in memory. With filters, the document in memory may be a subset + * of the document on the stream, and its validity may have been affected by + * the filtering. + * <p> All default attributes must be present on elements when the elements + * are passed to the filter methods. All other default content must be + * passed to the filter methods. + * <p> DOM applications must not raise exceptions in a filter. The effect of + * throwing exceptions from a filter is DOM implementation dependent. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ @@ -56,116 +56,116 @@ public interface LSParserFilter { */ public static final short FILTER_REJECT = 2; /** - * Skip this single node. The children of this node will still be - * considered. + * Skip this single node. The children of this node will still be + * considered. */ public static final short FILTER_SKIP = 3; /** - * Interrupt the normal processing of the document. + * Interrupt the normal processing of the document. */ public static final short FILTER_INTERRUPT = 4; /** - * The parser will call this method after each <code>Element</code> start - * tag has been scanned, but before the remainder of the - * <code>Element</code> is processed. The intent is to allow the - * element, including any children, to be efficiently skipped. Note that - * only element nodes are passed to the <code>startElement</code> - * function. - * <br>The element node passed to <code>startElement</code> for filtering - * will include all of the Element's attributes, but none of the - * children nodes. The Element may not yet be in place in the document - * being constructed (it may not have a parent node.) - * <br>A <code>startElement</code> filter function may access or change - * the attributes for the Element. Changing Namespace declarations will + * The parser will call this method after each <code>Element</code> start + * tag has been scanned, but before the remainder of the + * <code>Element</code> is processed. The intent is to allow the + * element, including any children, to be efficiently skipped. Note that + * only element nodes are passed to the <code>startElement</code> + * function. + * <br>The element node passed to <code>startElement</code> for filtering + * will include all of the Element's attributes, but none of the + * children nodes. The Element may not yet be in place in the document + * being constructed (it may not have a parent node.) + * <br>A <code>startElement</code> filter function may access or change + * the attributes for the Element. Changing Namespace declarations will * have no effect on namespace resolution by the parser. - * <br>For efficiency, the Element node passed to the filter may not be - * the same one as is actually placed in the tree if the node is - * accepted. And the actual node (node object identity) may be reused + * <br>For efficiency, the Element node passed to the filter may not be + * the same one as is actually placed in the tree if the node is + * accepted. And the actual node (node object identity) may be reused * during the process of reading in and filtering a document. - * @param elementArg The newly encountered element. At the time this - * method is called, the element is incomplete - it will have its - * attributes, but no children. - * @return + * @param elementArg The newly encountered element. At the time this + * method is called, the element is incomplete - it will have its + * attributes, but no children. + * @return * <ul> - * <li> <code>FILTER_ACCEPT</code> if the <code>Element</code> should - * be included in the DOM document being built. + * <li> <code>FILTER_ACCEPT</code> if the <code>Element</code> should + * be included in the DOM document being built. * </li> - * <li> - * <code>FILTER_REJECT</code> if the <code>Element</code> and all of - * its children should be rejected. + * <li> + * <code>FILTER_REJECT</code> if the <code>Element</code> and all of + * its children should be rejected. * </li> - * <li> <code>FILTER_SKIP</code> if the - * <code>Element</code> should be skipped. All of its children are - * inserted in place of the skipped <code>Element</code> node. + * <li> <code>FILTER_SKIP</code> if the + * <code>Element</code> should be skipped. All of its children are + * inserted in place of the skipped <code>Element</code> node. * </li> - * <li> - * <code>FILTER_INTERRUPT</code> if the filter wants to stop the - * processing of the document. Interrupting the processing of the - * document does no longer guarantee that the resulting DOM tree is - * XML well-formed. The <code>Element</code> is rejected. + * <li> + * <code>FILTER_INTERRUPT</code> if the filter wants to stop the + * processing of the document. Interrupting the processing of the + * document does no longer guarantee that the resulting DOM tree is + * XML well-formed. The <code>Element</code> is rejected. * </li> - * </ul> Returning - * any other values will result in unspecified behavior. + * </ul> Returning + * any other values will result in unspecified behavior. */ public short startElement(Element elementArg); /** - * This method will be called by the parser at the completion of the - * parsing of each node. The node and all of its descendants will exist - * and be complete. The parent node will also exist, although it may be - * incomplete, i.e. it may have additional children that have not yet + * This method will be called by the parser at the completion of the + * parsing of each node. The node and all of its descendants will exist + * and be complete. The parent node will also exist, although it may be + * incomplete, i.e. it may have additional children that have not yet * been parsed. Attribute nodes are never passed to this function. - * <br>From within this method, the new node may be freely modified - - * children may be added or removed, text nodes modified, etc. The state - * of the rest of the document outside this node is not defined, and the - * affect of any attempt to navigate to, or to modify any other part of - * the document is undefined. - * <br>For validating parsers, the checks are made on the original - * document, before any modification by the filter. No validity checks + * <br>From within this method, the new node may be freely modified - + * children may be added or removed, text nodes modified, etc. The state + * of the rest of the document outside this node is not defined, and the + * affect of any attempt to navigate to, or to modify any other part of + * the document is undefined. + * <br>For validating parsers, the checks are made on the original + * document, before any modification by the filter. No validity checks * are made on any document modifications made by the filter. - * <br>If this new node is rejected, the parser might reuse the new node + * <br>If this new node is rejected, the parser might reuse the new node * and any of its descendants. - * @param nodeArg The newly constructed element. At the time this method - * is called, the element is complete - it has all of its children - * (and their children, recursively) and attributes, and is attached - * as a child to its parent. - * @return + * @param nodeArg The newly constructed element. At the time this method + * is called, the element is complete - it has all of its children + * (and their children, recursively) and attributes, and is attached + * as a child to its parent. + * @return * <ul> - * <li> <code>FILTER_ACCEPT</code> if this <code>Node</code> should - * be included in the DOM document being built. + * <li> <code>FILTER_ACCEPT</code> if this <code>Node</code> should + * be included in the DOM document being built. * </li> - * <li> - * <code>FILTER_REJECT</code> if the <code>Node</code> and all of its - * children should be rejected. + * <li> + * <code>FILTER_REJECT</code> if the <code>Node</code> and all of its + * children should be rejected. * </li> - * <li> <code>FILTER_SKIP</code> if the - * <code>Node</code> should be skipped and the <code>Node</code> - * should be replaced by all the children of the <code>Node</code>. + * <li> <code>FILTER_SKIP</code> if the + * <code>Node</code> should be skipped and the <code>Node</code> + * should be replaced by all the children of the <code>Node</code>. * </li> - * <li> - * <code>FILTER_INTERRUPT</code> if the filter wants to stop the - * processing of the document. Interrupting the processing of the - * document does no longer guarantee that the resulting DOM tree is - * XML well-formed. The <code>Node</code> is accepted and will be the - * last completely parsed node. + * <li> + * <code>FILTER_INTERRUPT</code> if the filter wants to stop the + * processing of the document. Interrupting the processing of the + * document does no longer guarantee that the resulting DOM tree is + * XML well-formed. The <code>Node</code> is accepted and will be the + * last completely parsed node. * </li> * </ul> */ public short acceptNode(Node nodeArg); /** - * Tells the <code>LSParser</code> what types of nodes to show to the - * method <code>LSParserFilter.acceptNode</code>. If a node is not shown - * to the filter using this attribute, it is automatically included in - * the DOM document being built. See <code>NodeFilter</code> for + * Tells the <code>LSParser</code> what types of nodes to show to the + * method <code>LSParserFilter.acceptNode</code>. If a node is not shown + * to the filter using this attribute, it is automatically included in + * the DOM document being built. See <code>NodeFilter</code> for * definition of the constants. The constants <code>SHOW_ATTRIBUTE</code> - * , <code>SHOW_DOCUMENT</code>, <code>SHOW_DOCUMENT_TYPE</code>, - * <code>SHOW_NOTATION</code>, <code>SHOW_ENTITY</code>, and - * <code>SHOW_DOCUMENT_FRAGMENT</code> are meaningless here. Those nodes - * will never be passed to <code>LSParserFilter.acceptNode</code>. + * , <code>SHOW_DOCUMENT</code>, <code>SHOW_DOCUMENT_TYPE</code>, + * <code>SHOW_NOTATION</code>, <code>SHOW_ENTITY</code>, and + * <code>SHOW_DOCUMENT_FRAGMENT</code> are meaningless here. Those nodes + * will never be passed to <code>LSParserFilter.acceptNode</code>. * <br> The constants used here are defined in [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal and Range</a>] - * . + * . */ public int getWhatToShow(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java index da98e14ad5b..adf7b098ceb 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java @@ -15,13 +15,13 @@ package org.w3c.dom.ls; import org.w3c.dom.events.Event; /** - * This interface represents a progress event object that notifies the - * application about progress as a document is parsed. It extends the + * This interface represents a progress event object that notifies the + * application about progress as a document is parsed. It extends the * <code>Event</code> interface defined in [<a href='http://www.w3.org/TR/2003/NOTE-DOM-Level-3-Events-20031107'>DOM Level 3 Events</a>] - * . - * <p> The units used for the attributes <code>position</code> and - * <code>totalSize</code> are not specified and can be implementation and - * input dependent. + * . + * <p> The units used for the attributes <code>position</code> and + * <code>totalSize</code> are not specified and can be implementation and + * input dependent. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ @@ -32,15 +32,15 @@ public interface LSProgressEvent extends Event { public LSInput getInput(); /** - * The current position in the input source, including all external + * The current position in the input source, including all external * entities and other resources that have been read. */ public int getPosition(); /** - * The total size of the document including all external resources, this - * number might change as a document is being parsed if references to - * more external resources are seen. A value of <code>0</code> is + * The total size of the document including all external resources, this + * number might change as a document is being parsed if references to + * more external resources are seen. A value of <code>0</code> is * returned if the total size cannot be determined or estimated. */ public int getTotalSize(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java index c0c523c8a00..5301beb8f13 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java @@ -13,69 +13,69 @@ package org.w3c.dom.ls; /** - * <code>LSResourceResolver</code> provides a way for applications to - * redirect references to external resources. - * <p> Applications needing to implement custom handling for external - * resources can implement this interface and register their implementation - * by setting the "resource-resolver" parameter of - * <code>DOMConfiguration</code> objects attached to <code>LSParser</code> - * and <code>LSSerializer</code>. It can also be register on - * <code>DOMConfiguration</code> objects attached to <code>Document</code> - * if the "LS" feature is supported. - * <p> The <code>LSParser</code> will then allow the application to intercept - * any external entities, including the external DTD subset and external - * parameter entities, before including them. The top-level document entity - * is never passed to the <code>resolveResource</code> method. - * <p> Many DOM applications will not need to implement this interface, but it - * will be especially useful for applications that build XML documents from - * databases or other specialized input sources, or for applications that - * use URNs. - * <p ><b>Note:</b> <code>LSResourceResolver</code> is based on the SAX2 [<a href='http://www.saxproject.org/'>SAX</a>] <code>EntityResolver</code> - * interface. + * <code>LSResourceResolver</code> provides a way for applications to + * redirect references to external resources. + * <p> Applications needing to implement custom handling for external + * resources can implement this interface and register their implementation + * by setting the "resource-resolver" parameter of + * <code>DOMConfiguration</code> objects attached to <code>LSParser</code> + * and <code>LSSerializer</code>. It can also be register on + * <code>DOMConfiguration</code> objects attached to <code>Document</code> + * if the "LS" feature is supported. + * <p> The <code>LSParser</code> will then allow the application to intercept + * any external entities, including the external DTD subset and external + * parameter entities, before including them. The top-level document entity + * is never passed to the <code>resolveResource</code> method. + * <p> Many DOM applications will not need to implement this interface, but it + * will be especially useful for applications that build XML documents from + * databases or other specialized input sources, or for applications that + * use URNs. + * <p ><b>Note:</b> <code>LSResourceResolver</code> is based on the SAX2 [<a href='http://www.saxproject.org/'>SAX</a>] <code>EntityResolver</code> + * interface. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSResourceResolver { /** - * Allow the application to resolve external resources. - * <br> The <code>LSParser</code> will call this method before opening any - * external resource, including the external DTD subset, external - * entities referenced within the DTD, and external entities referenced - * within the document element (however, the top-level document entity - * is not passed to this method). The application may then request that - * the <code>LSParser</code> resolve the external resource itself, that - * it use an alternative URI, or that it use an entirely different input - * source. - * <br> Application writers can use this method to redirect external - * system identifiers to secure and/or local URI, to look up public - * identifiers in a catalogue, or to read an entity from a database or - * other input source (including, for example, a dialog box). - * @param type The type of the resource being resolved. For XML [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] resources - * (i.e. entities), applications must use the value + * Allow the application to resolve external resources. + * <br> The <code>LSParser</code> will call this method before opening any + * external resource, including the external DTD subset, external + * entities referenced within the DTD, and external entities referenced + * within the document element (however, the top-level document entity + * is not passed to this method). The application may then request that + * the <code>LSParser</code> resolve the external resource itself, that + * it use an alternative URI, or that it use an entirely different input + * source. + * <br> Application writers can use this method to redirect external + * system identifiers to secure and/or local URI, to look up public + * identifiers in a catalogue, or to read an entity from a database or + * other input source (including, for example, a dialog box). + * @param type The type of the resource being resolved. For XML [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>] resources + * (i.e. entities), applications must use the value * <code>"http://www.w3.org/TR/REC-xml"</code>. For XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * , applications must use the value - * <code>"http://www.w3.org/2001/XMLSchema"</code>. Other types of - * resources are outside the scope of this specification and therefore - * should recommend an absolute URI in order to use this method. - * @param namespaceURI The namespace of the resource being resolved, + * , applications must use the value + * <code>"http://www.w3.org/2001/XMLSchema"</code>. Other types of + * resources are outside the scope of this specification and therefore + * should recommend an absolute URI in order to use this method. + * @param namespaceURI The namespace of the resource being resolved, * e.g. the target namespace of the XML Schema [<a href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/'>XML Schema Part 1</a>] - * when resolving XML Schema resources. - * @param publicId The public identifier of the external entity being - * referenced, or <code>null</code> if no public identifier was - * supplied or if the resource is not an entity. - * @param systemId The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], of the - * external resource being referenced, or <code>null</code> if no - * system identifier was supplied. - * @param baseURI The absolute base URI of the resource being parsed, or - * <code>null</code> if there is no base URI. - * @return A <code>LSInput</code> object describing the new input - * source, or <code>null</code> to request that the parser open a - * regular URI connection to the resource. + * when resolving XML Schema resources. + * @param publicId The public identifier of the external entity being + * referenced, or <code>null</code> if no public identifier was + * supplied or if the resource is not an entity. + * @param systemId The system identifier, a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>], of the + * external resource being referenced, or <code>null</code> if no + * system identifier was supplied. + * @param baseURI The absolute base URI of the resource being parsed, or + * <code>null</code> if there is no base URI. + * @return A <code>LSInput</code> object describing the new input + * source, or <code>null</code> to request that the parser open a + * regular URI connection to the resource. */ - public LSInput resolveResource(String type, - String namespaceURI, - String publicId, - String systemId, + public LSInput resolveResource(String type, + String namespaceURI, + String publicId, + String systemId, String baseURI); } diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializer.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializer.java index e7b6350d304..2a6fb6ff475 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializer.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializer.java @@ -17,187 +17,187 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * A <code>LSSerializer</code> provides an API for serializing (writing) a - * DOM document out into XML. The XML data is written to a string or an - * output stream. Any changes or fixups made during the serialization affect - * only the serialized data. The <code>Document</code> object and its - * children are never altered by the serialization operation. + * A <code>LSSerializer</code> provides an API for serializing (writing) a + * DOM document out into XML. The XML data is written to a string or an + * output stream. Any changes or fixups made during the serialization affect + * only the serialized data. The <code>Document</code> object and its + * children are never altered by the serialization operation. * <p> During serialization of XML data, namespace fixup is done as defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] * , Appendix B. [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>DOM Level 2 Core</a>] - * allows empty strings as a real namespace URI. If the - * <code>namespaceURI</code> of a <code>Node</code> is empty string, the - * serialization will treat them as <code>null</code>, ignoring the prefix - * if any. - * <p> <code>LSSerializer</code> accepts any node type for serialization. For - * nodes of type <code>Document</code> or <code>Entity</code>, well-formed - * XML will be created when possible (well-formedness is guaranteed if the - * document or entity comes from a parse operation and is unchanged since it - * was created). The serialized output for these node types is either as a - * XML document or an External XML Entity, respectively, and is acceptable - * input for an XML parser. For all other types of nodes the serialized form - * is implementation dependent. - * <p>Within a <code>Document</code>, <code>DocumentFragment</code>, or - * <code>Entity</code> being serialized, <code>Nodes</code> are processed as + * allows empty strings as a real namespace URI. If the + * <code>namespaceURI</code> of a <code>Node</code> is empty string, the + * serialization will treat them as <code>null</code>, ignoring the prefix + * if any. + * <p> <code>LSSerializer</code> accepts any node type for serialization. For + * nodes of type <code>Document</code> or <code>Entity</code>, well-formed + * XML will be created when possible (well-formedness is guaranteed if the + * document or entity comes from a parse operation and is unchanged since it + * was created). The serialized output for these node types is either as a + * XML document or an External XML Entity, respectively, and is acceptable + * input for an XML parser. For all other types of nodes the serialized form + * is implementation dependent. + * <p>Within a <code>Document</code>, <code>DocumentFragment</code>, or + * <code>Entity</code> being serialized, <code>Nodes</code> are processed as * follows * <ul> - * <li> <code>Document</code> nodes are written, including the XML - * declaration (unless the parameter "xml-declaration" is set to - * <code>false</code>) and a DTD subset, if one exists in the DOM. Writing a - * <code>Document</code> node serializes the entire document. + * <li> <code>Document</code> nodes are written, including the XML + * declaration (unless the parameter "xml-declaration" is set to + * <code>false</code>) and a DTD subset, if one exists in the DOM. Writing a + * <code>Document</code> node serializes the entire document. * </li> - * <li> - * <code>Entity</code> nodes, when written directly by - * <code>LSSerializer.write</code>, outputs the entity expansion but no - * namespace fixup is done. The resulting output will be valid as an - * external entity. + * <li> + * <code>Entity</code> nodes, when written directly by + * <code>LSSerializer.write</code>, outputs the entity expansion but no + * namespace fixup is done. The resulting output will be valid as an + * external entity. * </li> * <li> If the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> - * entities</a>" is set to <code>true</code>, <code>EntityReference</code> nodes are + * entities</a>" is set to <code>true</code>, <code>EntityReference</code> nodes are * serialized as an entity reference of the form " - * <code>&entityName;</code>" in the output. Child nodes (the expansion) + * <code>&entityName;</code>" in the output. Child nodes (the expansion) * of the entity reference are ignored. If the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> - * entities</a>" is set to <code>false</code>, only the children of the entity reference - * are serialized. <code>EntityReference</code> nodes with no children (no - * corresponding <code>Entity</code> node or the corresponding - * <code>Entity</code> nodes have no children) are always serialized. + * entities</a>" is set to <code>false</code>, only the children of the entity reference + * are serialized. <code>EntityReference</code> nodes with no children (no + * corresponding <code>Entity</code> node or the corresponding + * <code>Entity</code> nodes have no children) are always serialized. * </li> - * <li> - * <code>CDATAsections</code> containing content characters that cannot be - * represented in the specified output encoding are handled according to the + * <li> + * <code>CDATAsections</code> containing content characters that cannot be + * represented in the specified output encoding are handled according to the * "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-split-cdata-sections'> - * split-cdata-sections</a>" parameter. If the parameter is set to <code>true</code>, - * <code>CDATAsections</code> are split, and the unrepresentable characters - * are serialized as numeric character references in ordinary content. The - * exact position and number of splits is not specified. If the parameter - * is set to <code>false</code>, unrepresentable characters in a - * <code>CDATAsection</code> are reported as + * split-cdata-sections</a>" parameter. If the parameter is set to <code>true</code>, + * <code>CDATAsections</code> are split, and the unrepresentable characters + * are serialized as numeric character references in ordinary content. The + * exact position and number of splits is not specified. If the parameter + * is set to <code>false</code>, unrepresentable characters in a + * <code>CDATAsection</code> are reported as * <code>"wf-invalid-character"</code> errors if the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-well-formed'> - * well-formed</a>" is set to <code>true</code>. The error is not recoverable - there is no - * mechanism for supplying alternative characters and continuing with the - * serialization. + * well-formed</a>" is set to <code>true</code>. The error is not recoverable - there is no + * mechanism for supplying alternative characters and continuing with the + * serialization. * </li> - * <li> <code>DocumentFragment</code> nodes are serialized by - * serializing the children of the document fragment in the order they - * appear in the document fragment. + * <li> <code>DocumentFragment</code> nodes are serialized by + * serializing the children of the document fragment in the order they + * appear in the document fragment. * </li> - * <li> All other node types (Element, Text, - * etc.) are serialized to their corresponding XML source form. + * <li> All other node types (Element, Text, + * etc.) are serialized to their corresponding XML source form. * </li> * </ul> - * <p ><b>Note:</b> The serialization of a <code>Node</code> does not always - * generate a well-formed XML document, i.e. a <code>LSParser</code> might - * throw fatal errors when parsing the resulting serialization. - * <p> Within the character data of a document (outside of markup), any - * characters that cannot be represented directly are replaced with - * character references. Occurrences of '<' and '&' are replaced by - * the predefined entities &lt; and &amp;. The other predefined - * entities (&gt;, &apos;, and &quot;) might not be used, except - * where needed (e.g. using &gt; in cases such as ']]>'). Any - * characters that cannot be represented directly in the output character - * encoding are serialized as numeric character references (and since - * character encoding standards commonly use hexadecimal representations of - * characters, using the hexadecimal representation when serializing - * character references is encouraged). - * <p> To allow attribute values to contain both single and double quotes, the - * apostrophe or single-quote character (') may be represented as - * "&apos;", and the double-quote character (") as "&quot;". New - * line characters and other characters that cannot be represented directly - * in attribute values in the output character encoding are serialized as a - * numeric character reference. - * <p> Within markup, but outside of attributes, any occurrence of a character - * that cannot be represented in the output character encoding is reported - * as a <code>DOMError</code> fatal error. An example would be serializing - * the element <LaCa\u00f1ada/> with <code>encoding="us-ascii"</code>. - * This will result with a generation of a <code>DOMError</code> + * <p ><b>Note:</b> The serialization of a <code>Node</code> does not always + * generate a well-formed XML document, i.e. a <code>LSParser</code> might + * throw fatal errors when parsing the resulting serialization. + * <p> Within the character data of a document (outside of markup), any + * characters that cannot be represented directly are replaced with + * character references. Occurrences of '<' and '&' are replaced by + * the predefined entities &lt; and &amp;. The other predefined + * entities (&gt;, &apos;, and &quot;) might not be used, except + * where needed (e.g. using &gt; in cases such as ']]>'). Any + * characters that cannot be represented directly in the output character + * encoding are serialized as numeric character references (and since + * character encoding standards commonly use hexadecimal representations of + * characters, using the hexadecimal representation when serializing + * character references is encouraged). + * <p> To allow attribute values to contain both single and double quotes, the + * apostrophe or single-quote character (') may be represented as + * "&apos;", and the double-quote character (") as "&quot;". New + * line characters and other characters that cannot be represented directly + * in attribute values in the output character encoding are serialized as a + * numeric character reference. + * <p> Within markup, but outside of attributes, any occurrence of a character + * that cannot be represented in the output character encoding is reported + * as a <code>DOMError</code> fatal error. An example would be serializing + * the element <LaCa\u00f1ada/> with <code>encoding="us-ascii"</code>. + * This will result with a generation of a <code>DOMError</code> * "wf-invalid-character-in-node-name" (as proposed in "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-well-formed'> - * well-formed</a>"). + * well-formed</a>"). * <p> When requested by setting the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-normalize-characters'> - * normalize-characters</a>" on <code>LSSerializer</code> to true, character normalization is - * performed according to the definition of <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully - * normalized</a> characters included in appendix E of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] on all - * data to be serialized, both markup and character data. The character - * normalization process affects only the data as it is being written; it - * does not alter the DOM's view of the document after serialization has - * completed. - * <p> Implementations are required to support the encodings "UTF-8", - * "UTF-16", "UTF-16BE", and "UTF-16LE" to guarantee that data is - * serializable in all encodings that are required to be supported by all - * XML parsers. When the encoding is UTF-8, whether or not a byte order mark - * is serialized, or if the output is big-endian or little-endian, is - * implementation dependent. When the encoding is UTF-16, whether or not the - * output is big-endian or little-endian is implementation dependent, but a - * Byte Order Mark must be generated for non-character outputs, such as - * <code>LSOutput.byteStream</code> or <code>LSOutput.systemId</code>. If - * the Byte Order Mark is not generated, a "byte-order-mark-needed" warning - * is reported. When the encoding is UTF-16LE or UTF-16BE, the output is - * big-endian (UTF-16BE) or little-endian (UTF-16LE) and the Byte Order Mark - * is not be generated. In all cases, the encoding declaration, if - * generated, will correspond to the encoding used during the serialization - * (e.g. <code>encoding="UTF-16"</code> will appear if UTF-16 was - * requested). - * <p> Namespaces are fixed up during serialization, the serialization process - * will verify that namespace declarations, namespace prefixes and the - * namespace URI associated with elements and attributes are consistent. If - * inconsistencies are found, the serialized form of the document will be - * altered to remove them. The method used for doing the namespace fixup - * while serializing a document is the algorithm defined in Appendix B.1, + * normalize-characters</a>" on <code>LSSerializer</code> to true, character normalization is + * performed according to the definition of <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully + * normalized</a> characters included in appendix E of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] on all + * data to be serialized, both markup and character data. The character + * normalization process affects only the data as it is being written; it + * does not alter the DOM's view of the document after serialization has + * completed. + * <p> Implementations are required to support the encodings "UTF-8", + * "UTF-16", "UTF-16BE", and "UTF-16LE" to guarantee that data is + * serializable in all encodings that are required to be supported by all + * XML parsers. When the encoding is UTF-8, whether or not a byte order mark + * is serialized, or if the output is big-endian or little-endian, is + * implementation dependent. When the encoding is UTF-16, whether or not the + * output is big-endian or little-endian is implementation dependent, but a + * Byte Order Mark must be generated for non-character outputs, such as + * <code>LSOutput.byteStream</code> or <code>LSOutput.systemId</code>. If + * the Byte Order Mark is not generated, a "byte-order-mark-needed" warning + * is reported. When the encoding is UTF-16LE or UTF-16BE, the output is + * big-endian (UTF-16BE) or little-endian (UTF-16LE) and the Byte Order Mark + * is not be generated. In all cases, the encoding declaration, if + * generated, will correspond to the encoding used during the serialization + * (e.g. <code>encoding="UTF-16"</code> will appear if UTF-16 was + * requested). + * <p> Namespaces are fixed up during serialization, the serialization process + * will verify that namespace declarations, namespace prefixes and the + * namespace URI associated with elements and attributes are consistent. If + * inconsistencies are found, the serialized form of the document will be + * altered to remove them. The method used for doing the namespace fixup + * while serializing a document is the algorithm defined in Appendix B.1, * "Namespace normalization", of [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * . - * <p> While serializing a document, the parameter "discard-default-content" - * controls whether or not non-specified data is serialized. - * <p> While serializing, errors and warnings are reported to the application + * . + * <p> While serializing a document, the parameter "discard-default-content" + * controls whether or not non-specified data is serialized. + * <p> While serializing, errors and warnings are reported to the application * through the error handler (<code>LSSerializer.domConfig</code>'s "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" parameter). This specification does in no way try to define all possible - * errors and warnings that can occur while serializing a DOM node, but some + * error-handler</a>" parameter). This specification does in no way try to define all possible + * errors and warnings that can occur while serializing a DOM node, but some * common error and warning cases are defined. The types ( - * <code>DOMError.type</code>) of errors and warnings defined by this - * specification are: + * <code>DOMError.type</code>) of errors and warnings defined by this + * specification are: * <dl> * <dt><code>"no-output-specified" [fatal]</code></dt> - * <dd> Raised when - * writing to a <code>LSOutput</code> if no output is specified in the + * <dd> Raised when + * writing to a <code>LSOutput</code> if no output is specified in the * <code>LSOutput</code>. </dd> - * <dt> + * <dt> * <code>"unbound-prefix-in-entity-reference" [fatal]</code> </dt> - * <dd> Raised if the + * <dd> Raised if the * configuration parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-namespaces'> - * namespaces</a>" is set to <code>true</code> and an entity whose replacement text - * contains unbound namespace prefixes is referenced in a location where + * namespaces</a>" is set to <code>true</code> and an entity whose replacement text + * contains unbound namespace prefixes is referenced in a location where * there are no bindings for the namespace prefixes. </dd> * <dt> * <code>"unsupported-encoding" [fatal]</code></dt> - * <dd> Raised if an unsupported + * <dd> Raised if an unsupported * encoding is encountered. </dd> - * </dl> - * <p> In addition to raising the defined errors and warnings, implementations - * are expected to raise implementation specific errors and warnings for any - * other error and warning cases such as IO errors (file not found, - * permission denied,...) and so on. + * </dl> + * <p> In addition to raising the defined errors and warnings, implementations + * are expected to raise implementation specific errors and warnings for any + * other error and warning cases such as IO errors (file not found, + * permission denied,...) and so on. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSSerializer { /** - * The <code>DOMConfiguration</code> object used by the - * <code>LSSerializer</code> when serializing a DOM node. + * The <code>DOMConfiguration</code> object used by the + * <code>LSSerializer</code> when serializing a DOM node. * <br> In addition to the parameters recognized by the <a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMConfiguration'> * DOMConfiguration</a> interface defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , the <code>DOMConfiguration</code> objects for - * <code>LSSerializer</code> adds, or modifies, the following - * parameters: + * , the <code>DOMConfiguration</code> objects for + * <code>LSSerializer</code> adds, or modifies, the following + * parameters: * <dl> * <dt><code>"canonical-form"</code></dt> * <dd> * <dl> * <dt><code>true</code></dt> - * <dd>[<em>optional</em>] Writes the document according to the rules specified in [<a href='http://www.w3.org/TR/2001/REC-xml-c14n-20010315'>Canonical XML</a>]. + * <dd>[<em>optional</em>] Writes the document according to the rules specified in [<a href='http://www.w3.org/TR/2001/REC-xml-c14n-20010315'>Canonical XML</a>]. * In addition to the behavior described in "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-canonical-form'> * canonical-form</a>" [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * , setting this parameter to <code>true</code> will set the parameters + * , setting this parameter to <code>true</code> will set the parameters * "format-pretty-print", "discard-default-content", and "xml-declaration - * ", to <code>false</code>. Setting one of those parameters to - * <code>true</code> will set this parameter to <code>false</code>. - * Serializing an XML 1.1 document when "canonical-form" is + * ", to <code>false</code>. Setting one of those parameters to + * <code>true</code> will set this parameter to <code>false</code>. + * Serializing an XML 1.1 document when "canonical-form" is * <code>true</code> will generate a fatal error. </dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>) Do not canonicalize the output. </dd> @@ -207,11 +207,11 @@ public interface LSSerializer { * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) Use the <code>Attr.specified</code> attribute to decide what attributes - * should be discarded. Note that some implementations might use - * whatever information available to the implementation (i.e. XML - * schema, DTD, the <code>Attr.specified</code> attribute, and so on) to - * determine what attributes and content to discard if this parameter is + * <dd>[<em>required</em>] (<em>default</em>) Use the <code>Attr.specified</code> attribute to decide what attributes + * should be discarded. Note that some implementations might use + * whatever information available to the implementation (i.e. XML + * schema, DTD, the <code>Attr.specified</code> attribute, and so on) to + * determine what attributes and content to discard if this parameter is * set to <code>true</code>. </dd> * <dt><code>false</code></dt> * <dd>[<em>required</em>]Keep all attributes and all content.</dd> @@ -221,40 +221,40 @@ public interface LSSerializer { * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>optional</em>] Formatting the output by adding whitespace to produce a pretty-printed, - * indented, human-readable form. The exact form of the transformations - * is not specified by this specification. Pretty-printing changes the - * content of the document and may affect the validity of the document, + * <dd>[<em>optional</em>] Formatting the output by adding whitespace to produce a pretty-printed, + * indented, human-readable form. The exact form of the transformations + * is not specified by this specification. Pretty-printing changes the + * content of the document and may affect the validity of the document, * validating implementations should preserve validity. </dd> * <dt> * <code>false</code></dt> * <dd>[<em>required</em>] (<em>default</em>) Don't pretty-print the result. </dd> * </dl></dd> - * <dt> + * <dt> * <code>"ignore-unknown-character-denormalizations"</code> </dt> * <dd> * <dl> * <dt> * <code>true</code></dt> - * <dd>[<em>required</em>] (<em>default</em>) If, while verifying full normalization when [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] is - * supported, a character is encountered for which the normalization - * properties cannot be determined, then raise a - * <code>"unknown-character-denormalization"</code> warning (instead of - * raising an error, if this parameter is not set) and ignore any + * <dd>[<em>required</em>] (<em>default</em>) If, while verifying full normalization when [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] is + * supported, a character is encountered for which the normalization + * properties cannot be determined, then raise a + * <code>"unknown-character-denormalization"</code> warning (instead of + * raising an error, if this parameter is not set) and ignore any * possible denormalizations caused by these characters. </dd> * <dt> * <code>false</code></dt> - * <dd>[<em>optional</em>] Report a fatal error if a character is encountered for which the + * <dd>[<em>optional</em>] Report a fatal error if a character is encountered for which the * processor cannot determine the normalization properties. </dd> * </dl></dd> * <dt> * <code>"normalize-characters"</code></dt> - * <dd> This parameter is equivalent to + * <dd> This parameter is equivalent to * the one defined by <code>DOMConfiguration</code> in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] - * . Unlike in the Core, the default value for this parameter is - * <code>true</code>. While DOM implementations are not required to - * support <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully - * normalizing</a> the characters in the document according to appendix E of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], this + * . Unlike in the Core, the default value for this parameter is + * <code>true</code>. While DOM implementations are not required to + * support <a href='http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm'>fully + * normalizing</a> the characters in the document according to appendix E of [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], this * parameter must be activated by default if supported. </dd> * <dt> * <code>"xml-declaration"</code></dt> @@ -262,17 +262,17 @@ public interface LSSerializer { * <dl> * <dt><code>true</code></dt> * <dd>[<em>required</em>] (<em>default</em>) If a <code>Document</code>, <code>Element</code>, or <code>Entity</code> - * node is serialized, the XML declaration, or text declaration, should - * be included. The version (<code>Document.xmlVersion</code> if the - * document is a Level 3 document and the version is non-null, otherwise - * use the value "1.0"), and the output encoding (see - * <code>LSSerializer.write</code> for details on how to find the output + * node is serialized, the XML declaration, or text declaration, should + * be included. The version (<code>Document.xmlVersion</code> if the + * document is a Level 3 document and the version is non-null, otherwise + * use the value "1.0"), and the output encoding (see + * <code>LSSerializer.write</code> for details on how to find the output * encoding) are specified in the serialized XML declaration. </dd> * <dt> * <code>false</code></dt> - * <dd>[<em>required</em>] Do not serialize the XML and text declarations. Report a - * <code>"xml-declaration-needed"</code> warning if this will cause - * problems (i.e. the serialized data is of an XML version other than [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], or an + * <dd>[<em>required</em>] Do not serialize the XML and text declarations. Report a + * <code>"xml-declaration-needed"</code> warning if this will cause + * problems (i.e. the serialized data is of an XML version other than [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], or an * encoding would be needed to be able to re-parse the serialized data). </dd> * </dl></dd> * </dl> @@ -280,155 +280,155 @@ public interface LSSerializer { public DOMConfiguration getDomConfig(); /** - * The end-of-line sequence of characters to be used in the XML being - * written out. Any string is supported, but XML treats only a certain - * set of characters sequence as end-of-line (See section 2.11, - * "End-of-Line Handling" in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], if the - * serialized content is XML 1.0 or section 2.11, "End-of-Line Handling" - * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], if the - * serialized content is XML 1.1). Using other character sequences than - * the recommended ones can result in a document that is either not - * serializable or not well-formed). - * <br> On retrieval, the default value of this attribute is the - * implementation specific default end-of-line sequence. DOM - * implementations should choose the default to match the usual - * convention for text files in the environment being used. - * Implementations must choose a default sequence that matches one of - * those allowed by XML 1.0 or XML 1.1, depending on the serialized - * content. Setting this attribute to <code>null</code> will reset its - * value to the default value. - * <br> + * The end-of-line sequence of characters to be used in the XML being + * written out. Any string is supported, but XML treats only a certain + * set of characters sequence as end-of-line (See section 2.11, + * "End-of-Line Handling" in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], if the + * serialized content is XML 1.0 or section 2.11, "End-of-Line Handling" + * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], if the + * serialized content is XML 1.1). Using other character sequences than + * the recommended ones can result in a document that is either not + * serializable or not well-formed). + * <br> On retrieval, the default value of this attribute is the + * implementation specific default end-of-line sequence. DOM + * implementations should choose the default to match the usual + * convention for text files in the environment being used. + * Implementations must choose a default sequence that matches one of + * those allowed by XML 1.0 or XML 1.1, depending on the serialized + * content. Setting this attribute to <code>null</code> will reset its + * value to the default value. + * <br> */ public String getNewLine(); /** - * The end-of-line sequence of characters to be used in the XML being - * written out. Any string is supported, but XML treats only a certain - * set of characters sequence as end-of-line (See section 2.11, - * "End-of-Line Handling" in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], if the - * serialized content is XML 1.0 or section 2.11, "End-of-Line Handling" - * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], if the - * serialized content is XML 1.1). Using other character sequences than - * the recommended ones can result in a document that is either not - * serializable or not well-formed). - * <br> On retrieval, the default value of this attribute is the - * implementation specific default end-of-line sequence. DOM - * implementations should choose the default to match the usual - * convention for text files in the environment being used. - * Implementations must choose a default sequence that matches one of - * those allowed by XML 1.0 or XML 1.1, depending on the serialized - * content. Setting this attribute to <code>null</code> will reset its - * value to the default value. - * <br> + * The end-of-line sequence of characters to be used in the XML being + * written out. Any string is supported, but XML treats only a certain + * set of characters sequence as end-of-line (See section 2.11, + * "End-of-Line Handling" in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>], if the + * serialized content is XML 1.0 or section 2.11, "End-of-Line Handling" + * in [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>], if the + * serialized content is XML 1.1). Using other character sequences than + * the recommended ones can result in a document that is either not + * serializable or not well-formed). + * <br> On retrieval, the default value of this attribute is the + * implementation specific default end-of-line sequence. DOM + * implementations should choose the default to match the usual + * convention for text files in the environment being used. + * Implementations must choose a default sequence that matches one of + * those allowed by XML 1.0 or XML 1.1, depending on the serialized + * content. Setting this attribute to <code>null</code> will reset its + * value to the default value. + * <br> */ public void setNewLine(String newLine); /** - * When the application provides a filter, the serializer will call out - * to the filter before serializing each Node. The filter implementation - * can choose to remove the node from the stream or to terminate the - * serialization early. - * <br> The filter is invoked after the operations requested by the - * <code>DOMConfiguration</code> parameters have been applied. For + * When the application provides a filter, the serializer will call out + * to the filter before serializing each Node. The filter implementation + * can choose to remove the node from the stream or to terminate the + * serialization early. + * <br> The filter is invoked after the operations requested by the + * <code>DOMConfiguration</code> parameters have been applied. For * example, CDATA sections won't be passed to the filter if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-cdata-sections'> - * cdata-sections</a>" is set to <code>false</code>. + * cdata-sections</a>" is set to <code>false</code>. */ public LSSerializerFilter getFilter(); /** - * When the application provides a filter, the serializer will call out - * to the filter before serializing each Node. The filter implementation - * can choose to remove the node from the stream or to terminate the - * serialization early. - * <br> The filter is invoked after the operations requested by the - * <code>DOMConfiguration</code> parameters have been applied. For + * When the application provides a filter, the serializer will call out + * to the filter before serializing each Node. The filter implementation + * can choose to remove the node from the stream or to terminate the + * serialization early. + * <br> The filter is invoked after the operations requested by the + * <code>DOMConfiguration</code> parameters have been applied. For * example, CDATA sections won't be passed to the filter if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-cdata-sections'> - * cdata-sections</a>" is set to <code>false</code>. + * cdata-sections</a>" is set to <code>false</code>. */ public void setFilter(LSSerializerFilter filter); /** - * Serialize the specified node as described above in the general - * description of the <code>LSSerializer</code> interface. The output is - * written to the supplied <code>LSOutput</code>. - * <br> When writing to a <code>LSOutput</code>, the encoding is found by - * looking at the encoding information that is reachable through the - * <code>LSOutput</code> and the item to be written (or its owner - * document) in this order: + * Serialize the specified node as described above in the general + * description of the <code>LSSerializer</code> interface. The output is + * written to the supplied <code>LSOutput</code>. + * <br> When writing to a <code>LSOutput</code>, the encoding is found by + * looking at the encoding information that is reachable through the + * <code>LSOutput</code> and the item to be written (or its owner + * document) in this order: * <ol> - * <li> <code>LSOutput.encoding</code>, + * <li> <code>LSOutput.encoding</code>, * </li> - * <li> - * <code>Document.inputEncoding</code>, + * <li> + * <code>Document.inputEncoding</code>, * </li> - * <li> - * <code>Document.xmlEncoding</code>. + * <li> + * <code>Document.xmlEncoding</code>. * </li> * </ol> - * <br> If no encoding is reachable through the above properties, a - * default encoding of "UTF-8" will be used. If the specified encoding - * is not supported an "unsupported-encoding" fatal error is raised. - * <br> If no output is specified in the <code>LSOutput</code>, a - * "no-output-specified" fatal error is raised. - * <br> The implementation is responsible of associating the appropriate - * media type with the serialized data. - * <br> When writing to a HTTP URI, a HTTP PUT is performed. When writing - * to other types of URIs, the mechanism for writing the data to the URI - * is implementation dependent. - * @param nodeArg The node to serialize. + * <br> If no encoding is reachable through the above properties, a + * default encoding of "UTF-8" will be used. If the specified encoding + * is not supported an "unsupported-encoding" fatal error is raised. + * <br> If no output is specified in the <code>LSOutput</code>, a + * "no-output-specified" fatal error is raised. + * <br> The implementation is responsible of associating the appropriate + * media type with the serialized data. + * <br> When writing to a HTTP URI, a HTTP PUT is performed. When writing + * to other types of URIs, the mechanism for writing the data to the URI + * is implementation dependent. + * @param nodeArg The node to serialize. * @param destination The destination for the serialized DOM. - * @return Returns <code>true</code> if <code>node</code> was - * successfully serialized. Return <code>false</code> in case the - * normal processing stopped but the implementation kept serializing - * the document; the result of the serialization being implementation - * dependent then. + * @return Returns <code>true</code> if <code>node</code> was + * successfully serialized. Return <code>false</code> in case the + * normal processing stopped but the implementation kept serializing + * the document; the result of the serialization being implementation + * dependent then. * @exception LSException - * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to - * serialize the node. DOM applications should attach a + * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to + * serialize the node. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ - public boolean write(Node nodeArg, + public boolean write(Node nodeArg, LSOutput destination) throws LSException; /** - * A convenience method that acts as if <code>LSSerializer.write</code> - * was called with a <code>LSOutput</code> with no encoding specified - * and <code>LSOutput.systemId</code> set to the <code>uri</code> - * argument. - * @param nodeArg The node to serialize. + * A convenience method that acts as if <code>LSSerializer.write</code> + * was called with a <code>LSOutput</code> with no encoding specified + * and <code>LSOutput.systemId</code> set to the <code>uri</code> + * argument. + * @param nodeArg The node to serialize. * @param uri The URI to write to. - * @return Returns <code>true</code> if <code>node</code> was - * successfully serialized. Return <code>false</code> in case the - * normal processing stopped but the implementation kept serializing - * the document; the result of the serialization being implementation - * dependent then. + * @return Returns <code>true</code> if <code>node</code> was + * successfully serialized. Return <code>false</code> in case the + * normal processing stopped but the implementation kept serializing + * the document; the result of the serialization being implementation + * dependent then. * @exception LSException - * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to - * serialize the node. DOM applications should attach a + * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to + * serialize the node. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ - public boolean writeToURI(Node nodeArg, + public boolean writeToURI(Node nodeArg, String uri) throws LSException; /** - * Serialize the specified node as described above in the general - * description of the <code>LSSerializer</code> interface. The output is - * written to a <code>DOMString</code> that is returned to the caller. - * The encoding used is the encoding of the <code>DOMString</code> type, - * i.e. UTF-16. Note that no Byte Order Mark is generated in a - * <code>DOMString</code> object. - * @param nodeArg The node to serialize. - * @return Returns the serialized data. + * Serialize the specified node as described above in the general + * description of the <code>LSSerializer</code> interface. The output is + * written to a <code>DOMString</code> that is returned to the caller. + * The encoding used is the encoding of the <code>DOMString</code> type, + * i.e. UTF-16. Note that no Byte Order Mark is generated in a + * <code>DOMString</code> object. + * @param nodeArg The node to serialize. + * @return Returns the serialized data. * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised if the resulting string is too long to - * fit in a <code>DOMString</code>. + * DOMSTRING_SIZE_ERR: Raised if the resulting string is too long to + * fit in a <code>DOMString</code>. * @exception LSException - * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to - * serialize the node. DOM applications should attach a + * SERIALIZE_ERR: Raised if the <code>LSSerializer</code> was unable to + * serialize the node. DOM applications should attach a * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> - * error-handler</a>" if they wish to get details on the error. + * error-handler</a>" if they wish to get details on the error. */ public String writeToString(Node nodeArg) throws DOMException, LSException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java index 049459c6417..b046556775e 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java @@ -15,48 +15,48 @@ package org.w3c.dom.ls; import org.w3c.dom.traversal.NodeFilter; /** - * <code>LSSerializerFilter</code>s provide applications the ability to - * examine nodes as they are being serialized and decide what nodes should - * be serialized or not. The <code>LSSerializerFilter</code> interface is + * <code>LSSerializerFilter</code>s provide applications the ability to + * examine nodes as they are being serialized and decide what nodes should + * be serialized or not. The <code>LSSerializerFilter</code> interface is * based on the <code>NodeFilter</code> interface defined in [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal and Range</a>] - * . - * <p> <code>Document</code>, <code>DocumentType</code>, + * . + * <p> <code>Document</code>, <code>DocumentType</code>, * <code>DocumentFragment</code>, <code>Notation</code>, <code>Entity</code> - * , and children of <code>Attr</code> nodes are not passed to the filter. - * The child nodes of an <code>EntityReference</code> node are only passed - * to the filter if the <code>EntityReference</code> node is skipped by the - * method <code>LSParserFilter.acceptNode()</code>. - * <p> When serializing an <code>Element</code>, the element is passed to the - * filter before any of its attributes are passed to the filter. Namespace + * , and children of <code>Attr</code> nodes are not passed to the filter. + * The child nodes of an <code>EntityReference</code> node are only passed + * to the filter if the <code>EntityReference</code> node is skipped by the + * method <code>LSParserFilter.acceptNode()</code>. + * <p> When serializing an <code>Element</code>, the element is passed to the + * filter before any of its attributes are passed to the filter. Namespace * declaration attributes, and default attributes (except in the case when " - * discard-default-content" is set to <code>false</code>), are never passed - * to the filter. - * <p> The result of any attempt to modify a node passed to a - * <code>LSSerializerFilter</code> is implementation dependent. - * <p> DOM applications must not raise exceptions in a filter. The effect of - * throwing exceptions from a filter is DOM implementation dependent. - * <p> For efficiency, a node passed to the filter may not be the same as the - * one that is actually in the tree. And the actual node (node object - * identity) may be reused during the process of filtering and serializing a - * document. + * discard-default-content" is set to <code>false</code>), are never passed + * to the filter. + * <p> The result of any attempt to modify a node passed to a + * <code>LSSerializerFilter</code> is implementation dependent. + * <p> DOM applications must not raise exceptions in a filter. The effect of + * throwing exceptions from a filter is DOM implementation dependent. + * <p> For efficiency, a node passed to the filter may not be the same as the + * one that is actually in the tree. And the actual node (node object + * identity) may be reused during the process of filtering and serializing a + * document. * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load and Save Specification</a>. */ public interface LSSerializerFilter extends NodeFilter { /** - * Tells the <code>LSSerializer</code> what types of nodes to show to the - * filter. If a node is not shown to the filter using this attribute, it - * is automatically serialized. See <code>NodeFilter</code> for + * Tells the <code>LSSerializer</code> what types of nodes to show to the + * filter. If a node is not shown to the filter using this attribute, it + * is automatically serialized. See <code>NodeFilter</code> for * definition of the constants. The constants <code>SHOW_DOCUMENT</code> * , <code>SHOW_DOCUMENT_TYPE</code>, <code>SHOW_DOCUMENT_FRAGMENT</code> - * , <code>SHOW_NOTATION</code>, and <code>SHOW_ENTITY</code> are - * meaningless here, such nodes will never be passed to a - * <code>LSSerializerFilter</code>. + * , <code>SHOW_NOTATION</code>, and <code>SHOW_ENTITY</code> are + * meaningless here, such nodes will never be passed to a + * <code>LSSerializerFilter</code>. * <br> Unlike [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal and Range</a>] - * , the <code>SHOW_ATTRIBUTE</code> constant indicates that the - * <code>Attr</code> nodes are shown and passed to the filter. + * , the <code>SHOW_ATTRIBUTE</code> constant indicates that the + * <code>Attr</code> nodes are shown and passed to the filter. * <br> The constants used here are defined in [<a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>DOM Level 2 Traversal and Range</a>] - * . + * . */ public int getWhatToShow(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java index 6b522670e20..de56e07d629 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java @@ -18,14 +18,14 @@ package org.w3c.dom.ranges; */ public interface DocumentRange { /** - * This interface can be obtained from the object implementing the - * <code>Document</code> interface using binding-specific casting + * This interface can be obtained from the object implementing the + * <code>Document</code> interface using binding-specific casting * methods. - * @return The initial state of the Range returned from this method is - * such that both of its boundary-points are positioned at the - * beginning of the corresponding Document, before any content. The - * Range returned can only be used to select content associated with - * this Document, or with DocumentFragments and Attrs for which this + * @return The initial state of the Range returned from this method is + * such that both of its boundary-points are positioned at the + * beginning of the corresponding Document, before any content. The + * Range returned can only be used to select content associated with + * this Document, or with DocumentFragments and Attrs for which this * Document is the <code>ownerDocument</code>. */ public Range createRange(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/Range.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/Range.java index a576b4dd642..9e1957883e5 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/Range.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/Range.java @@ -22,120 +22,120 @@ import org.w3c.dom.DocumentFragment; */ public interface Range { /** - * Node within which the Range begins + * Node within which the Range begins * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public Node getStartContainer() throws DOMException; /** - * Offset within the starting node of the Range. + * Offset within the starting node of the Range. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public int getStartOffset() throws DOMException; /** - * Node within which the Range ends + * Node within which the Range ends * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public Node getEndContainer() throws DOMException; /** - * Offset within the ending node of the Range. + * Offset within the ending node of the Range. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public int getEndOffset() throws DOMException; /** - * TRUE if the Range is collapsed + * TRUE if the Range is collapsed * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public boolean getCollapsed() throws DOMException; /** - * The deepest common ancestor container of the Range's two + * The deepest common ancestor container of the Range's two * boundary-points. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public Node getCommonAncestorContainer() throws DOMException; /** - * Sets the attributes describing the start of the Range. - * @param refNode The <code>refNode</code> value. This parameter must be + * Sets the attributes describing the start of the Range. + * @param refNode The <code>refNode</code> value. This parameter must be * different from <code>null</code>. - * @param offset The <code>startOffset</code> value. + * @param offset The <code>startOffset</code> value. * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor - * of <code>refNode</code> is an Entity, Notation, or DocumentType + * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor + * of <code>refNode</code> is an Entity, Notation, or DocumentType * node. * @exception DOMException - * INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater - * than the number of child units in <code>refNode</code>. Child units - * are 16-bit units if <code>refNode</code> is a type of CharacterData - * node (e.g., a Text or Comment node) or a ProcessingInstruction + * INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater + * than the number of child units in <code>refNode</code>. Child units + * are 16-bit units if <code>refNode</code> is a type of CharacterData + * node (e.g., a Text or Comment node) or a ProcessingInstruction * node. Child units are Nodes in all other cases. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ - public void setStart(Node refNode, + public void setStart(Node refNode, int offset) throws RangeException, DOMException; /** * Sets the attributes describing the end of a Range. - * @param refNode The <code>refNode</code> value. This parameter must be + * @param refNode The <code>refNode</code> value. This parameter must be * different from <code>null</code>. - * @param offset The <code>endOffset</code> value. + * @param offset The <code>endOffset</code> value. * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor - * of <code>refNode</code> is an Entity, Notation, or DocumentType + * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor + * of <code>refNode</code> is an Entity, Notation, or DocumentType * node. * @exception DOMException - * INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater - * than the number of child units in <code>refNode</code>. Child units - * are 16-bit units if <code>refNode</code> is a type of CharacterData - * node (e.g., a Text or Comment node) or a ProcessingInstruction + * INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater + * than the number of child units in <code>refNode</code>. Child units + * are 16-bit units if <code>refNode</code> is a type of CharacterData + * node (e.g., a Text or Comment node) or a ProcessingInstruction * node. Child units are Nodes in all other cases. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ - public void setEnd(Node refNode, + public void setEnd(Node refNode, int offset) throws RangeException, DOMException; /** * Sets the start position to be before a node - * @param refNode Range starts before <code>refNode</code> + * @param refNode Range starts before <code>refNode</code> * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if the root container of - * <code>refNode</code> is not an Attr, Document, or DocumentFragment - * node or if <code>refNode</code> is a Document, DocumentFragment, + * INVALID_NODE_TYPE_ERR: Raised if the root container of + * <code>refNode</code> is not an Attr, Document, or DocumentFragment + * node or if <code>refNode</code> is a Document, DocumentFragment, * Attr, Entity, or Notation node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void setStartBefore(Node refNode) @@ -143,93 +143,93 @@ public interface Range { /** * Sets the start position to be after a node - * @param refNode Range starts after <code>refNode</code> + * @param refNode Range starts after <code>refNode</code> * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if the root container of - * <code>refNode</code> is not an Attr, Document, or DocumentFragment - * node or if <code>refNode</code> is a Document, DocumentFragment, + * INVALID_NODE_TYPE_ERR: Raised if the root container of + * <code>refNode</code> is not an Attr, Document, or DocumentFragment + * node or if <code>refNode</code> is a Document, DocumentFragment, * Attr, Entity, or Notation node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void setStartAfter(Node refNode) throws RangeException, DOMException; /** - * Sets the end position to be before a node. - * @param refNode Range ends before <code>refNode</code> + * Sets the end position to be before a node. + * @param refNode Range ends before <code>refNode</code> * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if the root container of - * <code>refNode</code> is not an Attr, Document, or DocumentFragment - * node or if <code>refNode</code> is a Document, DocumentFragment, + * INVALID_NODE_TYPE_ERR: Raised if the root container of + * <code>refNode</code> is not an Attr, Document, or DocumentFragment + * node or if <code>refNode</code> is a Document, DocumentFragment, * Attr, Entity, or Notation node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void setEndBefore(Node refNode) throws RangeException, DOMException; /** - * Sets the end of a Range to be after a node - * @param refNode Range ends after <code>refNode</code>. + * Sets the end of a Range to be after a node + * @param refNode Range ends after <code>refNode</code>. * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if the root container of - * <code>refNode</code> is not an Attr, Document or DocumentFragment - * node or if <code>refNode</code> is a Document, DocumentFragment, + * INVALID_NODE_TYPE_ERR: Raised if the root container of + * <code>refNode</code> is not an Attr, Document or DocumentFragment + * node or if <code>refNode</code> is a Document, DocumentFragment, * Attr, Entity, or Notation node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void setEndAfter(Node refNode) throws RangeException, DOMException; /** - * Collapse a Range onto one of its boundary-points - * @param toStart If TRUE, collapses the Range onto its start; if FALSE, - * collapses it onto its end. + * Collapse a Range onto one of its boundary-points + * @param toStart If TRUE, collapses the Range onto its start; if FALSE, + * collapses it onto its end. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public void collapse(boolean toStart) throws DOMException; /** - * Select a node and its contents - * @param refNode The node to select. + * Select a node and its contents + * @param refNode The node to select. * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> - * is an Entity, Notation or DocumentType node or if - * <code>refNode</code> is a Document, DocumentFragment, Attr, Entity, + * INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> + * is an Entity, Notation or DocumentType node or if + * <code>refNode</code> is a Document, DocumentFragment, Attr, Entity, * or Notation node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void selectNode(Node refNode) throws RangeException, DOMException; /** - * Select the contents within a node - * @param refNode Node to select from + * Select the contents within a node + * @param refNode Node to select from * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor + * INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor * of <code>refNode</code> is an Entity, Notation or DocumentType node. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created + * <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created * from a different document than the one that created this range. */ public void selectNodeContents(Node refNode) @@ -237,177 +237,177 @@ public interface Range { // CompareHow /** - * Compare start boundary-point of <code>sourceRange</code> to start - * boundary-point of Range on which <code>compareBoundaryPoints</code> + * Compare start boundary-point of <code>sourceRange</code> to start + * boundary-point of Range on which <code>compareBoundaryPoints</code> * is invoked. */ public static final short START_TO_START = 0; /** - * Compare start boundary-point of <code>sourceRange</code> to end - * boundary-point of Range on which <code>compareBoundaryPoints</code> + * Compare start boundary-point of <code>sourceRange</code> to end + * boundary-point of Range on which <code>compareBoundaryPoints</code> * is invoked. */ public static final short START_TO_END = 1; /** - * Compare end boundary-point of <code>sourceRange</code> to end - * boundary-point of Range on which <code>compareBoundaryPoints</code> + * Compare end boundary-point of <code>sourceRange</code> to end + * boundary-point of Range on which <code>compareBoundaryPoints</code> * is invoked. */ public static final short END_TO_END = 2; /** - * Compare end boundary-point of <code>sourceRange</code> to start - * boundary-point of Range on which <code>compareBoundaryPoints</code> + * Compare end boundary-point of <code>sourceRange</code> to start + * boundary-point of Range on which <code>compareBoundaryPoints</code> * is invoked. */ public static final short END_TO_START = 3; /** * Compare the boundary-points of two Ranges in a document. - * @param how A code representing the type of comparison, as defined + * @param how A code representing the type of comparison, as defined * above. - * @param sourceRange The <code>Range</code> on which this current + * @param sourceRange The <code>Range</code> on which this current * <code>Range</code> is compared to. - * @return -1, 0 or 1 depending on whether the corresponding - * boundary-point of the Range is respectively before, equal to, or - * after the corresponding boundary-point of <code>sourceRange</code>. + * @return -1, 0 or 1 depending on whether the corresponding + * boundary-point of the Range is respectively before, equal to, or + * after the corresponding boundary-point of <code>sourceRange</code>. * @exception DOMException - * WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same + * WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same * Document or DocumentFragment. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. */ - public short compareBoundaryPoints(short how, + public short compareBoundaryPoints(short how, Range sourceRange) throws DOMException; /** - * Removes the contents of a Range from the containing document or - * document fragment without returning a reference to the removed - * content. + * Removes the contents of a Range from the containing document or + * document fragment without returning a reference to the removed + * content. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of - * the Range is read-only or any of the nodes that contain any of the + * NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of + * the Range is read-only or any of the nodes that contain any of the * content of the Range are read-only. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. */ public void deleteContents() throws DOMException; /** - * Moves the contents of a Range from the containing document or document - * fragment to a new DocumentFragment. - * @return A DocumentFragment containing the extracted contents. + * Moves the contents of a Range from the containing document or document + * fragment to a new DocumentFragment. + * @return A DocumentFragment containing the extracted contents. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of - * the Range is read-only or any of the nodes which contain any of the + * NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of + * the Range is read-only or any of the nodes which contain any of the * content of the Range are read-only. - * <br>HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be + * <br>HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be * extracted into the new DocumentFragment. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. */ public DocumentFragment extractContents() throws DOMException; /** - * Duplicates the contents of a Range - * @return A DocumentFragment that contains content equivalent to this + * Duplicates the contents of a Range + * @return A DocumentFragment that contains content equivalent to this * Range. * @exception DOMException - * HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be + * HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be * extracted into the new DocumentFragment. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. */ public DocumentFragment cloneContents() throws DOMException; /** - * Inserts a node into the Document or DocumentFragment at the start of - * the Range. If the container is a Text node, this will be split at the - * start of the Range (as if the Text node's splitText method was - * performed at the insertion point) and the insertion will occur - * between the two resulting Text nodes. Adjacent Text nodes will not be - * automatically merged. If the node to be inserted is a - * DocumentFragment node, the children will be inserted rather than the + * Inserts a node into the Document or DocumentFragment at the start of + * the Range. If the container is a Text node, this will be split at the + * start of the Range (as if the Text node's splitText method was + * performed at the insertion point) and the insertion will occur + * between the two resulting Text nodes. Adjacent Text nodes will not be + * automatically merged. If the node to be inserted is a + * DocumentFragment node, the children will be inserted rather than the * DocumentFragment node itself. - * @param newNode The node to insert at the start of the Range + * @param newNode The node to insert at the start of the Range * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the + * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the * start of the Range is read-only. - * <br>WRONG_DOCUMENT_ERR: Raised if <code>newNode</code> and the - * container of the start of the Range were not created from the same + * <br>WRONG_DOCUMENT_ERR: Raised if <code>newNode</code> and the + * container of the start of the Range were not created from the same * document. - * <br>HIERARCHY_REQUEST_ERR: Raised if the container of the start of - * the Range is of a type that does not allow children of the type of - * <code>newNode</code> or if <code>newNode</code> is an ancestor of + * <br>HIERARCHY_REQUEST_ERR: Raised if the container of the start of + * the Range is of a type that does not allow children of the type of + * <code>newNode</code> or if <code>newNode</code> is an ancestor of * the container. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. * @exception RangeException - * INVALID_NODE_TYPE_ERR: Raised if <code>newNode</code> is an Attr, + * INVALID_NODE_TYPE_ERR: Raised if <code>newNode</code> is an Attr, * Entity, Notation, or Document node. */ public void insertNode(Node newNode) throws DOMException, RangeException; /** - * Reparents the contents of the Range to the given node and inserts the - * node at the position of the start of the Range. - * @param newParent The node to surround the contents with. + * Reparents the contents of the Range to the given node and inserts the + * node at the position of the start of the Range. + * @param newParent The node to surround the contents with. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of + * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of * either boundary-point of the Range is read-only. - * <br>WRONG_DOCUMENT_ERR: Raised if <code> newParent</code> and the - * container of the start of the Range were not created from the same + * <br>WRONG_DOCUMENT_ERR: Raised if <code> newParent</code> and the + * container of the start of the Range were not created from the same * document. - * <br>HIERARCHY_REQUEST_ERR: Raised if the container of the start of - * the Range is of a type that does not allow children of the type of - * <code>newParent</code> or if <code>newParent</code> is an ancestor - * of the container or if <code>node</code> would end up with a child + * <br>HIERARCHY_REQUEST_ERR: Raised if the container of the start of + * the Range is of a type that does not allow children of the type of + * <code>newParent</code> or if <code>newParent</code> is an ancestor + * of the container or if <code>node</code> would end up with a child * node of a type not allowed by the type of <code>node</code>. - * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already + * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * been invoked on this object. * @exception RangeException - * BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a + * BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a * non-text node. - * <br>INVALID_NODE_TYPE_ERR: Raised if <code> node</code> is an Attr, + * <br>INVALID_NODE_TYPE_ERR: Raised if <code> node</code> is an Attr, * Entity, DocumentType, Notation, Document, or DocumentFragment node. */ public void surroundContents(Node newParent) throws DOMException, RangeException; /** - * Produces a new Range whose boundary-points are equal to the - * boundary-points of the Range. - * @return The duplicated Range. + * Produces a new Range whose boundary-points are equal to the + * boundary-points of the Range. + * @return The duplicated Range. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public Range cloneRange() throws DOMException; /** - * Returns the contents of a Range as a string. This string contains only - * the data characters, not any markup. + * Returns the contents of a Range as a string. This string contains only + * the data characters, not any markup. * @return The contents of the Range. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public String toString() throws DOMException; /** - * Called to indicate that the Range is no longer in use and that the - * implementation may relinquish any resources associated with this - * Range. Subsequent calls to any methods or attribute getters on this - * Range will result in a <code>DOMException</code> being thrown with an + * Called to indicate that the Range is no longer in use and that the + * implementation may relinquish any resources associated with this + * Range. Subsequent calls to any methods or attribute getters on this + * Range will result in a <code>DOMException</code> being thrown with an * error code of <code>INVALID_STATE_ERR</code>. * @exception DOMException - * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been + * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * invoked on this object. */ public void detach() diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/RangeException.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/RangeException.java index 551008e5dba..2dee8195b80 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/RangeException.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ranges/RangeException.java @@ -13,7 +13,7 @@ package org.w3c.dom.ranges; /** - * Range operations may throw a <code>RangeException</code> as specified in + * Range operations may throw a <code>RangeException</code> as specified in * their method descriptions. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * @since DOM Level 2 @@ -30,8 +30,8 @@ public class RangeException extends RuntimeException { */ public static final short BAD_BOUNDARYPOINTS_ERR = 1; /** - * If the container of an boundary-point of a Range is being set to either - * a node of an invalid type or a node with an ancestor of an invalid + * If the container of an boundary-point of a Range is being set to either + * a node of an invalid type or a node with an ancestor of an invalid * type. */ public static final short INVALID_NODE_TYPE_ERR = 2; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java index 612a561135a..ecfba994cdd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java @@ -13,21 +13,21 @@ package org.w3c.dom.stylesheets; /** - * The <code>DocumentStyle</code> interface provides a mechanism by which the - * style sheets embedded in a document can be retrieved. The expectation is - * that an instance of the <code>DocumentStyle</code> interface can be - * obtained by using binding-specific casting methods on an instance of the - * <code>Document</code> interface. + * The <code>DocumentStyle</code> interface provides a mechanism by which the + * style sheets embedded in a document can be retrieved. The expectation is + * that an instance of the <code>DocumentStyle</code> interface can be + * obtained by using binding-specific casting methods on an instance of the + * <code>Document</code> interface. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface DocumentStyle { /** - * A list containing all the style sheets explicitly linked into or - * embedded in a document. For HTML documents, this includes external - * style sheets, included via the HTML LINK element, and inline STYLE - * elements. In XML, this includes external style sheets, included via - * style sheet processing instructions (see [XML StyleSheet]). + * A list containing all the style sheets explicitly linked into or + * embedded in a document. For HTML documents, this includes external + * style sheets, included via the HTML LINK element, and inline STYLE + * elements. In XML, this includes external style sheets, included via + * style sheet processing instructions (see [XML StyleSheet]). */ public StyleSheetList getStyleSheets(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java index 481bd19dbab..c7560d64715 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java @@ -13,18 +13,18 @@ package org.w3c.dom.stylesheets; /** - * The <code>LinkStyle</code> interface provides a mechanism by which a style - * sheet can be retrieved from the node responsible for linking it into a - * document. An instance of the <code>LinkStyle</code> interface can be - * obtained using binding-specific casting methods on an instance of a - * linking node (<code>HTMLLinkElement</code>, <code>HTMLStyleElement</code> - * or <code>ProcessingInstruction</code> in DOM Level 2). + * The <code>LinkStyle</code> interface provides a mechanism by which a style + * sheet can be retrieved from the node responsible for linking it into a + * document. An instance of the <code>LinkStyle</code> interface can be + * obtained using binding-specific casting methods on an instance of a + * linking node (<code>HTMLLinkElement</code>, <code>HTMLStyleElement</code> + * or <code>ProcessingInstruction</code> in DOM Level 2). * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface LinkStyle { /** - * The style sheet. + * The style sheet. */ public StyleSheet getSheet(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java index f83d5f13d62..000c90c4366 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java @@ -15,69 +15,69 @@ package org.w3c.dom.stylesheets; import org.w3c.dom.DOMException; /** - * The <code>MediaList</code> interface provides the abstraction of an - * ordered collection of media, without defining or constraining how this - * collection is implemented. An empty list is the same as a list that - * contains the medium <code>"all"</code>. - * <p> The items in the <code>MediaList</code> are accessible via an integral - * index, starting from 0. + * The <code>MediaList</code> interface provides the abstraction of an + * ordered collection of media, without defining or constraining how this + * collection is implemented. An empty list is the same as a list that + * contains the medium <code>"all"</code>. + * <p> The items in the <code>MediaList</code> are accessible via an integral + * index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface MediaList { /** - * The parsable textual representation of the media list. This is a - * comma-separated list of media. + * The parsable textual representation of the media list. This is a + * comma-separated list of media. */ public String getMediaText(); /** - * The parsable textual representation of the media list. This is a - * comma-separated list of media. + * The parsable textual representation of the media list. This is a + * comma-separated list of media. * @exception DOMException - * SYNTAX_ERR: Raised if the specified string value has a syntax error + * SYNTAX_ERR: Raised if the specified string value has a syntax error * and is unparsable. - * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is + * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is * readonly. */ public void setMediaText(String mediaText) throws DOMException; /** - * The number of media in the list. The range of valid media is - * <code>0</code> to <code>length-1</code> inclusive. + * The number of media in the list. The range of valid media is + * <code>0</code> to <code>length-1</code> inclusive. */ public int getLength(); /** - * Returns the <code>index</code>th in the list. If <code>index</code> is - * greater than or equal to the number of media in the list, this - * returns <code>null</code>. - * @param index Index into the collection. - * @return The medium at the <code>index</code>th position in the - * <code>MediaList</code>, or <code>null</code> if that is not a valid - * index. + * Returns the <code>index</code>th in the list. If <code>index</code> is + * greater than or equal to the number of media in the list, this + * returns <code>null</code>. + * @param index Index into the collection. + * @return The medium at the <code>index</code>th position in the + * <code>MediaList</code>, or <code>null</code> if that is not a valid + * index. */ public String item(int index); /** - * Deletes the medium indicated by <code>oldMedium</code> from the list. + * Deletes the medium indicated by <code>oldMedium</code> from the list. * @param oldMedium The medium to delete in the media list. * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. - * <br> NOT_FOUND_ERR: Raised if <code>oldMedium</code> is not in the - * list. + * NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. + * <br> NOT_FOUND_ERR: Raised if <code>oldMedium</code> is not in the + * list. */ public void deleteMedium(String oldMedium) throws DOMException; /** - * Adds the medium <code>newMedium</code> to the end of the list. If the - * <code>newMedium</code> is already used, it is first removed. + * Adds the medium <code>newMedium</code> to the end of the list. If the + * <code>newMedium</code> is already used, it is first removed. * @param newMedium The new medium to add. * @exception DOMException - * INVALID_CHARACTER_ERR: If the medium contains characters that are - * invalid in the underlying style language. - * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. + * INVALID_CHARACTER_ERR: If the medium contains characters that are + * invalid in the underlying style language. + * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. */ public void appendMedium(String newMedium) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java index 3da43076994..8289028178d 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java @@ -15,88 +15,88 @@ package org.w3c.dom.stylesheets; import org.w3c.dom.Node; /** - * The <code>StyleSheet</code> interface is the abstract base interface for - * any type of style sheet. It represents a single style sheet associated - * with a structured document. In HTML, the StyleSheet interface represents - * either an external style sheet, included via the HTML LINK element, or - * an inline STYLE element. In XML, this interface represents an external - * style sheet, included via a style sheet processing instruction. + * The <code>StyleSheet</code> interface is the abstract base interface for + * any type of style sheet. It represents a single style sheet associated + * with a structured document. In HTML, the StyleSheet interface represents + * either an external style sheet, included via the HTML LINK element, or + * an inline STYLE element. In XML, this interface represents an external + * style sheet, included via a style sheet processing instruction. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface StyleSheet { /** - * This specifies the style sheet language for this style sheet. The - * style sheet language is specified as a content type (e.g. - * "text/css"). The content type is often specified in the - * <code>ownerNode</code>. Also see the type attribute definition for - * the <code>LINK</code> element in HTML 4.0, and the type - * pseudo-attribute for the XML style sheet processing instruction. + * This specifies the style sheet language for this style sheet. The + * style sheet language is specified as a content type (e.g. + * "text/css"). The content type is often specified in the + * <code>ownerNode</code>. Also see the type attribute definition for + * the <code>LINK</code> element in HTML 4.0, and the type + * pseudo-attribute for the XML style sheet processing instruction. */ public String getType(); /** - * <code>false</code> if the style sheet is applied to the document. - * <code>true</code> if it is not. Modifying this attribute may cause a - * new resolution of style for the document. A stylesheet only applies - * if both an appropriate medium definition is present and the disabled - * attribute is false. So, if the media doesn't apply to the current - * user agent, the <code>disabled</code> attribute is ignored. + * <code>false</code> if the style sheet is applied to the document. + * <code>true</code> if it is not. Modifying this attribute may cause a + * new resolution of style for the document. A stylesheet only applies + * if both an appropriate medium definition is present and the disabled + * attribute is false. So, if the media doesn't apply to the current + * user agent, the <code>disabled</code> attribute is ignored. */ public boolean getDisabled(); /** - * <code>false</code> if the style sheet is applied to the document. - * <code>true</code> if it is not. Modifying this attribute may cause a - * new resolution of style for the document. A stylesheet only applies - * if both an appropriate medium definition is present and the disabled - * attribute is false. So, if the media doesn't apply to the current - * user agent, the <code>disabled</code> attribute is ignored. + * <code>false</code> if the style sheet is applied to the document. + * <code>true</code> if it is not. Modifying this attribute may cause a + * new resolution of style for the document. A stylesheet only applies + * if both an appropriate medium definition is present and the disabled + * attribute is false. So, if the media doesn't apply to the current + * user agent, the <code>disabled</code> attribute is ignored. */ public void setDisabled(boolean disabled); /** - * The node that associates this style sheet with the document. For HTML, - * this may be the corresponding <code>LINK</code> or <code>STYLE</code> - * element. For XML, it may be the linking processing instruction. For - * style sheets that are included by other style sheets, the value of - * this attribute is <code>null</code>. + * The node that associates this style sheet with the document. For HTML, + * this may be the corresponding <code>LINK</code> or <code>STYLE</code> + * element. For XML, it may be the linking processing instruction. For + * style sheets that are included by other style sheets, the value of + * this attribute is <code>null</code>. */ public Node getOwnerNode(); /** - * For style sheet languages that support the concept of style sheet - * inclusion, this attribute represents the including style sheet, if - * one exists. If the style sheet is a top-level style sheet, or the - * style sheet language does not support inclusion, the value of this - * attribute is <code>null</code>. + * For style sheet languages that support the concept of style sheet + * inclusion, this attribute represents the including style sheet, if + * one exists. If the style sheet is a top-level style sheet, or the + * style sheet language does not support inclusion, the value of this + * attribute is <code>null</code>. */ public StyleSheet getParentStyleSheet(); /** - * If the style sheet is a linked style sheet, the value of its attribute - * is its location. For inline style sheets, the value of this attribute - * is <code>null</code>. See the href attribute definition for the - * <code>LINK</code> element in HTML 4.0, and the href pseudo-attribute - * for the XML style sheet processing instruction. + * If the style sheet is a linked style sheet, the value of its attribute + * is its location. For inline style sheets, the value of this attribute + * is <code>null</code>. See the href attribute definition for the + * <code>LINK</code> element in HTML 4.0, and the href pseudo-attribute + * for the XML style sheet processing instruction. */ public String getHref(); /** - * The advisory title. The title is often specified in the - * <code>ownerNode</code>. See the title attribute definition for the - * <code>LINK</code> element in HTML 4.0, and the title pseudo-attribute - * for the XML style sheet processing instruction. + * The advisory title. The title is often specified in the + * <code>ownerNode</code>. See the title attribute definition for the + * <code>LINK</code> element in HTML 4.0, and the title pseudo-attribute + * for the XML style sheet processing instruction. */ public String getTitle(); /** - * The intended destination media for style information. The media is - * often specified in the <code>ownerNode</code>. If no media has been - * specified, the <code>MediaList</code> will be empty. See the media - * attribute definition for the <code>LINK</code> element in HTML 4.0, - * and the media pseudo-attribute for the XML style sheet processing - * instruction . Modifying the media list may cause a change to the - * attribute <code>disabled</code>. + * The intended destination media for style information. The media is + * often specified in the <code>ownerNode</code>. If no media has been + * specified, the <code>MediaList</code> will be empty. See the media + * attribute definition for the <code>LINK</code> element in HTML 4.0, + * and the media pseudo-attribute for the XML style sheet processing + * instruction . Modifying the media list may cause a change to the + * attribute <code>disabled</code>. */ public MediaList getMedia(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java index b8f9a442330..6bb085fcad6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java @@ -13,29 +13,29 @@ package org.w3c.dom.stylesheets; /** - * The <code>StyleSheetList</code> interface provides the abstraction of an - * ordered collection of style sheets. - * <p> The items in the <code>StyleSheetList</code> are accessible via an - * integral index, starting from 0. + * The <code>StyleSheetList</code> interface provides the abstraction of an + * ordered collection of style sheets. + * <p> The items in the <code>StyleSheetList</code> are accessible via an + * integral index, starting from 0. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since DOM Level 2 */ public interface StyleSheetList { /** - * The number of <code>StyleSheets</code> in the list. The range of valid - * child stylesheet indices is <code>0</code> to <code>length-1</code> - * inclusive. + * The number of <code>StyleSheets</code> in the list. The range of valid + * child stylesheet indices is <code>0</code> to <code>length-1</code> + * inclusive. */ public int getLength(); /** - * Used to retrieve a style sheet by ordinal index. If index is greater - * than or equal to the number of style sheets in the list, this returns - * <code>null</code>. + * Used to retrieve a style sheet by ordinal index. If index is greater + * than or equal to the number of style sheets in the list, this returns + * <code>null</code>. * @param index Index into the collection - * @return The style sheet at the <code>index</code> position in the - * <code>StyleSheetList</code>, or <code>null</code> if that is not a - * valid index. + * @return The style sheet at the <code>index</code> position in the + * <code>StyleSheetList</code>, or <code>null</code> if that is not a + * valid index. */ public StyleSheet item(int index); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java index bc45ad9f753..e68d656f2dd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java @@ -16,77 +16,77 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * <code>DocumentTraversal</code> contains methods that create - * <code>NodeIterators</code> and <code>TreeWalkers</code> to traverse a - * node and its children in document order (depth first, pre-order - * traversal, which is equivalent to the order in which the start tags occur - * in the text representation of the document). In DOMs which support the - * Traversal feature, <code>DocumentTraversal</code> will be implemented by + * <code>DocumentTraversal</code> contains methods that create + * <code>NodeIterators</code> and <code>TreeWalkers</code> to traverse a + * node and its children in document order (depth first, pre-order + * traversal, which is equivalent to the order in which the start tags occur + * in the text representation of the document). In DOMs which support the + * Traversal feature, <code>DocumentTraversal</code> will be implemented by * the same objects that implement the Document interface. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * @since DOM Level 2 */ public interface DocumentTraversal { /** - * Create a new <code>NodeIterator</code> over the subtree rooted at the + * Create a new <code>NodeIterator</code> over the subtree rooted at the * specified node. - * @param root The node which will be iterated together with its - * children. The <code>NodeIterator</code> is initially positioned - * just before this node. The <code>whatToShow</code> flags and the - * filter, if any, are not considered when setting this position. The + * @param root The node which will be iterated together with its + * children. The <code>NodeIterator</code> is initially positioned + * just before this node. The <code>whatToShow</code> flags and the + * filter, if any, are not considered when setting this position. The * root must not be <code>null</code>. - * @param whatToShow This flag specifies which node types may appear in - * the logical view of the tree presented by the - * <code>NodeIterator</code>. See the description of - * <code>NodeFilter</code> for the set of possible <code>SHOW_</code> + * @param whatToShow This flag specifies which node types may appear in + * the logical view of the tree presented by the + * <code>NodeIterator</code>. See the description of + * <code>NodeFilter</code> for the set of possible <code>SHOW_</code> * values.These flags can be combined using <code>OR</code>. - * @param filter The <code>NodeFilter</code> to be used with this - * <code>NodeIterator</code>, or <code>null</code> to indicate no + * @param filter The <code>NodeFilter</code> to be used with this + * <code>NodeIterator</code>, or <code>null</code> to indicate no * filter. - * @param entityReferenceExpansion The value of this flag determines + * @param entityReferenceExpansion The value of this flag determines * whether entity reference nodes are expanded. * @return The newly created <code>NodeIterator</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the specified <code>root</code> is + * NOT_SUPPORTED_ERR: Raised if the specified <code>root</code> is * <code>null</code>. */ - public NodeIterator createNodeIterator(Node root, - int whatToShow, - NodeFilter filter, + public NodeIterator createNodeIterator(Node root, + int whatToShow, + NodeFilter filter, boolean entityReferenceExpansion) throws DOMException; /** - * Create a new <code>TreeWalker</code> over the subtree rooted at the + * Create a new <code>TreeWalker</code> over the subtree rooted at the * specified node. - * @param root The node which will serve as the <code>root</code> for the - * <code>TreeWalker</code>. The <code>whatToShow</code> flags and the - * <code>NodeFilter</code> are not considered when setting this value; - * any node type will be accepted as the <code>root</code>. The - * <code>currentNode</code> of the <code>TreeWalker</code> is - * initialized to this node, whether or not it is visible. The - * <code>root</code> functions as a stopping point for traversal - * methods that look upward in the document structure, such as - * <code>parentNode</code> and nextNode. The <code>root</code> must + * @param root The node which will serve as the <code>root</code> for the + * <code>TreeWalker</code>. The <code>whatToShow</code> flags and the + * <code>NodeFilter</code> are not considered when setting this value; + * any node type will be accepted as the <code>root</code>. The + * <code>currentNode</code> of the <code>TreeWalker</code> is + * initialized to this node, whether or not it is visible. The + * <code>root</code> functions as a stopping point for traversal + * methods that look upward in the document structure, such as + * <code>parentNode</code> and nextNode. The <code>root</code> must * not be <code>null</code>. - * @param whatToShow This flag specifies which node types may appear in - * the logical view of the tree presented by the - * <code>TreeWalker</code>. See the description of - * <code>NodeFilter</code> for the set of possible <code>SHOW_</code> + * @param whatToShow This flag specifies which node types may appear in + * the logical view of the tree presented by the + * <code>TreeWalker</code>. See the description of + * <code>NodeFilter</code> for the set of possible <code>SHOW_</code> * values.These flags can be combined using <code>OR</code>. - * @param filter The <code>NodeFilter</code> to be used with this + * @param filter The <code>NodeFilter</code> to be used with this * <code>TreeWalker</code>, or <code>null</code> to indicate no filter. - * @param entityReferenceExpansion If this flag is false, the contents of - * <code>EntityReference</code> nodes are not presented in the logical + * @param entityReferenceExpansion If this flag is false, the contents of + * <code>EntityReference</code> nodes are not presented in the logical * view. * @return The newly created <code>TreeWalker</code>. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if the specified <code>root</code> is + * NOT_SUPPORTED_ERR: Raised if the specified <code>root</code> is * <code>null</code>. */ - public TreeWalker createTreeWalker(Node root, - int whatToShow, - NodeFilter filter, + public TreeWalker createTreeWalker(Node root, + int whatToShow, + NodeFilter filter, boolean entityReferenceExpansion) throws DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java index b9beac476b3..5547750788c 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java @@ -15,19 +15,19 @@ package org.w3c.dom.traversal; import org.w3c.dom.Node; /** - * Filters are objects that know how to "filter out" nodes. If a - * <code>NodeIterator</code> or <code>TreeWalker</code> is given a - * <code>NodeFilter</code>, it applies the filter before it returns the next - * node. If the filter says to accept the node, the traversal logic returns - * it; otherwise, traversal looks for the next node and pretends that the + * Filters are objects that know how to "filter out" nodes. If a + * <code>NodeIterator</code> or <code>TreeWalker</code> is given a + * <code>NodeFilter</code>, it applies the filter before it returns the next + * node. If the filter says to accept the node, the traversal logic returns + * it; otherwise, traversal looks for the next node and pretends that the * node that was rejected was not there. - * <p>The DOM does not provide any filters. <code>NodeFilter</code> is just an - * interface that users can implement to provide their own filters. - * <p><code>NodeFilters</code> do not need to know how to traverse from node - * to node, nor do they need to know anything about the data structure that - * is being traversed. This makes it very easy to write filters, since the - * only thing they have to know how to do is evaluate a single node. One - * filter may be used with a number of different kinds of traversals, + * <p>The DOM does not provide any filters. <code>NodeFilter</code> is just an + * interface that users can implement to provide their own filters. + * <p><code>NodeFilters</code> do not need to know how to traverse from node + * to node, nor do they need to know anything about the data structure that + * is being traversed. This makes it very easy to write filters, since the + * only thing they have to know how to do is evaluate a single node. One + * filter may be used with a number of different kinds of traversals, * encouraging code reuse. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * @since DOM Level 2 @@ -35,25 +35,25 @@ import org.w3c.dom.Node; public interface NodeFilter { // Constants returned by acceptNode /** - * Accept the node. Navigation methods defined for - * <code>NodeIterator</code> or <code>TreeWalker</code> will return this + * Accept the node. Navigation methods defined for + * <code>NodeIterator</code> or <code>TreeWalker</code> will return this * node. */ public static final short FILTER_ACCEPT = 1; /** - * Reject the node. Navigation methods defined for - * <code>NodeIterator</code> or <code>TreeWalker</code> will not return - * this node. For <code>TreeWalker</code>, the children of this node - * will also be rejected. <code>NodeIterators</code> treat this as a + * Reject the node. Navigation methods defined for + * <code>NodeIterator</code> or <code>TreeWalker</code> will not return + * this node. For <code>TreeWalker</code>, the children of this node + * will also be rejected. <code>NodeIterators</code> treat this as a * synonym for <code>FILTER_SKIP</code>. */ public static final short FILTER_REJECT = 2; /** - * Skip this single node. Navigation methods defined for - * <code>NodeIterator</code> or <code>TreeWalker</code> will not return - * this node. For both <code>NodeIterator</code> and - * <code>TreeWalker</code>, the children of this node will still be - * considered. + * Skip this single node. Navigation methods defined for + * <code>NodeIterator</code> or <code>TreeWalker</code> will not return + * this node. For both <code>NodeIterator</code> and + * <code>TreeWalker</code>, the children of this node will still be + * considered. */ public static final short FILTER_SKIP = 3; @@ -67,11 +67,11 @@ public interface NodeFilter { */ public static final int SHOW_ELEMENT = 0x00000001; /** - * Show <code>Attr</code> nodes. This is meaningful only when creating an - * <code>NodeIterator</code> or <code>TreeWalker</code> with an - * attribute node as its <code>root</code>; in this case, it means that - * the attribute node will appear in the first position of the iteration - * or traversal. Since attributes are never children of other nodes, + * Show <code>Attr</code> nodes. This is meaningful only when creating an + * <code>NodeIterator</code> or <code>TreeWalker</code> with an + * attribute node as its <code>root</code>; in this case, it means that + * the attribute node will appear in the first position of the iteration + * or traversal. Since attributes are never children of other nodes, * they do not appear when traversing over the document tree. */ public static final int SHOW_ATTRIBUTE = 0x00000002; @@ -88,12 +88,12 @@ public interface NodeFilter { */ public static final int SHOW_ENTITY_REFERENCE = 0x00000010; /** - * Show <code>Entity</code> nodes. This is meaningful only when creating - * an <code>NodeIterator</code> or <code>TreeWalker</code> with an - * <code>Entity</code> node as its <code>root</code>; in this case, it - * means that the <code>Entity</code> node will appear in the first - * position of the traversal. Since entities are not part of the - * document tree, they do not appear when traversing over the document + * Show <code>Entity</code> nodes. This is meaningful only when creating + * an <code>NodeIterator</code> or <code>TreeWalker</code> with an + * <code>Entity</code> node as its <code>root</code>; in this case, it + * means that the <code>Entity</code> node will appear in the first + * position of the traversal. Since entities are not part of the + * document tree, they do not appear when traversing over the document * tree. */ public static final int SHOW_ENTITY = 0x00000020; @@ -118,25 +118,25 @@ public interface NodeFilter { */ public static final int SHOW_DOCUMENT_FRAGMENT = 0x00000400; /** - * Show <code>Notation</code> nodes. This is meaningful only when creating - * an <code>NodeIterator</code> or <code>TreeWalker</code> with a - * <code>Notation</code> node as its <code>root</code>; in this case, it - * means that the <code>Notation</code> node will appear in the first - * position of the traversal. Since notations are not part of the - * document tree, they do not appear when traversing over the document + * Show <code>Notation</code> nodes. This is meaningful only when creating + * an <code>NodeIterator</code> or <code>TreeWalker</code> with a + * <code>Notation</code> node as its <code>root</code>; in this case, it + * means that the <code>Notation</code> node will appear in the first + * position of the traversal. Since notations are not part of the + * document tree, they do not appear when traversing over the document * tree. */ public static final int SHOW_NOTATION = 0x00000800; /** - * Test whether a specified node is visible in the logical view of a - * <code>TreeWalker</code> or <code>NodeIterator</code>. This function - * will be called by the implementation of <code>TreeWalker</code> and - * <code>NodeIterator</code>; it is not normally called directly from - * user code. (Though you could do so if you wanted to use the same + * Test whether a specified node is visible in the logical view of a + * <code>TreeWalker</code> or <code>NodeIterator</code>. This function + * will be called by the implementation of <code>TreeWalker</code> and + * <code>NodeIterator</code>; it is not normally called directly from + * user code. (Though you could do so if you wanted to use the same * filter to guide your own application logic.) * @param n The node to check to see if it passes the filter or not. - * @return A constant to determine whether the node is accepted, + * @return A constant to determine whether the node is accepted, * rejected, or skipped, as defined above. */ public short acceptNode(Node n); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java index d1f0d08399d..40deef2f325 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java @@ -16,32 +16,32 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * <code>NodeIterators</code> are used to step through a set of nodes, e.g. - * the set of nodes in a <code>NodeList</code>, the document subtree - * governed by a particular <code>Node</code>, the results of a query, or - * any other set of nodes. The set of nodes to be iterated is determined by - * the implementation of the <code>NodeIterator</code>. DOM Level 2 - * specifies a single <code>NodeIterator</code> implementation for - * document-order traversal of a document subtree. Instances of these - * <code>NodeIterators</code> are created by calling + * <code>NodeIterators</code> are used to step through a set of nodes, e.g. + * the set of nodes in a <code>NodeList</code>, the document subtree + * governed by a particular <code>Node</code>, the results of a query, or + * any other set of nodes. The set of nodes to be iterated is determined by + * the implementation of the <code>NodeIterator</code>. DOM Level 2 + * specifies a single <code>NodeIterator</code> implementation for + * document-order traversal of a document subtree. Instances of these + * <code>NodeIterators</code> are created by calling * <code>DocumentTraversal</code><code>.createNodeIterator()</code>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * @since DOM Level 2 */ public interface NodeIterator { /** - * The root node of the <code>NodeIterator</code>, as specified when it + * The root node of the <code>NodeIterator</code>, as specified when it * was created. */ public Node getRoot(); /** - * This attribute determines which node types are presented via the - * <code>NodeIterator</code>. The available set of constants is defined - * in the <code>NodeFilter</code> interface. Nodes not accepted by - * <code>whatToShow</code> will be skipped, but their children may still - * be considered. Note that this skip takes precedence over the filter, - * if any. + * This attribute determines which node types are presented via the + * <code>NodeIterator</code>. The available set of constants is defined + * in the <code>NodeFilter</code> interface. Nodes not accepted by + * <code>whatToShow</code> will be skipped, but their children may still + * be considered. Note that this skip takes precedence over the filter, + * if any. */ public int getWhatToShow(); @@ -51,57 +51,57 @@ public interface NodeIterator { public NodeFilter getFilter(); /** - * The value of this flag determines whether the children of entity - * reference nodes are visible to the <code>NodeIterator</code>. If - * false, these children and their descendants will be rejected. Note - * that this rejection takes precedence over <code>whatToShow</code> and - * the filter. Also note that this is currently the only situation where - * <code>NodeIterators</code> may reject a complete subtree rather than - * skipping individual nodes. + * The value of this flag determines whether the children of entity + * reference nodes are visible to the <code>NodeIterator</code>. If + * false, these children and their descendants will be rejected. Note + * that this rejection takes precedence over <code>whatToShow</code> and + * the filter. Also note that this is currently the only situation where + * <code>NodeIterators</code> may reject a complete subtree rather than + * skipping individual nodes. * <br> - * <br> To produce a view of the document that has entity references - * expanded and does not expose the entity reference node itself, use - * the <code>whatToShow</code> flags to hide the entity reference node - * and set <code>expandEntityReferences</code> to true when creating the - * <code>NodeIterator</code>. To produce a view of the document that has - * entity reference nodes but no entity expansion, use the - * <code>whatToShow</code> flags to show the entity reference node and + * <br> To produce a view of the document that has entity references + * expanded and does not expose the entity reference node itself, use + * the <code>whatToShow</code> flags to hide the entity reference node + * and set <code>expandEntityReferences</code> to true when creating the + * <code>NodeIterator</code>. To produce a view of the document that has + * entity reference nodes but no entity expansion, use the + * <code>whatToShow</code> flags to show the entity reference node and * set <code>expandEntityReferences</code> to false. */ public boolean getExpandEntityReferences(); /** - * Returns the next node in the set and advances the position of the - * <code>NodeIterator</code> in the set. After a - * <code>NodeIterator</code> is created, the first call to + * Returns the next node in the set and advances the position of the + * <code>NodeIterator</code> in the set. After a + * <code>NodeIterator</code> is created, the first call to * <code>nextNode()</code> returns the first node in the set. - * @return The next <code>Node</code> in the set being iterated over, or + * @return The next <code>Node</code> in the set being iterated over, or * <code>null</code> if there are no more members in that set. * @exception DOMException - * INVALID_STATE_ERR: Raised if this method is called after the + * INVALID_STATE_ERR: Raised if this method is called after the * <code>detach</code> method was invoked. */ public Node nextNode() throws DOMException; /** - * Returns the previous node in the set and moves the position of the + * Returns the previous node in the set and moves the position of the * <code>NodeIterator</code> backwards in the set. - * @return The previous <code>Node</code> in the set being iterated over, - * or <code>null</code> if there are no more members in that set. + * @return The previous <code>Node</code> in the set being iterated over, + * or <code>null</code> if there are no more members in that set. * @exception DOMException - * INVALID_STATE_ERR: Raised if this method is called after the + * INVALID_STATE_ERR: Raised if this method is called after the * <code>detach</code> method was invoked. */ public Node previousNode() throws DOMException; /** - * Detaches the <code>NodeIterator</code> from the set which it iterated - * over, releasing any computational resources and placing the - * <code>NodeIterator</code> in the INVALID state. After - * <code>detach</code> has been invoked, calls to <code>nextNode</code> - * or <code>previousNode</code> will raise the exception + * Detaches the <code>NodeIterator</code> from the set which it iterated + * over, releasing any computational resources and placing the + * <code>NodeIterator</code> in the INVALID state. After + * <code>detach</code> has been invoked, calls to <code>nextNode</code> + * or <code>previousNode</code> will raise the exception * INVALID_STATE_ERR. */ public void detach(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java index f5fff86be09..74527f30df8 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java @@ -16,37 +16,37 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * <code>TreeWalker</code> objects are used to navigate a document tree or - * subtree using the view of the document defined by their - * <code>whatToShow</code> flags and filter (if any). Any function which - * performs navigation using a <code>TreeWalker</code> will automatically + * <code>TreeWalker</code> objects are used to navigate a document tree or + * subtree using the view of the document defined by their + * <code>whatToShow</code> flags and filter (if any). Any function which + * performs navigation using a <code>TreeWalker</code> will automatically * support any view defined by a <code>TreeWalker</code>. - * <p>Omitting nodes from the logical view of a subtree can result in a - * structure that is substantially different from the same subtree in the - * complete, unfiltered document. Nodes that are siblings in the - * <code>TreeWalker</code> view may be children of different, widely - * separated nodes in the original view. For instance, consider a - * <code>NodeFilter</code> that skips all nodes except for Text nodes and - * the root node of a document. In the logical view that results, all text - * nodes will be siblings and appear as direct children of the root node, no + * <p>Omitting nodes from the logical view of a subtree can result in a + * structure that is substantially different from the same subtree in the + * complete, unfiltered document. Nodes that are siblings in the + * <code>TreeWalker</code> view may be children of different, widely + * separated nodes in the original view. For instance, consider a + * <code>NodeFilter</code> that skips all nodes except for Text nodes and + * the root node of a document. In the logical view that results, all text + * nodes will be siblings and appear as direct children of the root node, no * matter how deeply nested the structure of the original document. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * @since DOM Level 2 */ public interface TreeWalker { /** - * The <code>root</code> node of the <code>TreeWalker</code>, as specified + * The <code>root</code> node of the <code>TreeWalker</code>, as specified * when it was created. */ public Node getRoot(); /** - * This attribute determines which node types are presented via the - * <code>TreeWalker</code>. The available set of constants is defined in - * the <code>NodeFilter</code> interface. Nodes not accepted by - * <code>whatToShow</code> will be skipped, but their children may still - * be considered. Note that this skip takes precedence over the filter, - * if any. + * This attribute determines which node types are presented via the + * <code>TreeWalker</code>. The available set of constants is defined in + * the <code>NodeFilter</code> interface. Nodes not accepted by + * <code>whatToShow</code> will be skipped, but their children may still + * be considered. Note that this skip takes precedence over the filter, + * if any. */ public int getWhatToShow(); @@ -56,123 +56,123 @@ public interface TreeWalker { public NodeFilter getFilter(); /** - * The value of this flag determines whether the children of entity - * reference nodes are visible to the <code>TreeWalker</code>. If false, - * these children and their descendants will be rejected. Note that - * this rejection takes precedence over <code>whatToShow</code> and the - * filter, if any. - * <br> To produce a view of the document that has entity references - * expanded and does not expose the entity reference node itself, use - * the <code>whatToShow</code> flags to hide the entity reference node - * and set <code>expandEntityReferences</code> to true when creating the - * <code>TreeWalker</code>. To produce a view of the document that has - * entity reference nodes but no entity expansion, use the - * <code>whatToShow</code> flags to show the entity reference node and + * The value of this flag determines whether the children of entity + * reference nodes are visible to the <code>TreeWalker</code>. If false, + * these children and their descendants will be rejected. Note that + * this rejection takes precedence over <code>whatToShow</code> and the + * filter, if any. + * <br> To produce a view of the document that has entity references + * expanded and does not expose the entity reference node itself, use + * the <code>whatToShow</code> flags to hide the entity reference node + * and set <code>expandEntityReferences</code> to true when creating the + * <code>TreeWalker</code>. To produce a view of the document that has + * entity reference nodes but no entity expansion, use the + * <code>whatToShow</code> flags to show the entity reference node and * set <code>expandEntityReferences</code> to false. */ public boolean getExpandEntityReferences(); /** * The node at which the <code>TreeWalker</code> is currently positioned. - * <br>Alterations to the DOM tree may cause the current node to no longer - * be accepted by the <code>TreeWalker</code>'s associated filter. - * <code>currentNode</code> may also be explicitly set to any node, - * whether or not it is within the subtree specified by the - * <code>root</code> node or would be accepted by the filter and - * <code>whatToShow</code> flags. Further traversal occurs relative to - * <code>currentNode</code> even if it is not part of the current view, - * by applying the filters in the requested direction; if no traversal - * is possible, <code>currentNode</code> is not changed. + * <br>Alterations to the DOM tree may cause the current node to no longer + * be accepted by the <code>TreeWalker</code>'s associated filter. + * <code>currentNode</code> may also be explicitly set to any node, + * whether or not it is within the subtree specified by the + * <code>root</code> node or would be accepted by the filter and + * <code>whatToShow</code> flags. Further traversal occurs relative to + * <code>currentNode</code> even if it is not part of the current view, + * by applying the filters in the requested direction; if no traversal + * is possible, <code>currentNode</code> is not changed. */ public Node getCurrentNode(); /** * The node at which the <code>TreeWalker</code> is currently positioned. - * <br>Alterations to the DOM tree may cause the current node to no longer - * be accepted by the <code>TreeWalker</code>'s associated filter. - * <code>currentNode</code> may also be explicitly set to any node, - * whether or not it is within the subtree specified by the - * <code>root</code> node or would be accepted by the filter and - * <code>whatToShow</code> flags. Further traversal occurs relative to - * <code>currentNode</code> even if it is not part of the current view, - * by applying the filters in the requested direction; if no traversal - * is possible, <code>currentNode</code> is not changed. + * <br>Alterations to the DOM tree may cause the current node to no longer + * be accepted by the <code>TreeWalker</code>'s associated filter. + * <code>currentNode</code> may also be explicitly set to any node, + * whether or not it is within the subtree specified by the + * <code>root</code> node or would be accepted by the filter and + * <code>whatToShow</code> flags. Further traversal occurs relative to + * <code>currentNode</code> even if it is not part of the current view, + * by applying the filters in the requested direction; if no traversal + * is possible, <code>currentNode</code> is not changed. * @exception DOMException - * NOT_SUPPORTED_ERR: Raised if an attempt is made to set + * NOT_SUPPORTED_ERR: Raised if an attempt is made to set * <code>currentNode</code> to <code>null</code>. */ public void setCurrentNode(Node currentNode) throws DOMException; /** - * Moves to and returns the closest visible ancestor node of the current - * node. If the search for <code>parentNode</code> attempts to step - * upward from the <code>TreeWalker</code>'s <code>root</code> node, or - * if it fails to find a visible ancestor node, this method retains the + * Moves to and returns the closest visible ancestor node of the current + * node. If the search for <code>parentNode</code> attempts to step + * upward from the <code>TreeWalker</code>'s <code>root</code> node, or + * if it fails to find a visible ancestor node, this method retains the * current position and returns <code>null</code>. - * @return The new parent node, or <code>null</code> if the current node - * has no parent in the <code>TreeWalker</code>'s logical view. + * @return The new parent node, or <code>null</code> if the current node + * has no parent in the <code>TreeWalker</code>'s logical view. */ public Node parentNode(); /** - * Moves the <code>TreeWalker</code> to the first visible child of the - * current node, and returns the new node. If the current node has no - * visible children, returns <code>null</code>, and retains the current + * Moves the <code>TreeWalker</code> to the first visible child of the + * current node, and returns the new node. If the current node has no + * visible children, returns <code>null</code>, and retains the current * node. - * @return The new node, or <code>null</code> if the current node has no - * visible children in the <code>TreeWalker</code>'s logical view. + * @return The new node, or <code>null</code> if the current node has no + * visible children in the <code>TreeWalker</code>'s logical view. */ public Node firstChild(); /** - * Moves the <code>TreeWalker</code> to the last visible child of the - * current node, and returns the new node. If the current node has no - * visible children, returns <code>null</code>, and retains the current + * Moves the <code>TreeWalker</code> to the last visible child of the + * current node, and returns the new node. If the current node has no + * visible children, returns <code>null</code>, and retains the current * node. - * @return The new node, or <code>null</code> if the current node has no - * children in the <code>TreeWalker</code>'s logical view. + * @return The new node, or <code>null</code> if the current node has no + * children in the <code>TreeWalker</code>'s logical view. */ public Node lastChild(); /** - * Moves the <code>TreeWalker</code> to the previous sibling of the - * current node, and returns the new node. If the current node has no - * visible previous sibling, returns <code>null</code>, and retains the + * Moves the <code>TreeWalker</code> to the previous sibling of the + * current node, and returns the new node. If the current node has no + * visible previous sibling, returns <code>null</code>, and retains the * current node. - * @return The new node, or <code>null</code> if the current node has no - * previous sibling. in the <code>TreeWalker</code>'s logical view. + * @return The new node, or <code>null</code> if the current node has no + * previous sibling. in the <code>TreeWalker</code>'s logical view. */ public Node previousSibling(); /** - * Moves the <code>TreeWalker</code> to the next sibling of the current - * node, and returns the new node. If the current node has no visible + * Moves the <code>TreeWalker</code> to the next sibling of the current + * node, and returns the new node. If the current node has no visible * next sibling, returns <code>null</code>, and retains the current node. - * @return The new node, or <code>null</code> if the current node has no - * next sibling. in the <code>TreeWalker</code>'s logical view. + * @return The new node, or <code>null</code> if the current node has no + * next sibling. in the <code>TreeWalker</code>'s logical view. */ public Node nextSibling(); /** - * Moves the <code>TreeWalker</code> to the previous visible node in - * document order relative to the current node, and returns the new - * node. If the current node has no previous node, or if the search for - * <code>previousNode</code> attempts to step upward from the - * <code>TreeWalker</code>'s <code>root</code> node, returns - * <code>null</code>, and retains the current node. - * @return The new node, or <code>null</code> if the current node has no - * previous node in the <code>TreeWalker</code>'s logical view. + * Moves the <code>TreeWalker</code> to the previous visible node in + * document order relative to the current node, and returns the new + * node. If the current node has no previous node, or if the search for + * <code>previousNode</code> attempts to step upward from the + * <code>TreeWalker</code>'s <code>root</code> node, returns + * <code>null</code>, and retains the current node. + * @return The new node, or <code>null</code> if the current node has no + * previous node in the <code>TreeWalker</code>'s logical view. */ public Node previousNode(); /** - * Moves the <code>TreeWalker</code> to the next visible node in document - * order relative to the current node, and returns the new node. If the - * current node has no next node, or if the search for nextNode attempts - * to step upward from the <code>TreeWalker</code>'s <code>root</code> + * Moves the <code>TreeWalker</code> to the next visible node in document + * order relative to the current node, and returns the new node. If the + * current node has no next node, or if the search for nextNode attempts + * to step upward from the <code>TreeWalker</code>'s <code>root</code> * node, returns <code>null</code>, and retains the current node. - * @return The new node, or <code>null</code> if the current node has no - * next node in the <code>TreeWalker</code>'s logical view. + * @return The new node, or <code>null</code> if the current node has no + * next node in the <code>TreeWalker</code>'s logical view. */ public Node nextNode(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/views/AbstractView.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/views/AbstractView.java index 97e8f0e2b0b..b024cc780cd 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/views/AbstractView.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/views/AbstractView.java @@ -19,7 +19,7 @@ package org.w3c.dom.views; */ public interface AbstractView { /** - * The source <code>DocumentView</code> of which this is an + * The source <code>DocumentView</code> of which this is an * <code>AbstractView</code>. */ public DocumentView getDocument(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/views/DocumentView.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/views/DocumentView.java index 2cb9eebb84b..37dfbe1a3ab 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/views/DocumentView.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/views/DocumentView.java @@ -13,16 +13,16 @@ package org.w3c.dom.views; /** - * The <code>DocumentView</code> interface is implemented by - * <code>Document</code> objects in DOM implementations supporting DOM - * Views. It provides an attribute to retrieve the default view of a + * The <code>DocumentView</code> interface is implemented by + * <code>Document</code> objects in DOM implementations supporting DOM + * Views. It provides an attribute to retrieve the default view of a * document. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113'>Document Object Model (DOM) Level 2 Views Specification</a>. * @since DOM Level 2 */ public interface DocumentView { /** - * The default <code>AbstractView</code> for this <code>Document</code>, + * The default <code>AbstractView</code> for this <code>Document</code>, * or <code>null</code> if none available. */ public AbstractView getDefaultView(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java index a85c0e811da..848c67329be 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java @@ -16,118 +16,118 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * The evaluation of XPath expressions is provided by - * <code>XPathEvaluator</code>. In a DOM implementation which supports the - * XPath 3.0 feature, as described above, the <code>XPathEvaluator</code> - * interface will be implemented on the same object which implements the - * <code>Document</code> interface permitting it to be obtained by the usual - * binding-specific method such as casting or by using the DOM Level 3 - * getInterface method. In this case the implementation obtained from the - * Document supports the XPath DOM module and is compatible with the XPath - * 1.0 specification. - * <p>Evaluation of expressions with specialized extension functions or - * variables may not work in all implementations and is, therefore, not - * portable. <code>XPathEvaluator</code> implementations may be available - * from other sources that could provide specific support for specialized - * extension functions or variables as would be defined by other - * specifications. + * The evaluation of XPath expressions is provided by + * <code>XPathEvaluator</code>. In a DOM implementation which supports the + * XPath 3.0 feature, as described above, the <code>XPathEvaluator</code> + * interface will be implemented on the same object which implements the + * <code>Document</code> interface permitting it to be obtained by the usual + * binding-specific method such as casting or by using the DOM Level 3 + * getInterface method. In this case the implementation obtained from the + * Document supports the XPath DOM module and is compatible with the XPath + * 1.0 specification. + * <p>Evaluation of expressions with specialized extension functions or + * variables may not work in all implementations and is, therefore, not + * portable. <code>XPathEvaluator</code> implementations may be available + * from other sources that could provide specific support for specialized + * extension functions or variables as would be defined by other + * specifications. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ public interface XPathEvaluator { /** - * Creates a parsed XPath expression with resolved namespaces. This is - * useful when an expression will be reused in an application since it - * makes it possible to compile the expression string into a more - * efficient internal form and preresolve all namespace prefixes which + * Creates a parsed XPath expression with resolved namespaces. This is + * useful when an expression will be reused in an application since it + * makes it possible to compile the expression string into a more + * efficient internal form and preresolve all namespace prefixes which * occur within the expression. * @param expression The XPath expression string to be parsed. - * @param resolver The <code>resolver</code> permits translation of all - * prefixes, including the <code>xml</code> namespace prefix, within - * the XPath expression into appropriate namespace URIs. If this is - * specified as <code>null</code>, any namespace prefix within the - * expression will result in <code>DOMException</code> being thrown + * @param resolver The <code>resolver</code> permits translation of all + * prefixes, including the <code>xml</code> namespace prefix, within + * the XPath expression into appropriate namespace URIs. If this is + * specified as <code>null</code>, any namespace prefix within the + * expression will result in <code>DOMException</code> being thrown * with the code <code>NAMESPACE_ERR</code>. * @return The compiled form of the XPath expression. * @exception XPathException - * INVALID_EXPRESSION_ERR: Raised if the expression is not legal + * INVALID_EXPRESSION_ERR: Raised if the expression is not legal * according to the rules of the <code>XPathEvaluator</code>. * @exception DOMException - * NAMESPACE_ERR: Raised if the expression contains namespace prefixes - * which cannot be resolved by the specified + * NAMESPACE_ERR: Raised if the expression contains namespace prefixes + * which cannot be resolved by the specified * <code>XPathNSResolver</code>. */ - public XPathExpression createExpression(String expression, + public XPathExpression createExpression(String expression, XPathNSResolver resolver) throws XPathException, DOMException; /** - * Adapts any DOM node to resolve namespaces so that an XPath expression - * can be easily evaluated relative to the context of the node where it - * appeared within the document. This adapter works like the DOM Level 3 - * method <code>lookupNamespaceURI</code> on nodes in resolving the - * namespaceURI from a given prefix using the current information - * available in the node's hierarchy at the time lookupNamespaceURI is + * Adapts any DOM node to resolve namespaces so that an XPath expression + * can be easily evaluated relative to the context of the node where it + * appeared within the document. This adapter works like the DOM Level 3 + * method <code>lookupNamespaceURI</code> on nodes in resolving the + * namespaceURI from a given prefix using the current information + * available in the node's hierarchy at the time lookupNamespaceURI is * called. also correctly resolving the implicit xml prefix. - * @param nodeResolver The node to be used as a context for namespace + * @param nodeResolver The node to be used as a context for namespace * resolution. - * @return <code>XPathNSResolver</code> which resolves namespaces with + * @return <code>XPathNSResolver</code> which resolves namespaces with * respect to the definitions in scope for a specified node. */ public XPathNSResolver createNSResolver(Node nodeResolver); /** - * Evaluates an XPath expression string and returns a result of the + * Evaluates an XPath expression string and returns a result of the * specified type if possible. - * @param expression The XPath expression string to be parsed and + * @param expression The XPath expression string to be parsed and * evaluated. - * @param contextNode The <code>context</code> is context node for the - * evaluation of this XPath expression. If the XPathEvaluator was - * obtained by casting the <code>Document</code> then this must be - * owned by the same document and must be a <code>Document</code>, - * <code>Element</code>, <code>Attribute</code>, <code>Text</code>, - * <code>CDATASection</code>, <code>Comment</code>, - * <code>ProcessingInstruction</code>, or <code>XPathNamespace</code> - * node. If the context node is a <code>Text</code> or a - * <code>CDATASection</code>, then the context is interpreted as the - * whole logical text node as seen by XPath, unless the node is empty + * @param contextNode The <code>context</code> is context node for the + * evaluation of this XPath expression. If the XPathEvaluator was + * obtained by casting the <code>Document</code> then this must be + * owned by the same document and must be a <code>Document</code>, + * <code>Element</code>, <code>Attribute</code>, <code>Text</code>, + * <code>CDATASection</code>, <code>Comment</code>, + * <code>ProcessingInstruction</code>, or <code>XPathNamespace</code> + * node. If the context node is a <code>Text</code> or a + * <code>CDATASection</code>, then the context is interpreted as the + * whole logical text node as seen by XPath, unless the node is empty * in which case it may not serve as the XPath context. - * @param resolver The <code>resolver</code> permits translation of all - * prefixes, including the <code>xml</code> namespace prefix, within - * the XPath expression into appropriate namespace URIs. If this is - * specified as <code>null</code>, any namespace prefix within the - * expression will result in <code>DOMException</code> being thrown + * @param resolver The <code>resolver</code> permits translation of all + * prefixes, including the <code>xml</code> namespace prefix, within + * the XPath expression into appropriate namespace URIs. If this is + * specified as <code>null</code>, any namespace prefix within the + * expression will result in <code>DOMException</code> being thrown * with the code <code>NAMESPACE_ERR</code>. - * @param type If a specific <code>type</code> is specified, then the - * result will be returned as the corresponding type.For XPath 1.0 - * results, this must be one of the codes of the + * @param type If a specific <code>type</code> is specified, then the + * result will be returned as the corresponding type.For XPath 1.0 + * results, this must be one of the codes of the * <code>XPathResult</code> interface. - * @param result The <code>result</code> specifies a specific result - * object which may be reused and returned by this method. If this is - * specified as <code>null</code>or the implementation does not reuse - * the specified result, a new result object will be constructed and - * returned.For XPath 1.0 results, this object will be of type + * @param result The <code>result</code> specifies a specific result + * object which may be reused and returned by this method. If this is + * specified as <code>null</code>or the implementation does not reuse + * the specified result, a new result object will be constructed and + * returned.For XPath 1.0 results, this object will be of type * <code>XPathResult</code>. - * @return The result of the evaluation of the XPath expression.For XPath + * @return The result of the evaluation of the XPath expression.For XPath * 1.0 results, this object will be of type <code>XPathResult</code>. * @exception XPathException - * INVALID_EXPRESSION_ERR: Raised if the expression is not legal + * INVALID_EXPRESSION_ERR: Raised if the expression is not legal * according to the rules of the <code>XPathEvaluator</code>i - * <br>TYPE_ERR: Raised if the result cannot be converted to return the + * <br>TYPE_ERR: Raised if the result cannot be converted to return the * specified type. * @exception DOMException - * NAMESPACE_ERR: Raised if the expression contains namespace prefixes - * which cannot be resolved by the specified + * NAMESPACE_ERR: Raised if the expression contains namespace prefixes + * which cannot be resolved by the specified * <code>XPathNSResolver</code>. - * <br>WRONG_DOCUMENT_ERR: The Node is from a document that is not + * <br>WRONG_DOCUMENT_ERR: The Node is from a document that is not * supported by this <code>XPathEvaluator</code>. - * <br>NOT_SUPPORTED_ERR: The Node is not a type permitted as an XPath - * context node or the request type is not permitted by this + * <br>NOT_SUPPORTED_ERR: The Node is not a type permitted as an XPath + * context node or the request type is not permitted by this * <code>XPathEvaluator</code>. */ - public Object evaluate(String expression, - Node contextNode, - XPathNSResolver resolver, - short type, + public Object evaluate(String expression, + Node contextNode, + XPathNSResolver resolver, + short type, Object result) throws XPathException, DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathException.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathException.java index deb1bd78394..6b13cdf00a8 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathException.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathException.java @@ -13,7 +13,7 @@ package org.w3c.dom.xpath; /** - * A new exception has been created for exceptions specific to these XPath + * A new exception has been created for exceptions specific to these XPath * interfaces. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ @@ -25,9 +25,9 @@ public class XPathException extends RuntimeException { public short code; // XPathExceptionCode /** - * If the expression has a syntax error or otherwise is not a legal - * expression according to the rules of the specific - * <code>XPathEvaluator</code> or contains specialized extension + * If the expression has a syntax error or otherwise is not a legal + * expression according to the rules of the specific + * <code>XPathEvaluator</code> or contains specialized extension * functions or variables not supported by this implementation. */ public static final short INVALID_EXPRESSION_ERR = 51; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java index e972532544d..ab5d28c43d6 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java @@ -16,49 +16,49 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * The <code>XPathExpression</code> interface represents a parsed and resolved + * The <code>XPathExpression</code> interface represents a parsed and resolved * XPath expression. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ public interface XPathExpression { /** * Evaluates this XPath expression and returns a result. - * @param contextNode The <code>context</code> is context node for the - * evaluation of this XPath expression.If the XPathEvaluator was - * obtained by casting the <code>Document</code> then this must be - * owned by the same document and must be a <code>Document</code>, - * <code>Element</code>, <code>Attribute</code>, <code>Text</code>, - * <code>CDATASection</code>, <code>Comment</code>, - * <code>ProcessingInstruction</code>, or <code>XPathNamespace</code> - * node.If the context node is a <code>Text</code> or a - * <code>CDATASection</code>, then the context is interpreted as the - * whole logical text node as seen by XPath, unless the node is empty + * @param contextNode The <code>context</code> is context node for the + * evaluation of this XPath expression.If the XPathEvaluator was + * obtained by casting the <code>Document</code> then this must be + * owned by the same document and must be a <code>Document</code>, + * <code>Element</code>, <code>Attribute</code>, <code>Text</code>, + * <code>CDATASection</code>, <code>Comment</code>, + * <code>ProcessingInstruction</code>, or <code>XPathNamespace</code> + * node.If the context node is a <code>Text</code> or a + * <code>CDATASection</code>, then the context is interpreted as the + * whole logical text node as seen by XPath, unless the node is empty * in which case it may not serve as the XPath context. - * @param type If a specific <code>type</code> is specified, then the - * result will be coerced to return the specified type relying on - * XPath conversions and fail if the desired coercion is not possible. + * @param type If a specific <code>type</code> is specified, then the + * result will be coerced to return the specified type relying on + * XPath conversions and fail if the desired coercion is not possible. * This must be one of the type codes of <code>XPathResult</code>. - * @param result The <code>result</code> specifies a specific result - * object which may be reused and returned by this method. If this is - * specified as <code>null</code>or the implementation does not reuse - * the specified result, a new result object will be constructed and - * returned.For XPath 1.0 results, this object will be of type + * @param result The <code>result</code> specifies a specific result + * object which may be reused and returned by this method. If this is + * specified as <code>null</code>or the implementation does not reuse + * the specified result, a new result object will be constructed and + * returned.For XPath 1.0 results, this object will be of type * <code>XPathResult</code>. - * @return The result of the evaluation of the XPath expression.For XPath + * @return The result of the evaluation of the XPath expression.For XPath * 1.0 results, this object will be of type <code>XPathResult</code>. * @exception XPathException - * TYPE_ERR: Raised if the result cannot be converted to return the + * TYPE_ERR: Raised if the result cannot be converted to return the * specified type. * @exception DOMException - * WRONG_DOCUMENT_ERR: The Node is from a document that is not supported + * WRONG_DOCUMENT_ERR: The Node is from a document that is not supported * by the XPathEvaluator that created this <code>XPathExpression</code> * . - * <br>NOT_SUPPORTED_ERR: The Node is not a type permitted as an XPath - * context node or the request type is not permitted by this + * <br>NOT_SUPPORTED_ERR: The Node is not a type permitted as an XPath + * context node or the request type is not permitted by this * <code>XPathExpression</code>. */ - public Object evaluate(Node contextNode, - short type, + public Object evaluate(Node contextNode, + short type, Object result) throws XPathException, DOMException; diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java index b8f05213812..5ce068de9d7 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java @@ -13,20 +13,20 @@ package org.w3c.dom.xpath; /** - * The <code>XPathNSResolver</code> interface permit <code>prefix</code> - * strings in the expression to be properly bound to - * <code>namespaceURI</code> strings. <code>XPathEvaluator</code> can - * construct an implementation of <code>XPathNSResolver</code> from a node, + * The <code>XPathNSResolver</code> interface permit <code>prefix</code> + * strings in the expression to be properly bound to + * <code>namespaceURI</code> strings. <code>XPathEvaluator</code> can + * construct an implementation of <code>XPathNSResolver</code> from a node, * or the interface may be implemented by any application. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ public interface XPathNSResolver { /** - * Look up the namespace URI associated to the given namespace prefix. The - * XPath evaluator must never call this with a <code>null</code> or + * Look up the namespace URI associated to the given namespace prefix. The + * XPath evaluator must never call this with a <code>null</code> or * empty argument, because the result of doing this is undefined. * @param prefix The prefix to look for. - * @return Returns the associated namespace URI or <code>null</code> if + * @return Returns the associated namespace URI or <code>null</code> if * none is found. */ public String lookupNamespaceURI(String prefix); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java index 9f15481d584..d644051f21a 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java @@ -16,36 +16,36 @@ import org.w3c.dom.Element; import org.w3c.dom.Node; /** - * The <code>XPathNamespace</code> interface is returned by - * <code>XPathResult</code> interfaces to represent the XPath namespace node - * type that DOM lacks. There is no public constructor for this node type. - * Attempts to place it into a hierarchy or a NamedNodeMap result in a + * The <code>XPathNamespace</code> interface is returned by + * <code>XPathResult</code> interfaces to represent the XPath namespace node + * type that DOM lacks. There is no public constructor for this node type. + * Attempts to place it into a hierarchy or a NamedNodeMap result in a * <code>DOMException</code> with the code <code>HIERARCHY_REQUEST_ERR</code> - * . This node is read only, so methods or setting of attributes that would - * mutate the node result in a DOMException with the code + * . This node is read only, so methods or setting of attributes that would + * mutate the node result in a DOMException with the code * <code>NO_MODIFICATION_ALLOWED_ERR</code>. - * <p>The core specification describes attributes of the <code>Node</code> - * interface that are different for different node types but does not - * describe <code>XPATH_NAMESPACE_NODE</code>, so here is a description of - * those attributes for this node type. All attributes of <code>Node</code> - * not described in this section have a <code>null</code> or + * <p>The core specification describes attributes of the <code>Node</code> + * interface that are different for different node types but does not + * describe <code>XPATH_NAMESPACE_NODE</code>, so here is a description of + * those attributes for this node type. All attributes of <code>Node</code> + * not described in this section have a <code>null</code> or * <code>false</code> value. - * <p><code>ownerDocument</code> matches the <code>ownerDocument</code> of the + * <p><code>ownerDocument</code> matches the <code>ownerDocument</code> of the * <code>ownerElement</code> even if the element is later adopted. * <p><code>nodeName</code> is always the string "<code>#namespace</code>". - * <p><code>prefix</code> is the prefix of the namespace represented by the + * <p><code>prefix</code> is the prefix of the namespace represented by the * node. * <p><code>localName</code> is the same as <code>prefix</code>. * <p><code>nodeType</code> is equal to <code>XPATH_NAMESPACE_NODE</code>. - * <p><code>namespaceURI</code> is the namespace URI of the namespace + * <p><code>namespaceURI</code> is the namespace URI of the namespace * represented by the node. * <p><code>nodeValue</code> is the same as <code>namespaceURI</code>. - * <p><code>adoptNode</code>, <code>cloneNode</code>, and - * <code>importNode</code> fail on this node type by raising a + * <p><code>adoptNode</code>, <code>cloneNode</code>, and + * <code>importNode</code> fail on this node type by raising a * <code>DOMException</code> with the code <code>NOT_SUPPORTED_ERR</code>. - * <p ><b>Note:</b> In future versions of the XPath specification, the - * definition of a namespace node may be changed incomatibly, in which case - * incompatible changes to field values may be required to implement + * <p ><b>Note:</b> In future versions of the XPath specification, the + * definition of a namespace node may be changed incomatibly, in which case + * incompatible changes to field values may be required to implement * versions beyond XPath 1.0. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ @@ -57,9 +57,9 @@ public interface XPathNamespace extends Node { public static final short XPATH_NAMESPACE_NODE = 13; /** - * The <code>Element</code> on which the namespace was in scope when it - * was requested. This does not change on a returned namespace node even - * if the document changes such that the namespace goes out of scope on + * The <code>Element</code> on which the namespace was in scope when it + * was requested. This does not change on a returned namespace node even + * if the document changes such that the namespace goes out of scope on * that element and this node is no longer found there by XPath. */ public Element getOwnerElement(); diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathResult.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathResult.java index 56064b90ecf..06fd29dac91 100644 --- a/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathResult.java +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/xpath/XPathResult.java @@ -16,115 +16,115 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * The <code>XPathResult</code> interface represents the result of the - * evaluation of an XPath 1.0 expression within the context of a particular - * node. Since evaluation of an XPath expression can result in various - * result types, this object makes it possible to discover and manipulate + * The <code>XPathResult</code> interface represents the result of the + * evaluation of an XPath 1.0 expression within the context of a particular + * node. Since evaluation of an XPath expression can result in various + * result types, this object makes it possible to discover and manipulate * the type and value of the result. * <p>See also the <a href='http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226'>Document Object Model (DOM) Level 3 XPath Specification</a>. */ public interface XPathResult { // XPathResultType /** - * This code does not represent a specific type. An evaluation of an XPath - * expression will never produce this type. If this type is requested, - * then the evaluation returns whatever type naturally results from - * evaluation of the expression. - * <br>If the natural result is a node set when <code>ANY_TYPE</code> was - * requested, then <code>UNORDERED_NODE_ITERATOR_TYPE</code> is always - * the resulting type. Any other representation of a node set must be + * This code does not represent a specific type. An evaluation of an XPath + * expression will never produce this type. If this type is requested, + * then the evaluation returns whatever type naturally results from + * evaluation of the expression. + * <br>If the natural result is a node set when <code>ANY_TYPE</code> was + * requested, then <code>UNORDERED_NODE_ITERATOR_TYPE</code> is always + * the resulting type. Any other representation of a node set must be * explicitly requested. */ public static final short ANY_TYPE = 0; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#numbers'>number</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. - * Document modification does not invalidate the number, but may mean + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#numbers'>number</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. + * Document modification does not invalidate the number, but may mean * that reevaluation would not yield the same number. */ public static final short NUMBER_TYPE = 1; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#strings'>string</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. - * Document modification does not invalidate the string, but may mean + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#strings'>string</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. + * Document modification does not invalidate the string, but may mean * that the string no longer corresponds to the current document. */ public static final short STRING_TYPE = 2; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#booleans'>boolean</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. - * Document modification does not invalidate the boolean, but may mean + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#booleans'>boolean</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>]. + * Document modification does not invalidate the boolean, but may mean * that reevaluation would not yield the same boolean. */ public static final short BOOLEAN_TYPE = 3; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that - * will be accessed iteratively, which may not produce nodes in a + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that + * will be accessed iteratively, which may not produce nodes in a * particular order. Document modification invalidates the iteration. - * <br>This is the default type returned if the result is a node set and + * <br>This is the default type returned if the result is a node set and * <code>ANY_TYPE</code> is requested. */ public static final short UNORDERED_NODE_ITERATOR_TYPE = 4; /** - * The result is a node set as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that - * will be accessed iteratively, which will produce document-ordered + * The result is a node set as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that + * will be accessed iteratively, which will produce document-ordered * nodes. Document modification invalidates the iteration. */ public static final short ORDERED_NODE_ITERATOR_TYPE = 5; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that - * will be accessed as a snapshot list of nodes that may not be in a - * particular order. Document modification does not invalidate the - * snapshot but may mean that reevaluation would not yield the same - * snapshot and nodes in the snapshot may have been altered, moved, or + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that + * will be accessed as a snapshot list of nodes that may not be in a + * particular order. Document modification does not invalidate the + * snapshot but may mean that reevaluation would not yield the same + * snapshot and nodes in the snapshot may have been altered, moved, or * removed from the document. */ public static final short UNORDERED_NODE_SNAPSHOT_TYPE = 6; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that - * will be accessed as a snapshot list of nodes that will be in original - * document order. Document modification does not invalidate the - * snapshot but may mean that reevaluation would not yield the same - * snapshot and nodes in the snapshot may have been altered, moved, or + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] that + * will be accessed as a snapshot list of nodes that will be in original + * document order. Document modification does not invalidate the + * snapshot but may mean that reevaluation would not yield the same + * snapshot and nodes in the snapshot may have been altered, moved, or * removed from the document. */ public static final short ORDERED_NODE_SNAPSHOT_TYPE = 7; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] and - * will be accessed as a single node, which may be <code>null</code>if - * the node set is empty. Document modification does not invalidate the - * node, but may mean that the result node no longer corresponds to the - * current document. This is a convenience that permits optimization - * since the implementation can stop once any node in the resulting set + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] and + * will be accessed as a single node, which may be <code>null</code>if + * the node set is empty. Document modification does not invalidate the + * node, but may mean that the result node no longer corresponds to the + * current document. This is a convenience that permits optimization + * since the implementation can stop once any node in the resulting set * has been found. - * <br>If there is more than one node in the actual result, the single + * <br>If there is more than one node in the actual result, the single * node returned might not be the first in document order. */ public static final short ANY_UNORDERED_NODE_TYPE = 8; /** - * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] and - * will be accessed as a single node, which may be <code>null</code> if - * the node set is empty. Document modification does not invalidate the - * node, but may mean that the result node no longer corresponds to the - * current document. This is a convenience that permits optimization - * since the implementation can stop once the first node in document + * The result is a <a href='http://www.w3.org/TR/1999/REC-xpath-19991116#node-sets'>node set</a> as defined by [<a href='http://www.w3.org/TR/1999/REC-xpath-19991116'>XPath 1.0</a>] and + * will be accessed as a single node, which may be <code>null</code> if + * the node set is empty. Document modification does not invalidate the + * node, but may mean that the result node no longer corresponds to the + * current document. This is a convenience that permits optimization + * since the implementation can stop once the first node in document * order of the resulting set has been found. - * <br>If there are more than one node in the actual result, the single + * <br>If there are more than one node in the actual result, the single * node returned will be the first in document order. */ public static final short FIRST_ORDERED_NODE_TYPE = 9; /** - * A code representing the type of this result, as defined by the type + * A code representing the type of this result, as defined by the type * constants. */ public short getResultType(); /** - * The value of this number result. If the native double type of the DOM - * binding does not directly support the exact IEEE 754 result of the - * XPath expression, then it is up to the definition of the binding to - * specify how the XPath number is converted to the native binding + * The value of this number result. If the native double type of the DOM + * binding does not directly support the exact IEEE 754 result of the + * XPath expression, then it is up to the definition of the binding to + * specify how the XPath number is converted to the native binding * number. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not + * TYPE_ERR: raised if <code>resultType</code> is not * <code>NUMBER_TYPE</code>. */ public double getNumberValue() @@ -133,7 +133,7 @@ public interface XPathResult { /** * The value of this string result. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not + * TYPE_ERR: raised if <code>resultType</code> is not * <code>STRING_TYPE</code>. */ public String getStringValue() @@ -142,7 +142,7 @@ public interface XPathResult { /** * The value of this boolean result. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not + * TYPE_ERR: raised if <code>resultType</code> is not * <code>BOOLEAN_TYPE</code>. */ public boolean getBooleanValue() @@ -151,61 +151,61 @@ public interface XPathResult { /** * The value of this single node result, which may be <code>null</code>. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not - * <code>ANY_UNORDERED_NODE_TYPE</code> or + * TYPE_ERR: raised if <code>resultType</code> is not + * <code>ANY_UNORDERED_NODE_TYPE</code> or * <code>FIRST_ORDERED_NODE_TYPE</code>. */ public Node getSingleNodeValue() throws XPathException; /** - * Signifies that the iterator has become invalid. True if - * <code>resultType</code> is <code>UNORDERED_NODE_ITERATOR_TYPE</code> - * or <code>ORDERED_NODE_ITERATOR_TYPE</code> and the document has been + * Signifies that the iterator has become invalid. True if + * <code>resultType</code> is <code>UNORDERED_NODE_ITERATOR_TYPE</code> + * or <code>ORDERED_NODE_ITERATOR_TYPE</code> and the document has been * modified since this result was returned. */ public boolean getInvalidIteratorState(); /** - * The number of nodes in the result snapshot. Valid values for - * snapshotItem indices are <code>0</code> to + * The number of nodes in the result snapshot. Valid values for + * snapshotItem indices are <code>0</code> to * <code>snapshotLength-1</code> inclusive. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not - * <code>UNORDERED_NODE_SNAPSHOT_TYPE</code> or + * TYPE_ERR: raised if <code>resultType</code> is not + * <code>UNORDERED_NODE_SNAPSHOT_TYPE</code> or * <code>ORDERED_NODE_SNAPSHOT_TYPE</code>. */ public int getSnapshotLength() throws XPathException; /** - * Iterates and returns the next node from the node set or + * Iterates and returns the next node from the node set or * <code>null</code>if there are no more nodes. * @return Returns the next node. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not - * <code>UNORDERED_NODE_ITERATOR_TYPE</code> or + * TYPE_ERR: raised if <code>resultType</code> is not + * <code>UNORDERED_NODE_ITERATOR_TYPE</code> or * <code>ORDERED_NODE_ITERATOR_TYPE</code>. * @exception DOMException - * INVALID_STATE_ERR: The document has been mutated since the result was + * INVALID_STATE_ERR: The document has been mutated since the result was * returned. */ public Node iterateNext() throws XPathException, DOMException; /** - * Returns the <code>index</code>th item in the snapshot collection. If - * <code>index</code> is greater than or equal to the number of nodes in - * the list, this method returns <code>null</code>. Unlike the iterator - * result, the snapshot does not become invalid, but may not correspond + * Returns the <code>index</code>th item in the snapshot collection. If + * <code>index</code> is greater than or equal to the number of nodes in + * the list, this method returns <code>null</code>. Unlike the iterator + * result, the snapshot does not become invalid, but may not correspond * to the current document if it is mutated. * @param index Index into the snapshot collection. - * @return The node at the <code>index</code>th position in the - * <code>NodeList</code>, or <code>null</code> if that is not a valid + * @return The node at the <code>index</code>th position in the + * <code>NodeList</code>, or <code>null</code> if that is not a valid * index. * @exception XPathException - * TYPE_ERR: raised if <code>resultType</code> is not - * <code>UNORDERED_NODE_SNAPSHOT_TYPE</code> or + * TYPE_ERR: raised if <code>resultType</code> is not + * <code>UNORDERED_NODE_SNAPSHOT_TYPE</code> or * <code>ORDERED_NODE_SNAPSHOT_TYPE</code>. */ public Node snapshotItem(int index) |