aboutsummaryrefslogtreecommitdiff
path: root/src/docs_format.cpp
blob: c3aaebf6475ec1e19fe6d1b96475d54c3c7d12bb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
#define OdinDocHeader_MagicString "odindoc\0"

template <typename T>
struct OdinDocArray {
	u32 offset;
	u32 length;
};

using OdinDocString = OdinDocArray<u8>;

struct OdinDocVersionType {
	u8 major, minor, patch;
	u8 pad0;
};

#define OdinDocVersionType_Major 0
#define OdinDocVersionType_Minor 1
#define OdinDocVersionType_Patch 0

struct OdinDocHeaderBase {
	u8                 magic[8];
	u32                padding0;
	OdinDocVersionType version;
	u32                total_size;
	u32                header_size;
	u32                hash; // after header
};

template <typename T>
Slice<T> from_array(OdinDocHeaderBase *base, OdinDocArray<T> const &a) {
	Slice<T> s = {};
	s.data  = cast(T *)(cast(uintptr)base + cast(uintptr)a.offset);
	s.count = cast(isize)a.length;
	return s;
}

String from_string(OdinDocHeaderBase *base, OdinDocString const &s) {
	String str = {};
	str.text = cast(u8 *)(cast(uintptr)base + cast(uintptr)s.offset);
	str.len  = cast(isize)s.length;
	return str;
}

typedef u32 OdinDocFileIndex;
typedef u32 OdinDocPkgIndex;
typedef u32 OdinDocEntityIndex;
typedef u32 OdinDocTypeIndex;

struct OdinDocFile {
	OdinDocPkgIndex pkg;
	OdinDocString   name;
};

struct OdinDocPosition {
	OdinDocFileIndex file;
	u32              line;
	u32              column;
	u32              offset;
};

enum OdinDocTypeKind : u32 {
	OdinDocType_Invalid          = 0,
	OdinDocType_Basic            = 1,
	OdinDocType_Named            = 2,
	OdinDocType_Generic          = 3,
	OdinDocType_Pointer          = 4,
	OdinDocType_Array            = 5,
	OdinDocType_EnumeratedArray  = 6,
	OdinDocType_Slice            = 7,
	OdinDocType_DynamicArray     = 8,
	OdinDocType_Map              = 9,
	OdinDocType_Struct           = 10,
	OdinDocType_Union            = 11,
	OdinDocType_Enum             = 12,
	OdinDocType_Tuple            = 13,
	OdinDocType_Proc             = 14,
	OdinDocType_BitSet           = 15,
	OdinDocType_SimdVector       = 16,
	OdinDocType_SOAStructFixed   = 17,
	OdinDocType_SOAStructSlice   = 18,
	OdinDocType_SOAStructDynamic = 19,
	OdinDocType_RelativePointer  = 20,
	OdinDocType_RelativeSlice    = 21,
};

enum OdinDocTypeFlag_Basic : u32 {
	OdinDocTypeFlag_Basic_untyped = 1<<1,
};

enum OdinDocTypeFlag_Struct : u32 {
	OdinDocTypeFlag_Struct_polymorphic = 1<<0,
	OdinDocTypeFlag_Struct_packed      = 1<<1,
	OdinDocTypeFlag_Struct_raw_union   = 1<<2,
};

enum OdinDocTypeFlag_Union : u32 {
	OdinDocTypeFlag_Union_polymorphic = 1<<0,
	OdinDocTypeFlag_Union_no_nil      = 1<<1,
	OdinDocTypeFlag_Union_maybe       = 1<<2,
};

enum OdinDocTypeFlag_Proc : u32 {
	OdinDocTypeFlag_Proc_polymorphic = 1<<0,
	OdinDocTypeFlag_Proc_diverging   = 1<<1,
	OdinDocTypeFlag_Proc_optional_ok = 1<<2,
	OdinDocTypeFlag_Proc_variadic    = 1<<3,
	OdinDocTypeFlag_Proc_c_vararg    = 1<<4,
};

