[Gzz-commits] fenfire/docs newbie-dev-faq.rst

[Matti Katila]

CVSROOT:        /cvsroot/fenfire
Module name:    fenfire
Changes by:     Matti Katila <address@hidden>   03/04/28 11:38:28

Modified files:
        docs           : newbie-dev-faq.rst 

Log message:
        more faq

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/fenfire/fenfire/docs/newbie-dev-faq.rst.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: fenfire/docs/newbie-dev-faq.rst
diff -u fenfire/docs/newbie-dev-faq.rst:1.1 fenfire/docs/newbie-dev-faq.rst:1.2
--- fenfire/docs/newbie-dev-faq.rst:1.1 Mon Apr 28 11:19:46 2003
+++ fenfire/docs/newbie-dev-faq.rst     Mon Apr 28 11:38:28 2003
@@ -3,8 +3,8 @@
 
====================================================================================
 
 :Date:         2002-11-24
-:Revision:     $Revision: 1.1 $
-:Last-Modified:        $Date: 2003/04/28 15:19:46 $
+:Revision:     $Revision: 1.2 $
+:Last-Modified:        $Date: 2003/04/28 15:38:28 $
    
 
 This file is for newbie developers.
@@ -76,6 +76,34 @@
 
 will find you the above line.
 
+It's more efficient to use boolean primitive to check debug strings.
+So, you are *NOT* allowed to construct debug messages like: ::
+
+    class Foo {
+        static public boolean dbg = false;
+        private void p(String s) { if (dbg) pa(s); }
+        private void pa(String s) { System.out.println("Foo::"+s);
+
+
+        public void example() {
+            p("Just a test")
+        }
+    }
+
+If you use this, debug string is always created and that isn't very efficient 
in java.
+Well, instead of previous example, write a bit longer but more efficient: ::
+
+    class Foo {
+        static public boolean dbg = false;
+        private void pa(String s) { System.out.println("Foo::"+s);
+
+
+        public void example() {
+            if (dbg) pa("Just a test")
+        }
+    }
+
+
 
 Slang
 =====
@@ -83,9 +111,9 @@
 ``'daissaus' or 'daissata' [Finnish]`` = Something is splitted/chopped in very 
small pieces.
 Probably it is a texture.
 
-     -Engl. "dice", p.o. suom. "pilkkoa"/"pieniae"
+   - Engl. "dice", p.o. suom. "pilkkoa"/"pieniae"
 
-     -when having a large rectangle, which is to be rendered
+   - when having a large rectangle, which is to be rendered
      in a distorted view, it first needs to be diced i.e.
      made into a large number of small rectangles, so that
      it will appear curved when the vertices of the small
@@ -95,12 +123,12 @@
 Terms
 =====
 
--Bilinear and Trilinear
+Bilinear and Trilinear
 
-Close temrs to mipmapping. Trilinear sums 8 texels and counts 
-weighted average factor from two mipmap levels.
-Bilinear is same with 4 texels from one mipmap level.
-Of course trilinear looks much better - it doesn't jump around.
+  - Close temrs to mipmapping. Trilinear sums 8 texels and counts 
+    weighted average factor from two mipmap levels.
+    Bilinear is same with 4 texels from one mipmap level.
+    Of course trilinear looks much better - it doesn't jump around.
 
 
 How to use mediaserver, mstmpimg and texpacker for mipzips?