From 96d6c3ff35ba8a4acb4059e9383c4e6df073ed52 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Andr=C3=A9=20Wobst?= <wobsta@users.sourceforge.net>
Date: Tue, 6 Jul 2010 16:34:44 +0000
Subject: [PATCH] be a little restrictive

git-svn-id: https://pyx.svn.sourceforge.net/svnroot/pyx/trunk/pyx@3031 069f4177-920e-0410-937b-c2a4a81bcd90
---
 CHANGES          |  1 +
 manual/graph.tex | 13 +++++++------
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index dcad4213..37f72bc2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -109,6 +109,7 @@ TODO:
       mesh_as_bitmap_resolution (TODO: documentation)
     - fix for commented out UniqueID
   - graph modules:
+    - bar style on graphxyz (single datasets only)
     - graphxyz:
       - fix position of z4 axis
       - set correct errorname for z axis (thanks to Axel Freyn)
diff --git a/manual/graph.tex b/manual/graph.tex
index a0076d53..ee6cf040 100644
--- a/manual/graph.tex
+++ b/manual/graph.tex
@@ -1008,12 +1008,13 @@ definition is:
   which is a list containing \code{[color.gradient.Rainbow,
   deco.stroked([color.grey.black])]}.
 
-  On 3d graphs \var{epsilon} is used to prevent numerical
-  instabilities on bars without hight. When \var{gradient} is not
-  \code{None} it is used to calculate a lighting coloring taking into
-  account the angle between the view ray and the bar and the distance
-  between viewer and bar. The precise conversion is defined in the
-  \method{lighting} method.
+  The bar style has limited support for 3d graphs: Occlusion does not
+  work properly on stacked bars or multiple dataset. \var{epsilon} is
+  used in 3d to prevent numerical instabilities on bars without hight.
+  When \var{gradient} is not \code{None} it is used to calculate a
+  lighting coloring taking into account the angle between the view ray
+  and the bar and the distance between viewer and bar. The precise
+  conversion is defined in the \method{lighting} method.
 \end{classdesc} % }}}
 
 \begin{classdesc}{changebar}{barattrs=[]} % {{{
-- 
2.11.4.GIT