[Bf-blender-cvs] [388335f] temp-openvdb: Minor comments

[Campbell Barton]

Commit: 388335fa6a4ed0223fddcfe6ccbd8a18323e2490
Author: Campbell Barton
Date:   Sat Jan 23 16:32:00 2016 +1100
Branches: temp-openvdb
https://developer.blender.org/rB388335fa6a4ed0223fddcfe6ccbd8a18323e2490

Minor comments

===================================================================

M	source/blender/blenkernel/intern/pointcache.c

===================================================================

diff --git a/source/blender/blenkernel/intern/pointcache.c b/source/blender/blenkernel/intern/pointcache.c
index 15eaf47..268a76d 100644
--- a/source/blender/blenkernel/intern/pointcache.c
+++ b/source/blender/blenkernel/intern/pointcache.c
@@ -892,13 +892,17 @@ static int ptcache_smoke_read(PTCacheFile *pf, void *smoke_v)
 }
 
 #ifdef WITH_OPENVDB
-/* Construct matrices which represent the fluid object, for low and high res:
+/**
+ * Construct matrices which represent the fluid object, for low and high res:
+ * <pre>
  * vs 0  0  0
  * 0  vs 0  0
  * 0  0  vs 0
  * px py pz 1
- * with vs = voxel size, and px, py, pz, the min position of the domain's
- * bounding box.
+ * </pre>
+ *
+ * with `vs` = voxel size, and `px, py, pz`,
+ * the min position of the domain's bounding box.
  */
 static void compute_fluid_matrices(SmokeDomainSettings *sds)
 {
@@ -1746,6 +1750,9 @@ static const char *ptcache_file_extension(const PTCacheID *pid)
 	}
 }
 
+/**
+ * Similar to #BLI_path_frame_get, but takes into account the stack-index which is after the frame.
+ */
 static int ptcache_frame_from_filename(const char *filename, const char *ext)
 {
 	const int frame_len = 6;