Add small comments and README modifications

README.md

@@ -149,7 +149,7 @@ ENV NGINX_WORKER_PROCESSES auto
 COPY ./app /app
 ```
 
-## Custom Nginx maximum connections per worker setting
+## Custom Nginx maximum connections per worker
 
 By default, Nginx will start with a maximum limit of 1024 connections per worker.
 
@@ -159,11 +159,13 @@ If you want to set a different number you can use the environment variable `NGIN
 ENV NGINX_WORKER_CONNECTIONS 2048
 ```
 
-## Custom Nginx maximum open files setting
+It cannot exceed the current limit on the maximum number of open files. See how to configure it in the next section.
 
-Nginx workers are limited by the system with regard to the maximum open file descriptors.
+## Custom Nginx maximum open files
 
-If you want to change the limit you can use the environment variable `NGINX_WORKER_OPEN_FILES`, e.g.:
+The number connections per Nginx worker cannot exceed the limit on the maximum number of open files.
+
+You can change the limit of open files with the environment variable `NGINX_WORKER_OPEN_FILES`, e.g.:
 
 ```Dockerfile
 ENV NGINX_WORKER_OPEN_FILES 2048

python2.7-alpine3.7/entrypoint.sh

@@ -16,6 +16,7 @@ USE_NGINX_WORKER_PROCESSES=${NGINX_WORKER_PROCESSES:-1}
 sed -i "/worker_processes\s/c\worker_processes ${USE_NGINX_WORKER_PROCESSES};" /etc/nginx/nginx.conf
 
 # Set the max number of connections per worker for Nginx, if requested
+# Cannot exceed worker_rlimit_nofile, see NGINX_WORKER_OPEN_FILES below
 if [[ -v NGINX_WORKER_CONNECTIONS ]] ; then
     sed -i "/worker_connections\s/c\    worker_connections ${NGINX_WORKER_CONNECTIONS};" /etc/nginx/nginx.conf
 fi

python2.7/entrypoint.sh

@@ -12,6 +12,7 @@ USE_NGINX_WORKER_PROCESSES=${NGINX_WORKER_PROCESSES:-1}
 sed -i "/worker_processes\s/c\worker_processes ${USE_NGINX_WORKER_PROCESSES};" /etc/nginx/nginx.conf
 
 # Set the max number of connections per worker for Nginx, if requested
+# Cannot exceed worker_rlimit_nofile, see NGINX_WORKER_OPEN_FILES below
 if [[ -v NGINX_WORKER_CONNECTIONS ]] ; then
     sed -i "/worker_connections\s/c\    worker_connections ${NGINX_WORKER_CONNECTIONS};" /etc/nginx/nginx.conf
 fi

python3.5/entrypoint.sh

@@ -12,6 +12,7 @@ USE_NGINX_WORKER_PROCESSES=${NGINX_WORKER_PROCESSES:-1}
 sed -i "/worker_processes\s/c\worker_processes ${USE_NGINX_WORKER_PROCESSES};" /etc/nginx/nginx.conf
 
 # Set the max number of connections per worker for Nginx, if requested
+# Cannot exceed worker_rlimit_nofile, see NGINX_WORKER_OPEN_FILES below
 if [[ -v NGINX_WORKER_CONNECTIONS ]] ; then
     sed -i "/worker_connections\s/c\    worker_connections ${NGINX_WORKER_CONNECTIONS};" /etc/nginx/nginx.conf
 fi

python3.6-alpine3.7/entrypoint.sh

@@ -16,6 +16,7 @@ USE_NGINX_WORKER_PROCESSES=${NGINX_WORKER_PROCESSES:-1}
 sed -i "/worker_processes\s/c\worker_processes ${USE_NGINX_WORKER_PROCESSES};" /etc/nginx/nginx.conf
 
 # Set the max number of connections per worker for Nginx, if requested
+# Cannot exceed worker_rlimit_nofile, see NGINX_WORKER_OPEN_FILES below
 if [[ -v NGINX_WORKER_CONNECTIONS ]] ; then
     sed -i "/worker_connections\s/c\    worker_connections ${NGINX_WORKER_CONNECTIONS};" /etc/nginx/nginx.conf
 fi

python3.6/entrypoint.sh

@@ -11,7 +11,8 @@ USE_NGINX_WORKER_PROCESSES=${NGINX_WORKER_PROCESSES:-1}
 # Modify the number of worker processes in Nginx config
 sed -i "/worker_processes\s/c\worker_processes ${USE_NGINX_WORKER_PROCESSES};" /etc/nginx/nginx.conf
 
-# Set the max number of connections per worker for Nginx, if requested
+# Set the max number of connections per worker for Nginx, if requested 
+# Cannot exceed worker_rlimit_nofile, see NGINX_WORKER_OPEN_FILES below
 if [[ -v NGINX_WORKER_CONNECTIONS ]] ; then
     sed -i "/worker_connections\s/c\    worker_connections ${NGINX_WORKER_CONNECTIONS};" /etc/nginx/nginx.conf
 fi