docs typos & generator future compatibility fix

Author: vaind

generator/lib/src/entity_resolver.dart

@@ -153,9 +153,8 @@ class EntityResolver extends Builder {
               "  invalid relation property '${f.name}' in entity '${element.name}' - must use ToOne/ToMany<TargetEntity>");
           continue;
         }
-        relTargetName = (f.type as ParameterizedType)
-            .typeArguments[0]
-            .getDisplayString(withNullability: false);
+        relTargetName =
+            (f.type as ParameterizedType).typeArguments[0].element.name;
       }
 
       if (_backlinkChecker.hasAnnotationOfExact(f)) {

objectbox/lib/src/annotations.dart

@@ -1,5 +1,5 @@
-/// Entity annotation is used to on a class to let ObjectBox know it should
-/// store it - making the class a "persistable Entity".
+/// Entity annotation is used on a class to let ObjectBox know it should store
+/// it - making the class a "persistable Entity".
 ///
 /// This annotation is matched by ObjectBox code generator when you call
 /// `pub run_build_runner build`. The generator creates `objectbox.g.dart` with
@@ -21,10 +21,8 @@ class Entity {
   const Entity({this.uid});
 }
 
-/// Property annotation enables you to explicitly specify configure some details
-/// about how a field is stored in the database.
-///
-/// Use PropertyType and OBXPropertyFlag values, resp. for type and flag.
+/// Property annotation enables you to explicitly configure some details about
+/// how a field is stored in the database.
 class Property {
   /// ObjectBox keeps track of entities and properties by assigning them unique
   /// identifiers, UIDs, during the code-generation phase. All those UIDs are
@@ -111,7 +109,7 @@ class Id {
   const Id();
 }
 
-/// Transient annotation marks properties that should not be stored in the DB.
+/// Transient annotation marks fields that should not be stored in the database.
 class Transient {
   /// Create a Transient annotation.
   const Transient();
@@ -135,7 +133,7 @@ class Index {
   /// Index type.
   final IndexType /*?*/ type;
 
-  /// Create an Index annotaion.
+  /// Create an Index annotation.
   const Index({this.type});
 }
 
@@ -153,8 +151,7 @@ enum IndexType {
   /// it's default, [hash].
   value,
 
-  /// Uses a 32-bit hash of the field value to build the index. This is a
-  /// default for [String] properties.
+  /// Uses a 32-bit hash of the field value; default for [String] properties.
   ///
   /// Hash collisions should be sporadic and shouldn't impact performance in
   /// practice. Because it requires less storage space, it's usually a better

objectbox/lib/src/observable.dart

@@ -63,7 +63,7 @@ class _Observable {
 }
 
 /// Streamable adds stream support to queries. The stream reruns the query
-/// whenever there's a change in any of the object in the queried Entity
+/// whenever there's a change in any of the objects in the queried Box
 /// (regardless of the filter conditions).
 extension Streamable<T> on Query<T> {
   void _setup() {
@@ -79,8 +79,8 @@ extension Streamable<T> on Query<T> {
     };
   }
 
-  /// Create a stream, executing [Query.find()] whenever there's a change to the
-  /// underlying Entity.
+  /// Create a stream, executing [Query.find()] whenever there's a change to any
+  /// of the objects in the queried Box.
   Stream<List<T>> findStream(
       {@Deprecated('Use offset() instead') int offset = 0,
       @Deprecated('Use limit() instead') int limit = 0}) {

objectbox/lib/src/relations/to_one.dart

@@ -115,7 +115,7 @@ class ToOne<EntityT> {
     }
   }
 
-  /// Whether the relatin field has a value stored. Otherwise it's null.
+  /// Whether the relation field has a value stored. Otherwise it's null.
   bool get hasValue => _value._state != _ToOneState.none;
 
   /// Initialize the relation field, attaching it to the store.