shedskin-packaging

README.txt

92:83bef89a5c11
2019-07-01 Paul Boddie Fixed upstream repository locations in packaging. Updated packaging metadata and practices
     1 Shed Skin Packaging for Debian
     2 ==============================
     3 
     4 Firstly, download the latest upstream source release. Although it might be
     5 desirable to get the latest code from the repository, Debian will eventually
     6 be using the actual source releases specified in the watch file. Here's how
     7 to download using the watch file:
     8 
     9 uscan --force-download --destdir=..
    10 
    11 The --force-download option is required when --download indicates that the
    12 package is up-to-date. This will make the necessary symbolic link for the
    13 shedskin_0.9.4.orig.tar.gz archive that must be present when building the
    14 package.
    15 
    16 Unpack the archive as follows:
    17 
    18 cd ..
    19 tar zxf shedskin-0.9.4.tgz
    20 
    21 Using the Upstream Repository
    22 -----------------------------
    23 
    24 One can also try and persuade GitHub to yield a file by visiting the
    25 following address:
    26 
    27 https://github.com/shedskin/shedskin/releases/download/v0.9.4/shedskin-0.9.4.tgz
    28 
    29 The idea is then to combine the snapshot with this packaging infrastructure.
    30 
    31 Unpack the archive:
    32 
    33 cd ..
    34 tar zxf shedskin-mainline-0.9.4.tar.gz
    35 mv shedskin-mainline shedskin_0.9.4
    36 
    37 Make a copy of the archive for Debian non-native packaging purposes:
    38 
    39 tar zcf shedskin_0.9.4.orig.tar.gz shedskin_0.9.4
    40 
    41 Building the Package
    42 --------------------
    43 
    44 Move into the sources directory:
    45 
    46 cd shedskin_0.9.4
    47 
    48 Or:
    49 
    50 cd shedskin-0.9.4
    51 
    52 Now, copy the debian directory from this directory into the export directory:
    53 
    54 cp -R ../shedskin-packaging/debian/ .
    55 
    56 There are patches in debian/patches which should be applied when pbuilder is
    57 run. These should not need to be applied manually.
    58 
    59 Using pbuilder, try and build the package (this example is using my signing
    60 key):
    61 
    62 pdebuild --auto-debsign --debsign-k 9F308B3C
    63 
    64 Add extra options for the first packaging of a new release:
    65 
    66 pdebuild --auto-debsign --debsign-k 9F308B3C --debbuildopts -sa
    67 
    68 This makes sure that the original source archive is produced and referenced in
    69 the changes file (used by dput when uploading a package to a Debian package
    70 repository/archive).
    71 
    72 For a different distribution:
    73 
    74 pdebuild --auto-debsign --debsign-k 9F308B3C --debbuildopts -sa \
    75     -- --distribution squeeze
    76 
    77 Some files will appear in /var/cache/pbuilder/result/ (such as the binary
    78 package files), whereas others will appear in the parent directory.
    79 
    80 Uploading the Package
    81 ---------------------
    82 
    83 With an appropriate .dput.cf file, the following command can be used to upload
    84 package files to the Debian Mentors service:
    85 
    86 dput debexpo /var/cache/pbuilder/result/shedskin_0.9.4-1_i386.changes
    87 
    88 Maintenance Notes
    89 -----------------
    90 
    91 When packaging a new release, update the release history below along with the
    92 debian/changelog file:
    93 
    94 debchange -v 0.9.4-1 -D unstable
    95 
    96 The "-n" part of the version number causes a non-native Debian package to be
    97 produced.
    98 
    99 Shed Skin Release History
   100 =========================
   101 
   102 Release     Git Changeset
   103 -------     -------------
   104 0.9.4       b54fa10d27f69e13b90d1f4c68713fa466571b18
   105 0.9.3       8bd94f658bd4a82e04a6dca7d8cc8b19302c8006
   106 0.9.2       bdd827253d37650ad6986dd2fd16d28058fd7a81
   107 0.9.1       5834046e821b8f2e6526815084220260e3db6420
   108 0.9-1       a3f8f54590d4099c4ec66669296d5169a7f652ff
   109 0.9         31b8214b451d87fae5ec7194a7b4430daa3f49ce
   110 0.8-1       d7cf784f5e12952a5630f6b78b3155995c825a38
   111 0.8         7f7388c3dfab40dc1776cfd6334dd41bdaa62beb
   112 0.7.1       d35a07c99c29618e0dad6d31a3cf01599c0d758a
   113 0.7         8fc85b49137a79ca9acc5e63fa9fdfbb50751907
   114 0.6         1e6708d49e9092a7949ed74b7e339c5245bb6661
   115 
   116 Release     Subversion Revision
   117 -------     -------------------
   118 0.5         1507
   119 0.4         1363
   120 0.3-2       1165
   121 0.3-1       1165