From f4a13fafc47e03118ab92847612171ff03fb4ca1 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Andr=C3=A9=20Malo?= Date: Mon, 20 Jan 2014 09:02:09 +0000 Subject: [PATCH] avoid non-ascii quotes. Sometimes they're just wrong. Sometimes they simply break the current latex build git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1559649 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/developer/lua.xml | 6 ++--- docs/manual/misc/perf-scaling.xml | 40 +++++++++++++++---------------- 2 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/manual/developer/lua.xml b/docs/manual/developer/lua.xml index c68f227549..06d9087624 100644 --- a/docs/manual/developer/lua.xml +++ b/docs/manual/developer/lua.xml @@ -531,9 +531,9 @@ LuaHookTranslateName /path/to/script.lua proxy_handler ]]-- local backends = { - “http://backend1.foo.com/“, - “http://backend2.foo.com/“, - “http://backend3.foo.com/“ + "http://backend1.foo.com/", + "http://backend2.foo.com/", + "http://backend3.foo.com/" } function pick_backend(r) diff --git a/docs/manual/misc/perf-scaling.xml b/docs/manual/misc/perf-scaling.xml index 2f5d2db996..833acdc325 100644 --- a/docs/manual/misc/perf-scaling.xml +++ b/docs/manual/misc/perf-scaling.xml @@ -29,12 +29,12 @@

The Performance Tuning page in the Apache 1.3 documentation says:

- “Apache is a general webserver, which is designed to be + "Apache is a general webserver, which is designed to be correct first, and fast second. Even so, its performance is quite satisfactory. Most sites have less than 10Mbits of outgoing bandwidth, which Apache can fill using only a low end Pentium-based - webserver.”

+ webserver."

However, this sentence was written a few years ago, and in the meantime several things have happened. On one hand, web server @@ -140,7 +140,7 @@ Swap: 4194296k total, 860584k used, 3333712k free, 1157552k cached 69 root 15 -5 0 0 0 S 0 0.0 0:00.04 kblockd/1 70 root 15 -5 0 0 0 S 0 0.0 0:00.04 kblockd/2 -

Top is a wonderful tool even though it’s slightly resource +

Top is a wonderful tool even though it's slightly resource intensive (when running, its own process is usually in the top ten CPU gluttons). It is indispensable in determining the size of a running process, which comes in handy when @@ -324,7 +324,7 @@ Swap: 3903784 12540 3891244

The Error Log is configured through the ErrorLog and LogLevel - configuration directives. The error log of httpd’s main + configuration directives. The error log of httpd's main server configuration receives the log messages that pertain to the entire server: startup, shutdown, crashes, excessive process spawns, etc. The ErrorLog @@ -590,7 +590,7 @@ Swap: 3903784 12540 3891244 APACHE=/usr/local/apache2
HTTPD=$APACHE/bin/httpd
mv $APACHE/logs/access_log - $APACHE/logarchive/access_log-‘date +%F‘
+ $APACHE/logarchive/access_log-`date +%F`
$HTTPD -k graceful @@ -662,8 +662,8 @@ Swap: 3903784 12540 3891244 server has many virtual hosts, all the open logfiles put a resource burden on your system, and it may be preferable to log to a single file. Use the %v - format character at the start of your LogFormat - and starting 2.3.8 of your ErrorLog + format character at the start of your LogFormat + and starting 2.3.8 of your ErrorLog to make httpd print the hostname of the virtual host that received the request or the error at the beginning of each log line. A simple Perl script can split out the log file @@ -686,7 +686,7 @@ Swap: 3903784 12540 3891244

It is useful to generate a test load to monitor system performance under realistic operating circumstances. Besides - commercial packages such as LoadRunner + commercial packages such as LoadRunner ,there are a number of freely available tools to generate a test load against your web server.

@@ -713,13 +713,13 @@ Swap: 3903784 12540 3891244

  • ASF external projects, that have proven to be quite - good: grinder, httperf, tsung, FunkLoad + good: grinder, httperf, tsung, FunkLoad

    • When you load-test your web server, please keep in mind that if that server is in production, the test load may negatively - affect the server’s response. Also, any data traffic you + affect the server's response. Also, any data traffic you generate may be charged against your monthly traffic allowance.

    @@ -747,8 +747,8 @@ Swap: 3903784 12540 3891244 MPM runs a smaller number of child processes, and spawns multiple request handling threads within each child process. In 2.4 MPMs are no longer hard-wired. They too can be exchanged - via LoadModule. - The default MPM in 2.4 is the event MPM. + via LoadModule. + The default MPM in 2.4 is the event MPM.

    The maximum number of workers, be they pre-forked child processes or threads within a process, is an indication of how @@ -760,7 +760,7 @@ Swap: 3903784 12540 3891244 denied access. However, once requests start backing up, system performance is likely to degrade.

    -

    Finally, if the httpd server in question is not executing any third-party +

    Finally, if the httpd server in question is not executing any third-party code, via mod_php, mod_perl or similar, we recommend the use of mpm_event. This MPM is ideal for situations where httpd serves as a thin layer between clients and @@ -803,7 +803,7 @@ Swap: 3903784 12540 3891244 is evenly divisible by ThreadsPerChild - .If you set either directive to a number that doesn’t + .If you set either directive to a number that doesn't meet this requirement, Apache will send a message of complaint to the error log and adjust the ThreadsPerChild @@ -828,7 +828,7 @@ Swap: 3903784 12540 3891244

    - total RAM − RAM for OS − RAM for external programs
    + total RAM - RAM for OS - RAM for external programs
    MaxClients = -------------------------------------------------------
    RAM per httpd process @@ -866,8 +866,8 @@ Swap: 3903784 12540 3891244 value. The Linux kernel will put extra memory to good use for caching disk access. On Solaris you need enough available real RAM memory to create any process. If no real - memory is available, httpd will start writing ‘No space - left on device’ messages to the error log and be unable + memory is available, httpd will start writing 'No space + left on device' messages to the error log and be unable to fork additional child processes, so a higher MaxClients @@ -1199,7 +1199,7 @@ Swap: 3903784 12540 3891244 their functionality and configuration directives, you can turn them off by commenting out the corresponding LoadModule - lines. Read the documentation on each module’s + lines. Read the documentation on each module's functionality before deciding whether to keep it enabled. While the performance overhead of an unused module is small, it's also unnecessary. @@ -1272,7 +1272,7 @@ Swap: 3903784 12540 3891244

    This can be run periodically from Cron, after you upload content, etc. To make Apache substitute the statically - rendered pages for the dynamic content, we’ll use + rendered pages for the dynamic content, we'll use mod_rewrite. This module is included with the Apache source code, but is not compiled by default. It can be built with the server by passing the option --enable-rewrite[=shared] @@ -1373,7 +1373,7 @@ Listen *:8001 a better example here too.-->

    The Apache Software Foundation Wiki is served by MoinMoin. - MoinMoin is written in Python and runs as a CGI. To date, any + MoinMoin is written in Python and runs as a CGI. To date, any attempts to run it under mod_python has been unsuccessful. The CGI proved to place an untenably high load on the server machine, especially when the Wiki was being indexed -- 2.40.0