@@ -1065,8 +1065,8 @@ class File(google.protobuf.message.Message):
10651065
10661066 @typing_extensions .final
10671067 class Position (google .protobuf .message .Message ):
1068- """Position represents a position within a file using a specific unit. The
1069- number of dimensions of the position value depends on the unit type.
1068+ """Position within a file, as coordinates in a a specific unit. The
1069+ number of dimensions of the coordinate depends on the unit type.
10701070 """
10711071
10721072 DESCRIPTOR : google .protobuf .descriptor .Descriptor
@@ -1082,7 +1082,9 @@ class File(google.protobuf.message.Message):
10821082 UNIT_CHARACTER : File .Position ._Unit .ValueType # 1
10831083 """Character positions (for Markdown and other text files)."""
10841084 UNIT_PAGE : File .Position ._Unit .ValueType # 2
1085- """Page positions (for documents)."""
1085+ """Page positions (for documents). For pages, positions are 1-indexed
1086+ (e.g., page 4 of 4) to align with document visualization standards.
1087+ """
10861088 UNIT_TIME_MS : File .Position ._Unit .ValueType # 3
10871089 """Time positions in milliseconds (for audio/video files)."""
10881090 UNIT_PIXEL : File .Position ._Unit .ValueType # 4
@@ -1096,7 +1098,9 @@ class File(google.protobuf.message.Message):
10961098 UNIT_CHARACTER : File .Position .Unit .ValueType # 1
10971099 """Character positions (for Markdown and other text files)."""
10981100 UNIT_PAGE : File .Position .Unit .ValueType # 2
1099- """Page positions (for documents)."""
1101+ """Page positions (for documents). For pages, positions are 1-indexed
1102+ (e.g., page 4 of 4) to align with document visualization standards.
1103+ """
11001104 UNIT_TIME_MS : File .Position .Unit .ValueType # 3
11011105 """Time positions in milliseconds (for audio/video files)."""
11021106 UNIT_PIXEL : File .Position .Unit .ValueType # 4
0 commit comments