style cleanup: comment blocks

doc/manpage/blender.1

@@ -1,4 +1,4 @@
-.TH "BLENDER" "1" "July 19, 2012" "Blender Blender 2\&.63 (sub 14)"
+.TH "BLENDER" "1" "October 04, 2012" "Blender Blender 2\&.64 (sub 0)"
 
 .SH NAME
 blender \- a 3D modelling and rendering package
@@ -15,7 +15,7 @@ Use Blender to create TV commercials, to make technical visualizations, business
 http://www.blender.org
 .SH OPTIONS
 
-Blender 2.63 (sub 14)
+Blender 2.64 (sub 0)
 Usage: blender [args ...] [file] [args ...]
 .br
 .SS "Render Options:"

source/blender/blenkernel/intern/ipo.c

@@ -1757,13 +1757,13 @@ void do_versions_ipos_to_animato(Main *main)
 
 				{
 					/* If we have any empty action actuators, assume they were
-					   converted IPO Actuators using the object IPO */
+					 * converted IPO Actuators using the object IPO */
 					bActuator *act;
 					bActionActuator *aa;
 
 					for (act = ob->actuators.first; act; act = act->next) {
 						/* Any actuators set to ACT_IPO at this point are actually Action Actuators that
-						   need this converted IPO to finish converting the actuator. */
+						 * need this converted IPO to finish converting the actuator. */
 						if (act->type == ACT_IPO) {
 							aa = (bActionActuator *)act->data;
 							aa->act = ob->adt->action;

source/blender/blenkernel/intern/object.c

@@ -2261,7 +2261,7 @@ void BKE_object_minmax(Object *ob, float min_r[3], float max_r[3], const short u
 			Curve *cu = ob->data;
 
 			/* Use the object bounding box so that modifier output
-			   gets taken into account */
+			 * gets taken into account */
 			if (ob->bb)
 				bb = *(ob->bb);
 			else {

source/blender/blenkernel/intern/sequencer.c

@@ -3959,10 +3959,10 @@ Sequence *BKE_sequencer_add_sound_strip(bContext *C, ListBase *seqbasep, SeqLoad
 	sound = sound_new_file(bmain, seq_load->path); /* handles relative paths */
 
 	if (sound == NULL || sound->playback_handle == NULL) {
-		/*
+#if 0
 		 if (op)
 			BKE_report(op->reports, RPT_ERROR, "Unsupported audio format");
-		*/
+#endif
 
 		return NULL;
 	}
@@ -3971,10 +3971,10 @@ Sequence *BKE_sequencer_add_sound_strip(bContext *C, ListBase *seqbasep, SeqLoad
 
 	if (info.specs.channels == AUD_CHANNELS_INVALID) {
 		sound_delete(bmain, sound);
-		/*
+#if 0
 		if (op)
 			BKE_report(op->reports, RPT_ERROR, "Unsupported audio format");
-		*/
+#endif
 		return NULL;
 	}
 

source/blender/blenloader/intern/readfile.c

@@ -206,7 +206,7 @@
  * - join all Mains
  * - link all LibBlocks and indirect pointers to libblocks
  * - initialize FileGlobal and copy pointers to Global
-*/
+ */
 
 /* also occurs in library.c */
 /* GS reads the memory pointed at in a specific ordering. There are,

source/blender/blenloader/intern/writefile.c

@@ -30,46 +30,46 @@
 
 
 /*
-FILEFORMAT: IFF-style structure  (but not IFF compatible!)
+ * FILEFORMAT: IFF-style structure  (but not IFF compatible!)
-
+ *
-start file:
+ * start file:
-	BLENDER_V100	12 bytes  (versie 1.00)
+ *     BLENDER_V100    12 bytes  (versie 1.00)
-					V = big endian, v = little endian
+ *                     V = big endian, v = little endian
-					_ = 4 byte pointer, - = 8 byte pointer
+ *                     _ = 4 byte pointer, - = 8 byte pointer
-
+ *
-datablocks:		also see struct BHead
+ * datablocks:     also see struct BHead
-	<bh.code>			4 chars
+ *     <bh.code>           4 chars
-	<bh.len>			int,  len data after BHead
+ *     <bh.len>            int,  len data after BHead
-	<bh.old>			void,  old pointer
+ *     <bh.old>            void,  old pointer
-	<bh.SDNAnr>			int
+ *     <bh.SDNAnr>         int
-	<bh.nr>				int, in case of array: amount of structs
+ *     <bh.nr>             int, in case of array: amount of structs
-	data
+ *     data
-	...
+ *     ...
-	...
+ *     ...
-
+ *
-Almost all data in Blender are structures. Each struct saved
+ * Almost all data in Blender are structures. Each struct saved
-gets a BHead header.  With BHead the struct can be linked again
+ * gets a BHead header.  With BHead the struct can be linked again
-and compared with StructDNA .
+ * and compared with StructDNA .
-
+ *
-WRITE
+ * WRITE
-
+ *
-Preferred writing order: (not really a must, but why would you do it random?)
+ * Preferred writing order: (not really a must, but why would you do it random?)
-Any case: direct data is ALWAYS after the lib block
+ * Any case: direct data is ALWAYS after the lib block
-
+ *
-(Local file data)
+ * (Local file data)
-- for each LibBlock
+ * - for each LibBlock
-	- write LibBlock
+ *     - write LibBlock
-	- write associated direct data
+ *     - write associated direct data
-(External file data)
+ * (External file data)
-- per library
+ * - per library
-	- write library block
+ *     - write library block
-	- per LibBlock
+ *     - per LibBlock
-		- write the ID of LibBlock
+ *         - write the ID of LibBlock
-- write TEST (128x128, blend file preview, optional)
+ * - write TEST (128x128, blend file preview, optional)
-- write FileGlobal (some global vars)
+ * - write FileGlobal (some global vars)
-- write SDNA
+ * - write SDNA
-- write USER if filename is ~/X.XX/config/startup.blend
+ * - write USER if filename is ~/X.XX/config/startup.blend
-*/
+ */
 
 
 #include <math.h>

source/blender/collada/DocumentImporter.cpp

@@ -88,8 +88,8 @@ extern "C" {
 
 
 /*
-   COLLADA Importer limitations:
+ * COLLADA Importer limitations:
-   - no multiple scene import, all objects are added to active scene
+ * - no multiple scene import, all objects are added to active scene
  */
 
 // #define COLLADA_DEBUG
@@ -878,7 +878,7 @@ bool DocumentImporter::writeCamera(const COLLADAFW::Camera *camera)
 		}
 		break;
 		/* XXX correct way to do following four is probably to get also render
-		   size and determine proper settings from that somehow */
+		 * size and determine proper settings from that somehow */
 		case COLLADAFW::Camera::ASPECTRATIO_AND_X:
 		case COLLADAFW::Camera::SINGLE_X:
 		case COLLADAFW::Camera::X_AND_Y:

source/blender/collada/DocumentImporter.h

@@ -78,8 +78,9 @@ public:
 	void write_profile_COMMON(COLLADAFW::EffectCommon*, Material*);
 	void translate_anim_recursive(COLLADAFW::Node*, COLLADAFW::Node*, Object*);
 
-	/** This method will be called if an error in the loading process occurred and the loader cannot
+	/**
-	continue to load. The writer should undo all operations that have been performed.
+	 * This method will be called if an error in the loading process occurred and the loader cannot
+	 * continue to load. The writer should undo all operations that have been performed.
 	\param errorMessage A message containing informations about the error that occurred.
 	*/
 	void cancel(const COLLADAFW::String& errorMessage);

source/blender/collada/GeometryExporter.cpp

@@ -358,8 +358,8 @@ void GeometryExporter::createVertsSource(std::string geom_id, Mesh *me)
 	param.push_back("X");
 	param.push_back("Y");
 	param.push_back("Z");
-	/*main function, it creates <source id = "">, <float_array id = ""
+	/* main function, it creates <source id = "">, <float_array id = ""
-	   count = ""> */
+	 * count = ""> */
 	source.prepareToAppendValues();
 	//appends data to <float_array>
 	int i = 0;

source/blender/editors/mesh/editmesh_knife.c

@@ -446,8 +446,8 @@ static KnifeVert *knife_split_edge(KnifeTool_OpData *kcd, KnifeEdge *kfe, float
 	}
 	else {
 		/* kfe cuts across an existing face.
-		   If v1 and v2 are in multiple faces together (e.g., if they
+		 * If v1 and v2 are in multiple faces together (e.g., if they
-		   are in doubled polys) then this arbitrarily chooses one of them */
+		 * are in doubled polys) then this arbitrarily chooses one of them */
 		f = knife_find_common_face(&kfe->v1->faces, &kfe->v2->faces);
 		if (f)
 			knife_append_list(kcd, &newkfe->v2->faces, f);

source/blender/editors/mesh/editmesh_tools.c

@@ -2140,7 +2140,7 @@ static int edbm_select_vertex_path_exec(bContext *C, wmOperator *op)
 	}
 
 	/* if those are not found, because vertices where selected by e.g.
-	   border or circle select, find two selected vertices */
+	 * border or circle select, find two selected vertices */
 	if (svert == NULL) {
 		BM_ITER_MESH (eve, &iter, em->bm, BM_VERTS_OF_MESH) {
 			if (!BM_elem_flag_test(eve, BM_ELEM_SELECT) || BM_elem_flag_test(eve, BM_ELEM_HIDDEN))
@@ -2150,7 +2150,7 @@ static int edbm_select_vertex_path_exec(bContext *C, wmOperator *op)
 			else if (evert == NULL) evert = eve;
 			else {
 				/* more than two vertices are selected,
-				   show warning message and cancel operator */
+				 * show warning message and cancel operator */
 				svert = evert = NULL;
 				break;
 			}

source/blender/editors/space_view3d/view3d_edit.c

@@ -1235,8 +1235,8 @@ void VIEW3D_OT_ndof_pan(struct wmOperatorType *ot)
 
 
 /*
-* this is basically just the pan only code + the rotate only code crammed into one function that does both
+ * this is basically just the pan only code + the rotate only code crammed into one function that does both
-*/
+ */
 static int ndof_all_invoke(bContext *C, wmOperator *op, wmEvent *event)
 {
 	if (event->type != NDOF_MOTION)

source/blender/imbuf/intern/indexer.c

@@ -955,9 +955,9 @@ static int index_rebuild_ffmpeg(FFmpegIndexBuilderContext *context,
 	}
 
 	/* process pictures still stuck in decoder engine after EOF
-	   according to ffmpeg docs using 0-size packets. 
+	 * according to ffmpeg docs using 0-size packets.
-
+	 *
-	   At least, if we haven't already stopped... */
+	 * At least, if we haven't already stopped... */
 	if (!*stop) {
 		int frame_finished;
 

source/blender/makesrna/intern/rna_nodetree.c

@@ -2195,14 +2195,14 @@ static void def_cmp_inpaint(StructRNA *srna)
 {
 	PropertyRNA *prop;
 
-/*
+#if 0
 	prop = RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
 
 	RNA_def_property_enum_sdna(prop, NULL, "custom1");
 	RNA_def_property_enum_items(prop, type_items);
 	RNA_def_property_ui_text(prop, "Type", "Type of inpaint algorithm");
 	RNA_def_property_update(prop, NC_NODE | NA_EDITED, "rna_Node_update");
-*/
+#endif
 	
 	prop = RNA_def_property(srna, "distance", PROP_INT, PROP_NONE);
 	RNA_def_property_int_sdna(prop, NULL, "custom2");

source/blender/makesrna/intern/rna_sequencer.c

@@ -1673,14 +1673,14 @@ static void rna_def_effect_inputs(StructRNA *srna, int count)
 		RNA_def_property_ui_text(prop, "Input 2", "Second input for the effect strip");
 	}
 
-	/*
+#if 0
 	if (count == 3) { // not used by any effects (perhaps one day plugins?)
 		prop = RNA_def_property(srna, "input_3",  PROP_POINTER, PROP_NONE);
 		RNA_def_property_pointer_sdna(prop, NULL, "seq3");
 		RNA_def_property_flag(prop, PROP_EDITABLE | PROP_NEVER_NULL);
 		RNA_def_property_ui_text(prop, "Input 3", "Third input for the effect strip");
 	}
-	*/
+#endif
 }
 
 static void rna_def_image(BlenderRNA *brna)

source/blender/nodes/composite/node_composite_tree.c

@@ -515,8 +515,8 @@ static int setExecutableNodes(bNodeTreeExec *exec, ThreadData *thd)
 static void freeExecutableNode(bNodeTreeExec *exec)
 {
 	/* node outputs can be freed when:
-	- not a render result or image node
+	 * - not a render result or image node
-	- when node outputs go to nodes all being set NODE_FINISHED
+	 * - when node outputs go to nodes all being set NODE_FINISHED
 	 */
 	bNodeTree *ntree = exec->nodetree;
 	bNodeExec *nodeexec;

source/blender/render/intern/source/occlusion.c

@@ -232,9 +232,9 @@ static void occ_build_shade(Render *re, OcclusionTree *tree)
 /* ------------------------- Spherical Harmonics --------------------------- */
 
 /* Use 2nd order SH => 9 coefficients, stored in this order:
-* 0 = (0,0),
+ * 0 = (0,0),
-* 1 = (1,-1), 2 = (1,0), 3 = (1,1),
+ * 1 = (1,-1), 2 = (1,0), 3 = (1,1),
-* 4 = (2,-2), 5 = (2,-1), 6 = (2,0), 7 = (2,1), 8 = (2,2) */
+ * 4 = (2,-2), 5 = (2,-1), 6 = (2,0), 7 = (2,1), 8 = (2,2) */
 
 static void sh_copy(float *shresult, float *sh)
 {