doc: keep perfetto docs in BUILDING.md only

Revert the doc/api/tracing.md, doc/api/cli.md and doc/node.1 changes so
that the perfetto build is described in one place. The build-time flag is
not mature enough to document in the API docs yet.

Signed-off-by: Lazizbek Ergashev <lazerg2@gmail.com>

Author: lazerg

BUILDING.md

@@ -1095,8 +1095,12 @@ format instead:
 ```
 
 The Perfetto SDK ships in `deps/perfetto`, so no additional dependency is
-needed. See [Trace events](doc/api/tracing.md) for how the output of such a
-build differs.
+needed.
+
+Such a build writes Perfetto protobuf traces instead of JSON, so the default
+trace file name becomes `node_trace.${rotation}.pftrace` and the files can be
+opened in <https://ui.perfetto.dev>. It cannot write JSON traces, and it does
+not support trace collection over the inspector protocol.
 
 ## Building Node.js with external core modules
 

doc/api/cli.md

@@ -3302,9 +3302,7 @@ added: v9.8.0
 -->
 
 Template string specifying the filepath for the trace event data, it
-supports `${rotation}` and `${pid}`. It defaults to `node_trace.${rotation}.log`,
-or to `node_trace.${rotation}.pftrace` in builds with Perfetto support. See
-[Trace events][] for details.
+supports `${rotation}` and `${pid}`.
 
 ### `--trace-events-enabled`
 
@@ -4483,7 +4481,6 @@ node --stack-trace-limit=12 -p -e "Error.stackTraceLimit" # prints 12
 [ShadowRealm]: https://github.com/tc39/proposal-shadowrealm
 [Source Map]: https://tc39.es/ecma426/
 [Test tags]: test.md#test-tags
-[Trace events]: tracing.md
 [TypeScript type-stripping]: typescript.md#type-stripping
 [V8 Inspector integration for Node.js]: debugger.md#v8-inspector-integration-for-nodejs
 [V8 JavaScript code coverage]: https://v8project.blogspot.com/2017/12/javascript-code-coverage.html

doc/api/tracing.md

@@ -102,12 +102,6 @@ string that supports `${rotation}` and `${pid}`:
 node --trace-event-categories v8 --trace-event-file-pattern '${pid}-${rotation}.log' server.js
 ```
 
-Node.js can also be built with [Perfetto][] support, as described in
-[BUILDING.md][]. Such a build writes Perfetto protobuf traces instead of JSON,
-so the default file name becomes `node_trace.${rotation}.pftrace` and the files
-can be opened in <https://ui.perfetto.dev>. It cannot write JSON traces, and it
-does not support trace collection over the inspector protocol.
-
 To guarantee that the log file is properly generated after signal events like
 `SIGINT`, `SIGTERM`, or `SIGBREAK`, make sure to have the appropriate handlers
 in your code, such as:
@@ -295,8 +289,6 @@ console.log(getEnabledCategories());
 
 ### Collect trace events data by inspector
 
-The `NodeTracing` domain is not registered in builds with Perfetto support.
-
 ```mjs
 import { Session } from 'node:inspector';
 const session = new Session();
@@ -369,8 +361,6 @@ async function collect() {
 collect();
 ```
 
-[BUILDING.md]: https://github.com/nodejs/node/blob/HEAD/BUILDING.md#building-nodejs-with-perfetto-support
-[Perfetto]: https://perfetto.dev/
 [Performance API]: perf_hooks.md
 [V8]: v8.md
 [`Worker`]: worker_threads.md#class-worker

doc/node.1

@@ -835,6 +835,14 @@ Enable experimental WebAssembly System Interface (WASI) support.
 .It Fl -experimental-worker-inspection
 Enable experimental support for the worker inspection with Chrome DevTools.
 .
+.It Fl -expose-gc
+This flag will expose the gc extension from V8.
+.Bd -literal
+if (globalThis.gc) {
+  globalThis.gc();
+}
+.Ed
+.
 .It Fl -force-context-aware
 Disable loading native addons that are not context-aware.
 .
@@ -1599,9 +1607,7 @@ tracing is enabled using \fB--trace-events-enabled\fR.
 .
 .It Fl -trace-event-file-pattern
 Template string specifying the filepath for the trace event data, it
-supports \fB${rotation}\fR and \fB${pid}\fR. It defaults to \fBnode_trace.${rotation}.log\fR,
-or to \fBnode_trace.${rotation}.pftrace\fR in builds with Perfetto support. See
-Trace events for details.
+supports \fB${rotation}\fR and \fB${pid}\fR.
 .
 .It Fl -trace-events-enabled
 Enables the collection of trace event tracing information.