Commit graph

8 commits

Author SHA1 Message Date
Ruud van Asseldonk
45b545562b Stylize RCL consistently in small caps in docs
The diff here is best viewed with --word-diff.
2024-06-20 22:36:50 +02:00
Ruud van Asseldonk
0f35dfe9d4 Allow escaping } in strings
It never needs to be escaped, but { needs to be escaped in f-strings,
so for symmetry, allow escaping the } too.
2024-03-02 19:37:30 +01:00
Ruud van Asseldonk
546c139aca Correct docs and Pygments lexer for \u{...} escapes
After changing the sytnax from \u[...] to \u{...}.
2023-09-30 02:18:20 +02:00
Ruud van Asseldonk
095678fe7d Enable syntax highlighting in docs examples 2023-09-24 22:16:57 +02:00
Ruud van Asseldonk
ccce882f4b Force a line break after """
Allowing this creates so many problems that I now have to work around
and fix ... let's just ban it, it will be easier.

Supporting """-quoted strings that are sometimes immediately followed by
a line break and sometimes not, and thinking about what that meant for
how to strip the whitespace ... it was a big ugly mess. I almost got it
to work, until it got to the case of

    let x = """   x
        bar
        """;

What should that even mean? So to simplify things, let's just ban this
and demand a newline after the opening quotes. I'm open to later
relaxing to allow single-line """-strings, but for now I just don't want
to implement all the special cases.
2023-09-20 20:35:44 +02:00
Ruud van Asseldonk
f96f20b9bd Handle blank lines in multiline strings 2023-09-17 21:09:23 +02:00
Ruud van Asseldonk
c6151c7197 Clarify string documentation a bit
Also update to the latest version of the docs theme. I added support for
footnotes because I use them here. Without specific style the hr is very
ugli, and also the way I set up the <ol> does not work when there is a
<p> inside the <li>. Floating the <li>::before helps.
2023-09-04 21:37:43 +02:00
Ruud van Asseldonk
d81b812abb Document how strings work 2023-08-28 01:41:00 +02:00