source/proj/mutt-nntp-debian/index.rst

   1
   2 =======================================
   3 Debian package for Mutt with NNTP patch
   4 =======================================
   5
   6
   7 Introduction
   8 ============
   9
  10 Did you ever wanted Mutt_ with NNTP_ support packed up for your Debian_ (or
  11 Debian_\ -ish) box, but you are too lazy to do it yourself? Did you even tried
  12 to report a bug__ so the patch can be applied to the `official Debian
  13 package`__ but the maintainers told you they wont do it?
  14
  15 __ http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=488868
  16 __ http://packages.debian.org/sid/mutt
  17
  18 If so, this is a great day for you, because I did it and I'm giving it away
  19 with no charge in this one time only opportunity!!! =P
  20
  21 Seriously, I can understand why the maintainers don't want to support it
  22 officially, it a big patch and can be some work to fold it in. So I did it
  23 myself, and it turned out it's wasn't that bad.
  24
  25 I adjusted the patch__ maintained by Vsevolod Volkov to work on top of all the
  26 other patches included in the mutt-patched__ Debian_ package (the only
  27 conflicting patch is the `sidebar patch`__ and some files that doesn't exist
  28 because the patch should be applied after autotools files are generated and
  29 Debian_ apply the patches *before* that) and built a new package,
  30 ``mutt-nntp`` using the latest (at the time of writing) Debian_ source.
  31
  32 __ http://mutt.org.ua/download/mutt-1.5.21/
  33 __ http://packages.debian.org/sid/mutt-patched
  34 __ http://www.lunar-linux.org/index.php?page=mutt-sidebar
  35
  36
  37 Compiling/Installing
  38 ====================
  39
  40 You can find the latest source and the binary packages for Ubuntu_
  41 12.04 Precise (i386 and amd64) here__. You can find there the modified NNTP_
  42 patch too.
  43
  44 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/latest/
  45
  46 If you have other Ubuntu_, Debian_, other Debian_ based distribution or
  47 another architecture, you can compile the binary package by downloading the
  48 files ``mutt_x.y.z-NnntpM.diff.gz`` and ``mutt_x.y.z-NnntpM.dsc`` [1]_ from
  49 here__, and ``mutt_x.y.z.orig.tar.gz`` from the Debian_ `mutt source
  50 package`__ page (see the links at the right), then run (where ``x.y.z`` is the
  51 Mutt_ version, ``N`` is the Debian_ package revision, ``M`` is my package
  52 revision and ``ARCH`` is your architecture)::
  53
  54    ver=1.5.21
  55    deb_ver=$ver-5nntp2
  56    url=https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/latest
  57    wget $url/mutt_$deb_ver.dsc $url/mutt_$deb_ver.diff.gz \
  58       http://ftp.de.debian.org/debian/pool/main/m/mutt/mutt_$ver.orig.tar.gz
  59    sudo apt-get build-dep mutt
  60    dpkg-source -x mutt_$deb_ver.dsc
  61    cd mutt-$ver
  62    dpkg-buildpackage -rfakeroot
  63    # install any missing packages reported by dpkg-buildpackage and try again
  64    cd ..
  65    sudo dpkg -i mutt-nntp_${deb_ver}_*.deb
  66
  67 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/latest/
  68 __ http://packages.debian.org/sid/mutt
  69
  70 Now you can enjoy reading your favourite newsgroups and your favourite mailing
  71 lists via Gmane_ with Mutt_ without leaving the beauty of your packaging
  72 system.  No need to thank me, I'm glad to be helpful (but if you want to make
  73 a donation, just let me know ;).
  74
  75 .. note::
  76
  77    You should always install the same ``mutt`` version as the one the
  78    ``mutt-nntp`` is based on (i.e. the version number without the ``nntpX``
  79    suffix, for example if mutt-nntp version is 1.5.21-5nntp1, your mutt
  80    version should be 1.5.21-5 or 1.5.21-5ubuntu2). A newer version will
  81    satisfy the dependency too but it is not guaranteed to work (even when it
  82    probably will, specially if the upstream version is the same). You could
  83    also install the generated/provided mutt package, but that might be
  84    problematic when upgrading your distribution.
  85
  86
  87 News
  88 ====
  89
  90 If you want to keep up with the updates, I usually post new releases in `my
  91 blog`__. You can subscribe__ to the `mutt tag`__ feed if you want to receive
  92 any news (or random thoughts related to Mutt_) or to all `mutt + nntp + release
  93 tags`__ feed if you only want to be notified of `new releases`__.
  94
  95 __ /blog/
  96 __ /blog/blog.cgi/atom?tag=mutt
  97 __ /blog/blog/tag/mutt
  98 __ /blog/?tag=mutt&tag=nntp&tag=release
  99 __ /blog/blog.cgi/atom?tag=mutt&tag=nntp&tag=release
 100
 101
 102 Repository
 103 ===========
 104
 105 You can find a clone from the `official Mutt Debian Package git repository`__,
 106 with my extra changes to add and enable the NNTP patch in `my git
 107 repository`__ (you probably want to see the `nntp branch`__). To build the
 108 latest package from the repository, you can just do::
 109
 110    git clone https://git.llucax.com/r/software/mutt-debian.git
 111    cd mutt-debian
 112    git checkout nntp # or a particular "nntp/*" tag
 113    dpkg-buildpackage -rfakeroot -i.git -I.git
 114
 115 __ git://git.debian.org/git/pkg-mutt/mutt.git
 116 __ https://git.llucax.com/w/software/mutt-debian.git
 117 __ https://git.llucax.com/w/software/mutt-debian.git/shortlog/refs/heads/nntp
 118
 119
 120 Release History
 121 ===============
 122
 123 2012-07-05
 124    Version `1.5.21-5nntp3`__ released (`release notes`__).
 125
 126 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.21-5nntp3/
 127 __ /blog/blog/post/08e2764c
 128
 129 2012-07-04
 130    Version `1.5.21-5nntp2`__ released (`release notes`__).
 131
 132 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.21-5nntp2/
 133 __ /blog/blog/post/7f45506f
 134
 135 2011-05-24
 136    Version `1.5.21-5nntp1`__ released (`release notes`__).
 137
 138 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.21-5nntp1/
 139 __ /blog/blog/post/5bc9cbdd
 140
 141 2011-04-12
 142    Version `1.5.21-4nntp1`__ released (`release notes`__).
 143
 144 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.21-4nntp1/
 145 __ /blog/blog/post/17f1c4e4
 146
 147 2011-01-19
 148    Version `1.5.21-2nntp1`__ released (`release notes`__).
 149
 150 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.21-2nntp1/
 151 __ /blog/blog/post/-507b5231
 152
 153 2010-06-06
 154    Version `1.5.20-8luca1`__ released (`release notes`__).
 155
 156 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.20-8luca1/
 157 __ /blog/blog/post/1e329497
 158
 159 2010-02-22
 160    Version `1.5.20-7luca1`__ released.
 161
 162 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.20-7luca1/
 163
 164 2009-10-14
 165    Version `1.5.20-4luca1`__ released.
 166
 167 __ https://llucax.com.nyud.net/proj/mutt-nntp-debian/files/1.5.20-4luca1/
 168
 169
 170 .. _Mutt: http://www.mutt.org/
 171 .. _NNTP: http://en.wikipedia.org/wiki/Network_News_Transfer_Protocol
 172 .. _Debian: http://www.debian.org/
 173 .. _Ubuntu: http://www.ubuntu.com/
 174 .. _Gmane: http://gmane.org/
 175
 176
 177 .. [1] Please note that In previous versiones I used the naming scheme
 178        ``NlucaM`` instead of ``NnntpM``.
 179
 180 .. vim: set et sw=3 sts=3 tw=78 :