From 515cc87174e1ea150c77e63bb8e17b007dde44d1 Mon Sep 17 00:00:00 2001
From: Tang Chen <chen.tang@easystack.cn>
Date: Fri, 11 Mar 2016 16:38:48 +0800
Subject: [PATCH] Add incompatibility info for "ip floating list" command

Commit d8abec33ada8b2b028d52eb8bfad2640812b9af8 changed
the output of "ip floating list" command. But forgot to
add any backward incompatibility info.

Output of command "ip floating list" for nova network
has been changed. And it is different from the output
of neutron network.

This patch adds this incompatibility info.

Change-Id: I45858fda3b9bcc0bdf4d0891637fa7dd712872af
Partial-Bug: 1519502
Related-to: blueprint neutron-client
---
 doc/source/backwards-incompatible.rst         | 30 +++++++++++++++++++
 .../notes/bug-1519502-f72236598d14d350.yaml   |  4 +++
 2 files changed, 34 insertions(+)

diff --git a/doc/source/backwards-incompatible.rst b/doc/source/backwards-incompatible.rst
index bb2b0bddb9..4b90d6e1bc 100644
--- a/doc/source/backwards-incompatible.rst
+++ b/doc/source/backwards-incompatible.rst
@@ -162,6 +162,36 @@ List of Backwards Incompatible Changes
   * Bug: https://bugs.launchpad.net/python-openstackclient/+bug/1546065
   * Commit: https://review.openstack.org/#/c/281089/
 
+14. Output of `ip floating list` command has changed.
+
+  When using Compute v2, the original output of `ip floating list` command is:
+  +----+--------+------------+----------+-------------+
+  | ID | Pool   | IP         | Fixed IP | Instance ID |
+  +----+--------+-----------------------+-------------+
+  |  1 | public | 172.24.4.1 | None     | None        |
+  +----+--------+------------+----------+-------------+
+
+  Now it changes to:
+  +----+---------------------+------------------+-----------+--------+
+  | ID | Floating IP Address | Fixed IP Address | Server ID | Pool   |
+  +----+---------------------+------------------+-----------+--------+
+  |  1 | 172.24.4.1          | None             | None      | public |
+  +----+---------------------+------------------+-----------+--------+
+
+  When using Network v2, the output of `ip floating list` command is:
+  +--------------------------------------+---------------------+------------------+------+
+  | ID                                   | Floating IP Address | Fixed IP Address | Port |
+  +--------------------------------------+---------------------+------------------+------+
+  | 1976df86-e66a-4f96-81bd-c6ffee6407f1 | 172.24.4.3          | None             | None |
+  +--------------------------------------+---------------------+------------------+------+
+  which is different from Compute v2.
+
+  * In favor of: Use `ip floating list` command
+  * As of: NA
+  * Removed in: NA
+  * Bug: https://bugs.launchpad.net/python-openstackclient/+bug/1519502
+  * Commit: https://review.openstack.org/#/c/277720/
+
 For Developers
 ==============
 
diff --git a/releasenotes/notes/bug-1519502-f72236598d14d350.yaml b/releasenotes/notes/bug-1519502-f72236598d14d350.yaml
index 73ead7f427..1ace59bd66 100644
--- a/releasenotes/notes/bug-1519502-f72236598d14d350.yaml
+++ b/releasenotes/notes/bug-1519502-f72236598d14d350.yaml
@@ -6,3 +6,7 @@ features:
     [Bug `1519502 <https://bugs.launchpad.net/python-openstackclient/+bug/1519502>`_]
   - Add command ``ip floating show`` for neutron and nova network.
     [Bug `1519502 <https://bugs.launchpad.net/python-openstackclient/+bug/1519502>`_]
+upgrade:
+  - Output of command ``ip floating list`` for nova network has been changed.
+    And it is different from the output of neutron network.
+    [Ref `<http://docs.openstack.org/developer/python-openstackclient/backwards-incompatible.html>`_]