Merge pull request #106080 from Ma27/nginx-config-doc

nixos/nginx: improve documentation for `config`
This commit is contained in:
Maximilian Bosch 2020-12-10 21:54:01 +01:00 committed by GitHub
commit 07aff199ad
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -390,13 +390,24 @@ in
}; };
config = mkOption { config = mkOption {
type = types.str;
default = ""; default = "";
description = " description = ''
Verbatim nginx.conf configuration. Verbatim <filename>nginx.conf</filename> configuration.
This is mutually exclusive with the structured configuration This is mutually exclusive to any other config option for
via virtualHosts and the recommendedXyzSettings configuration <filename>nginx.conf</filename> except for
options. See appendConfig for appending to the generated http block. <itemizedlist>
"; <listitem><para><xref linkend="opt-services.nginx.appendConfig" />
</para></listitem>
<listitem><para><xref linkend="opt-services.nginx.httpConfig" />
</para></listitem>
<listitem><para><xref linkend="opt-services.nginx.logError" />
</para></listitem>
</itemizedlist>
If additional verbatim config in addition to other options is needed,
<xref linkend="opt-services.nginx.appendConfig" /> should be used instead.
'';
}; };
appendConfig = mkOption { appendConfig = mkOption {