Bug#949769: arduino-mk: clean-up package for Debian

[Osamu Aoki]

Control: tags -1 + patch

Hi,

As I see 3 bugs on this arduino-mk package, the issue is mostly lack of
documentation and gap with expectation.

Of course, we should provide examples which need mo-excuses ;-)
Gere us a patch for it.

In addition to this, let's make 2 key upstream documentation contents
accerssible from the expected location: /usr/share/doc/arduino-mk/*

Since upstream README.md contains too many non-Debian contents, adding
README.Debian which is lightly edited excerpts of the upstream README.md
is a good idea. Also whoever care to use this package needs to be
informed about extremely old version problem for arduino.

  Due to recent changes in the upstream software distribution infrastructure
  of Arduino relying heavily on pre-compiled binary blobs making them DFSG
  non-FREE, Debian Arduino package itself is stack in very old version.  It's
  not as bad as it looks.

  For the use of arduino-mk aimed for the classic 8-bit AVR MCU platform, it is
  fairly usable shape since we use the fairly new version of gcc-avr,
  binutils-avr, avr-libc, and avrdude packages created from the latest original
  upstream.

Also arduino-mk-vars.md should be  accessible there.
(This can't be compressed since it is used by make as message)

If user configure system as described in README.md in ~/.bashrc,
maybe issues such as https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=856870
may be avoided if upstream code uses  variables `AVRDUDE` and
`AVRDUDE_CONF`.

Also this is the reason I dudn't replace hardcoded ../../ with
/usr/share/arduino since we have $ARDMK_DIR set from ~/.bashec.

I attach my patch.  I hope this helps.

FYI: New upstream version is available: v1.6.0

| @sudar sudar released this on Jul 17, 2017 · 105 commits to master since this release
|
| This release adds support for Robotis OpenCM boards (contributed by @fuzzyTew)
|
| In addition to that the following changes were also made
|
| Fix: Allowed for SparkFun's weird usb pid/vid submenu shenanigans (issue #499). (https://github.com/sej7278)
| Fix: Do not include the Arduino header when calling generate_assembly on .cpp files. (https://github.com/Batchyx)
| Fix: Auto-detect F_CPU on Teensy from boards.txt (https://github.com/DaWelter)
| Fix: params typo in PuTTY section (issue #487) (https://github.com/ericdand)
| Fix: Fixed sed expression to properly format show_submenu (issue #488) (https://github.com/cbosdo)
| Tweak: Removed tilde from documentation (issue #497). (https://github.com/sej7278)
| New: Add support for good old cu as monitor command (issue #492) (https://github.com/mwm)
| New: Add a documentation how to setup Makefile for 3rd party boards (issue #499). (https://github.com/MilanV)

Osamu
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-Enhance-packaging.patch
Type: text/x-diff
Size: 7644 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/debian-science-maintainers/attachments/20200412/53350c51/attachment-0002.patch>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0002-Use-ARDMK_DIR-in-examples.patch
Type: text/x-diff
Size: 6465 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/debian-science-maintainers/attachments/20200412/53350c51/attachment-0003.patch>