All Classes

Introduction

What do the Dates Mean?

The supplied dates indicate when the API change was made, on the CVS trunk. From this you can generally tell whether the change should be present in a given build or not; for trunk builds, simply whether it was made before or after the change; for builds on a stabilization branch, whether the branch was made before or after the given date. In some cases corresponding API changes have been made both in the trunk and in an in-progress stabilization branch, if they were needed for a bug fix; this ought to be marked in this list.

Index of APIs

SendOpts API
SendOpts SPI

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

(Aug 20 '06) Completelly rewritten

All changes by date

(Mar 23 '17) Command line with instances
(Mar 21 '17) Print Usage into Caller's Stream
(Mar 21 '17) Explictly specify option processors
(Mar 18 '12) Easier way to process own --help request
(Dec 31 '11) @Arg annotation
(Jul 30 '07) An option that is always on
(Aug 20 '06) Completelly rewritten
(Mar 18 '06) Use short description for each Option
(Mar 18 '06) Command exceptions can have localized messages
(Mar 15 '06) Using PrintStream
(Feb 26 '06) Using PrintStream

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: $codebase > 1.20

(2.37) Command line with instances
(2.37) Print Usage into Caller's Stream
(2.37) Explictly specify option processors
(2.21) Easier way to process own --help request
(2.20) @Arg annotation
(2.1) An option that is always on
(2.0) Completelly rewritten
(1.8) Use short description for each Option
(1.8) Command exceptions can have localized messages
(1.7) Using PrintStream
(1.4) Using PrintStream

Changes by affected class

`org.netbeans.spi.sendopts.Arg`

(Dec 31 '11) @Arg annotation

`org.netbeans.spi.sendopts.ArgsProcessor`

(Dec 31 '11) @Arg annotation

`org.netbeans.api.sendopts.CommandException`

(Mar 18 '06) Command exceptions can have localized messages

`org.netbeans.api.sendopts.CommandLine`

(Mar 23 '17) Command line with instances
(Mar 21 '17) Explictly specify option processors
(Dec 31 '11) @Arg annotation
(Mar 15 '06) Using PrintStream

`org.netbeans.spi.sendopts.Env`

(Mar 21 '17) Print Usage into Caller's Stream
(Mar 18 '12) Easier way to process own --help request
(Feb 26 '06) Using PrintStream

`org.netbeans.spi.sendopts.Option`

(Mar 18 '06) Use short description for each Option

Details of all changes by API and date

SendOpts API

Command line with instances

Mar 23 '17; API spec. version: 2.37; affected top-level classes: CommandLine; made by: jtulach
Create command line with instances of OptionProcessor and ArgsProcessor.

Command exceptions can have localized messages

Mar 18 '06; API spec. version: 1.8; affected top-level classes: CommandException; made by: jtulach
There is a new factory method in CommandException that can influence the localized message which is then printed to the user as a description of the error.

Using PrintStream

Mar 15 '06; API spec. version: 1.7; affected top-level classes: CommandLine; made by: jtulach
There is new method usage that allows to print description of all available options in the command line.

SendOpts SPI

Print Usage into Caller's Stream

Mar 21 '17; API spec. version: 2.37; affected top-level classes: Env; made by: jtulach
Env.usage method now takes an optional OutputStream parameter.

Explictly specify option processors

Mar 21 '17; API spec. version: 2.37; affected top-level classes: CommandLine; made by: jtulach
CommandLine.html.create(Class...) can now be called with classes that extend OptionProcessor.

Easier way to process own `--help` request

Mar 18 '12; API spec. version: 2.21; affected top-level classes: Env; made by: jtulach
Env.usage can be called when one wants to process own --help option.

@Arg annotation

Dec 31 '11; API spec. version: 2.20; affected top-level classes: Arg ArgsProcessor CommandLine; made by: jtulach
@Arg annotation and associated classes allow to register options declaratively. There is a new factory method to create multiple instances of differently configured command lines.

An option that is always on

Jul 30 '07; API spec. version: 2.1; made by: jtulach
Those processors that wish to be informed about every command line processing, can register themselves as providers of always option. This one is automatically present in each successfully parsed command line.

Completelly rewritten

Aug 20 '06; API spec. version: 2.0; made by: jtulach
After the review from others it has been decided to de-generify the interfaces. As a result of this complete rewrite, the API clients need to be fully rewritten as most of the method signatures changed.

Use short description for each Option

Mar 18 '06; API spec. version: 1.8; affected top-level classes: Option; made by: jtulach
Use Option.shortDescription to associate a one-liner text with an option. This description will be printed when showing usage for the command line.

Using PrintStream

Feb 26 '06; API spec. version: 1.4; affected top-level classes: Env; made by: jtulach
Env.getErrorStream() and Env.getOutputStream() return PrintStream.