X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=devel%2FSTYLE;fp=devel%2FSTYLE;h=24bd5482a4899b185f923302bb4801177dc6b3ea;hb=7e2d0ef10588b37922a6b48ca18005ce51bc0669;hp=92de42ccc9ba1847234532a88b58840ab5b0151a;hpb=e6ad3a5dd4ca7a09a4760c4eb6721217cc906aaa;p=notmuch

diff --git a/devel/STYLE b/devel/STYLE
index 92de42cc..24bd5482 100644
--- a/devel/STYLE
+++ b/devel/STYLE
@@ -93,3 +93,13 @@ libnotmuch conventions
 
 * Code which needs to be accessed from both the CLI and from
   libnotmuch should be factored out into libutil (under util/).
+
+* Deprecated functions should be marked with the NOTMUCH_DEPRECATED
+  macro which generates run time warnings with gcc and clang. In order
+  not to confuse doxygen this should go at the beginning of the
+  declaration like:
+
+  NOTMUCH_DEPRECATED(major,minor) notmuch_status_t notmuch_dwim(void *arg);
+
+  The @deprecated doxygen command can be used to generate markup in
+  the API docs.