notmuch/devel/nmbug, branch 0.22

nmbug: ignore # comments

2016-03-28T12:29:42Z

Lines starting with # have always (for a long time, anyway) been ignored by notmuch-restore, but have not been generated by notmuch-dump previously. In order to make nmbug robust against such output, ignore comment lines.

notmuch-report: Add notmuch-report(1) and notmuch-report.json(5) man pages

2016-03-24T10:41:24Z

To describe the script and config file format, so folks don't have to dig through NEWS or the script's source to get that information. The Makefile and conf.py are excerpted from the main doc/ directory with minor simplifications and adjustments. The devel/nmbug/ scripts are largely independent of notmuch, and separating the docs here allows packagers to easily build the docs and install the scripts in a separate package, without complicating notmuch's core build/install process.

notmuch-report.json: Rename from status-config.json

2016-03-24T10:41:06Z

status-config.json wasn't obviously associated with the old nmubg-status, now notmuch-report. The new name is ${CONFIGURED_SCRIPT}.json, so the association should be clear.

notmuch-report: Rename from nmbug-status

2016-03-24T10:40:39Z

This script generates reports based on notmuch queries, and doesn't really have anything to do with nmbug, except for sharing the NMBGIT environment variable.

status-config.json: Remove parens from query entry

2016-03-24T10:39:57Z

These are now added by nmbug-status.

nmbug-status: Wrap query phrases in parentheses when and-ing together

2016-03-24T10:39:42Z

For example: "query": ["tag:a", "tag:b or tag:c"] is now converted to: ( tag:a ) and ( tag:b or tag:c ) instead of the old: tag:a and tag:b or tag:c This helps us avoid confusion due to Xapian's higher-precedence AND [1], where the old query would be interpreted as: ( tag:a and tag:b ) or tag:c [1]: http://xapian.org/docs/queryparser.html

nmbug-status: Add meta.message-url config setting

2016-03-24T10:39:25Z

So you can link to archives other than Gmane. For example, I'm doing this in [1]. [1]: https://github.com/wking/nmbug-oci

nmbug-status: Fix unbalanced
tags in default header/footer

2016-01-13T14:29:14Z

These were broken by b70386a4 (Move the generated date from the top of the page to the footer, 2014-05-31), which moved 'Generated ...' to the footer with the opening tag, but didn't replace the blurb opening tag or add a closing tag after 'Generated ...'.

nmbug-status: Style headers with smaller fonts

2016-01-13T14:28:49Z

We only use h1 through h3, and David prefers smaller headers [1], so shift over to the font sizes usually used for h2 through h4 [2,3,4]. I haven't bothered with the W3C's default margins, since a bit of extra whitespace doesn't seem like a big deal. [1]: id:87k2nl8r0k.fsf@zancas.localnet http://article.gmane.org/gmane.mail.notmuch.general/21595 [2]: http://www.w3.org/TR/html-markup/h2.html [3]: http://www.w3.org/TR/html-markup/h3.html [4]: http://www.w3.org/TR/html-markup/h4.html

nmbug-status: Adjust headers to start with h1

2016-01-13T14:28:38Z

We've been leading off with h2s since 3e5fb88f (contrib/nmbug: add nmbug-status script, 2012-07-07), but the semantically-correct headers are:

{title}

...

Views

...

View 1

...

View 2

... We can always add additional CSS if the default h1 formatting is too intense.