Skip to contentSkip to conversation

SyntaxWarning for '\S'

DISCUSSION Stephen Smith 2 participants 3 messages Sep 10, 2024 – Sep 13, 2024

lore
Share & tools
lore
#0 lore raw

When compiling Git from source on my Ubuntu machine I've lately been getting some warnings when the docs are built.

An example of is:

ASCIIDOC git-sh-i18n--envsubst.html <unknown>:1: SyntaxWarning: invalid escape sequence '\S' <unknown>:1: SyntaxWarning: invalid escape sequence '\S'

This syntax warning shows up for nearly every man page or html file.

Is there are current documented solution? If there isn't a documented
solution, where do I start looking and I will craft a patch and submit it.

Thanks

#1 lore raw
Quoted 5 lines · Stephen Smith

When compiling Git from source on my Ubuntu machine I've lately been getting some warnings when the docs are built.

An example of is:

Quoted 8 lines

ASCIIDOC git-sh-i18n--envsubst.html <unknown>:1: SyntaxWarning: invalid escape sequence '\S' <unknown>:1: SyntaxWarning: invalid escape sequence '\S'

This syntax warning shows up for nearly every man page or html file.

Is there are current documented solution? If there isn't a documented
solution, where do I start looking and I will craft a patch and submit it.

I believe this is a warning from Python about the asciidoc program itself. I don't see this on my Debian unstable system, so it may be that it's fixed upstream (you can check at
https://gitlab.com/asciidoc3/asciidoc3/) and if so, you can open an issue with Ubuntu to get it fixed.

If it bothers you, you could also use Asciidoctor, which is written in Ruby, and which won't have that warning.

Signature · 2 lines
brian m. carlson (they/them or he/him)
Toronto, Ontario, CA
#2 lore raw

Given that you don’t see it and that Ubuntu release is due a month from now I will see if it is part of the update. If the fix isn’t part of the update I will report it.

Thanks.
SPS

Quoted 29 lines · brian m. carlson
Quoted 5 lines · Stephen Smith

When compiling Git from source on my Ubuntu machine I've lately been getting some warnings when the docs are built.

An example of is:

Quoted 8 lines

ASCIIDOC git-sh-i18n--envsubst.html <unknown>:1: SyntaxWarning: invalid escape sequence '\S' <unknown>:1: SyntaxWarning: invalid escape sequence '\S'

This syntax warning shows up for nearly every man page or html file.

Is there are current documented solution? If there isn't a documented
solution, where do I start looking and I will craft a patch and submit it.

I believe this is a warning from Python about the asciidoc program itself. I don't see this on my Debian unstable system, so it may be that it's fixed upstream (you can check at
https://gitlab.com/asciidoc3/asciidoc3/) and if so, you can open an issue with Ubuntu to get it fixed.

If it bothers you, you could also use Asciidoctor, which is written in Ruby, and which won't have that warning.
--
brian m. carlson (they/them or he/him)
Toronto, Ontario, CA
<signature.asc>