enum OdinDocTypeFlag_BitSet : u32 {
	OdinDocTypeFlag_BitSet_Range          = 1<<1,
	OdinDocTypeFlag_BitSet_OpLt           = 1<<2,
	OdinDocTypeFlag_BitSet_OpLtEq         = 1<<3,
	OdinDocTypeFlag_BitSet_UnderlyingType = 1<<4,
};

enum OdinDocTypeFlag_SimdVector : u32 {
	OdinDocTypeFlag_BitSet_x86_mmx = 1<<1,
};

enum {
	// constants
	OdinDocType_ElemsCap = 4,
};

struct OdinDocType {
	OdinDocTypeKind kind;
	u32             flags;
	OdinDocString   name;
	OdinDocString   custom_align;

	// Used by some types
	u32 elem_count_len;
	i64 elem_counts[OdinDocType_ElemsCap];

	// Each of these is esed by some types, not all
	OdinDocString calling_convention;
	OdinDocArray<OdinDocTypeIndex> types;
	OdinDocArray<OdinDocEntityIndex> entities;
	OdinDocTypeIndex polmorphic_params;
	OdinDocArray<OdinDocString> where_clauses;
};

struct OdinDocAttribute {
	OdinDocString name;
	OdinDocString value;
};

enum OdinDocEntityKind : u32 {
	OdinDocEntity_Invalid     = 0,
	OdinDocEntity_Constant    = 1,
	OdinDocEntity_Variable    = 2,
	OdinDocEntity_TypeName    = 3,
	OdinDocEntity_Procedure   = 4,
	OdinDocEntity_ProcGroup   = 5,
	OdinDocEntity_ImportName  = 6,
	OdinDocEntity_LibraryName = 7,
};

enum OdinDocEntityFlag : u32 {
	OdinDocEntityFlag_Foreign = 1<<0,
	OdinDocEntityFlag_Export  = 1<<1,

	OdinDocEntityFlag_Param_Using    = 1<<2,
	OdinDocEntityFlag_Param_Const    = 1<<3,
	OdinDocEntityFlag_Param_AutoCast = 1<<4,
	OdinDocEntityFlag_Param_Ellipsis = 1<<5,
	OdinDocEntityFlag_Param_CVararg  = 1<<6,
	OdinDocEntityFlag_Param_NoAlias  = 1<<7,

	OdinDocEntityFlag_Type_Alias = 1<<8,

	OdinDocEntityFlag_Var_Thread_Local = 1<<9,
};

struct OdinDocEntity {
	OdinDocEntityKind  kind;
	u32                flags;
	OdinDocPosition    pos;
	OdinDocString      name;
	OdinDocTypeIndex   type;
	OdinDocString      init_string;
	u32                reserved_for_init;
	OdinDocString      comment;
	OdinDocString      docs;
	OdinDocEntityIndex foreign_library;
	OdinDocString      link_name;
	OdinDocArray<OdinDocAttribute> attributes;
	OdinDocArray<OdinDocEntityIndex> grouped_entities; // Procedure Groups
	OdinDocArray<OdinDocString>      where_clauses; // Procedures
};

enum OdinDocPkgFlags : u32 {
	OdinDocPkgFlag_Builtin = 1<<0,
	OdinDocPkgFlag_Runtime = 1<<1,
	OdinDocPkgFlag_Init    = 1<<2,
};

struct OdinDocPkg {
	OdinDocString fullpath;
	OdinDocString name;
	u32           flags;
	OdinDocString docs;
	OdinDocArray<OdinDocFileIndex>   files;
	OdinDocArray<OdinDocEntityIndex> entities;
};

struct OdinDocHeader {
	OdinDocHeaderBase base;

	OdinDocArray<OdinDocFile>   files;
	OdinDocArray<OdinDocPkg>    pkgs;
	OdinDocArray<OdinDocEntity> entities;
	OdinDocArray<OdinDocType>   types;
};