X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Frenderer.h;h=dd54ca1691dfaf49233608ff85f2ff5de9e69440;hb=afd625b06702e7a25e0730601f03955832b64e65;hp=501d1db3159667c42f92f3ecdfe2e85cb28fc1c4;hpb=92f87b75f96392c0f6b306a55738cdab413a7b92;p=libs%2Fgl.git

diff --git a/source/renderer.h b/source/renderer.h
index 501d1db3..dd54ca16 100644
--- a/source/renderer.h
+++ b/source/renderer.h
@@ -24,7 +24,9 @@ particular, Objects and Scenes) can by rendered without a Renderer, using one
 will often be more efficient.  This is especially true for ObjectInstances.
 
 The Renderer works by deferring GL state changes until something is actually
-being drawn.  This avoids many unnecessary GL calls. */
+being drawn.  This avoids many unnecessary GL calls if consecutive renderables
+use the same resources.
+*/
 class Renderer
 {
 public:
@@ -92,7 +94,9 @@ public:
 	void push_state();
 	void pop_state();
 
-	/** Prepares for temporarily bypassing the Renderer. */
+	/** Prepares for temporarily bypassing the Renderer by synchronizing the
+	current state with GL.  No additional call is necessary to resume using the
+	Renderer. */
 	void escape();
 
 	void draw(const Batch &);