annotate xml/en/docs/faq/variables_in_config.xml @ 580:be54c443235a

Added copyright markers to documentation sources.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 10 Jul 2012 12:59:42 +0000
parents ec4626d04879
children 764fbac1b8b4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 198
diff changeset
1 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 198
diff changeset
2 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 198
diff changeset
3 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 198
diff changeset
4
198
ec4626d04879 - Bulk commit following discussion in devrep
Andrey Alexeev <andrew@nginx.com>
parents: 196
diff changeset
5 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
196
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
6
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
7 <article name="Is there a proper way to use nginx variables to
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
8 make sections of the configuration shorter,
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
9 using them as macros for making
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
10 parts of configuration work as templates?"
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
11 link="/en/docs/faq/variables_in_config.html"
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
12 lang="en">
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
13
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
14 <section>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
15
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
16 <para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
17 <initial>Q:</initial>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
18 Is there a proper way to use nginx variables to make sections of
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
19 the configuration shorter, using them as macros for making
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
20 parts of configuration work as templates?
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
21 </para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
22
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
23 <para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
24 &nbsp;
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
25 </para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
26
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
27 <para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
28 <initial>A:</initial>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
29 Variables should not be used as template macros. Variables are
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
30 evaluated in the run-time during the processing of each
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
31 request, so they are rather costly compared to plain static
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
32 configuration. Using variables to store static strings is also
198
ec4626d04879 - Bulk commit following discussion in devrep
Andrey Alexeev <andrew@nginx.com>
parents: 196
diff changeset
33 a bad idea. Instead, a macro expansion and "include" directives
ec4626d04879 - Bulk commit following discussion in devrep
Andrey Alexeev <andrew@nginx.com>
parents: 196
diff changeset
34 should be used to generate configs more easily and it can be
ec4626d04879 - Bulk commit following discussion in devrep
Andrey Alexeev <andrew@nginx.com>
parents: 196
diff changeset
35 done with the external tools, e.g. sed + make or any other
ec4626d04879 - Bulk commit following discussion in devrep
Andrey Alexeev <andrew@nginx.com>
parents: 196
diff changeset
36 common template mechanism.
196
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
37 </para>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
38
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
39 </section>
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
40
aafe530e7d6f - Added faq/ and more q&a as previously agreed
Andrey Alexeev <andrew@nginx.com>
parents:
diff changeset
41 </article>