## Deprecated API

Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Interfaces
org.gjt.sp.jedit.MiscUtilities.Compare
com.microstar.xml.XmlHandler

Deprecated Classes
org.gjt.sp.jedit.Buffer.TokenList Use org.gjt.sp.jedit.syntax.DefaultTokenHandler instead
com.microstar.xml.HandlerBase use org.xml.sax.helpers.DefaultHandler
org.gjt.sp.jedit.MiscUtilities.MenuItemCompare Replaced with `MenuItemTextComparator`
org.gjt.sp.jedit.MiscUtilities.StringCompare use `StandardUtilities.StringCompare`
org.gjt.sp.jedit.MiscUtilities.StringICaseCompare use `StandardUtilities.StringCompare`
org.gjt.sp.util.ReadWriteLock Use java.util.concurrent.locks.ReentrantReadWriteLock which is available since J2SE 5.0 (1.5). This class was written for J2SE 1.4, and is still here only for compatibility.
org.gjt.sp.jedit.io.VFS.DirectoryEntry Use `VFSFile` instead.
com.microstar.xml.XmlParser use org.xml.sax.XMLReader

Deprecated Exceptions
com.microstar.xml.XmlException use import org.xml.sax.SAXParseException

Deprecated Fields
org.gjt.sp.jedit.View.ABOVE_ACTION_BAR_LAYER Status bar no longer added as a tool bar.
org.gjt.sp.jedit.io.VFSFile.canRead Use the accessor/mutator methods instead.
org.gjt.sp.jedit.io.VFSFile.canWrite Use the accessor/mutator methods instead.
org.gjt.sp.jedit.io.VFSFile.deletePath Use the accessor/mutator methods instead.
org.gjt.sp.jedit.GUIUtilities.DIRTY_BUFFER_ICON Use `GUIUtilities.loadIcon("dirty.gif");` instead.
org.gjt.sp.jedit.syntax.ParserRule.EXCLUDE_MATCH
org.gjt.sp.jedit.bufferio.BufferIORequest.GZIP_MAGIC_1
org.gjt.sp.jedit.bufferio.BufferIORequest.GZIP_MAGIC_2
org.gjt.sp.jedit.io.VFSFile.hidden Use the accessor/mutator methods instead.
org.gjt.sp.jedit.io.VFSFile.length Use the accessor/mutator methods instead.
org.gjt.sp.jedit.io.FileVFS.LocalFile.modified Call getModified() instead.
org.gjt.sp.jedit.io.VFSFile.name Use the accessor/mutator methods instead.
org.gjt.sp.jedit.GUIUtilities.NEW_BUFFER_ICON Use `GUIUtilities.loadIcon("new.gif");` instead.
org.gjt.sp.jedit.syntax.ParserRule.next As the linking between rules is not anymore done within the rule but external. See `ParserRuleSet.getRules(Character)`
org.gjt.sp.jedit.syntax.ParserRule.NO_ESCAPE
org.gjt.sp.jedit.GUIUtilities.NORMAL_BUFFER_ICON Use `GUIUtilities.loadIcon("normal.gif");` instead.
org.gjt.sp.jedit.io.VFSFile.path Use the accessor/mutator methods instead.
org.gjt.sp.jedit.GUIUtilities.READ_ONLY_BUFFER_ICON Use `GUIUtilities.loadIcon("readonly.gif");` instead.
org.gjt.sp.jedit.buffer.FoldHandler.SERVICE use `ServiceManager.ServiceFoldHandlerProvider`
org.gjt.sp.jedit.io.VFSFile.symlinkPath Use the accessor/mutator methods instead.
org.gjt.sp.jedit.io.VFSFile.type Use the accessor/mutator methods instead.
org.gjt.sp.jedit.bufferio.BufferIORequest.UNICODE_MAGIC_1
org.gjt.sp.jedit.bufferio.BufferIORequest.UNICODE_MAGIC_2
org.gjt.sp.jedit.MiscUtilities.UTF_8_Y Extended encodings are now supported as services. This value is no longer used.
org.gjt.sp.jedit.bufferio.BufferIORequest.UTF8_MAGIC_1
org.gjt.sp.jedit.bufferio.BufferIORequest.UTF8_MAGIC_2
org.gjt.sp.jedit.bufferio.BufferIORequest.UTF8_MAGIC_3
org.gjt.sp.jedit.GUIUtilities.WINDOW_ICON Use `GUIUtilities.loadIcon("jedit-icon.gif");` instead.
org.gjt.sp.jedit.bufferio.BufferIORequest.XML_PI_LENGTH

