/*
 * Copyright 2019, TeamDev. All rights reserved.
 *
 * Redistribution and use in source and/or binary forms, with or without
 * modification, must retain the above copyright notice and the following
 * disclaimer.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package io.spine.server.entity.storage;

import io.spine.annotation.Internal;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

/**
 * ...
 *
 * <p>A number of columns internally used by Spine are shared between different entities or can't
 * be stored to Protobuf for some other reasons. These columns are marked with this annotation and
 * are processed by the column introspector separately.
 *
 * <p>The methods annotated with this annotation should conform to the same {@code get...()} syntax
 * as the Protobuf-based columns.
 */
@Target(METHOD)
@Retention(RUNTIME)
@Internal
public @interface SystemColumn {
}

@@ -1350,32 +1350,27 @@
 are 
-shared between different
+applied to multiple
  ent
@@ -1387,33 +1387,51 @@
 an't
+ be
 %0A * 
-be stored to Protobuf
+expressed as a Protobuf field option
  for
@@ -1477,32 +1477,35 @@
 marked with this
+%0A *
  annotation and%0A
@@ -1503,19 +1503,16 @@
 tion and
-%0A *
  are pro
@@ -1597,23 +1597,28 @@
 ith 
-this annotation
+%7B@code SystemColumn%7D
  sho
@@ -1661,18 +1661,18 @@
 .()%7D
+%0A *
  syntax
-%0A *
  as 

Reword doc