Incorrect parameters for "Create floating IP"

[Takanori Miyagishi]

In http://developer.openstack.org/api-ref-networking-v2.html,
create floating ip has some misdescription in request/response parameters table.

[Request parameters table]
 1. "floating_network_id"
    This is required parameter, but it is described as "(Optional)" in the table.

 2. "floating_ip_address" and "ip"
    These parameter can not be specified in the request body.

[Response parameters table]
 1. "floating_network_id", "fixed_ip_address", "floating_ip_address"
    These parameters described as "(Optional)" in the table.
    But, all response parameters are not selectable whether to get information.

 2. "router_id" and "status"
    These parameters is included in response body, but the table don't described
    these parameters.

So, I'd like to fix these paramaters as follows.
[Request parameters table]
 1. "floating_ip"
    Delete "(Optional)" signage.

 2. "floating_ip_address" and "ip"
    Delete from the table.

[Response parameters table]
 1. Optional parameters
    Delete "(Optional)" signage.

 2. "router_id" and "status"
    Add these parameters to the table.

[Takanori Miyagishi (miyagishi-t)]

Review page: https://review.openstack.org/158599/

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/158599
Committed: https://git.openstack.org/cgit/openstack/api-site/commit/?id=e0d9ebf612d5975448172cf19b2bf1d4bc2ab4e7
Submitter: Jenkins
Branch: master

commit e0d9ebf612d5975448172cf19b2bf1d4bc2ab4e7
Author: Takanori Miyagishi <email address hidden>
Date: Tue Feb 24 16:49:26 2015 +0900

    Fix incorrect parameters for "create floatingip"

    Fix following parameters
     [Request parameter]
      (1)floating_network_id
        Remove "(Optional)" signage.
      (2)ip
        Remove from Request parameters table.

     [Response parameter]
      (1)floating_network_id, fixed_ip_address, floating_ip_address
        Remove "(Optional)" signage
      (2)router_id, status
        Add to Response parameters table.

    Change-Id: I0427648e20aac2364773e709be86c7f9de8acf7b
    Closes-Bug: #1417076