[man-pages] - update description of /proc/sys/fs/file-nr file in proc(5) man page (#497197)

[pschiffe]

commit 2d3edddddf66664f2286f5a6c29c8bbfac7eeafa
Author: Peter Schiffer <pschiffe at redhat.com>
Date:   Mon Sep 17 17:21:14 2012 +0200

    - update description of /proc/sys/fs/file-nr file in proc(5) man page (#497197)

 man-pages-3.42-proc-file-nr.patch |   28 ++++++++++++++++++++++++++++
 man-pages.spec                    |    4 ++++
 2 files changed, 32 insertions(+), 0 deletions(-)
---
diff --git a/man-pages-3.42-proc-file-nr.patch b/man-pages-3.42-proc-file-nr.patch
new file mode 100644
index 0000000..64dde52
--- /dev/null
+++ b/man-pages-3.42-proc-file-nr.patch
@@ -0,0 +1,28 @@
+diff -ur man-pages-3.42.orig/man5/proc.5 man-pages-3.42/man5/proc.5
+--- man-pages-3.42.orig/man5/proc.5	2012-08-14 00:39:40.000000000 +0200
++++ man-pages-3.42/man5/proc.5	2012-09-17 17:15:33.209361397 +0200
+@@ -1927,16 +1927,14 @@
+ limit.
+ .TP
+ .I /proc/sys/fs/file-nr
+-This (read-only) file gives the number of files presently opened.
+-It contains three numbers: the number of allocated file handles;
+-the number of free file handles; and the maximum number of file handles.
+-The kernel allocates file handles dynamically, but it
+-doesn't free them again.
+-If the number of allocated files is close to the
+-maximum, you should consider increasing the maximum.
+-When the number of free file handles is
+-large, you've encountered a peak in your usage of file
+-handles and you probably don't need to increase the maximum.
++Historically,the kernel was able to allocate file handles
++dynamically, but not to free them again. The three values in
++file-nr denote the number of allocated file handles, the number
++of allocated but unused file handles, and the maximum number of
++file handles. Linux 2.6 always reports 0 as the number of free
++file handles -- this is not an error, it just means that the
++number of allocated file handles exactly matches the number of
++used file handles.
+ .TP
+ .I /proc/sys/fs/inode-max
+ This file contains the maximum number of in-memory inodes.
diff --git a/man-pages.spec b/man-pages.spec
index 5bed7dc..7d12d82 100644
--- a/man-pages.spec
+++ b/man-pages.spec
@@ -59,6 +59,8 @@ Patch52: man-pages-3.42-ip-local-port.patch
 Patch53: man-pages-3.42-getdents.patch
 # resolves: #650985
 Patch54: man-pages-3.42-close.patch
+# resolves: #497197
+Patch55: man-pages-3.42-proc-file-nr.patch
 
 
 Autoreq: false
@@ -95,6 +97,7 @@ Documentation Project (LDP).
 %patch52 -p1
 %patch53 -p1
 %patch54 -p1
+%patch55 -p1
 
 ## Remove man pages we are not going to use ##
 
@@ -174,6 +177,7 @@ cd ..
 - added information about incorrect use of getdents(2) call to the man page (#809490)
 - removed man-pages-3.22-sched_setaffinity.patch because the problem it describes was fixed in the kernel. see #533811 for more info
 - document why to use shutdown() before close() when dealing with sockets on close(2) man page (#650985)
+- update description of /proc/sys/fs/file-nr file in proc(5) man page (#497197)
 
 * Thu Jul 19 2012 Fedora Release Engineering <rel-eng at lists.fedoraproject.org> - 3.41-2
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_18_Mass_Rebuild