[Nut-upsdev] Output from 'make distcheck-light' and documentation question

[Jim Klimov]

Those warnings are (assumed) harmless and have to do with asciidoc tooling,
at least as of the packagrd version in distro, using some Python syntax
that the language has, in its new round of immense wisdom, decided to wind
down and deprecate eventually.

Jim

On Mon, Feb 17, 2025, 21:19 William R. Elliot via Nut-upsdev <
nut-upsdev at alioth-lists.debian.net> wrote:

> Hello all,
>
> I am nearing the end of the driver development and am crossing t's and
> dotting i's. When running 'make distcheck-light' I am getting a very large
> number of messages like the following:
>
> While in /nut/docs/man:
>   DOC-MAN  Generating nut.conf.5
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
>   DOC-MAN  Generating ups.conf.5
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
>   DOC-MAN  Generating upsd.conf.5
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
>   DOC-MAN  Generating upsd.users.5
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> (etc.)
>
> Or in /nut/nut-2.8.2.1968.10/_build/sub/docs/man (basically, the same list
> of files):
>
>   DOC-MAN-HTML Generating nut.conf.html
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
>   DOC-MAN-HTML Generating ups.conf.html
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
>   DOC-MAN-HTML Generating upsd.conf.html
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
> (etc.)
>
> To the best of my knowledge I have not touched the long list of files
> being processed (except for the new .txt file for the new driver).
>
> Regarding documentation, I have place a new .txt file in  nut/docs/man and
> updated Makefile.am in SRC_SERIAL_PAGES, MAN_SERIAL_PAGES,
> HTML_SERIAL_MANS, SrC_USB_LIBUSB_PAGES, and HTML_USB_LIBUSB_MANS.
>
> Are there other sections of the Makefile.am or other files that need to be
> modified for the man pages to be populated?
>
> Many thanks,
>
> Bill
>
>
>
>
> <http://www.avg.com/email-signature?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=emailclient>
> Virus-free.www.avg.com
> <http://www.avg.com/email-signature?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=emailclient>
> <#m_-4873275473956643599_DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2>
> _______________________________________________
> Nut-upsdev mailing list
> Nut-upsdev at alioth-lists.debian.net
> https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/nut-upsdev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/nut-upsdev/attachments/20250218/42b3f752/attachment.htm>