diff --git a/pkg/urbit/vere/io/conn.c b/pkg/urbit/vere/io/conn.c
index 99551d11fa..1018e3823a 100644
--- a/pkg/urbit/vere/io/conn.c
+++ b/pkg/urbit/vere/io/conn.c
@@ -54,10 +54,18 @@
 **  (unit).
 **
 **  the %peel path /help produces a list of available commands.
-**  /args produces the command-line arguments used to start vere.
 **  /info produces runtime metrics at the moment in time that the
 **  request was received.
 **
+**  the type produced by /info is currently:
+**
+**      (list [cord (list [cord (list [cord @])])])
+**
+**  where the first layer of cord is major subsystem ('http',
+**  'ames', or 'work'), the second layer is instance identifier
+**  or 'all', and the third is metric name. most metrics are @ud,
+**  but the precise interpretation depends on the metric.
+**
 **  %ovum is a raw kernel move, to be injected directly into
 **  arvo. needless to say this will void your warranty. usually
 **  you want to use %fyrd instead. an update will be sent: %done