/usr/share/doc/alot-doc/html/faq.html is in alot-doc 0.3.5-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>5. FAQ — Alot User Manual</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '0.3.5',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="Alot User Manual" href="index.html" />
<link rel="next" title="Manpage" href="manpage.html" />
<link rel="prev" title="4.8. Crypto" href="api/crypto.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="manpage.html" title="Manpage"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="api/crypto.html" title="4.8. Crypto"
accesskey="P">previous</a> |</li>
<li><a href="index.html">Alot User Manual</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="faq">
<h1>5. FAQ<a class="headerlink" href="#faq" title="Permalink to this headline">ΒΆ</a></h1>
<ol class="arabic">
<li><p class="first">Why reinvent the wheel? Why not extend an existing MUA to work nicely with notmuch?</p>
<blockquote>
<div><p>alot makes use of existing solutions where possible: It does not fetch, send or edit
mails; it lets <a class="reference external" href="http://notmuchmail.org">notmuch</a> handle your mailindex and uses a
<a class="reference external" href="http://excess.org/urwid/">toolkit</a> to render its display. You are responsible for
<a class="reference external" href="http://notmuchmail.org/initial_tagging/">automatic initial tagging</a>.</p>
<p>This said, there are few CLI MUAs that could be easily and naturally adapted to using notmuch.
Rebuilding an interface from scratch using <a class="reference external" href="http://www.python.org/">friendly and extensible tools</a>
seemed easier and more promising.</p>
<p>Update: see <a class="reference external" href="https://github.com/karelzak/mutt-kz">mutt-kz</a> for a fork of mutt..</p>
</div></blockquote>
</li>
<li><p class="first">What’s with the snotty name?</p>
<blockquote>
<div><p>It’s not meant to be presumptuous. I like the dichotomy; I like to picture the look on
someone’s face who reads the <em class="mailheader">User-Agent</em> header “notmuch/alot”; I like cookies; I like
<a class="reference external" href="http://hyperboleandahalf.blogspot.com/2010/04/alot-is-better-than-you-at-everything.html">this comic strip</a>.</p>
</div></blockquote>
</li>
<li><p class="first">I want feature X!</p>
<blockquote>
<div><p>Me too! Feel free to file a new or comment on existing
<a class="reference external" href="https://github.com/pazz/alot/issues">issues</a> if you don’t want/have the time/know how to
implement it yourself. Be verbose as to how it should look or work when it’s finished and
give it some thought how you think we should implement it. We’ll discuss it from there.</p>
</div></blockquote>
</li>
<li><p class="first">Why are the default key bindings so counter-intuitive?</p>
<blockquote>
<div><p>Be aware that the bindings for all modes are <a class="reference internal" href="configuration/key_bindings.html#config-key-bindings"><em>fully configurable</em></a>.
That said, I choose the bindings to be natural for me. I use <a class="reference external" href="http://www.vim.org">vim</a> and
<a class="reference external" href="http://dactyl.sourceforge.net/pentadactyl/">pentadactyl</a> a lot. However, I’d be
interested in discussing the defaults. If you think your bindings are more intuitive or
better suited as defaults for some reason, don’t hesitate to send me your config. The same
holds for the theme settings you use. Tell me. Let’s improve the defaults.</p>
</div></blockquote>
</li>
<li><p class="first">Help! I don’t see <cite>text/html</cite> content!</p>
<blockquote>
<div><p>better: How do I properly set up an inline renderer for <cite>text/html</cite>?
Try <a class="reference external" href="http://w3m.sourceforge.net/">w3m</a> and put the following into your
<tt class="file docutils literal"><span class="pre">~/.mailcap</span></tt>:</p>
<div class="highlight-python"><pre>text/html; w3m -dump -o document_charset=%{charset} '%s'; nametemplate=%s.html; copiousoutput</pre>
</div>
<p>Most <a class="reference external" href="http://en.wikipedia.org/wiki/Text-based_web_browser">text based browsers</a> have
a dump mode that can be used here.</p>
</div></blockquote>
</li>
<li><p class="first">Why are you $THIS not $THAT way?</p>
<blockquote>
<div><p>Lazyness and Ignorance: In most cases I simply did not or still don’t know a better solution.
I try to outsource as much as I can to well established libraries and be it only to avoid
having to read rfc’s. But there are lots
of tasks I implemented myself, possibly overlooking a ready made and available solution.
Twisted is such a feature-rich but gray area in my mind for example.
If you think you know how to improve the current implementation let me know!</p>
<p>The few exceptions to above stated rule are the following:</p>
<ul class="simple">
<li>CLI option parsing is done using twisted.usage.Options, and not (as e.g. in-app command parsing)
via argparse. The reason is that argparse does not yet offer optional subcommands.</li>
<li>The modules cmd and cmd2, that handle all sorts of convenience around command objects
hate urwid: They are painfully strongly coupled to user in/output via stdin and out.</li>
<li><cite>notmuch reply</cite> is not used to format reply messages because 1. it is not offered by
notmuch’s library but is a feature of the CLI. This means we would have to call the notmuch
binary, something that is avoided where possible. 2. As there is no <cite>notmuch forward</cite> equivalent,
this (very similar) functionality would have to be re-implemented anyway.</li>
</ul>
</div></blockquote>
</li>
</ol>
<ol class="arabic" id="faq-7" start="7">
<li><p class="first">Why doesn’t alot run on python3?</p>
<p>Because it builds on libraries that don’t (yet):</p>
<blockquote>
<div><ul class="simple">
<li><a class="reference external" href="http://www.voidspace.org.uk/python/weblog/arch_d7_2010_12_11.shtml">configobj</a></li>
<li><a class="reference external" href="http://twistedmatrix.com/trac/milestone/Python-3.x">twisted</a></li>
</ul>
</div></blockquote>
<p>Alot itself can be converted to py3k syntax automatically using
<a class="reference external" href="http://docs.python.org/2/library/2to3.html">2to3</a> and I will push those changes as soon
as the libs are ready.</p>
</li>
</ol>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="api/crypto.html"
title="previous chapter">4.8. Crypto</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="manpage.html"
title="next chapter">Manpage</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/faq.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="manpage.html" title="Manpage"
>next</a> |</li>
<li class="right" >
<a href="api/crypto.html" title="4.8. Crypto"
>previous</a> |</li>
<li><a href="index.html">Alot User Manual</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2012, Patrick Totzke.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
|