]> sipb.mit.edu Git - wiki.git/blobdiff - doc/debian-hacking.mdwn
Convert most http: links to https:
[wiki.git] / doc / debian-hacking.mdwn
index 70c84d54c313ca7eb5c281cec836666b26403b7b..aea672c7b2a77be9c57be95d921d1a33ff1c3943 100644 (file)
@@ -1,16 +1,16 @@
 Debian and Ubuntu packages make it easy to hack on software that's
-packaged and try out your changes. These instructions assume that you
-have an understanding of how Debian packaging works, although all you
-really need to know is that each file in the distribution comes from a
-<i>package</i>, which contains the compiled form of a <i>source
-package</i>.
+packaged and try out your changes, within the framework of the packaging
+system. These instructions assume that you have an understanding of how
+Debian packaging works, although all you really need to know is that
+each file in the distribution comes from a <i>package</i>, which
+contains the compiled form of a <i>source package</i>.
 
 1. Figure out what package the software is from. Usually it's named
 approximately the same as the software itself, e.g., `barnowl` or `gdb`
 or `libwww-mechanize-ruby`. You can use the command `dpkg -S` to figure
 out where a file comes from, or search on
-[packages.debian.org](http://packages.debian.org/) or
-[packages.ubuntu.com](http://packages.ubuntu.com/).
+[packages.debian.org](https://packages.debian.org/) or
+[packages.ubuntu.com](https://packages.ubuntu.com/).
 
 2. Type `apt-get source` followed by the package name. This will
 download the source package.
@@ -18,11 +18,12 @@ download the source package.
 3. cd into the directory that was just created and make whatever changes
 you want.
 
-4. Run the command `dch -i`, which edits the debian/changelog file. Add
-something like "~edited1" to the end of the verson; a version with a
-tilde in it comes before a version without. This means Debian will let
-you install your edited version over the current version, but also
-permit the next offical release to supersede your hacked version.
+4. Run the command `dch -i`, which edits the debian/changelog file and
+increments the version. Add something like "~edited1" to the end of the
+version, because a version with a tilde in it is considered older than a
+version without. This means Debian will let you install your edited
+version over the current version, but also permit the next offical
+release to supersede your hacked version.
 
 5. Run the command `debuild` to compile the software and build a
 package.
@@ -32,5 +33,5 @@ package.
 
 You can find more information about writing Debian or Ubuntu packages in
 [Ubuntu's packaging guide](https://wiki.ubuntu.com/PackagingGuide) or
-SIPB's [packaging tutorial](http://debathena.mit.edu/packaging/) on the
+SIPB's [packaging tutorial](https://debathena.mit.edu/packaging/) on the
 Debathena website.