[helpdoc] Update reference docs for main
diff --git a/main/tools/fx/cmd/log.md b/main/tools/fx/cmd/log.md
index 43bc294..b1ff3f9 100644
--- a/main/tools/fx/cmd/log.md
+++ b/main/tools/fx/cmd/log.md
@@ -1,9 +1,18 @@
# fx log
-listen for logs from the on-device log\_listener
+Display logs from a target device.
```none
-usage: fx log [-h | --help] [--raw] [-r | --remote-symbols] LOG_LISTENER_FLAGS
+usage: fx log FFX_LOG_FLAGS
+
+ FFX_LOG_FLAGS flags to pass to ffx log, see `fx ffx log --help`.
+
+LEGACY MODE: listen for logs from the on-device log_listener
+
+usage: fx log --legacy [-h | --help] [--raw] LOG_LISTENER_FLAGS
+
+ --legacy runs in legacy mode, i.e. listen for logs from
+ the on-device log_listener
--raw do not attempt to symbolize the log
diff --git a/main/tools/fx/index.md b/main/tools/fx/index.md
index d98a900..cc64943 100644
--- a/main/tools/fx/index.md
+++ b/main/tools/fx/index.md
@@ -63,7 +63,7 @@
[list-devices](cmd/list-devices.md) | [Device discovery](device_discovery/README.md) | list all nearby devices (excluding those on zedboot)
[list-products](cmd/list-products.md) | [Build](build/README.md) | list products available for building
[list-usb-disks](cmd/list-usb-disks.md) | [Other](other/README.md) | list attached usb disks
-[log](cmd/log.md) | [Run, inspect and debug](run_inspect_and_debug/README.md) | listen for logs from the on-device log\_listener
+[log](cmd/log.md) | [Run, inspect and debug](run_inspect_and_debug/README.md) | Display logs from a target device.
[mdlint](cmd/mdlint.md) | [Code submission and review](code_submission_and_review/README.md) | Markdown linter
[merge-package-config](cmd/merge-package-config.md) | [Other](other/README.md) |
[metrics](cmd/metrics.md) | [Other](other/README.md) | manage collection of metrics in fx tools
diff --git a/main/tools/fx/run_inspect_and_debug/README.md b/main/tools/fx/run_inspect_and_debug/README.md
index 2412982..75fbdbd 100644
--- a/main/tools/fx/run_inspect_and_debug/README.md
+++ b/main/tools/fx/run_inspect_and_debug/README.md
@@ -5,7 +5,7 @@
[bootfs-size-report](../cmd/bootfs-size-report.md) | produce an uncompressed size report from a ZBI
[host-tool](../cmd/host-tool.md) | run a host tool produced by the build
[klog](../cmd/klog.md) | listen for kernel logs
-[log](../cmd/log.md) | listen for logs from the on-device log\_listener
+[log](../cmd/log.md) | Display logs from a target device.
[qemu](../cmd/qemu.md) | start fuchsia in qemu with a FVM disk
[run-netboot](../cmd/run-netboot.md) | start fuchsia in qemu via netboot
[symbolize](../cmd/symbolize.md) | Deprecated, please use "ffx debug symbolize"