Package: tidy
Version: 1:5.2.0-1.1
Severity: wishlist
Tags: patch

First, thank you for packaging tidy-html5!

My complaint is just that the package description hasn't been updated
this millennium.  A remarkable amount of it is still fine, but there's
one line that definitely needs updating, where it says that tidy
"[...] has a comprehensive knowledge of the attributes defined in the
HTML 4.0 recommendation from W3C, and [...]".

You might want to use the obvious minimal fix "s/4/5/", but it'll be
5.1 soon; and besides, tidy can handle more than just HTML, and knows
more about the specs than just the bits about "attributes".  My patch
rephrases it to say that tidy "[...] has a comprehensive knowledge of
the W3C recommendations for HTML/XHTML/XML, and [...]".

Oh, one other thing: there's what seems to be a surplus article in the
clause about encodings, where it says "and understands the US ASCII,
ISO Latin-1, UTF-8 and the ISO 2022 family of 7-bit encodings".  Given
that UTF-8 isn't 7-bit, it can't be saying "the X/Y/Z 7-bit
encodings"; it must be trying to say "X, Y, and the Z encodings", so
I've taken out the first article.  I've also added an IANA-conformant
hyphen to "US-ASCII".

It's possible that the final line saying "Tidy is a product of the
World Wide Web Consortium" may want an update to something explicitly
mentioning HTML5 and HTACG.  I'll leave that up to you.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (990, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 4.6.0-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages tidy depends on:
ii  dpkg      1.18.7
ii  libc6     2.22-11
ii  libtidy5  1:5.2.0-1.1

tidy recommends no packages.

tidy suggests no packages.

-- no debconf information

-- 
JBR     with qualifications in linguistics, experience as a Debian
        sysadmin, and probably no clue about this particular package
diff -ru tidy-html5-5.2.0.pristine/debian/control tidy-html5-5.2.0/debian/control
--- tidy-html5-5.2.0.pristine/debian/control	2016-06-08 14:09:39.000000000 +0100
+++ tidy-html5-5.2.0/debian/control	2016-06-27 11:42:57.221243947 +0100
@@ -13,9 +13,9 @@
 Description: HTML syntax checker and reformatter
  Corrects markup in a way compliant with the latest standards, and
  optimal for the popular browsers.  It has a comprehensive knowledge
- of the attributes defined in the HTML 4.0 recommendation from W3C,
- and understands the US ASCII, ISO Latin-1, UTF-8 and the ISO 2022
- family of 7-bit encodings.  In the output:
+ of the W3C recommendations for HTML/XHTML/XML, and understands
+ US-ASCII, ISO Latin-1, UTF-8 and the ISO 2022 family of 7-bit
+ encodings.  In the output:
  .
   * HTML entity names for characters are used when appropriate.
   * Missing attribute quotes are added, and mismatched quotes found.

Reply via email to