09d52b3cb4
The only time underscores aren't special in Markdown is when they appear
in preformatted text. We have gotten away with not escaping underscores
where an asterisk-enclosed span or the paragraph ends before the next
underscore appears, but this is fragile and bad practice. Conversely,
there are many places where we have not escaped underscores but needed
to.
Escape all underscores that do not appear in preformatted blocks or
preformatted spans and are not themselves delineating emphasized spans.
The changes in this commit are exactly the result of executing the
following Bash code:
```bash
e=':x;' # begin loop
e+='s/^' # anchor match at beginning of line
e+='(' # begin capturing subexpression
e+='(' # begin list of alternatives
e+='[^`_\\]|' # any mundane character, or
e+='`([^`\\]|\\.)*`|' # backtick-enclosed span, or
e+='\b_|_\b|' # underscore at boundary, or
e+='\\.' # backslash-escaped character
e+=')*' # any number of the preceding alternatives
e+=')' # end capturing subexpression
e+='\B_\B/\1\\_/;' # escape non-formatting underscore
e+='tx' # repeat loop if we escaped an underscore
escape_underscores=(
sed
# use extended regular expressions
-E
# skip over indented blocks (following an empty line)
-e '/^$/{:i;n;/^( {4,}|\t)/bi}'
# skip over preformatted blocks
-e '/^\s*```/,/^\s*```/{p;d}'
# skip over generated sections
-e '/GENERATE-FROM-SCHEMA-START/,/GENERATE-FROM-SCHEMA-END/{p;d}'
# escape underscores
-e "${e}"
)
"${escape_underscores[@]}" -i doc/*.[0-9].md
```
Changelog-None
2.9 KiB
lightning-sendinvoice -- Command for send an invoice for an offer
SYNOPSIS
(WARNING: experimental-offers only)
sendinvoice offer label [msatoshi] [timeout] [quantity]
DESCRIPTION
The sendinvoice RPC command creates and sends an invoice to the issuer of an offer for it to pay: the offer must contain send_invoice; see lightning-fetchinvoice(7).
If fetchinvoice-noconnect is not specified in the configuation, it
will connect to the destination in the (currently common!) case where it
cannot find a route which supports option_onion_messages.
offer is the bolt12 offer string beginning with "lno1".
label is the unique label to use for this invoice.
msatoshi is optional: it is required if the offer does not specify an amount at all, or specifies it in a different currency. Otherwise you may set it (e.g. to provide a tip), and if not it defaults to the amount contained in the offer (multiplied by quantity if any).
timeout is how many seconds to wait for the offering node to pay the invoice or return an error, default 90 seconds. This will also be the timeout on the invoice that is sent.
quantity is optional: it is required if the offer specifies quantity_min or quantity_max, otherwise it is not allowed.
RETURN VALUE
On success, an object is returned, containing:
- label (string): unique label supplied at invoice creation
- description (string): description used in the invoice
- payment_hash (hex): the hash of the payment_preimage which will prove payment (always 64 characters)
- status (string): Whether it's paid, unpaid or unpayable (one of "unpaid", "paid", "expired")
- expires_at (u64): UNIX timestamp of when it will become / became unpayable
- amount_msat (msat, optional): the amount required to pay this invoice
- bolt12 (string, optional): the BOLT12 string
If status is "paid":
- pay_index (u64): Unique incrementing index for this payment
- amount_received_msat (msat): the amount actually received (could be slightly greater than amount_msat, since clients may overpay)
- paid_at (u64): UNIX timestamp of when it was paid
- payment_preimage (hex): proof of payment (always 64 characters)
The following error codes may occur:
- -1: Catchall nonspecific error.
- 1002: Offer has expired.
- 1003: Cannot find a route to the node making the offer.
- 1004: The node making the offer returned an error message.
- 1005: We timed out waiting for the invoice to be paid
AUTHOR
Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.
SEE ALSO
lightning-fetchinvoice(7).
RESOURCES
Main web site: https://github.com/ElementsProject/lightning