SyntaxWarning for '\S'

SyntaxWarning for '\S'

[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:

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

Re: SyntaxWarning for '\S'

[brian m. carlson]

[-- Attachment #1: Type: text/plain, Size: 1065 bytes --]

On 2024-09-10 at 03:49:33, Stephen Smith wrote:
> 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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 262 bytes --]

Re: SyntaxWarning for '\S'

[Stephen Smith]

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

> On Sep 13, 2024, at 11:24 AM, brian m. carlson <sandals@crustytoothpaste.net> wrote:
> 
> On 2024-09-10 at 03:49:33, Stephen Smith wrote:
>> 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
> <signature.asc>