=== Overview ===
A wiki page to coordinate the Debian packaging of pat, a Winlink client with basic messaging capabilities.

  ''Constructive feedback edits are welcome on this page.''

This is a joint effort circa 2021 to close ITP [[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=877030|#877030]] by [[Taowa]] and [[donfede]], building on past work by [[TheAnarcat]].


Salsa repo
: https://salsa.debian.org/debian-hamradio-team/pat

Taowa's pat-work project on Salsa
: https://salsa.debian.org/taowa/pat-work



=== Items to review ===
Items to review and decide upon:
 * (2021-03) ?get pat to build without bindata_assetfs.go [2021-04-03 FG is this necessary to remove? it's "generated by go-bindata" from files in the res/ subdir here ; seems like it should be OK]

Items to review, though no changes required:
 * (2021-02 FG) d/copyright different license on res/ files, and d/missing-sources


=== TODO: ===
 * (2021-07, 2021-11) pat 0.11  (with forms support!) and/or 0.12 (with XDG Base Directory support)eased, needs to be packaged -- https://github.com/la5nta/pat
   * res/ subdir is no longer used since upstream [[https://github.com/la5nta/pat/commit/37f73134d61e4dc9e1f9838a2caa802137aa323e|37f73134]] and pat 0.12
 * (2021-04) add README.Debian with introductory steps (e.g. from personal 'Winlink - Pat - work notes')
 * (2021-02) what to do about systemd service {{{pat@.service}}}
   * a service must be run per user [FG thinks]; should debconf be used to query and configure user setup? eval after use
 * (2021-02) d/control Is WINWOR/WINMOR still supported, or should it be removed?
 * (2021-02) review and document dependency mismatches 


=== Completed Items ===
 * (2021-04 #debian-hams review) improve licenses on 2x file sets
   * ./res/bootstrap-tokenfield.min.css: {{{{
 Copyright 2013-2014 Sliptree and other contributors; Licensed MIT
 The following licenses covers all third party software used by the web GUI
 plus a whole chapter with more (C)
 only some (C) holders are documented in d/copyright for that
}}}}
   * ./res/js/jquery.min.js: * Copyright 2011-2014 Twitter, Inc.

 * (2021-03; 2021-04-24) pristine-tar # [[https://go-team.pages.debian.net/workflow-changes.html#wf-2017-11-pristine-tar | discouraged]] with go-team; what is debian-hams pref?
   * pristine-tar is not required for debian-hams; passing on this branch for now; it can be added later if required

 * (2021-02; 2021-04-01) lintian errors with osx
   * {{{E: pat source: source-includes-file-in-files-excluded osx/Pat-Info.rtfd/TXT.rtf}}}
   * left osx/ subdir, after reviewing [[https://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#repackaged-upstream-source  | Deb Pol 6.7.8.2. Repackaged upstream source]] closer, bullet 3 suggests leaving "MS-DOS files"; pat/osx/ subdir is by the same author and clearly licensed MIT
   * other ideas included
     * ?exclude osx from our orig.tar.gz "dfsg" [donfede unclear how to do this; find another sample package]
  
 * (2021-03; 2021-03-30) CI - updated d/gitlab-ci.yml to match #debian-hams
   * CI required enabling; script run by Myon 
   * (2021-03-29) droped golang specific CI; most debian-hams CI is the same, e.g. https://salsa.debian.org/debian-hamradio-team/hamradio-files/-/blob/master/debian/gitlab-ci.yml

 * (2021-02; 2021-03-28) Where/how to store the upstream ''debian/changelog''? (which is really pat changelog, rather than Debian packaging specific)
   * stored in /usr/share/doc/changelog.gz - https://www.debian.org/doc/debian-policy/ch-docs.html#changelog-files-and-release-notes
 * (2021-03-28) added README.Debian noting patched out ptc-go

 * (2021-02; 2021-03-28) Evaluated d/control upstream Recommends ; relocated to Suggests given most will not need all transports and utils 
   * {{{Recommends: libhamlib-utils (>= 1.2), ax25-tools, gpsd (>= 2.90)}}}



=== Notes: ===
 * Upstream supports {{{Architecture: amd64 i386 armhf}}}; trying to support all Debian architectures
   * could test build on porter boxes; wait for error reports for now
 * podcast "LHS Episode #428: Pat and Winlink Deep Dive" by Russ (K5TUX) circa 2021-09 -- https://lhspodcast.info/2021/09/lhs-episode-428-pat-and-winlink-deep-dive/