Deprecated Methods
org.gjt.sp.jedit.io.VFS._getDirectoryEntry(Object, String, Component) Use `_getFile()` instead.
org.gjt.sp.jedit.io.VFS._listDirectory(Object, String, Component) Use `_listFiles()` instead.
org.gjt.sp.jedit.Buffer.addBufferChangeListener(BufferChangeListener) Call `JEditBuffer.addBufferListener(BufferListener)`.
org.gjt.sp.jedit.Buffer.addBufferChangeListener(BufferChangeListener, int) Call `JEditBuffer.addBufferListener(BufferListener,int)`.
org.gjt.sp.jedit.GUIUtilities.centerOnScreen(Window) use `Window.setLocationRelativeTo(java.awt.Component)`
org.gjt.sp.jedit.MiscUtilities.charsToEntities(String) Use `XMLUtilities.charsToEntities(String, boolean)`.
org.gjt.sp.jedit.MiscUtilities.charsToEscapes(String) use `StandardUtilities.charsToEscapes(String)`
org.gjt.sp.jedit.MiscUtilities.charsToEscapes(String, String) use `StandardUtilities.charsToEscapes(String)`
org.gjt.sp.jedit.gui.HistoryModel.clear() Call `removeAllElements()` instead.
org.gjt.sp.jedit.MiscUtilities.closeQuietly(InputStream) use `IOUtilities.closeQuietly(java.io.InputStream)`
org.gjt.sp.jedit.MiscUtilities.closeQuietly(OutputStream) use `IOUtilities.closeQuietly(java.io.OutputStream)`
org.gjt.sp.jedit.MiscUtilities.compareStrings(String, String, boolean) use `StandardUtilities.compareStrings(String, String, boolean)`
org.gjt.sp.jedit.MiscUtilities.compareVersions(String, String) Call `StandardUtilities.compareStrings(String, String, boolean)` instead
org.gjt.sp.jedit.MiscUtilities.copyStream(int, ProgressObserver, InputStream, OutputStream, boolean) use `IOUtilities.copyStream(int, org.gjt.sp.util.ProgressObserver, java.io.InputStream, java.io.OutputStream, boolean)`
org.gjt.sp.jedit.MiscUtilities.copyStream(ProgressObserver, InputStream, OutputStream, boolean) use `IOUtilities.copyStream(org.gjt.sp.util.ProgressObserver, java.io.InputStream, java.io.OutputStream, boolean)`
org.gjt.sp.jedit.EditPlugin.createMenuItems(Vector) Instead of overriding this method, define properties as specified in the description of this class.
org.gjt.sp.jedit.EditPlugin.createOptionPanes(OptionsDialog) Instead of overriding this method, define properties as specified in the description of this class.
org.gjt.sp.jedit.syntax.ParserRule.createRegexpEOLSpanRule(char, int, String, ParserRuleSet, byte, byte, boolean) Use `ParserRule.createRegexpEOLSpanRule(String,int,String,ParserRuleSet,byte,byte,boolean)` instead
org.gjt.sp.jedit.syntax.ParserRule.createRegexpSequenceRule(char, int, String, ParserRuleSet, byte, boolean) Use `ParserRule.createRegexpSequenceRule(String,int,String,ParserRuleSet,byte,boolean)` instead
org.gjt.sp.jedit.jEdit.createTextArea() use new JEditEmbeddedTextArea() instead
org.gjt.sp.jedit.MiscUtilities.createWhiteSpace(int, int) use `StandardUtilities.createWhiteSpace(int, int)`
org.gjt.sp.jedit.MiscUtilities.createWhiteSpace(int, int, int) use `StandardUtilities.createWhiteSpace(int, int, int)`
org.gjt.sp.jedit.io.VFSManager.error(Component, String, Object[]) Call the other `error()` method instead.
org.gjt.sp.jedit.BeanShell.eval(View, NameSpace, String, boolean) The `rethrowBshErrors` parameter is now obsolete; call `_eval()` or `eval()` instead.
org.gjt.sp.jedit.BeanShell.eval(View, String, boolean) The `rethrowBshErrors` parameter is now obsolete; call `_eval()` or `eval()` instead.
org.gjt.sp.jedit.MiscUtilities.findEntity(String, String, Class) Use `XMLUtilities.findEntity(String,String,Class)`.
org.gjt.sp.jedit.PluginJAR.getActions() Call getActionSet() instead
org.gjt.sp.jedit.jEdit.getActions() Call getActionNames() instead
org.gjt.sp.jedit.jEdit.getActionSetForAction(EditAction) Use the form that takes a String instead
org.gjt.sp.jedit.indent.BracketIndentRule.getBrackets(String) Use `BracketIndentRule.getBrackets(JEditBuffer,int,int,int)` instead. Brackets in comments or literals should be ignored for indent. But it can't be done without syntax parsing of a buffer.
org.gjt.sp.jedit.GUIUtilities.getColorHexString(Color) use `SyntaxUtilities.parseStyle(String,String,int,boolean)`
org.gjt.sp.jedit.bsh.JavaCharStream.getColumn()
org.gjt.sp.jedit.EditBus.getComponents() Don't use this method. It now returns an empty array.
org.gjt.sp.jedit.MiscUtilities.getEncodings() See #getEncodings(boolean)
org.gjt.sp.jedit.Buffer.getFile() Do not call this method, use `Buffer.getPath()` instead.
org.gjt.sp.jedit.browser.VFSBrowser.getFilenameFilter() Use `VFSBrowser.getVFSFileFilter()` instead. This method might return wrong information since jEdit 4.3pre6.
org.gjt.sp.jedit.MiscUtilities.getFileParent(String) Call getParentOfPath() instead
org.gjt.sp.jedit.MiscUtilities.getFileProtocol(String) Call getProtocolOfURL() instead
org.gjt.sp.jedit.io.VFSManager.getFilesystems() Use `getVFSs()` instead.
org.gjt.sp.jedit.MiscUtilities.getLeadingWhiteSpace(String) use `StandardUtilities.getLeadingWhiteSpace(String)`
org.gjt.sp.jedit.MiscUtilities.getLeadingWhiteSpaceWidth(String, int) use `StandardUtilities.getLeadingWhiteSpace(String)`
org.gjt.sp.jedit.bsh.JavaCharStream.getLine()
org.gjt.sp.jedit.Buffer.getMarkersPath(VFS) it will fail if you save to another VFS. use `Buffer.getMarkersPath(VFS, String)`
org.gjt.sp.jedit.textarea.TextArea.getMarkLine() Do not use.
org.gjt.sp.jedit.textarea.TextArea.getMarkPosition() Do not use.
org.gjt.sp.jedit.MiscUtilities.getOffsetOfVirtualColumn(Segment, int, int, int[]) use `StandardUtilities.getVirtualWidth(javax.swing.text.Segment, int)`
org.gjt.sp.jedit.syntax.ParserRuleSet.getRules(char) As the linking between rules is not anymore done within the rule, use `ParserRuleSet.getRules(Character)` instead
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionEnd() Instead, obtain a Selection instance using any means, and call its `getEnd()` method
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionEnd(int) Instead, obtain a Selection instance using any means, and call its `getEnd(int)` method
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionEndLine() Instead, obtain a Selection instance using any means, and call its `getEndLine()` method
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionStart() Instead, obtain a Selection instance using any means, and call its `getStart()` method
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionStart(int) Instead, obtain a Selection instance using any means, and call its `getStart(int)` method
org.gjt.sp.jedit.textarea.JEditTextArea.getSelectionStartLine() Instead, obtain a Selection instance using any means, and call its `getStartLine()` method
org.gjt.sp.jedit.MiscUtilities.getTrailingWhiteSpace(String) use `StandardUtilities.getTrailingWhiteSpace(String)`
org.gjt.sp.jedit.io.VFSManager.getVFSByName(String) Use `getVFSForProtocol()` instead.
org.gjt.sp.jedit.EditAction.getView(Component) Call `GUIUtilities.getView()` instead.
org.gjt.sp.jedit.MiscUtilities.getVirtualWidth(Segment, int) use `StandardUtilities.getVirtualWidth(javax.swing.text.Segment, int)`
org.gjt.sp.jedit.JARClassLoader.getZipFile() Call `PluginJAR.getZipFile()` instead.
org.gjt.sp.jedit.MiscUtilities.globToRE(String) Use `StandardUtilities.globToRE(String)`.
org.gjt.sp.jedit.OperatingSystem.hasJava14()
org.gjt.sp.jedit.OperatingSystem.hasJava15()
org.gjt.sp.jedit.buffer.JEditBuffer.indentLine(int, boolean, boolean) Use `JEditBuffer.indentLine(int,boolean)` instead.
org.gjt.sp.jedit.Buffer.insertString(int, String, AttributeSet) Call `insert()` instead.
org.gjt.sp.jedit.textarea.TextAreaPainter.isAntiAliasEnabled() - use @ref getAntiAlias()
org.gjt.sp.jedit.MiscUtilities.isBinary(Reader) Use isBinary(InputStream) instead.
org.gjt.sp.jedit.textarea.TextArea.isDragInProgress() the org.gjt.jedit.Java14 class no longer exists.
org.gjt.sp.jedit.buffer.JEditBuffer.isElectricKey(char) Use #isElectricKey(char,int)
org.gjt.sp.jedit.indent.RegexpIndentRule.isMatch(String) Do not use this. This is here only for compatibility.
org.gjt.sp.jedit.indent.CloseBracketIndentRule.isMatch(String) This method calls BracketIndentRule#getBrackets(String) which has been deprecated.
org.gjt.sp.jedit.textarea.JEditTextArea.isSelectionRectangular() Instead, check if the appropriate Selection is an instance of the Selection.Rect class.
org.gjt.sp.jedit.GUIUtilities.loadStyles(String, int) use `SyntaxUtilities.loadStyles(String,int)`
org.gjt.sp.jedit.GUIUtilities.loadStyles(String, int, boolean) use `SyntaxUtilities.loadStyles(String,int,boolean)`
org.gjt.sp.jedit.Buffer.markTokens(int) Use the other form of `markTokens()` instead
org.gjt.sp.jedit.MiscUtilities.moveFile(File, File) use `IOUtilities.moveFile(java.io.File, java.io.File)`
org.gjt.sp.jedit.MiscUtilities.objectsEqual(Object, Object) use `StandardUtilities.objectsEqual(Object, Object)`
org.gjt.sp.jedit.jEdit.openFile(View, String, String, boolean, boolean) The openFile() forms with the readOnly parameter should not be used. The readOnly prameter is no longer supported.
org.gjt.sp.jedit.jEdit.openFile(View, String, String, boolean, boolean, Hashtable) The openFile() forms with the readOnly parameter should not be used. The readOnly prameter is no longer supported.
org.gjt.sp.jedit.GUIUtilities.parseColor(String, Color) use `SyntaxUtilities.parseColor(String,Color)`
org.gjt.sp.jedit.GUIUtilities.parseStyle(String, String, int, boolean) use `SyntaxUtilities.parseStyle(String,String,int,boolean)`
org.gjt.sp.jedit.MiscUtilities.parseXML(InputStream, DefaultHandler) Use `XMLUtilities.parseXML(InputStream,DefaultHandler)`.
org.gjt.sp.jedit.View.processKeyEvent(KeyEvent, int, boolean) do not use, try `InputHandler.processKeyEvent(java.awt.event.KeyEvent, int, boolean)`
org.gjt.sp.jedit.Buffer.putBooleanProperty(String, boolean) Call `setBooleanProperty()` instead
org.gjt.sp.jedit.Buffer.putProperty(Object, Object) Call `setProperty()` instead.
org.gjt.sp.jedit.MiscUtilities.quicksort(List, Comparator) `Collections.sort()`
org.gjt.sp.jedit.MiscUtilities.quicksort(Object[], Comparator) use `Arrays.sort()`
org.gjt.sp.jedit.MiscUtilities.quicksort(Object[], MiscUtilities.Compare) use `Arrays.sort()`
org.gjt.sp.jedit.MiscUtilities.quicksort(Vector, Comparator) `Collections.sort()`
org.gjt.sp.jedit.MiscUtilities.quicksort(Vector, MiscUtilities.Compare) `Collections.sort()`
org.gjt.sp.jedit.gui.InputHandler.readNextChar(String) Use the other form of this method instead
org.gjt.sp.jedit.io.VFSManager.registerVFS(String, VFS) Write a `services.xml` file instead; see `ServiceManager`.
org.gjt.sp.jedit.Buffer.removeBufferChangeListener(BufferChangeListener) Call `JEditBuffer.removeBufferListener(BufferListener)`.
org.gjt.sp.jedit.BeanShell.runScript(View, String, boolean, boolean) The `rethrowBshErrors` parameter is now obsolete; call `_runScript()` or `runScript()` instead.
org.gjt.sp.jedit.BeanShell.runScript(View, String, Reader, boolean, boolean) The `rethrowBshErrors` parameter is now obsolete; call `_runScript()` or `runScript()` instead.
org.gjt.sp.jedit.textarea.JEditTextArea.select(int, int) Instead, call either `addToSelection()`, or `setSelection()` with a new Selection instance.
org.gjt.sp.jedit.textarea.JEditTextArea.select(int, int, boolean) Instead, call either `addToSelection()`, or `setSelection()` with a new Selection instance.
org.gjt.sp.jedit.gui.DockableLayout.setAlternateLayout() use isAlternateLayout
org.gjt.sp.jedit.textarea.TextAreaPainter.setAntiAliasEnabled(boolean) use setAntiAlias(AntiAlias newMode)
org.gjt.sp.jedit.textarea.TextArea.setDragInProgress(boolean) the org.gjt.jedit.Java14 class no longer exists.
org.gjt.sp.util.WorkRequest.setProgressMaximum(int) use `WorkRequest.setMaximum(long)`
org.gjt.sp.util.WorkRequest.setProgressValue(int) use `WorkRequest.setValue(long)`
org.gjt.sp.jedit.textarea.JEditTextArea.setSelectionEnd(int) Do not use.
org.gjt.sp.jedit.textarea.JEditTextArea.setSelectionStart(int) Do not use.
org.gjt.sp.jedit.bsh.NameSpace.setTypedVariable(String, Class, Object, boolean) See #setTypedVariable( String, Class, Object, Modifiers )
org.gjt.sp.jedit.io.VFS.showBrowseDialog(Object[], Component) This function is not used in the jEdit core anymore, so it doesn't have to be provided anymore. If you want to use it for another purpose like in the FTP plugin, feel free to do so.
org.gjt.sp.jedit.MiscUtilities.stringsEqual(String, String) Call `StandardUtilities.objectsEqual(Object, Object)` instead.
org.gjt.sp.jedit.gui.GrabKeyDialog.toString(KeyEvent) use `AbstractInputHandler.toString(java.awt.event.KeyEvent)`

Deprecated Constructors
org.gjt.sp.util.SegmentCharSequence(Segment, boolean) Use ReverseCharSequence to get reverse view of this class (or any other CharSequence). This class doesn't support subSequence() and toString() for reversed instance.
org.gjt.sp.jedit.io.VFS(String) Use the form where the constructor takes a capability list.