Informational 15 Bitcoin Committed Oct 13, 2026 · 15:53 UTC

doc: fix references to manpages that don't exist

33fda2d0 View source ↗

Public commit record

What the developer wrote

Authored by mikeua

68/100 · Adequate

doc: fix references to manpages that don't exist

Several schema descriptions and see_also lists name manpages that are
never generated, so the links in the rendered docs are dead:

- lightningd-fetchinvoice(7) / lightningd-invoicerequest(7) ->
lightning-fetchinvoice(7) / lightning-invoicerequest(7)
- lightning-listsentpays(7) -> lightning-listsendpays(7)
- lightning-currencyrates(7) -> lightning-currencyrate(7)
- lightning-invoicerequests(7) -> lightning-invoicerequest(7)
- lightning-listbalances(7) and lightning-bkpr-listfunds(7) ->
lightning-bkpr-listbalances(7)

contrib/msggen/msggen/schema.json is updated to match.

Changelog-None

✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context

The short version

What changed, and why it matters

This commit only fixes broken documentation links. It corrects the names of referenced manual pages in JSON schema files so that generated documentation points to pages that actually exist. There are no code, configuration, or behavior changes, and no security implications.

Recommended action

No security action required. Treat as a normal documentation fix.

Security signals we found

No strong security signals were identified.

Technical analysis

Evidence from the diff

The commit updates doc/schema JSON files and contrib/msggen/msggen/schema.json to replace references to non-existent manpages with the correct names (e.g., lightningd-fetchinvoice -> lightning-fetchinvoice, lightning-listsentpays -> lightning-listsendpays, lightning-bkpr-listfunds -> lightning-bkpr-listbalances). These are purely documentation metadata changes; no executable logic, API behavior, or wire protocol is affected.

Changed components

doc/schemas/bkpr-channelsapy.jsondoc/schemas/bkpr-dumpincomecsv.jsondoc/schemas/bkpr-inspect.jsondoc/schemas/currencyconvert.jsondoc/schemas/delpay.jsondoc/schemas/injectpaymentonion.jsondoc/schemas/listinvoicerequests.jsondoc/schemas/pay.jsondoc/schemas/sendonion.jsondoc/schemas/xpay.jsoncontrib/msggen/msggen/schema.json

Inspect captured patch +22 / −22

### contrib/msggen/msggen/schema.json
@@ -3420,7 +3420,7 @@
       ],
       "see_also": [
         "lightning-bkpr-listincome(7)",
-        "lightning-bkpr-listfunds(7)",
+        "lightning-bkpr-listbalances(7)",
         "lightning-bkpr-listaccountevents(7)",
         "lightning-bkpr-dumpincomecsv(7)",
         "lightning-listpeers(7)"
@@ -3608,7 +3608,7 @@
       ],
       "see_also": [
         "lightning-bkpr-listincome(7)",
-        "lightning-bkpr-listfunds(7)",
+        "lightning-bkpr-listbalances(7)",
         "lightning-bkpr-listaccountevents(7)",
         "lightning-bkpr-channelsapy(7)",
         "lightning-listpeers(7)"
@@ -4449,7 +4449,7 @@
         "Lisa Neigut [niftynei@gmail.com](mailto:niftynei@gmail.com) is mainly responsible."
       ],
       "see_also": [
-        "lightning-listbalances(7)",
+        "lightning-bkpr-listbalances(7)",
         "lightning-listfunds(7)",
         "lightning-listpeers(7)"
       ],
@@ -8399,7 +8399,7 @@
         "daywalker90 is mainly responsible."
       ],
       "see_also": [
-        "lightning-currencyrates(7)"
+        "lightning-currencyrate(7)"
       ],
       "resources": [
         "Main web site: [https://github.com/ElementsProject/lightning](https://github.com/ElementsProject/lightning)"
@@ -12649,7 +12649,7 @@
       },
       "errors": [
         "On failure, an error is returned. If the lightning process fails before responding, the",
-        "caller should use lightning-listsentpays(7) or lightning-listpays(7) to query whether this payment was deleted or not.",
+        "caller should use lightning-listsendpays(7) or lightning-listpays(7) to query whether this payment was deleted or not.",
         "",
         "The following error codes may occur:",
         "",
@@ -17860,7 +17860,7 @@
           "localinvreqid": {
             "type": "hash",
             "description": [
-              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7)."
+              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7)."
             ]
           },
           "destination_msat": {
@@ -25001,7 +25001,7 @@
         "Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
       ],
       "see_also": [
-        "lightning-invoicerequests(7)",
+        "lightning-invoicerequest(7)",
         "lightning-disableinvoicerequest(7)"
       ],
       "resources": [
@@ -32647,7 +32647,7 @@
             "description": [
               "NOTE: `invstring` is an alternate name for this parameter, since v26.06, for xpay compatibility.",
               "",
-              "Bolt11 or bolt12 invoice (such as one received from lightningd-fetchinvoice(7)). For a bolt11 invoice, if it does not contain an amount, *amount_msat* is required, otherwise if it is specified it must be *null*."
+              "Bolt11 or bolt12 invoice (such as one received from lightning-fetchinvoice(7)). For a bolt11 invoice, if it does not contain an amount, *amount_msat* is required, otherwise if it is specified it must be *null*."
             ]
           },
           "amount_msat": {
@@ -32699,7 +32699,7 @@
           "localinvreqid": {
             "type": "hex",
             "description": [
-              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
+              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
             ]
           },
           "exclude": {
@@ -35165,7 +35165,7 @@
           "localinvreqid": {
             "type": "hash",
             "description": [
-              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7)."
+              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7)."
             ]
           },
           "groupid": {
@@ -41380,7 +41380,7 @@
             "type": "hex",
             "added": "v26.06",
             "description": [
-              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
+              "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
             ]
           },
           "dev_use_shadow": {

### doc/schemas/bkpr-channelsapy.json
@@ -198,7 +198,7 @@
   ],
   "see_also": [
     "lightning-bkpr-listincome(7)",
-    "lightning-bkpr-listfunds(7)",
+    "lightning-bkpr-listbalances(7)",
     "lightning-bkpr-listaccountevents(7)",
     "lightning-bkpr-dumpincomecsv(7)",
     "lightning-listpeers(7)"

### doc/schemas/bkpr-dumpincomecsv.json
@@ -79,7 +79,7 @@
   ],
   "see_also": [
     "lightning-bkpr-listincome(7)",
-    "lightning-bkpr-listfunds(7)",
+    "lightning-bkpr-listbalances(7)",
     "lightning-bkpr-listaccountevents(7)",
     "lightning-bkpr-channelsapy(7)",
     "lightning-listpeers(7)"

### doc/schemas/bkpr-inspect.json
@@ -200,7 +200,7 @@
     "Lisa Neigut [niftynei@gmail.com](mailto:niftynei@gmail.com) is mainly responsible."
   ],
   "see_also": [
-    "lightning-listbalances(7)",
+    "lightning-bkpr-listbalances(7)",
     "lightning-listfunds(7)",
     "lightning-listpeers(7)"
   ],

