rabbit-slide-kenhys-tokyodebian-repack-howto-202211 2022.11.19.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2d9219bd98e15bb409710d9efcaaa9171aa5c1a47631f3fb5715178a77991240
+  data.tar.gz: 98790f2bff9ea9cc63bc436e895c46bc690cbdedb75d8d42e550a99ed201f998
+SHA512:
+  metadata.gz: e58ec6cd36e0cb098cb983b209cd97fb279c6048195a00297664766a6b0d0788a66c64bdcf92e5e98da7697d5de2e155a7b482cb01a22be6c67adb8ce2489845
+  data.tar.gz: e74f1acc5a47dc9db6f675bcefa2a905f33251fe501c62c11d98c1da53a332340d16a214f6ed5b78fb8eaeda607823258134c8ab6151bc324d9ba31de7116145

data/.rabbit

@@ -0,0 +1 @@
+--size=1024,768 tokyodebian-repack-howto.md

data/README.md

@@ -0,0 +1,14 @@
+# Tokyo Debian Repack Howto 202211
+
+## How to show
+
+  % rabbit
+
+## How to install
+
+  % gem install rabbit-slide-kenhys-tokyodebian-repack-howto-202211
+
+## How to create PDF
+
+  % rake pdf
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  # spec.add_runtime_dependency("rabbit-theme-YOUR-THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,26 @@
+---
+id: tokyodebian-repack-howto-202211
+base_name: tokyodebian-repack-howto
+tags:
+- rabbit
+- debian
+- repack
+- files-excluded
+presentation_date: 2022-11-19
+presentation_start_time:
+presentation_end_time:
+slideshare_id:
+version: 2022.11.19.1
+licenses:
+- CC-BY-SA-4.0
+slideshare_id: kenhys
+speaker_deck_id:
+vimeo_id:
+youtube_id:
+author:
+  markup_language: :md
+  name: Kentaro Hayashi
+  email: kenhys@gmail.com
+  rubygems_user: kenhys
+  slideshare_user:
+  speaker_deck_user:

data/theme.rb

@@ -0,0 +1,5 @@
+@default_font = "Ubuntu"
+@monospace_font = "Ubuntu"
+include_theme("debian")
+#@slide_show_span = 1300
+@slide_show_loop = true

data/tokyodebian-repack-howto.md

