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