From 5ce7d9b7bcb4dae9fa27ff416b45f7cf77eff6ae Mon Sep 17 00:00:00 2001 From: Thien-Thi Nguyen Date: Wed, 22 Dec 2021 10:14:37 -0500 Subject: Convert ":http:host:ENDPOINT" syntax into simple "POST ENDPOINT" text The :http:post:ENDPOINT syntax runs afoul of the limited httpdomain.py understanding of the optional parts of ENDPOINT. This results in warnings when building. One resolution to the problem is to make Sphinx (httpdomain.py) smarter. Another is to add all the combinations of the optional and non-optional ENDPOINT as anchors. Discussion starts here: . This change takes the third approach of avoiding the fancy syntax by using simple non-referential text. --- taler-nfc-guide.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'taler-nfc-guide.rst') diff --git a/taler-nfc-guide.rst b/taler-nfc-guide.rst index 1b3cfb18..98b481c2 100644 --- a/taler-nfc-guide.rst +++ b/taler-nfc-guide.rst @@ -45,7 +45,7 @@ using `curl `_ to make HTTP(S) requests. can be opened, and give a warning if it is detected that the devices does not have Internet connectivity. - The following :http:post:`/private/orders` request to the merchant backend creates a + The following POST ``/private/orders`` request to the merchant backend creates a simple order: .. code-block:: console @@ -69,7 +69,7 @@ using `curl `_ to make HTTP(S) requests. } 2. The merchant checks the payment status of the order using - :http:get:`/private/orders/$ORDER_ID`: + GET ``/private/orders/$ORDER_ID``: .. code-block:: console @@ -135,7 +135,8 @@ using `curl `_ to make HTTP(S) requests. before responding with the fulfillment page. For in-store payments, the merchant must periodically check the payment status. - Instead of polling in a busy loop, the ``timeout_ms`` parameter of :http:get:`/private/orders/$ORDER_ID` + Instead of polling in a busy loop, the ``timeout_ms`` parameter + of GET ``/private/orders/$ORDER_ID`` should be used. -- cgit v1.2.3