Re: SyntaxWarning for '\S'

From: brian m. carlson <sandals@crustytoothpaste.net>
Date: Sep 13, 2024, 18:24 UTC
Message-ID: <ZuSDQPssBOujNCrF@tapette.crustytoothpaste.net>
In-Reply-To: <2214912.irdbgypaU6@thunderbird>

On 2024-09-10 at 03:49:33, Stephen Smith wrote:

Show 13 quoted lines

> 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.

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