apteryx pushed a commit to branch master
in repository guix.
commit fc921acbef5a3864d525020afe524ccc8d66b4b5
Author: Tomas Volf <[email protected]>
AuthorDate: Thu Jun 20 15:31:15 2024 +0200
doc: Improve description of nginx's configuration.
* doc/guix.texi (Web Services)[nginx-server-configuration]: Document
semantics
of raw-content field.
[nginx-location-configuration]: Document semantics of body field.
Change-Id: I1e699d085a27f2615190de1e1973146da4ab193d
Signed-off-by: Maxim Cournoyer <[email protected]>
---
doc/guix.texi | 16 ++++++++++------
1 file changed, 10 insertions(+), 6 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 0ad0a23b6c..fd19245539 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -32127,7 +32127,9 @@ you don't have a key or you don't want to use HTTPS.
Whether the server should add its configuration to response.
@item @code{raw-content} (default: @code{'()})
-A list of raw lines added to the server block.
+A list of strings or file-like objects to be appended to the server
+block. Each item is prefixed with indentation and suffixed with a new
+line. Nested lists are flattened.
@end table
@end deftp
@@ -32164,11 +32166,13 @@ URI which this location block matches.
@anchor{nginx-location-configuration body}
@item @code{body}
-Body of the location block, specified as a list of strings. This can contain
-many
-configuration directives. For example, to pass requests to a upstream
-server group defined using an @code{nginx-upstream-configuration} block,
-the following directive would be specified in the body @samp{(list "proxy_pass
+Body of the location block, specified as a list of strings or file-like
+objects. Each item is prefixed with indentation and suffixed with a new
+line. Nested lists are flattened.
+
+For example, to pass requests to a upstream server group defined using
+an @code{nginx-upstream-configuration} block, the following directive
+would be specified in the body @samp{(list "proxy_pass
http://upstream-name;";)}.
@end table
