1 files changed, 8 insertions, 7 deletions

diff --git a/usr.bin/gcore/gcore.1 b/usr.bin/gcore/gcore.1
index cee2bb7d0590..2073e79323f9 100644
--- a/usr.bin/gcore/gcore.1
+++ b/usr.bin/gcore/gcore.1
@@ -63,12 +63,13 @@ The following options are available:
 Write the core file to the specified file instead of
 .Dq Pa core.<pid> .
 .It Fl f
-Dumps all the available segments, excluding only the malformed ones and
-un-dumpable ones. Unlike the default invocation, it also dumps
-device- and sglist-mapped areas that may invalidate the state of
-some transactions. This flag must be used very carefully, when the
-behavior of the application is fully understood and the fallouts can
-be easily controlled.
+Dumps all available segments, excluding only malformed and undumpable segments.
+Unlike the default invocation, this flag dumps mappings of devices which
+may invalidate the state of device transactions or trigger other unexpected
+behavior.
+As a result, this flag should only be used when the behavior of the
+application and any devices it has mapped is fully understood and any side
+effects can be controlled or tolerated.
 .It Fl s
 Stop the process while gathering the core image, and resume it
 when done.
@@ -94,7 +95,7 @@ Because of the
 .Xr ptrace 2
 usage
 .Nm
-may not work with processes which are actively investigated with
+may not work with processes which are actively being investigated with
 .Xr truss 1
 or
 .Xr gdb 1 .