The following pull request was submitted through Github.
It can be accessed and reviewed at: https://github.com/lxc/lxd/pull/3608

This e-mail was sent by the LXC bot, direct replies will not reach the author
unless they happen to be subscribed to this list.

=== Description (from pull-request) ===
Just escaped the brackets for path params in the docs that were not escaped and therefore rendered incorrectly (those path params were just missing).
From 706f27e2a6687ca8811b21b52dda8ac14204fa73 Mon Sep 17 00:00:00 2001
From: Andy Greene <[email protected]>
Date: Sun, 30 Jul 2017 21:47:10 -0400
Subject: [PATCH] escaping brackets for path params

---
 doc/api-extensions.md | 36 ++++++++++++++++++------------------
 doc/rest-api.md       |  8 ++++----
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/doc/api-extensions.md b/doc/api-extensions.md
index 4550b7d72..089cbc067 100644
--- a/doc/api-extensions.md
+++ b/doc/api-extensions.md
@@ -112,9 +112,9 @@ This includes:
  * Addition of the "managed" property on /1.0/networks entries
  * All the network configuration options (see configuration.md for details)
  * POST /1.0/networks (see rest-api.md for details)
- * PUT /1.0/networks/<entry> (see rest-api.md for details)
- * PATCH /1.0/networks/<entry> (see rest-api.md for details)
- * DELETE /1.0/networks/<entry> (see rest-api.md for details)
+ * PUT /1.0/networks/\<entry\> (see rest-api.md for details)
+ * PATCH /1.0/networks/\<entry\> (see rest-api.md for details)
+ * DELETE /1.0/networks/\<entry\> (see rest-api.md for details)
  * ipv4.address property on "nic" type devices (when nictype is "bridged")
  * ipv6.address property on "nic" type devices (when nictype is "bridged")
  * security.mac\_filtering property on "nic" type devices (when nictype is 
"bridged")
@@ -130,7 +130,7 @@ server and operate in pull mode.
 
 ## container\_exec\_recording
 Introduces a new boolean "record-output", parameter to
-/1.0/containers/<name>/exec which when set to "true" and combined with
+/1.0/containers/\<name\>/exec which when set to "true" and combined with
 with "wait-for-websocket" set to false, will record stdout and stderr to
 disk and make them available through the logs interface.
 
@@ -146,7 +146,7 @@ Adds the following to the REST API:
  * PATCH of certificate entries
 
 ## container\_exec\_signal\_handling
-Adds support /1.0/containers/<name>/exec for forwarding signals sent to the
+Adds support /1.0/containers/\<name\>/exec for forwarding signals sent to the
 client to the processes executing in the container. Currently SIGTERM and
 SIGHUP are forwarded. Further signals that can be forwarded might be added
 later.
@@ -184,22 +184,22 @@ This includes:
 * GET /1.0/storage-pools
 * POST /1.0/storage-pools (see rest-api.md for details)
 
-* GET /1.0/storage-pools/<name> (see rest-api.md for details)
-* POST /1.0/storage-pools/<name> (see rest-api.md for details)
-* PUT /1.0/storage-pools/<name> (see rest-api.md for details)
-* PATCH /1.0/storage-pools/<name> (see rest-api.md for details)
-* DELETE /1.0/storage-pools/<name> (see rest-api.md for details)
+* GET /1.0/storage-pools/\<name\> (see rest-api.md for details)
+* POST /1.0/storage-pools/\<name\> (see rest-api.md for details)
+* PUT /1.0/storage-pools/\<name\> (see rest-api.md for details)
+* PATCH /1.0/storage-pools/\<name\> (see rest-api.md for details)
+* DELETE /1.0/storage-pools/\<name\> (see rest-api.md for details)
 
-* GET /1.0/storage-pools/<name>/volumes (see rest-api.md for details)
+* GET /1.0/storage-pools/\<name\>/volumes (see rest-api.md for details)
 
-* GET /1.0/storage-pools/<name>/volumes/<volume_type> (see rest-api.md for 
details)
-* POST /1.0/storage-pools/<name>/volumes/<volume_type> (see rest-api.md for 
details)
+* GET /1.0/storage-pools/\<name\>/volumes/\<volume_type\> (see rest-api.md for 
details)
+* POST /1.0/storage-pools/\<name\>/volumes/\<volume_type\> (see rest-api.md 
for details)
 
-* GET /1.0/storage-pools/<pool>/volumes/<volume_type>/<name> (see rest-api.md 
for details)
-* POST /1.0/storage-pools/<pool>/volumes/<volume_type>/<name> (see rest-api.md 
for details)
-* PUT /1.0/storage-pools/<pool>/volumes/<volume_type>/<name> (see rest-api.md 
for details)
-* PATCH /1.0/storage-pools/<pool>/volumes/<volume_type>/<name> (see 
rest-api.md for details)
-* DELETE /1.0/storage-pools/<pool>/volumes/<volume_type>/<name> (see 
rest-api.md for details)
+* GET /1.0/storage-pools/\<pool\>/volumes/\<volume_type\>/\<name\> (see 
rest-api.md for details)
+* POST /1.0/storage-pools/\<pool\>/volumes/\<volume_type\>/\<name\> (see 
rest-api.md for details)
+* PUT /1.0/storage-pools/\<pool\>/volumes/\<volume_type\>/\<name\> (see 
rest-api.md for details)
+* PATCH /1.0/storage-pools/\<pool\>/volumes/\<volume_type\>/\<name\> (see 
rest-api.md for details)
+* DELETE /1.0/storage-pools/\<pool\>/volumes/\<volume_type\>/\<name\> (see 
rest-api.md for details)
 
 - All storage configuration options (see configuration.md for details)
 
diff --git a/doc/rest-api.md b/doc/rest-api.md
index 5f91ff4ef..b5c8f9a9c 100644
--- a/doc/rest-api.md
+++ b/doc/rest-api.md
@@ -2054,7 +2054,7 @@ Input:
         "name": "pool1"
     }
 
-## /1.0/storage-pools/<name>
+## /1.0/storage-pools/\<name\>
 ### GET
  * Description: information about a storage pool
  * Introduced: with API extension "storage"
@@ -2152,7 +2152,7 @@ Input (none at present):
     {
     }
 
-## /1.0/storage-pools/<name>/volumes
+## /1.0/storage-pools/\<name\>/volumes
 ### GET
  * Description: list of storage volumes
  * Introduced: with API extension "storage"
@@ -2184,7 +2184,7 @@ Input (none at present):
         
"/1.0/storage-pools/default/volumes/images/62e850a334bb9d99cac00b2e618e0291e5e7bb7db56c4246ecaf8e46fa0631a6"
     ]
 
-## /1.0/storage-pools/<pool>/volumes
+## /1.0/storage-pools/\<pool\>/volumes
 ### GET
  * Description: list all storage volumes on a storage pool
  * Introduced: with API extension "storage"
@@ -2252,7 +2252,7 @@ Input:
     }
 
 
-## /1.0/storage-pools/<pool>/volumes/<type>/<name>
+## /1.0/storage-pools/\<pool\>/volumes/\<type\>/\<name\>
 ### GET
  * Description: information about a storage volume of a given type on a 
storage pool
  * Introduced: with API extension "storage"
_______________________________________________
lxc-devel mailing list
[email protected]
http://lists.linuxcontainers.org/listinfo/lxc-devel

Reply via email to