[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [gnunet] 02/02: doc: developer
From: |
gnunet |
Subject: |
[GNUnet-SVN] [gnunet] 02/02: doc: developer |
Date: |
Wed, 09 May 2018 10:38:30 +0200 |
This is an automated email from the git hooks/post-receive script.
ng0 pushed a commit to branch master
in repository gnunet.
commit e5e809d2a541bb2d710d607740caa9afeaaca74d
Author: Nils Gillmann <address@hidden>
AuthorDate: Wed May 9 08:38:49 2018 +0000
doc: developer
Signed-off-by: Nils Gillmann <address@hidden>
---
doc/documentation/chapters/developer.texi | 25 ++++++++++++++-----------
1 file changed, 14 insertions(+), 11 deletions(-)
diff --git a/doc/documentation/chapters/developer.texi
b/doc/documentation/chapters/developer.texi
index e95355302..6a895ed11 100644
--- a/doc/documentation/chapters/developer.texi
+++ b/doc/documentation/chapters/developer.texi
@@ -8381,7 +8381,7 @@ The REST service will automatically load all REST plugins
on startup.
@strong{Configuration}
-The rest service can be configured in various ways.
+The REST service can be configured in various ways.
The reference config file can be found in
@file{src/rest/rest.conf}:
@example
@@ -8392,8 +8392,11 @@ REST_ALLOW_ORIGIN=*
REST_ALLOW_CREDENTIALS=true
@end example
-The port as well as Cross-origin resource sharing (CORS) headers that
-are supposed to be advertised by the rest service are configurable.
+The port as well as
address@hidden resource sharing} (CORS)
address@hidden deffn
+headers that are supposed to be advertised by the rest service are
+configurable.
@menu
* Namespace considerations::
@@ -8403,14 +8406,15 @@ are supposed to be advertised by the rest service are
configurable.
@node Namespace considerations
@subsection Namespace considerations
-The gnunet-rest-service will load all plugins that are installed.
+The @command{gnunet-rest-service} will load all plugins that are installed.
As such it is important that the endpoint namespaces do not clash.
-For example, plugin X might expose the endpoint ``/xxx'' while plugin Y exposes
-endpoint ``/xxx/yyy''.
-This is a problem if plugins X is also supposed to handle a call to
-``/xxx/yyy''.
-Currently, the REST service will not complain or warn about such clashes so
-please make sure that endpoints are unambiguous.
+
+For example, plugin X might expose the endpoint ``/xxx'' while plugin Y
+exposes endpoint ``/xxx/yyy''.
+This is a problem if plugin X is also supposed to handle a call
+to ``/xxx/yyy''.
+Currently the REST service will not complain or warn about such clashes,
+so please make sure that endpoints are unambiguous.
@node Endpoint documentation
@subsection Endpoint documentation
@@ -8418,4 +8422,3 @@ please make sure that endpoints are unambiguous.
This is WIP. Endpoints should be documented appropriately.
Perferably using annotations.
-
--
To stop receiving notification emails like this one, please contact
address@hidden