@@ -0,0 +1,175 @@
+# Debianパッケージング\\nrepack編
+
+subtitle
+:  そのソフトウェア、そのまま配布して大丈夫だっけ
+
+author
+:  Kentaro Hayashi
+
+institution
+:  ClearCode Inc.
+
+content-source
+:  2022年11月 東京エリア・関西合同Debian勉強会
+
+allotted-time
+:  20m
+
+theme
+:  .
+
+# スライドはRabbit Slide Showにて公開済みです
+
+* Debianパッケージング repack編
+  * <https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-repack-howto-202211/>
+
+# 本日の内容
+
+* 自由なソフトウェア・不自由なソフトウェア
+* バージョンによる区別のしかた(+dfsg or +ds)
+* 再パッケージングどうやる問題
+
+# Debian(たまに)あるある
+
+* 使いたいソフトウェアはまだaptでインストール不可
+* そうだ、パッケージングしよう!!
+  * 自由なソフトウェアである
+    * 今回の話題の対象外
+  * (Debian的には) **不自由なソフトウェアである** 😢
+
+# 自由なソフトウェアでない
+
+* いろんなパターンがある
+  * 自由でないのが主要構成部分か
+    * さすがにどうしようもないので諦める 😭
+  * 自由でないのは一部である
+    * 例: rapidjson (JSONライセンス)
+      * <https://wiki.debian.org/qa.debian.org/jsonevil>
+    * バンドルしているソフトウェアが自由でない
+
+# 自由でないのは一部である
+
+* **問題のある部分を除去**してmainとして配布する
+
+# 再配布できるようにしたソフトウェアの見分け方
+
+* パッケージに+dfsg or +dsがついている
+* 参考: lintianに新規ルールを追加する方法
+  <https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-lintian-howto-202112/>
+
+# +dfsg と +ds の区別
+
+* +dfsg
+  * DFSGに適合しないものを除去した
+  * 例: rapidjson-dev 1.1.0+dfsg2-7.1
+* +ds
+  * DFSGとの適合云々とは別の理由で除去した
+  * 例: バンドルしているソフトウェアを削除
+
+# 再パッケージングのしかた
+
+* 必要なもの
+  * (パッケージ名)_(バージョン)+dfsg.orig.tar.gz
+  * (パッケージ名)_(バージョン)+ds.orig.tar.gz
+* +dfsgや+dsなアーカイブはどうつくる？
+
+# repackして除去
+
+* debian/copyrightにFiles-Excluded:を書く
+* debian/watchでrepackルールを記述する
+  * debian/rulesでget-orig-sourceルールでrepackするのは古いやりかた
+
+# Files-Excluded:について
+
+* Files-Excluded:の仕様に関するバグ
+  * <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=685506>
+
+* Files-Excluded:のドキュメント化に関するバグ
+  * <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1000771>
+
+* <https://wiki.debian.org/UscanEnhancements>
+
+# debian/copyrightにどう書くか
+
+```
+Files-Excluded:
+ (削除対象のファイル・ディレクトリにマッチするパターンを列挙)
+Comment:
+ (削除対象のファイル・ディレクトリに関する説明)
+```
+
+
+# debian/copyrightの例
+
+* groonga-12.0.9+dfsg-1
+
+```
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: Groonga
+Upstream-Contact: Groonga Project <packages@groonga.org>
+Source: http://packages.groonga.org/source/groonga/
+Files-Excluded:
+ doc/locale/en/html/*.html
+ doc/locale/en/html/_static
+ doc/locale/en/html/searchindex.js
+ doc/locale/ja/html/*.html
+ doc/locale/ja/html/searchindex.js
+ doc/locale/ja/html/_static
+ vendor/rapidjson-1.1.0
+Comment: The following files were removed because
+ doc/locale/en/html/*.html: regenerated during building package
+ ...
+
+Files: *
+```
+
+# Files-Excluded:の注意
+
+* 必ずヘッダパラグラフに書くこと
+  * 以下のように改行入れると機能しなくてはまる
+
+```
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: Groonga
+Upstream-Contact: Groonga Project <packages@groonga.org>
+Source: http://packages.groonga.org/source/groonga/
+
+Files-Excluded:
+ doc/locale/en/html/*.html
+ ...
+ vendor/rapidjson-1.1.0
+Comment: The following files were removed because
+ doc/locale/en/html/*.html: regenerated during building package
+ ...
+
+Files: *
+```
+
+# debian/watchの例
+
+* repackとrepacksuffix=+dfsgを指定する
+
+```
+version=4
+opts=\
+  repack,\
+  dversionmangle=auto,\
+  repacksuffix=+dfsg,\
+  pgpsigurlmangle=s/$/.asc/ \
+  https://packages.groonga.org/source/@PACKAGE@/@PACKAGE@-@ANY_VERSION@@ARCHIVE_EXT@
+```
+
+# パッケージングの流れ
+
+* gbp import-orig --uscan
+  * +dfsgなアーカイブが作成される
+  * upstream/(バージョン)+dfsgタグ付与
+  * pristine-tarブランチに`(パッケージ)_(バージョン)+dfsg.orig.tar.xz.(delta|id)`が作成される
+* gbp dchでdebian/changelogを更新 & もろもろ作業
+* debsign & dputでアップロード
+
+# さいごに
+
+* 部分的に不自由なソフトウェアを再配布可能にするには
+  * d/copyrightでFiles-Excluded:を使え
+  * d/watchでrepack,repacksuffixを記述

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kenhys-tokyodebian-repack-howto-202211
+version: !ruby/object:Gem::Version
+  version: 2022.11.19.1
+platform: ruby
+authors:
+- Kentaro Hayashi
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-11-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: ''
+email:
+- kenhys@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- pdf/tokyodebian-repack-howto-202211-tokyodebian-repack-howto.pdf
+- theme.rb
+- tokyodebian-repack-howto.md
+homepage: https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-repack-howto-202211/
+licenses:
+- CC-BY-SA-4.0
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Tokyo Debian Repack Howto 202211
+test_files: []