Updated Branches: refs/heads/master c8b061ee9 -> 846d6e59b
Add a note about shell packages/annotations change Project: http://git-wip-us.apache.org/repos/asf/karaf/repo Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/846d6e59 Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/846d6e59 Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/846d6e59 Branch: refs/heads/master Commit: 846d6e59b6b51d4dbf4e64215a14f70ea0050670 Parents: c8b061e Author: Jean-Baptiste Onofré <[email protected]> Authored: Wed Dec 25 21:19:59 2013 +0100 Committer: Jean-Baptiste Onofré <[email protected]> Committed: Wed Dec 25 21:19:59 2013 +0100 ---------------------------------------------------------------------- manual/src/main/webapp/update-notes.conf | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/karaf/blob/846d6e59/manual/src/main/webapp/update-notes.conf ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/update-notes.conf b/manual/src/main/webapp/update-notes.conf index 49d5d0d..f63cf07 100644 --- a/manual/src/main/webapp/update-notes.conf +++ b/manual/src/main/webapp/update-notes.conf @@ -22,7 +22,7 @@ The purpose is to standardize the naming convention, and use more "logic" scope The following table shows the correspondence between the "old" commands and the "new" ones. -|| Apache Karaf 2.x || Apache Karaf 3.x || +|| Apache Karaf 2.x || Apache Karaf 3.x || | admin:change-opts | instance:opts-change | | admin:change-rmi-registry-port | instance:rmi-registry-port-change | | admin:change-rmi-server-port | instance:rmi-server-port-change | @@ -146,6 +146,21 @@ The following table shows the correspondence between the "old" commands and the We encourage the users to use the {{--help}} option to check the name and type of arguments and options. +In term of development, the previously shell anotations provided by the {{org.apache.felix.gogo.commands*}} package ({{@Command}}, {{@Argument}}, etc) +are now deprecated. Apache Karaf 3.0.0 still supports these annotations, but we encourage the users to upgrade to the new package {{org.apache.karaf.shell.commands}}. + +|| Shell annotation || Apache Karaf 2.x || Apache Karaf 3.x || +| {{@Argument}} | {{org.apache.felix.gogo.commands.Argument}} | {{org.apache.karaf.shell.commands.Argument}} | +| {{@Command}} | {{org.apache.felix.gogo.commands.Command}} | {{org.apache.karaf.shell.commands.Command}} | +| {{@CompleterValues}} | {{org.apache.felix.gogo.commands.CompleterValues}} | {{org.apache.karaf.shell.commands.CompleterValues}} | +| {{@Option}} | {{org.apache.felix.gogo.commands.Option}} | {{org.apache.karaf.shell.commands.Option | +| {{@SubShell}} | {{org.apache.felix.gogo.commands.SubShell}} | {{org.apache.karaf.shell.commands.SubShell | + +|| Class name || Apache Karaf 2.x || Apache Karaf 3.x || +| Action | {{org.apache.felix.gogo.commands.Action}} | {{org.apache.karaf.shell.commands.Action}} | +| CommandException | {{org.apache.felix.gogo.commands.CommandException}} | {{org.apache.karaf.shell.commands.CommandException}} | +| AbstractCommand | {{org.apache.felix.gogo.commands.basic.AbstractCommand}} | {{org.apache.karaf.shell.commands.basic.AbstractCommand}} | + h2. JMX MBeans Like the console commands, the JMX MBeans object names have been renamed and the operations haven been dispatched in
