[Pkg-electronics-devel] Bug#1001758: arduino(1) woefully wrong

[Joseph Carter]

Package: arduino
Version: 2:1.8.16+dfsg1-1
Severity: normal

The arduino(1) manpage written in 2010 may have been accurate at the
time, but … today isn't. It says the program takes no options, etc. The
github repo for the project contains this adoc file:

https://github.com/arduino/Arduino/blob/master/build/shared/manpage.adoc

It begs to differ, suggesting all of these work:


arduino [FILE.ino…]

arduino [--verify|--upload] [--board package:arch:board[:parameters]] [--port portname] [--pref name=value] [-v|--verbose] [--preserve-temp-files] [FILE.ino]

arduino [--get-pref [preference]]

arduino [--install-boards package name:platform architecture[:version]]

arduino [--install-library library name[:version][,library name[:version],library name[:version]]

arduino [--version]


Sadly, one would be forgiven for failing to know about this because they
DO NOT SUPPORT --help! *twelve minute gap tirade about Java apps being
standards-ignoring flaming piles of horse excrement censored*

Could you work the upstream manpage in to future releases please? Much
appreciated!

-- System Information:
Debian Release: bookworm/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 5.15.0-2-amd64 (SMP w/16 CPU threads)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, 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 arduino depends on:
ii  arduino-builder               1.3.25-3
ii  arduino-core-avr              1.8.4+dfsg1-1
ii  avrdude                       6.3-20171130+svn1429-2+b1
ii  default-jre                   2:1.11-72
ii  dpkg-dev                      1.21.1
ii  libastylej-jni                3.1-2+b1
ii  libbatik-java                 1.14-1
ii  libbcpg-java                  1.68-5
ii  libbcprov-java                1.68-5
ii  libcommons-codec-java         1.15-1
ii  libcommons-compress-java      1.21-1
ii  libcommons-exec-java          1.3-2
ii  libcommons-io-java            2.11.0-2
ii  libcommons-lang3-java         3.11-1
ii  libcommons-logging-java       1.2-2
ii  libcommons-net-java           3.6-1
ii  libhttpclient-java            4.5.13-3
ii  libjackson2-annotations-java  2.13.0-1
ii  libjackson2-core-java         2.13.0-2
ii  libjackson2-databind-java     2.13.0-2
ii  libjaxp1.3-java               1.3.05-6
ii  libjmdns-java                 3.5.5-1
ii  libjna-java                   5.9.0-1
ii  libjna-platform-java          5.9.0-1
ii  libjsch-java                  0.1.55-1
ii  libjssc-java                  2.8.0-3
ii  liblistserialsj-dev           1.4.0-1+b1
ii  liblog4j2-java                2.16.0-1
ii  librsyntaxtextarea-java       2.5.8-1
ii  librxtx-java                  2.2pre2+dfsg1-2
ii  libsemver-java                0.9.0-4
ii  libslf4j-java                 1.7.32-1
ii  libxml-commons-external-java  1.4.01-5
ii  libxmlgraphics-commons-java   2.6-1
ii  openjdk-11-jre                11.0.13+8-1

Versions of packages arduino recommends:
ii  extra-xdg-menus  1.0-6
ii  policykit-1      0.105-31

arduino suggests no packages.

-- no debconf information