Address further review comments.

zlaski-semmle · geoffw0 · commit 2baa74839015 · 2019-11-12T17:35:50.000Z
diff --git a/cpp/ql/src/semmle/code/cpp/Type.qll b/cpp/ql/src/semmle/code/cpp/Type.qll
@@ -1184,9 +1184,11 @@ class ArrayType extends DerivedType {
  * allows vector types to be introduced using the `ext_vector_type`,
  * `neon_vector_type`, and `neon_polyvector_type` attributes (all of which take
  * an element count rather than a byte size).
+ * 
+ * In the example below, both `v4si` and `float4` are GNU vector types:
  * ```
  * typedef int v4si __attribute__ (( vector_size(4*sizeof(int)) ));
- * v4si v = { 1, 2, 3, 4 };
+ * typedef float float4 __attribute__((ext_vector_type(4)));
  * ```
  */
 class GNUVectorType extends DerivedType {
diff --git a/cpp/ql/src/semmle/code/cpp/exprs/Assignment.qll b/cpp/ql/src/semmle/code/cpp/exprs/Assignment.qll
@@ -218,7 +218,7 @@ class AssignPointerSubExpr extends AssignOperation, @assignpsubexpr {
  * // c is no longer in scope
  * while (int d = x - y) { do_something_else_with(d); }
  * // d is no longer is scope
- * ``` 
+ * ```
  */
 class ConditionDeclExpr extends Expr, @condition_decl {
   /**
diff --git a/cpp/ql/src/semmle/code/cpp/exprs/BuiltInOperations.qll b/cpp/ql/src/semmle/code/cpp/exprs/BuiltInOperations.qll
@@ -2,7 +2,7 @@ import semmle.code.cpp.exprs.Expr
 
 /**
  * A C/C++ builtin operation. This is the root QL class encompassing
- * built-in operationality.
+ * built-in functionality.
  */
 abstract class BuiltInOperation extends Expr {
   override string getCanonicalQLClass() { result = "BuiltInOperation" }
@@ -83,7 +83,7 @@ class BuiltInNoOp extends BuiltInOperation, @noopexpr {
 deprecated class BuiltInOperationOffsetOf = BuiltInOperationBuiltInOffsetOf;
 
 /**
- * A C/C++ `__offsetof` built-in operation (used by some implementations
+ * A C/C++ `__builtin_offsetof` built-in operation (used by some implementations
  * of `offsetof`).  The operation retains its semantics even in the presence
  * of an overloaded `operator &`).  This is a GNU/Clang extension.
  * ```
