From faa570f45c1775185bef5c41dba5d5bcc26d76c8 Mon Sep 17 00:00:00 2001 From: Chris Mayo Date: Thu, 22 Feb 2024 19:21:53 +0000 Subject: [PATCH 1/2] Document CssSyntaxCheck and HtmlSyntaxCheck submit URLs --- doc/src/man/linkcheckerrc.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/doc/src/man/linkcheckerrc.rst b/doc/src/man/linkcheckerrc.rst index 0b31a958..2a97f68a 100644 --- a/doc/src/man/linkcheckerrc.rst +++ b/doc/src/man/linkcheckerrc.rst @@ -534,8 +534,10 @@ warnings. HtmlSyntaxCheck ^^^^^^^^^^^^^^^ -Check the syntax of HTML pages with the online W3C HTML validator. See -https://validator.w3.org/docs/api.html. +Check the syntax of HTML pages by submitting their URLs to the online W3C HTML +validator. If a page URL is not accessible to the validator no check is +performed and no warning given. +See https://validator.w3.org/docs/api.html. .. note:: @@ -553,8 +555,10 @@ Print HTTP headers in URL info. CssSyntaxCheck ^^^^^^^^^^^^^^ -Check the syntax of HTML pages with the online W3C CSS validator. See -https://jigsaw.w3.org/css-validator/manual.html#expert. +Check the syntax of HTML pages by submitting their URLs to the online W3C CSS +validator. If a page URL is not accessible to the validator no check is +performed and no warning given. +See https://jigsaw.w3.org/css-validator/manual.html#expert. VirusCheck ^^^^^^^^^^ From ffe4a83b8858fe4706a3ba30d5f8054a233dd1a4 Mon Sep 17 00:00:00 2001 From: Chris Mayo Date: Thu, 22 Feb 2024 19:21:53 +0000 Subject: [PATCH 2/2] Document CssSyntaxCheck checks stylesheets --- doc/src/man/linkcheckerrc.rst | 4 ++-- linkcheck/plugins/syntaxchecks.py | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/src/man/linkcheckerrc.rst b/doc/src/man/linkcheckerrc.rst index 2a97f68a..d7ee4382 100644 --- a/doc/src/man/linkcheckerrc.rst +++ b/doc/src/man/linkcheckerrc.rst @@ -555,8 +555,8 @@ Print HTTP headers in URL info. CssSyntaxCheck ^^^^^^^^^^^^^^ -Check the syntax of HTML pages by submitting their URLs to the online W3C CSS -validator. If a page URL is not accessible to the validator no check is +Check the syntax of CSS stylesheets by submitting their URLs to the online W3C CSS +validator. If a stylesheet URL is not accessible to the validator no check is performed and no warning given. See https://jigsaw.w3.org/css-validator/manual.html#expert. diff --git a/linkcheck/plugins/syntaxchecks.py b/linkcheck/plugins/syntaxchecks.py index a011d6a1..2dd13026 100644 --- a/linkcheck/plugins/syntaxchecks.py +++ b/linkcheck/plugins/syntaxchecks.py @@ -83,7 +83,7 @@ class HtmlSyntaxCheck(_ContentPlugin): class CssSyntaxCheck(_ContentPlugin): - """Check the syntax of HTML pages with the online W3C CSS validator. + """Check the syntax of CSS stylesheets with the online W3C CSS validator. See https://jigsaw.w3.org/css-validator/manual.html#expert. """