Hopefully, improve the grammar and wording in the changes to shmctl(2)

manpage and UPDATING entry 20090302.

UPDATING changes suggested by bf2006a yahoo com.
man page corrections by bde.

2 files changed, 9 insertions, 8 deletions

diff --git a/UPDATING b/UPDATING
index 53dede7..33665b0 100644
--- a/UPDATING
+++ b/UPDATING
@@ -23,11 +23,11 @@ NOTE TO PEOPLE WHO THINK THAT FreeBSD 8.x IS SLOW:
 	ln -s aj /etc/malloc.conf.)
 
 20090302:
-	The workaround is committed to allow to create System V shared
-	memory segment of size > 2 Gb on the 64-bit architectures.
-	Due to limitation of the existing ABI, the shm_segsz member
+	A workaround is committed to allow the creation of System V shared
+	memory segment of size > 2 GB on the 64-bit architectures.
+	Due to a limitation of the existing ABI, the shm_segsz member
 	of the struct shmid_ds, returned by shmctl(IPC_STAT) call is
-	wrong for large segments. Note that limits shall be explicitely
+	wrong for large segments. Note that limits must be explicitely
 	raised to allow such segments to be created.
 
 20090301:
diff --git a/lib/libc/sys/shmctl.2 b/lib/libc/sys/shmctl.2
index 3e19666..2ac7d05 100644
--- a/lib/libc/sys/shmctl.2
+++ b/lib/libc/sys/shmctl.2
@@ -134,12 +134,13 @@ Permission denied due to mismatch between operation and mode of
 shared memory segment.
 .El
 .Sh "BUGS"
+The segment size has size_t type.
 The shm_segsz member of the
 .Vt shmid_ds
-structure has int type, that is too short to represent full range
-of the values for segment size, which is allowed to be size_t.
-If shared memory limits are raised to allow segments with size > 2 Gb
-to be created, be aware that IPC_STAT call may return truncated value
+structure has type int, which is too short to represent the full range
+of values for a segment size.
+If shared memory limits are raised to allow segments with size > 2 GB
+to be created, be aware that IPC_STAT call may return a truncated value
 for shm_segsz.
 .El
 .Sh "SEE ALSO"