[xml/sgml-pkgs] Bug#1101840: “LinuxdocTools::process_file: Cannot find favourites.gpx. Aborting” -- also, docs are wrong

[Manny]

Package: linuxdoc-tools
Version: 0.9.82-1
Severity: normal
Tags: upstream
X-Debbugs-Cc: debbug.linuxdoc-tools at sideload.33mail.com

A simple attempt to validate SGML conformance of a GPX file from OSMand fails:

  $ linuxdoc -B check favourites.gpx
  Processing file favourites.gpx
  LinuxdocTools::process_file: Cannot find favourites.gpx. Aborting ...

This file most certainly does exist. It is in the current directory. I
also tried prepending with “./” and that made no difference.

This was the command to obtain the file from an Android:

  $ adb pull storage/sdcard1/Android/data/net.osmand.plus/files/favourites.gpx

The file has MSDOS carriage returns. I piped it through dos2unix, made
some edits, then ran “linuxdoc -B check newfile.gpx”. That failed in
the same way.

I have to say as well that the man page is wrong. For example, this is
documented as a mandatory parameter:

  --papersize=size

But this would make no sense. Paper size is irrelevant to SGML
docs. There is also a default (A4). If there is a default then it
cannot be a mandatory option. So the correct BNF is to enclose it in
square brackets, like this: [--papersize=size].

I am assuming the problem is not lack of parameters, but it’s hard to
be confident when the man page is wrong.

The obsolete command sgmlcheck seems to be correctly documented since
the syntax is so simple. So I tried:

  $ sgmlcheck favourites.gpx
  Processing file favourites.gpx
  LinuxdocTools::process_file: Cannot find favourites.gpx. Aborting ...

That also gave the same failure output.

-- System Information:
Debian Release: 12.10
  APT prefers stable-updates
  APT policy: (990, 'stable-updates'), (990, 'stable-security'), (990, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.10.0-28-amd64 (SMP w/2 CPU threads)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages linuxdoc-tools depends on:
ii  gawk       1:5.2.1-2
ii  libc6      2.36-9+deb12u10
ii  libfl2     2.6.4-8.2
ii  mawk       1.3.4.20200120-3.1
ii  opensp     1.5.2-13+b2
ii  perl       5.36.0-7+deb12u1
ii  sgml-base  1.31
ii  sgml-data  2.0.11+nmu1

linuxdoc-tools recommends no packages.

Versions of packages linuxdoc-tools suggests:
ii  emacs-gtk [info-browser]   1:28.2+1-15+deb12u4
pn  groff                      <none>
ii  info [info-browser]        6.8-6+b1
pn  linuxdoc-tools-info        <none>
pn  linuxdoc-tools-latex       <none>
pn  linuxdoc-tools-text        <none>
ii  texinfo                    6.8-6+b1
ii  texlive-latex-recommended  2022.20230122-3

-- no debconf information