[xml/sgml-pkgs] Bug#824772: libxml2-utils: Several xmllint shell commands missing from man-page

[Sam Kuper]

Package: libxml2-utils
Version: 2.9.1+dfsg1-5+deb8u1
Severity: minor

Dear Maintainer,

The xmllint man page gives the impression that it summarises every
command available in the xmllint shell.

However, running `xmllint --shell` and then entering the `help` command
reveals that there are several commands available that are not
documented in the man page:

setbase URI
set xml_fragment
xpath expr
setns nsreg
setrootns
whereis
relaxng rng
grep string

It appears that some of these commands were added to xmllint >10 years
ago:

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=149013

For a command not to be documented in the relevant man page would seem
to be a documentation bug. Please, therefore, could these commands be
be documented in the man page?

I am unsure whether or not this problem exists upstream.

Thanks,

- spk

P.S. Some informal but helpful documentation exists on the Web. For
example:

http://linux.byexamples.com/archives/565/your-xml-friend-xpath-command-line-xmllint/

http://chihungchan.blogspot.co.uk/2011/01/xmllint-for-xml-namspace.html

https://mail.gnome.org/archives/xml/2010-January/msg00028.html



-- System Information:
Debian Release: 8.4
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 3.16.0-4-686-pae (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 libxml2-utils depends on:
ii  libc6    2.19-18+deb8u4
ii  libxml2  2.9.1+dfsg1-5+deb8u1

libxml2-utils recommends no packages.

libxml2-utils suggests no packages.

-- no debconf information