From 626dc2a770207bc1398214e040166f58ec9b8df4 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@kth.se>
Date: Wed, 11 May 2016 20:50:06 +0200
Subject: Manual: use inplace addition whenever possible
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <maandree@kth.se>
---
 doc/arithmetic.tex | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'doc/arithmetic.tex')

diff --git a/doc/arithmetic.tex b/doc/arithmetic.tex
index 713eedc..f16f04f 100644
--- a/doc/arithmetic.tex
+++ b/doc/arithmetic.tex
@@ -87,6 +87,23 @@ is however not implemented because it is
 not deemed important enough and would
 be detrimental to libzahl's simplicity.
 
+{\tt zadd} and {\tt zadd\_unsigned} support
+in-place operation:
+
+\begin{alltt}
+  zadd(a, a, b);
+  zadd(b, a, b);           \textcolor{c}{/* \textrm{should be avoided} */}
+  zadd_unsigned(a, a, b);
+  zadd_unsigned(b, a, b);  \textcolor{c}{/* \textrm{should be avoided} */}
+\end{alltt}
+
+\noindent
+Use this whenever possible, it will improve
+your performance, as it will involve less
+CPU instructions for each character-addition
+and it may be possible to elementation some
+character-additions.
+
 
 \newpage
 \section{Subtraction}
-- 
cgit v1.2.3-70-g09d2

