[PATCH v2 0/2] doxygen generated library reference man page

2014-01-05 Thread David Bremner
Jani Nikula writes: > v2 of id:cover.1385826040.git.jani at nikula.org > > Rebase, minor tweaks since v1; the TODO in the referenced message above > is still valid. I suggest we get this merged as a starting point, so we > can collaborate on including a nice API man page (and possibly a HTML >

[PATCH 3/3] debian: install info files

2014-01-05 Thread David Bremner
From: David Bremner It seems dh_installinfo doesn't understand wildcards or look in debian/tmp --- debian/notmuch-emacs.info | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 debian/notmuch-emacs.info diff --git a/debian/notmuch-emacs.info

[PATCH 2/3] man: partial conversion to pod.

2014-01-05 Thread David Bremner
From: David Bremner This allows generation of man page and info document from the same source. It is also a bit more friendly to edit for most people. The conversion was done as follows: % groff -e -mandoc -Tascii -rHY=0 $* | rman -f POD | sed -e '/./,/^$/!d' -e 's/

[PATCH 1/3] info: start info documentation.

2014-01-05 Thread David Bremner
From: David Bremner Initially, just a skeleton of documentation for the emacs interface. There are a few dangling references to other info pages; these are to be generated from the man pages in a following commit. As far as actual documentation, so far this contains only a

third draft of info manual

2014-01-05 Thread David Bremner
Jani was mentioning how much he loved editing troff, so I decided to dust off these patches, which as a side effect convert (some of) the man pages to pod. As I write this, I realized that the second commit message is sort of a lie, I now use a quick and dirty perl script [1] to do the

notmuch-0.16: realpath() compatibility issue; clang visibility problem

2014-01-05 Thread Jani Nikula
g the call. Why is it necessary to resolve > $HOME here? realpath is used to follow, not overwrite symlinks. -- next part -- An HTML attachment was scrubbed... URL: <http://notmuchmail.org/pipermail/notmuch/attachments/20140105/f7650df2/attachment.html>

third draft of info manual

2014-01-05 Thread David Bremner
Jani was mentioning how much he loved editing troff, so I decided to dust off these patches, which as a side effect convert (some of) the man pages to pod. As I write this, I realized that the second commit message is sort of a lie, I now use a quick and dirty perl script [1] to do the

[PATCH 1/3] info: start info documentation.

2014-01-05 Thread David Bremner
From: David Bremner brem...@debian.org Initially, just a skeleton of documentation for the emacs interface. There are a few dangling references to other info pages; these are to be generated from the man pages in a following commit. As far as actual documentation, so far this contains only a

[PATCH 3/3] debian: install info files

2014-01-05 Thread David Bremner
From: David Bremner brem...@debian.org It seems dh_installinfo doesn't understand wildcards or look in debian/tmp --- debian/notmuch-emacs.info | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 debian/notmuch-emacs.info diff --git a/debian/notmuch-emacs.info

[PATCH 2/3] man: partial conversion to pod.

2014-01-05 Thread David Bremner
From: David Bremner brem...@debian.org This allows generation of man page and info document from the same source. It is also a bit more friendly to edit for most people. The conversion was done as follows: % groff -e -mandoc -Tascii -rHY=0 $* | rman -f POD | sed -e '/./,/^$/!d' -e 's/ Some

Re: [PATCH v2 0/2] doxygen generated library reference man page

2014-01-05 Thread David Bremner
Jani Nikula j...@nikula.org writes: v2 of id:cover.1385826040.git.j...@nikula.org Rebase, minor tweaks since v1; the TODO in the referenced message above is still valid. I suggest we get this merged as a starting point, so we can collaborate on including a nice API man page (and possibly a