44/49: doc: Improve description of nginx's configuration.

[guix-commits]

apteryx pushed a commit to branch master
in repository guix.

commit fc921acbef5a3864d525020afe524ccc8d66b4b5
Author: Tomas Volf <~@wolfsden.cz>
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 <maxim.cournoyer@gmail.com>
---
 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