### doc/schemas/currencyconvert.json
@@ -48,7 +48,7 @@
     "daywalker90 is mainly responsible."
   ],
   "see_also": [
-    "lightning-currencyrates(7)"
+    "lightning-currencyrate(7)"
   ],
   "resources": [
     "Main web site: [https://github.com/ElementsProject/lightning](https://github.com/ElementsProject/lightning)"

### doc/schemas/delpay.json
@@ -189,7 +189,7 @@
   },
   "errors": [
     "On failure, an error is returned. If the lightning process fails before responding, the",
-    "caller should use lightning-listsentpays(7) or lightning-listpays(7) to query whether this payment was deleted or not.",
+    "caller should use lightning-listsendpays(7) or lightning-listpays(7) to query whether this payment was deleted or not.",
     "",
     "The following error codes may occur:",
     "",

### doc/schemas/injectpaymentonion.json
@@ -70,7 +70,7 @@
       "localinvreqid": {
         "type": "hash",
         "description": [
-          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7)."
+          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7)."
         ]
       },
       "destination_msat": {

### doc/schemas/listinvoicerequests.json
@@ -93,7 +93,7 @@
     "Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
   ],
   "see_also": [
-    "lightning-invoicerequests(7)",
+    "lightning-invoicerequest(7)",
     "lightning-disableinvoicerequest(7)"
   ],
   "resources": [

### doc/schemas/pay.json
@@ -27,7 +27,7 @@
         "description": [
           "NOTE: `invstring` is an alternate name for this parameter, since v26.06, for xpay compatibility.",
           "",
-          "Bolt11 or bolt12 invoice (such as one received from lightningd-fetchinvoice(7)). For a bolt11 invoice, if it does not contain an amount, *amount_msat* is required, otherwise if it is specified it must be *null*."
+          "Bolt11 or bolt12 invoice (such as one received from lightning-fetchinvoice(7)). For a bolt11 invoice, if it does not contain an amount, *amount_msat* is required, otherwise if it is specified it must be *null*."
         ]
       },
       "amount_msat": {
@@ -79,7 +79,7 @@
       "localinvreqid": {
         "type": "hex",
         "description": [
-          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
+          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
         ]
       },
       "exclude": {

### doc/schemas/sendonion.json
@@ -111,7 +111,7 @@
       "localinvreqid": {
         "type": "hash",
         "description": [
-          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7)."
+          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7)."
         ]
       },
       "groupid": {

### doc/schemas/xpay.json
@@ -85,7 +85,7 @@
         "type": "hex",
         "added": "v26.06",
         "description": [
-          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightningd-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
+          "`localinvreqid` is used by offers to link a payment attempt to a local `invoice_request` offer created by lightning-invoicerequest(7). This  ensures that we only make a single payment for an offer, and that the offer is marked `used` once paid."
         ]
       },
       "dev_use_shadow": {

Risk score

Why this scored 15/100

Our methodology →

Potential impact 0/30

Exploitability 0/25

Stealth signal 0/15

Affected reach 0/15

Confidence 10/10

Evidence quality 5/5

Human-validated context

Community notes

Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.

No validated notes yet.

The AI analysis stands alone for now. Submit a note if you can add evidence or important context.

What the developer wrote

What changed, and why it matters

Security signals we found

Evidence from the diff

Changed components

Why this scored 15/100

Community notes

Related watches

reprobuild: cross-compile armv7 tarballs

tools: add sign-release-arm.sh

CI: never replace files already on the release