From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2041) id D0EF6383EC51; Tue, 14 Jun 2022 21:26:27 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org D0EF6383EC51 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Vladimir Mezentsev To: bfd-cvs@sourceware.org, gdb-cvs@sourceware.org Subject: [binutils-gdb] gprofng docs: provide help for == X-Act-Checkin: binutils-gdb X-Git-Author: Vladimir Mezentsev X-Git-Refname: refs/heads/master X-Git-Oldrev: 08328cfbafcebac5dac058e2d568d9b2fd3ee478 X-Git-Newrev: a675e77e55759bad4501cbaaba36fa18dad2339d Message-Id: <20220614212627.D0EF6383EC51@sourceware.org> Date: Tue, 14 Jun 2022 21:26:27 +0000 (GMT) X-BeenThere: gdb-cvs@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 14 Jun 2022 21:26:27 -0000 https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3Da675e77e5575= 9bad4501cbaaba36fa18dad2339d commit a675e77e55759bad4501cbaaba36fa18dad2339d Author: Vladimir Mezentsev Date: Tue Jun 14 14:16:24 2022 -0700 gprofng docs: provide help for =3D=3D =20 The help message from 'gprofng collect app -h', in the section on =3D=3D , had a dangling reference to a non-existent manpage. Provide basic info, including reasons for caution. Diff: --- gprofng/common/hwctable.c | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/gprofng/common/hwctable.c b/gprofng/common/hwctable.c index bc441e133a7..a1422b63c11 100644 --- a/gprofng/common/hwctable.c +++ b/gprofng/common/hwctable.c @@ -5091,8 +5091,24 @@ hwc_usage_internal (int forKernel, FILE *f_usage, co= nst char *cmd, const char *d fprintf (f_usage, GTXT (" `lo' per-thread maximum rate= of ~10 samples/second\n")); fprintf (f_usage, GTXT (" `on' per-thread maximum rate= of ~100 samples/second\n")); fprintf (f_usage, GTXT (" `hi' per-thread maximum rate= of ~1000 samples/second\n\n")); - fprintf (f_usage, GTXT (" =3D=3D \n")); - fprintf (f_usage, GTXT (" event interval; see collect (1) = for details\n\n")); + fprintf (f_usage, GTXT (" =3D=3D \n" + " Fixed event interval value to trigger a sample.\n" + " Smaller intervals imply more frequent samples.\n" + " Example: when counting cycles on a 2 GHz processor,\n" + " an interval of 2,000,003 implies ~1000 samples/sec\n" + "\n" + " Use this feature with caution, because:\n" + " (1) Frequent sampling increases overhead and may di= sturb \n" + " other applications on your system.\n" + " (2) Event counts vary dramatically depending on the= event \n" + " and depending on the application.\n" + " (3) A fixed event interval disables any other gprof= ng\n" + " internal mechanisms that may limit event rates.= \n" + "\n" + " Guidelines: Aim at <1000 events per second. Start b= y \n" + " collecting with the 'hi' option; in the experiment ov= erview,\n" + " notice how many events are recorded per second; divid= e by\n" + " 1000, and use that as your starting point.\n\n")); =20 fprintf (f_usage, GTXT (" A comma ',' followed immediately by= white space may be omitted.\n\n")); }