2016-02-25 23:52:11 +00:00
|
|
|
/*
|
2016-06-24 19:33:37 +00:00
|
|
|
* Mr. 4th Dimention - Allen Webster
|
|
|
|
*
|
|
|
|
* 25.02.2016
|
|
|
|
*
|
|
|
|
* File editing view for 4coder
|
|
|
|
*
|
|
|
|
*/
|
2016-02-25 23:52:11 +00:00
|
|
|
|
|
|
|
// TOP
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
#include "4ed_meta.h"
|
2016-07-06 19:18:10 +00:00
|
|
|
#include "internal_4coder_string.cpp"
|
2016-02-25 23:52:11 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
#include "4cpp_types.h"
|
|
|
|
#include "4cpp_lexer_types.h"
|
|
|
|
|
|
|
|
#define FCPP_LEXER_IMPLEMENTATION
|
|
|
|
#include "4cpp_lexer.h"
|
|
|
|
|
2016-06-27 14:25:17 +00:00
|
|
|
#include "4coder_version.h"
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
#include "4coder_mem.h"
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
struct Global_Settings{
|
|
|
|
int generate_docs;
|
2016-08-22 23:54:20 +00:00
|
|
|
int generate_string;
|
2016-07-02 14:15:15 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
static Global_Settings global_settings;
|
|
|
|
|
2016-02-27 17:34:13 +00:00
|
|
|
struct Struct_Field{
|
|
|
|
char *type;
|
|
|
|
char *name;
|
|
|
|
};
|
|
|
|
|
|
|
|
void to_lower(char *src, char *dst){
|
|
|
|
char *c, ch;
|
2016-03-05 04:10:55 +00:00
|
|
|
for (c = src; *c != 0; ++c){
|
|
|
|
ch = char_to_lower(*c);
|
|
|
|
*dst++ = ch;
|
|
|
|
}
|
|
|
|
*dst = 0;
|
|
|
|
}
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
void to_lower(String *str){
|
|
|
|
char *c;
|
|
|
|
int i = 0;
|
|
|
|
int size = str->size;
|
|
|
|
for (c = str->str; i < size; ++c, ++i){
|
|
|
|
*c = char_to_lower(*c);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
void to_upper(char *src, char *dst){
|
|
|
|
char *c, ch;
|
|
|
|
for (c = src; *c != 0; ++c){
|
|
|
|
ch = char_to_upper(*c);
|
|
|
|
*dst++ = ch;
|
|
|
|
}
|
|
|
|
*dst = 0;
|
|
|
|
}
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
void to_upper(String *str){
|
|
|
|
char *c;
|
|
|
|
int i = 0;
|
|
|
|
int size = str->size;
|
|
|
|
for (c = str->str; i < size; ++c, ++i){
|
|
|
|
*c = char_to_upper(*c);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
void to_camel(char *src, char *dst){
|
|
|
|
char *c, ch;
|
|
|
|
int is_first = 1;
|
2016-02-27 17:34:13 +00:00
|
|
|
for (c = src; *c != 0; ++c){
|
|
|
|
ch = *c;
|
2016-03-05 04:10:55 +00:00
|
|
|
if (char_is_alpha_numeric_true(ch)){
|
|
|
|
if (is_first){
|
|
|
|
is_first = 0;
|
|
|
|
ch = char_to_upper(ch);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
ch = char_to_lower(ch);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
is_first = 1;
|
2016-02-27 17:34:13 +00:00
|
|
|
}
|
|
|
|
*dst++ = ch;
|
|
|
|
}
|
|
|
|
*dst = 0;
|
|
|
|
}
|
|
|
|
|
2016-02-25 23:52:11 +00:00
|
|
|
#include <stdlib.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <string.h>
|
2016-05-25 22:43:58 +00:00
|
|
|
#include <assert.h>
|
2016-02-25 23:52:11 +00:00
|
|
|
|
2016-02-27 17:34:13 +00:00
|
|
|
void struct_begin(FILE *file, char *name){
|
|
|
|
fprintf(file, "struct %s{\n", name);
|
|
|
|
}
|
|
|
|
|
|
|
|
void struct_fields(FILE *file, Struct_Field *fields, int count){
|
|
|
|
int i;
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
fprintf(file, " %s %s;\n", fields[i].type, fields[i].name);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void struct_end(FILE *file){
|
|
|
|
fprintf(file, "};\n\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2016-03-04 23:10:00 +00:00
|
|
|
void enum_begin(FILE *file, char *name){
|
|
|
|
fprintf(file, "enum %s{\n", name);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2016-02-25 23:52:11 +00:00
|
|
|
char *keys_that_need_codes[] = {
|
2016-06-07 18:52:40 +00:00
|
|
|
"back",
|
|
|
|
"up",
|
|
|
|
"down",
|
|
|
|
"left",
|
|
|
|
"right",
|
|
|
|
"del",
|
|
|
|
"insert",
|
|
|
|
"home",
|
|
|
|
"end",
|
|
|
|
"page_up",
|
|
|
|
"page_down",
|
|
|
|
"esc",
|
|
|
|
|
|
|
|
"mouse_left",
|
|
|
|
"mouse_right",
|
2016-02-25 23:52:11 +00:00
|
|
|
|
|
|
|
"f1",
|
|
|
|
"f2",
|
|
|
|
"f3",
|
|
|
|
"f4",
|
|
|
|
"f5",
|
|
|
|
"f6",
|
|
|
|
"f7",
|
|
|
|
"f8",
|
|
|
|
|
|
|
|
"f9",
|
|
|
|
"f10",
|
|
|
|
"f11",
|
|
|
|
"f12",
|
|
|
|
"f13",
|
|
|
|
"f14",
|
|
|
|
"f15",
|
|
|
|
"f16",
|
|
|
|
};
|
|
|
|
|
2016-02-27 17:34:13 +00:00
|
|
|
char* generate_keycode_enum(){
|
2016-02-25 23:52:11 +00:00
|
|
|
FILE *file;
|
2016-02-27 17:34:13 +00:00
|
|
|
char *filename = "4coder_keycodes.h";
|
2016-02-25 23:52:11 +00:00
|
|
|
int i, count;
|
|
|
|
unsigned char code = 1;
|
|
|
|
|
|
|
|
file = fopen(filename, "wb");
|
2016-07-01 05:42:19 +00:00
|
|
|
fprintf(file, "enum Key_Code_Names{\n");
|
2016-02-25 23:52:11 +00:00
|
|
|
count = ArrayCount(keys_that_need_codes);
|
2016-06-07 16:26:11 +00:00
|
|
|
for (i = 0; i < count; i){
|
2016-02-25 23:52:11 +00:00
|
|
|
if (strcmp(keys_that_need_codes[i], "f1") == 0 && code < 0x7F){
|
|
|
|
code = 0x7F;
|
|
|
|
}
|
|
|
|
switch (code){
|
2016-06-07 18:52:40 +00:00
|
|
|
case '\n': code++; break;
|
|
|
|
case '\t': code++; break;
|
|
|
|
case 0x20: code = 0x7F; break;
|
|
|
|
default:
|
|
|
|
fprintf(file, "key_%s = %d,\n", keys_that_need_codes[i++], code++);
|
|
|
|
break;
|
2016-02-25 23:52:11 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
fprintf(file, "};\n");
|
2016-06-07 16:26:11 +00:00
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"static char*\n"
|
|
|
|
"global_key_name(int key_code, int *size){\n"
|
|
|
|
"char *result = 0;\n"
|
|
|
|
"switch(key_code){\n"
|
|
|
|
);
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
fprintf(file,
|
|
|
|
"case key_%s: result = \"%s\"; *size = sizeof(\"%s\")-1; break;\n",
|
|
|
|
keys_that_need_codes[i],
|
|
|
|
keys_that_need_codes[i],
|
|
|
|
keys_that_need_codes[i]
|
|
|
|
);
|
|
|
|
}
|
|
|
|
fprintf(file,
|
|
|
|
"}\n"
|
|
|
|
"return(result);\n"
|
|
|
|
"}\n"
|
|
|
|
);
|
|
|
|
|
2016-02-25 23:52:11 +00:00
|
|
|
fclose(file);
|
2016-02-27 17:34:13 +00:00
|
|
|
return(filename);
|
|
|
|
}
|
|
|
|
|
2016-03-04 23:10:00 +00:00
|
|
|
//////////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
char* bar_style_fields[] = {
|
|
|
|
"bar",
|
|
|
|
"bar_active",
|
|
|
|
"base",
|
|
|
|
"pop1",
|
|
|
|
"pop2",
|
|
|
|
};
|
|
|
|
|
|
|
|
char* main_style_fields[] = {
|
|
|
|
"back",
|
2016-06-07 18:52:40 +00:00
|
|
|
"margin",
|
|
|
|
"margin_hover",
|
|
|
|
"margin_active",
|
|
|
|
"cursor",
|
|
|
|
"at_cursor",
|
|
|
|
"highlight",
|
|
|
|
"at_highlight",
|
|
|
|
"mark",
|
|
|
|
"default",
|
|
|
|
"comment",
|
|
|
|
"keyword",
|
|
|
|
"str_constant",
|
|
|
|
"char_constant",
|
|
|
|
"int_constant",
|
|
|
|
"float_constant",
|
|
|
|
"bool_constant",
|
2016-03-04 23:10:00 +00:00
|
|
|
"preproc",
|
2016-06-07 18:52:40 +00:00
|
|
|
"include",
|
|
|
|
"special_character",
|
|
|
|
"highlight_junk",
|
|
|
|
"highlight_white",
|
2016-03-04 23:10:00 +00:00
|
|
|
"paste",
|
|
|
|
"undo",
|
|
|
|
"next_undo",
|
|
|
|
};
|
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
static char*
|
|
|
|
make_style_tag(char *tag){
|
|
|
|
char *str;
|
|
|
|
int len;
|
2016-03-04 23:10:00 +00:00
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
len = (int)strlen(tag);
|
|
|
|
str = (char*)malloc(len + 1);
|
|
|
|
to_camel(tag, str);
|
|
|
|
str[len] = 0;
|
2016-06-07 18:52:40 +00:00
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
return(str);
|
2016-03-04 23:10:00 +00:00
|
|
|
}
|
|
|
|
|
2016-03-05 04:10:55 +00:00
|
|
|
char style_index_function_start[] =
|
|
|
|
"inline u32*\n"
|
|
|
|
"style_index_by_tag(Style_Main_Data *s, u32 tag){\n"
|
|
|
|
" u32 *result = 0;\n"
|
|
|
|
" switch (tag){\n";
|
|
|
|
|
|
|
|
char style_index_function_end[] =
|
|
|
|
" }\n"
|
|
|
|
" return(result);\n"
|
|
|
|
"}\n\n";
|
|
|
|
|
|
|
|
char style_case[] = " case Stag_%s: result = &s->%s_color; break;\n";
|
|
|
|
char style_info_case[] = " case Stag_%s: result = &s->file_info_style.%s_color; break;\n";
|
|
|
|
|
2016-03-04 23:10:00 +00:00
|
|
|
char* generate_style(){
|
|
|
|
char *filename = "4coder_style.h & 4ed_style.h";
|
|
|
|
char filename_4coder[] = "4coder_style.h";
|
|
|
|
char filename_4ed[] = "4ed_style.h";
|
|
|
|
FILE *file;
|
2016-03-05 04:10:55 +00:00
|
|
|
char *tag;
|
2016-03-04 23:10:00 +00:00
|
|
|
int count, i;
|
2016-06-07 18:52:40 +00:00
|
|
|
|
2016-03-04 23:10:00 +00:00
|
|
|
file = fopen(filename_4coder, "wb");
|
|
|
|
enum_begin(file, "Style_Tag");
|
|
|
|
{
|
|
|
|
count = ArrayCount(bar_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
2016-03-05 04:10:55 +00:00
|
|
|
tag = make_style_tag(bar_style_fields[i]);
|
|
|
|
fprintf(file, "Stag_%s,\n", tag);
|
|
|
|
free(tag);
|
2016-03-04 23:10:00 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
count = ArrayCount(main_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
2016-03-05 04:10:55 +00:00
|
|
|
tag = make_style_tag(main_style_fields[i]);
|
|
|
|
fprintf(file, "Stag_%s,\n", tag);
|
|
|
|
free(tag);
|
2016-03-04 23:10:00 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
struct_end(file);
|
|
|
|
fclose(file);
|
|
|
|
|
|
|
|
file = fopen(filename_4ed, "wb");
|
|
|
|
struct_begin(file, "Interactive_Style");
|
|
|
|
{
|
|
|
|
count = ArrayCount(bar_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
fprintf(file, "u32 %s_color;\n", bar_style_fields[i]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
struct_end(file);
|
|
|
|
|
|
|
|
struct_begin(file, "Style_Main_Data");
|
|
|
|
{
|
|
|
|
count = ArrayCount(main_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
fprintf(file, "u32 %s_color;\n", main_style_fields[i]);
|
|
|
|
}
|
|
|
|
fprintf(file, "Interactive_Style file_info_style;\n");
|
|
|
|
}
|
|
|
|
struct_end(file);
|
2016-03-05 04:10:55 +00:00
|
|
|
|
|
|
|
{
|
|
|
|
fprintf(file, "%s", style_index_function_start);
|
|
|
|
count = ArrayCount(bar_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
tag = make_style_tag(bar_style_fields[i]);
|
|
|
|
fprintf(file, style_info_case, tag, bar_style_fields[i]);
|
|
|
|
free(tag);
|
|
|
|
}
|
|
|
|
|
|
|
|
count = ArrayCount(main_style_fields);
|
|
|
|
for (i = 0; i < count; ++i){
|
|
|
|
tag = make_style_tag(main_style_fields[i]);
|
|
|
|
fprintf(file, style_case, tag, main_style_fields[i]);
|
|
|
|
free(tag);
|
|
|
|
}
|
|
|
|
fprintf(file, "%s", style_index_function_end);
|
|
|
|
}
|
|
|
|
|
2016-03-04 23:10:00 +00:00
|
|
|
fclose(file);
|
|
|
|
|
|
|
|
return(filename);
|
|
|
|
}
|
2016-03-04 06:06:11 +00:00
|
|
|
|
2016-05-29 19:54:20 +00:00
|
|
|
//////////////////////////////////////////////////////////////////////////////////////////////////
|
2016-06-27 19:45:15 +00:00
|
|
|
typedef struct Argument_Breakdown{
|
|
|
|
int count;
|
|
|
|
String *param_string;
|
|
|
|
String *param_name;
|
|
|
|
} Argument_Breakdown;
|
|
|
|
|
|
|
|
typedef struct Documentation{
|
|
|
|
int param_count;
|
|
|
|
String *param_name;
|
|
|
|
String *param_docs;
|
|
|
|
String return_doc;
|
|
|
|
String main_doc;
|
|
|
|
int see_also_count;
|
|
|
|
String *see_also;
|
|
|
|
} Documentation;
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
struct App_API{
|
|
|
|
String *macros;
|
|
|
|
String *public_name;
|
|
|
|
};
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
struct Function_Set{
|
2016-06-24 19:33:37 +00:00
|
|
|
String *name;
|
|
|
|
String *ret;
|
|
|
|
String *args;
|
2016-07-06 19:18:10 +00:00
|
|
|
String *body;
|
|
|
|
String *marker;
|
2016-06-24 19:33:37 +00:00
|
|
|
|
2016-06-27 14:25:17 +00:00
|
|
|
String *doc_string;
|
2016-06-24 19:33:37 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
int *is_macro;
|
2016-06-24 19:33:37 +00:00
|
|
|
int *valid;
|
2016-06-27 19:45:15 +00:00
|
|
|
|
|
|
|
Argument_Breakdown *breakdown;
|
|
|
|
Documentation *doc;
|
2016-07-01 05:42:19 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct Typedef_Set{
|
|
|
|
String *type;
|
|
|
|
String *name;
|
|
|
|
String *doc_string;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Struct_Member{
|
|
|
|
String name;
|
|
|
|
String type;
|
|
|
|
String type_postfix;
|
|
|
|
String doc_string;
|
|
|
|
Struct_Member *first_child;
|
|
|
|
Struct_Member *next_sibling;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Struct_Set{
|
|
|
|
Struct_Member *structs;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Enum_Member{
|
|
|
|
String name;
|
|
|
|
String value;
|
|
|
|
String doc_string;
|
|
|
|
Enum_Member *next;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Enum_Set{
|
|
|
|
String *name;
|
|
|
|
String *type;
|
|
|
|
Enum_Member **first_member;
|
|
|
|
String *doc_string;
|
|
|
|
};
|
2016-05-25 22:43:58 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
void
|
|
|
|
zero_index(Function_Set fnc_set, int sig_count){
|
|
|
|
fnc_set.name [sig_count] = string_zero();
|
|
|
|
fnc_set.ret [sig_count] = string_zero();
|
|
|
|
fnc_set.args [sig_count] = string_zero();
|
|
|
|
fnc_set.valid[sig_count] = 0;
|
|
|
|
}
|
|
|
|
|
2016-05-25 22:43:58 +00:00
|
|
|
String
|
|
|
|
file_dump(char *filename){
|
|
|
|
String result = {0};
|
|
|
|
FILE *file = fopen(filename, "rb");
|
|
|
|
|
|
|
|
if (file){
|
|
|
|
fseek(file, 0, SEEK_END);
|
|
|
|
result.size = ftell(file);
|
|
|
|
fseek(file, 0, SEEK_SET);
|
|
|
|
|
|
|
|
result.memory_size = result.size + 1;
|
|
|
|
result.str = (char*)malloc(result.memory_size);
|
|
|
|
|
|
|
|
fread(result.str, 1, result.size, file);
|
|
|
|
result.str[result.size] = 0;
|
|
|
|
|
|
|
|
fclose(file);
|
|
|
|
}
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
String
|
|
|
|
get_first_line(String source){
|
|
|
|
String line = {0};
|
|
|
|
int pos = find(source, 0, '\n');
|
|
|
|
|
|
|
|
line = substr(source, 0, pos);
|
|
|
|
|
|
|
|
return(line);
|
|
|
|
}
|
|
|
|
|
|
|
|
String
|
|
|
|
get_next_line(String source, String line){
|
|
|
|
String next = {0};
|
|
|
|
int pos = (int)(line.str - source.str) + line.size;
|
|
|
|
int start = 0;
|
|
|
|
|
|
|
|
if (pos < source.size){
|
|
|
|
assert(source.str[pos] == '\n');
|
|
|
|
start = pos + 1;
|
|
|
|
|
|
|
|
if (start < source.size){
|
|
|
|
pos = find(source, start, '\n');
|
|
|
|
next = substr(source, start, pos - start);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return(next);
|
|
|
|
}
|
|
|
|
|
|
|
|
int
|
|
|
|
is_comment(String str){
|
|
|
|
int result = 0;
|
|
|
|
if (str.size >= 2){
|
|
|
|
if (str.str[0] == '/' &&
|
|
|
|
str.str[1] == '/'){
|
|
|
|
result = 1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
2016-06-27 15:52:58 +00:00
|
|
|
struct Parse{
|
2016-06-24 19:33:37 +00:00
|
|
|
Cpp_Token_Stack tokens;
|
|
|
|
};
|
|
|
|
|
|
|
|
int
|
|
|
|
check_and_fix_docs(String *lexeme){
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
if (lexeme->size > 4){
|
|
|
|
if (lexeme->str[0] == '/'){
|
|
|
|
if (lexeme->str[1] == '*'){
|
|
|
|
if (lexeme->str[lexeme->size - 2] == '*'){
|
|
|
|
if (lexeme->str[lexeme->size - 1] == '/'){
|
|
|
|
result = true;
|
|
|
|
lexeme->str += 2;
|
|
|
|
lexeme->size -= 4;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
2016-06-27 19:45:15 +00:00
|
|
|
enum Doc_Note_Type{
|
|
|
|
DOC_PARAM,
|
|
|
|
DOC_RETURN,
|
|
|
|
DOC,
|
|
|
|
DOC_SEE
|
|
|
|
};
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
static String
|
|
|
|
doc_note_string[] = {
|
|
|
|
make_lit_string("DOC_PARAM"),
|
|
|
|
make_lit_string("DOC_RETURN"),
|
|
|
|
make_lit_string("DOC"),
|
|
|
|
make_lit_string("DOC_SEE"),
|
|
|
|
};
|
|
|
|
|
2016-06-27 14:25:17 +00:00
|
|
|
String
|
2016-06-27 19:45:15 +00:00
|
|
|
doc_parse_note(String source, int *pos){
|
|
|
|
String result = {0};
|
|
|
|
|
|
|
|
int p = *pos;
|
|
|
|
int start = p;
|
|
|
|
for (; p < source.size; ++p){
|
|
|
|
if (source.str[p] == '('){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (p != source.size){
|
|
|
|
result = make_string(source.str + start, p - start);
|
|
|
|
result = skip_chop_whitespace(result);
|
|
|
|
}
|
|
|
|
*pos = p;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
String
|
|
|
|
doc_parse_note_string(String source, int *pos){
|
2016-06-27 14:25:17 +00:00
|
|
|
String result = {0};
|
2016-06-27 19:45:15 +00:00
|
|
|
|
|
|
|
assert(source.str[*pos] == '(');
|
|
|
|
|
|
|
|
int p = *pos + 1;
|
|
|
|
int start = p;
|
|
|
|
|
|
|
|
int nest_level = 0;
|
|
|
|
|
|
|
|
for (; p < source.size; ++p){
|
|
|
|
if (source.str[p] == ')'){
|
|
|
|
if (nest_level == 0){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
--nest_level;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (source.str[p] == '('){
|
|
|
|
++nest_level;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (p != source.size){
|
|
|
|
result = make_string(source.str + start, p - start);
|
|
|
|
result = skip_chop_whitespace(result);
|
|
|
|
++p;
|
|
|
|
}
|
|
|
|
*pos = p;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
String
|
|
|
|
doc_parse_parameter(String source, int *pos){
|
|
|
|
String result = {0};
|
|
|
|
|
|
|
|
int p = *pos;
|
|
|
|
int start = p;
|
|
|
|
|
|
|
|
for (; p < source.size; ++p){
|
|
|
|
if (source.str[p] == ','){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (p != source.size){
|
|
|
|
result = make_string(source.str + start, p - start);
|
|
|
|
result = skip_chop_whitespace(result);
|
|
|
|
++p;
|
|
|
|
}
|
|
|
|
*pos = p;
|
|
|
|
|
2016-06-27 14:25:17 +00:00
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
2016-06-27 19:45:15 +00:00
|
|
|
String
|
|
|
|
doc_parse_last_parameter(String source, int *pos){
|
|
|
|
String result = {0};
|
|
|
|
|
|
|
|
int p = *pos;
|
|
|
|
int start = p;
|
|
|
|
|
|
|
|
for (; p < source.size; ++p){
|
|
|
|
if (source.str[p] == ')'){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (p == source.size){
|
|
|
|
result = make_string(source.str + start, p - start);
|
|
|
|
result = skip_chop_whitespace(result);
|
|
|
|
}
|
|
|
|
*pos = p;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
void
|
2016-07-02 14:15:15 +00:00
|
|
|
perform_doc_parse(Partition *part, String doc_string, Documentation *doc){
|
2016-06-24 19:33:37 +00:00
|
|
|
int keep_parsing = true;
|
|
|
|
int pos = 0;
|
|
|
|
|
2016-06-27 19:45:15 +00:00
|
|
|
int param_count = 0;
|
|
|
|
int see_count = 0;
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
do{
|
2016-06-27 19:45:15 +00:00
|
|
|
String doc_note = doc_parse_note(doc_string, &pos);
|
2016-06-24 19:33:37 +00:00
|
|
|
if (doc_note.size == 0){
|
|
|
|
keep_parsing = false;
|
|
|
|
}
|
|
|
|
else{
|
2016-06-27 14:25:17 +00:00
|
|
|
int doc_note_type;
|
|
|
|
if (string_set_match(doc_note_string, ArrayCount(doc_note_string), doc_note, &doc_note_type)){
|
2016-06-27 19:45:15 +00:00
|
|
|
|
|
|
|
doc_parse_note_string(doc_string, &pos);
|
|
|
|
|
|
|
|
switch (doc_note_type){
|
|
|
|
case DOC_PARAM:
|
|
|
|
++param_count;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case DOC_SEE:
|
|
|
|
++see_count;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}while(keep_parsing);
|
|
|
|
|
|
|
|
if (param_count + see_count > 0){
|
|
|
|
int memory_size = sizeof(String)*(2*param_count + see_count);
|
2016-07-02 14:15:15 +00:00
|
|
|
doc->param_name = push_array(part, String, memory_size);
|
2016-06-27 19:45:15 +00:00
|
|
|
doc->param_docs = doc->param_name + param_count;
|
|
|
|
doc->see_also = doc->param_docs + param_count;
|
|
|
|
|
|
|
|
doc->param_count = param_count;
|
|
|
|
doc->see_also_count = see_count;
|
|
|
|
}
|
|
|
|
|
|
|
|
int param_index = 0;
|
|
|
|
int see_index = 0;
|
|
|
|
|
|
|
|
keep_parsing = true;
|
|
|
|
pos = 0;
|
|
|
|
do{
|
|
|
|
String doc_note = doc_parse_note(doc_string, &pos);
|
|
|
|
if (doc_note.size == 0){
|
|
|
|
keep_parsing = false;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
int doc_note_type;
|
|
|
|
if (string_set_match(doc_note_string, ArrayCount(doc_note_string), doc_note, &doc_note_type)){
|
|
|
|
|
|
|
|
String doc_note_string = doc_parse_note_string(doc_string, &pos);
|
|
|
|
|
|
|
|
switch (doc_note_type){
|
|
|
|
case DOC_PARAM:
|
|
|
|
{
|
|
|
|
assert(param_index < param_count);
|
|
|
|
int param_pos = 0;
|
|
|
|
String param_name = doc_parse_parameter(doc_note_string, ¶m_pos);
|
|
|
|
String param_docs = doc_parse_last_parameter(doc_note_string, ¶m_pos);
|
|
|
|
doc->param_name[param_index] = param_name;
|
|
|
|
doc->param_docs[param_index] = param_docs;
|
|
|
|
++param_index;
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case DOC_RETURN:
|
|
|
|
{
|
|
|
|
doc->return_doc = doc_note_string;
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case DOC:
|
|
|
|
{
|
|
|
|
doc->main_doc = doc_note_string;
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case DOC_SEE:
|
|
|
|
{
|
|
|
|
assert(see_index < see_count);
|
|
|
|
doc->see_also[see_index++] = doc_note_string;
|
|
|
|
}break;
|
|
|
|
}
|
2016-06-24 19:33:37 +00:00
|
|
|
}
|
|
|
|
else{
|
2016-06-29 17:16:08 +00:00
|
|
|
fprintf(stderr, "warning: invalid doc note %.*s\n", doc_note.size, doc_note.str);
|
2016-06-24 19:33:37 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}while(keep_parsing);
|
|
|
|
}
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
static int
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(char *data, Cpp_Token *tokens, int i,
|
2016-07-01 05:42:19 +00:00
|
|
|
String *doc_string){
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
if (i > 0){
|
|
|
|
Cpp_Token *prev_token = tokens + i - 1;
|
|
|
|
if (prev_token->type == CPP_TOKEN_COMMENT){
|
2016-07-16 18:40:26 +00:00
|
|
|
*doc_string = make_string(data + prev_token->start, prev_token->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
if (check_and_fix_docs(doc_string)){
|
|
|
|
result = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
parse_struct(Partition *part, int is_struct,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Cpp_Token *tokens, int count,
|
2016-07-01 05:42:19 +00:00
|
|
|
Cpp_Token **token_ptr,
|
|
|
|
Struct_Member *top_member);
|
|
|
|
|
|
|
|
static int
|
|
|
|
parse_struct_member(Partition *part,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Cpp_Token *tokens, int count,
|
2016-07-01 05:42:19 +00:00
|
|
|
Cpp_Token **token_ptr,
|
|
|
|
Struct_Member *member){
|
|
|
|
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
int i = (int)(token - tokens);
|
|
|
|
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
|
|
|
int start_i = i;
|
|
|
|
Cpp_Token *start_token = token;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_SEMICOLON){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *token_j = token;
|
|
|
|
|
|
|
|
int nest_level = 0;
|
|
|
|
for (int j = i; j > start_i; --j, --token_j){
|
|
|
|
if (token_j->type == CPP_TOKEN_BRACKET_CLOSE){
|
|
|
|
++nest_level;
|
|
|
|
}
|
|
|
|
else if (token_j->type == CPP_TOKEN_BRACKET_OPEN){
|
|
|
|
--nest_level;
|
|
|
|
if (nest_level < 0){
|
|
|
|
j = start_i;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (nest_level == 0){
|
|
|
|
if (token_j->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String name = make_string(data + token_j->start, token_j->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
name = skip_chop_whitespace(name);
|
|
|
|
|
|
|
|
int type_start = start_token->start;
|
|
|
|
int type_end = token_j->start;
|
2016-07-16 18:40:26 +00:00
|
|
|
String type = make_string(data + type_start, type_end - type_start);
|
2016-07-01 05:42:19 +00:00
|
|
|
type = skip_chop_whitespace(type);
|
|
|
|
|
|
|
|
type_start = token_j->start + token_j->size;
|
|
|
|
type_end = token->start;
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String type_postfix = make_string(data + type_start, type_end - type_start);
|
2016-07-01 05:42:19 +00:00
|
|
|
type_postfix = skip_chop_whitespace(type_postfix);
|
|
|
|
|
|
|
|
++token;
|
|
|
|
result = true;
|
|
|
|
|
|
|
|
member->name = name;
|
|
|
|
member->type = type;
|
|
|
|
member->type_postfix = type_postfix;
|
|
|
|
member->doc_string = doc_string;
|
|
|
|
member->first_child = 0;
|
|
|
|
member->next_sibling = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static Struct_Member*
|
|
|
|
parse_struct_next_member(Partition *part,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Cpp_Token *tokens, int count,
|
2016-07-01 05:42:19 +00:00
|
|
|
Cpp_Token **token_ptr){
|
|
|
|
Struct_Member *result = 0;
|
|
|
|
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
int i = (int)(token - tokens);
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER ||
|
|
|
|
(token->flags & CPP_TFLAG_IS_KEYWORD)){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
|
|
|
if (match(lexeme, make_lit_string("struct"))){
|
|
|
|
Struct_Member *member = push_struct(part, Struct_Member);
|
2016-07-16 18:40:26 +00:00
|
|
|
if (parse_struct(part, true, data, tokens, count, &token, member)){
|
2016-07-01 05:42:19 +00:00
|
|
|
result = member;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
assert(!"unhandled error");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (match(lexeme, make_lit_string("union"))){
|
|
|
|
Struct_Member *member = push_struct(part, Struct_Member);
|
2016-07-16 18:40:26 +00:00
|
|
|
if (parse_struct(part, false, data, tokens, count, &token, member)){
|
2016-07-01 05:42:19 +00:00
|
|
|
result = member;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
assert(!"unhandled error");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
Struct_Member *member = push_struct(part, Struct_Member);
|
2016-07-16 18:40:26 +00:00
|
|
|
if (parse_struct_member(part, data, tokens, count, &token, member)){
|
2016-07-01 05:42:19 +00:00
|
|
|
result = member;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
assert(!"unhandled error");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_BRACE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
parse_struct(Partition *part, int is_struct,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Cpp_Token *tokens, int count,
|
2016-07-01 05:42:19 +00:00
|
|
|
Cpp_Token **token_ptr,
|
|
|
|
Struct_Member *top_member){
|
|
|
|
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
int i = (int)(token - tokens);
|
|
|
|
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
|
|
|
int start_i = i;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_BRACE_OPEN){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *token_j = token;
|
|
|
|
int j = i;
|
|
|
|
|
|
|
|
for (; j > start_i; --j, --token_j){
|
|
|
|
if (token_j->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
String name = {0};
|
|
|
|
|
|
|
|
if (j != start_i){
|
2016-07-16 18:40:26 +00:00
|
|
|
name = make_string(data + token_j->start, token_j->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
name = skip_chop_whitespace(name);
|
|
|
|
}
|
|
|
|
|
|
|
|
String type = {0};
|
|
|
|
if (is_struct){
|
|
|
|
type = make_lit_string("struct");
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
type = make_lit_string("union");
|
|
|
|
}
|
|
|
|
|
|
|
|
++token;
|
|
|
|
Struct_Member *new_member =
|
2016-07-16 18:40:26 +00:00
|
|
|
parse_struct_next_member(part, data, tokens, count, &token);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
|
|
|
if (new_member){
|
|
|
|
top_member->first_child = new_member;
|
|
|
|
|
|
|
|
Struct_Member *head_member = new_member;
|
|
|
|
for(;;){
|
|
|
|
new_member =
|
2016-07-16 18:40:26 +00:00
|
|
|
parse_struct_next_member(part, data, tokens, count, &token);
|
2016-07-01 05:42:19 +00:00
|
|
|
if (new_member){
|
|
|
|
head_member->next_sibling = new_member;
|
|
|
|
head_member = new_member;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
i = (int)(token - tokens);
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_SEMICOLON){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
++token;
|
|
|
|
|
|
|
|
top_member->name = name;
|
|
|
|
top_member->type = type;
|
|
|
|
top_member->doc_string = doc_string;
|
|
|
|
top_member->next_sibling = 0;
|
|
|
|
|
|
|
|
result = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_struct_html(FILE *file, Struct_Member *member){
|
|
|
|
String name = member->name;
|
|
|
|
String type = member->type;
|
|
|
|
String type_postfix = member->type_postfix;
|
|
|
|
|
|
|
|
if (match(type, make_lit_string("struct")) ||
|
|
|
|
match(type, make_lit_string("union"))){
|
|
|
|
fprintf(file,
|
|
|
|
"%.*s %.*s {<br>\n"
|
|
|
|
"<div style='margin-left: 8mm;'>\n",
|
|
|
|
type.size, type.str,
|
|
|
|
name.size, name.str);
|
|
|
|
|
|
|
|
for (Struct_Member *member_iter = member->first_child;
|
|
|
|
member_iter != 0;
|
|
|
|
member_iter = member_iter->next_sibling){
|
|
|
|
print_struct_html(file, member_iter);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"</div>\n"
|
|
|
|
"};<br>\n");
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
fprintf(file,
|
|
|
|
"%.*s %.*s%.*s;<br>\n",
|
|
|
|
type.size, type.str,
|
|
|
|
name.size, name.str,
|
|
|
|
type_postfix.size, type_postfix.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
static void
|
|
|
|
print_function_html(FILE *file, Function_Set function_set, int i, String name,
|
|
|
|
char *function_call_head){
|
|
|
|
String ret = function_set.ret[i];
|
|
|
|
fprintf(file,
|
|
|
|
"%.*s %s%.*s(\n"
|
|
|
|
"<div style='margin-left: 4mm;'>",
|
|
|
|
ret.size, ret.str,
|
|
|
|
function_call_head,
|
|
|
|
name.size, name.str);
|
|
|
|
|
|
|
|
Argument_Breakdown *breakdown = &function_set.breakdown[i];
|
|
|
|
int arg_count = breakdown->count;
|
|
|
|
for (int j = 0; j < arg_count; ++j){
|
|
|
|
String param_string = breakdown->param_string[j];
|
|
|
|
if (j < arg_count - 1){
|
|
|
|
fprintf(file, "%.*s,<br>", param_string.size, param_string.str);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
fprintf(file, "%.*s<br>", param_string.size, param_string.str);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>)\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_macro_html(FILE *file, Function_Set function_set, int i, String name){
|
|
|
|
Argument_Breakdown *breakdown = &function_set.breakdown[i];
|
|
|
|
int arg_count = breakdown->count;
|
|
|
|
if (arg_count == 0){
|
|
|
|
fprintf(file,
|
|
|
|
"#define %.*s()",
|
|
|
|
name.size, name.str);
|
|
|
|
}
|
|
|
|
else if (arg_count == 1){
|
|
|
|
String param_string = breakdown->param_string[0];
|
|
|
|
fprintf(file,
|
|
|
|
"#define %.*s(%.*s)",
|
|
|
|
name.size, name.str,
|
|
|
|
param_string.size, param_string.str);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
fprintf(file,
|
|
|
|
"#define %.*s(\n"
|
|
|
|
"<div style='margin-left: 4mm;'>",
|
|
|
|
name.size, name.str);
|
|
|
|
|
|
|
|
for (int j = 0; j < arg_count; ++j){
|
|
|
|
String param_string = breakdown->param_string[j];
|
|
|
|
if (j < arg_count - 1){
|
|
|
|
fprintf(file, "%.*s,<br>", param_string.size, param_string.str);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
fprintf(file, "%.*s<br>", param_string.size, param_string.str);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>)\n");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
#define BACK_COLOR "#FAFAFA"
|
|
|
|
#define TEXT_COLOR "#0D0D0D"
|
|
|
|
#define CODE_BACK "#DFDFDF"
|
|
|
|
|
|
|
|
#define POP_COLOR_1 "#309030"
|
|
|
|
#define POP_BACK_1 "#E0FFD0"
|
|
|
|
#define VISITED_LINK "#A0C050"
|
|
|
|
|
|
|
|
#define POP_COLOR_2 "#005000"
|
|
|
|
|
|
|
|
#define CODE_STYLE "font-family: \"Courier New\", Courier, monospace; text-align: left;"
|
|
|
|
|
|
|
|
#define DESCRIPT_SECTION_STYLE \
|
|
|
|
"margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; " \
|
|
|
|
"background: "CODE_BACK"; padding: 0.25em;"
|
|
|
|
|
|
|
|
#define DOC_HEAD_OPEN "<div style='margin-top: 3mm; margin-bottom: 3mm; color: "POP_COLOR_1";'><b><i>"
|
|
|
|
#define DOC_HEAD_CLOSE "</i></b></div>"
|
|
|
|
|
|
|
|
#define DOC_ITEM_HEAD_STYLE "font-weight: 600;"
|
|
|
|
|
|
|
|
#define DOC_ITEM_HEAD_INL_OPEN "<span style='"DOC_ITEM_HEAD_STYLE"'>"
|
|
|
|
#define DOC_ITEM_HEAD_INL_CLOSE "</span>"
|
|
|
|
|
|
|
|
#define DOC_ITEM_HEAD_OPEN "<div style='"DOC_ITEM_HEAD_STYLE"'>"
|
|
|
|
#define DOC_ITEM_HEAD_CLOSE "</div>"
|
|
|
|
|
|
|
|
#define DOC_ITEM_OPEN "<div style='margin-left: 5mm; margin-right: 5mm;'>"
|
|
|
|
#define DOC_ITEM_CLOSE "</div>"
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_struct_docs(FILE *file, Partition *part, Struct_Member *member){
|
|
|
|
for (Struct_Member *member_iter = member->first_child;
|
|
|
|
member_iter != 0;
|
|
|
|
member_iter = member_iter->next_sibling){
|
|
|
|
String type = member_iter->type;
|
|
|
|
if (match(type, make_lit_string("struct")) ||
|
|
|
|
match(type, make_lit_string("union"))){
|
|
|
|
print_struct_docs(file, part, member_iter);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, member_iter->doc_string, &doc);
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<div>\n"
|
|
|
|
"<div style='"CODE_STYLE"'>"DOC_ITEM_HEAD_INL_OPEN
|
|
|
|
"%.*s"DOC_ITEM_HEAD_INL_CLOSE"</div>\n"
|
|
|
|
"<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
|
|
|
|
"</div>\n",
|
|
|
|
member_iter->name.size, member_iter->name.str,
|
|
|
|
doc.main_doc.size, doc.main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_see_also(FILE *file, Documentation *doc){
|
|
|
|
int doc_see_count = doc->see_also_count;
|
|
|
|
if (doc_see_count > 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"See Also"DOC_HEAD_CLOSE);
|
|
|
|
|
|
|
|
for (int j = 0; j < doc_see_count; ++j){
|
|
|
|
String see_also = doc->see_also[j];
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"<a href='#%.*s_doc'>%.*s</a>"DOC_ITEM_CLOSE,
|
|
|
|
see_also.size, see_also.str,
|
|
|
|
see_also.size, see_also.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
static int
|
2016-07-16 18:40:26 +00:00
|
|
|
parse_enum(Partition *part, char *data,
|
2016-07-01 05:42:19 +00:00
|
|
|
Cpp_Token *tokens, int count,
|
|
|
|
Cpp_Token **token_ptr, int start_i,
|
|
|
|
Enum_Set flag_set, int flag_index){
|
|
|
|
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
int i = (int)(token - tokens);
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *token_j = token;
|
|
|
|
|
|
|
|
for (int j = i; j > start_i; --j, --token_j){
|
|
|
|
if (token_j->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String name = make_string(data + token_j->start, token_j->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
name = skip_chop_whitespace(name);
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_BRACE_OPEN){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
Enum_Member *first_member = 0;
|
|
|
|
Enum_Member *head_member = 0;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_BRACE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String name = make_string(data + token->start, token->size);
|
2016-07-01 05:42:19 +00:00
|
|
|
name = skip_chop_whitespace(name);
|
|
|
|
|
|
|
|
String value = {0};
|
|
|
|
|
|
|
|
++i;
|
|
|
|
++token;
|
|
|
|
|
|
|
|
if (token->type == CPP_TOKEN_EQ){
|
|
|
|
Cpp_Token *start_token = token;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_COMMA ||
|
|
|
|
token->type == CPP_TOKEN_BRACE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
int val_start = start_token->start + start_token->size;
|
|
|
|
int val_end = token->start;
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
value = make_string(data + val_start, val_end - val_start);
|
2016-07-01 05:42:19 +00:00
|
|
|
value = skip_chop_whitespace(value);
|
|
|
|
|
|
|
|
--i;
|
|
|
|
--token;
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
--i;
|
|
|
|
--token;
|
|
|
|
}
|
|
|
|
|
|
|
|
Enum_Member *new_member = push_struct(part, Enum_Member);
|
|
|
|
if (first_member == 0){
|
|
|
|
first_member = new_member;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (head_member){
|
|
|
|
head_member->next = new_member;
|
|
|
|
}
|
|
|
|
head_member = new_member;
|
|
|
|
|
|
|
|
new_member->name = name;
|
|
|
|
new_member->value = value;
|
|
|
|
new_member->doc_string = doc_string;
|
|
|
|
new_member->next = 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_BRACE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
++i;
|
|
|
|
++token;
|
|
|
|
|
|
|
|
result = true;
|
|
|
|
flag_set.name[flag_index] = name;
|
|
|
|
flag_set.first_member[flag_index] = first_member;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
static App_API
|
|
|
|
allocate_app_api(int count){
|
|
|
|
App_API app_api = {0};
|
|
|
|
int memory_size = (sizeof(String)*2)*count;
|
|
|
|
app_api.macros = (String*)malloc(memory_size);
|
|
|
|
app_api.public_name = app_api.macros + count;
|
|
|
|
memset(app_api.macros, 0, memory_size);
|
|
|
|
return(app_api);
|
|
|
|
}
|
|
|
|
|
|
|
|
static Function_Set
|
|
|
|
allocate_function_set(int count){
|
|
|
|
Function_Set function_set = {0};
|
|
|
|
int memory_size = (sizeof(String)*6 +
|
|
|
|
sizeof(int)*2 +
|
|
|
|
sizeof(Argument_Breakdown) +
|
|
|
|
sizeof(Documentation))*count;
|
2016-06-24 19:33:37 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.name = (String*)malloc(memory_size);
|
|
|
|
function_set.ret = function_set.name + count;
|
|
|
|
function_set.args = function_set.ret + count;
|
|
|
|
function_set.body = function_set.args + count;
|
|
|
|
function_set.marker = function_set.body + count;
|
|
|
|
function_set.doc_string = function_set.marker + count;
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.is_macro = (int*)(function_set.doc_string + count);
|
|
|
|
function_set.valid = function_set.is_macro + count;
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.breakdown = (Argument_Breakdown*)(function_set.valid + count);
|
2016-06-24 19:33:37 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.doc = (Documentation*)(function_set.breakdown + count);
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
memset(function_set.name, 0, memory_size);
|
|
|
|
return(function_set);
|
|
|
|
}
|
|
|
|
|
|
|
|
static Argument_Breakdown
|
|
|
|
allocate_argument_breakdown(int count){
|
|
|
|
Argument_Breakdown breakdown = {0};
|
|
|
|
int memory_size = (sizeof(String)*2)*count;
|
|
|
|
breakdown.count = count;
|
|
|
|
breakdown.param_string = (String*)malloc(memory_size);
|
|
|
|
breakdown.param_name = breakdown.param_string + count;
|
|
|
|
memset(breakdown.param_string, 0, memory_size);
|
|
|
|
return(breakdown);
|
|
|
|
}
|
|
|
|
|
|
|
|
static Argument_Breakdown
|
2016-07-16 18:40:26 +00:00
|
|
|
do_parameter_parse(char *data, Cpp_Token *args_start_token, Cpp_Token *token){
|
2016-07-06 19:18:10 +00:00
|
|
|
int arg_index = 0;
|
|
|
|
Cpp_Token *arg_token = args_start_token + 1;
|
|
|
|
int param_string_start = arg_token->start;
|
|
|
|
|
|
|
|
int arg_count = 1;
|
|
|
|
arg_token = args_start_token;
|
|
|
|
for (; arg_token < token; ++arg_token){
|
|
|
|
if (arg_token->type == CPP_TOKEN_COMMA){
|
|
|
|
++arg_count;
|
|
|
|
}
|
|
|
|
}
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
Argument_Breakdown breakdown = allocate_argument_breakdown(arg_count);
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
arg_token = args_start_token + 1;
|
|
|
|
for (; arg_token <= token; ++arg_token){
|
|
|
|
if (arg_token->type == CPP_TOKEN_COMMA ||
|
|
|
|
arg_token->type == CPP_TOKEN_PARENTHESE_CLOSE){
|
|
|
|
|
|
|
|
int size = arg_token->start - param_string_start;
|
2016-07-16 18:40:26 +00:00
|
|
|
String param_string = make_string(data + param_string_start, size);
|
2016-07-06 19:18:10 +00:00
|
|
|
param_string = chop_whitespace(param_string);
|
|
|
|
breakdown.param_string[arg_index] = param_string;
|
|
|
|
|
|
|
|
for (Cpp_Token *param_name_token = arg_token - 1;
|
|
|
|
param_name_token->start > param_string_start;
|
|
|
|
--param_name_token){
|
|
|
|
if (param_name_token->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
int start = param_name_token->start;
|
|
|
|
int size = param_name_token->size;
|
2016-07-16 18:40:26 +00:00
|
|
|
breakdown.param_name[arg_index] = make_string(data + start, size);
|
2016-07-06 19:18:10 +00:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
++arg_index;
|
|
|
|
|
|
|
|
++arg_token;
|
|
|
|
if (arg_token <= token){
|
|
|
|
param_string_start = arg_token->start;
|
|
|
|
}
|
|
|
|
--arg_token;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return(breakdown);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
do_function_parse_check(int *index, Cpp_Token **token_ptr, int count){
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
{
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_PARENTHESE_OPEN){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
if (i < count){
|
|
|
|
--i;
|
|
|
|
--token;
|
|
|
|
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
result = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
do_function_get_doc(int *index, Cpp_Token **token_ptr, int count,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, String *doc_string){
|
2016-07-06 19:18:10 +00:00
|
|
|
int result = false;
|
|
|
|
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_COMMENT){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
if (check_and_fix_docs(&lexeme)){
|
|
|
|
*doc_string = lexeme;
|
|
|
|
result = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_BRACE_OPEN){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
do_function_parse(int *index, Cpp_Token **token_ptr, int count, Cpp_Token *ret_start_token,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Function_Set function_set, int sig_count){
|
2016-07-06 19:18:10 +00:00
|
|
|
int result = false;
|
|
|
|
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
Cpp_Token *args_start_token = token+1;
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
function_set.name[sig_count] = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
int size = token->start - ret_start_token->start;
|
2016-07-16 18:40:26 +00:00
|
|
|
String ret = make_string(data + ret_start_token->start, size);
|
2016-07-06 19:18:10 +00:00
|
|
|
ret = chop_whitespace(ret);
|
|
|
|
function_set.ret[sig_count] = ret;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
int size = token->start + token->size - args_start_token->start;;
|
|
|
|
function_set.args[sig_count] =
|
2016-07-16 18:40:26 +00:00
|
|
|
make_string(data + args_start_token->start, size);
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.valid[sig_count] = true;
|
|
|
|
result = true;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
Argument_Breakdown *breakdown = &function_set.breakdown[sig_count];
|
2016-07-16 18:40:26 +00:00
|
|
|
*breakdown = do_parameter_parse(data, args_start_token, token);
|
2016-07-06 19:18:10 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
2016-07-16 18:40:26 +00:00
|
|
|
do_full_function_parse(int *index, Cpp_Token **token_ptr, int count, char *data,
|
2016-07-06 19:18:10 +00:00
|
|
|
Function_Set function_set, int sig_count){
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
{
|
2016-07-16 18:40:26 +00:00
|
|
|
function_set.marker[sig_count] = make_string(data + token->start, token->size);
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
int j = i;
|
|
|
|
Cpp_Token *jtoken = token;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
if (do_function_parse_check(&j, &jtoken, count)){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
if (do_function_get_doc(&j, &jtoken, count, data, &doc_string)){
|
2016-07-06 19:18:10 +00:00
|
|
|
function_set.doc_string[sig_count] = doc_string;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
++i, ++token;
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *ret_start_token = token;
|
|
|
|
if (do_function_parse_check(&i, &token, count)){
|
|
|
|
if (do_function_parse(&i, &token, count, ret_start_token,
|
2016-07-16 18:40:26 +00:00
|
|
|
data, function_set, sig_count)){
|
2016-07-06 19:18:10 +00:00
|
|
|
result = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
do_macro_parse_check(int *index, Cpp_Token **token_ptr, int count){
|
|
|
|
int result = false;
|
|
|
|
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
{
|
|
|
|
++i, ++token;
|
|
|
|
if (i < count){
|
|
|
|
if (token->type == CPP_TOKEN_COMMENT){
|
|
|
|
++i, ++token;
|
|
|
|
if (i < count){
|
|
|
|
if (token->type == CPP_PP_DEFINE){
|
|
|
|
result = true;
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int
|
|
|
|
do_macro_parse(int *index, Cpp_Token **token_ptr, int count,
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data, Function_Set macro_set, int sig_count){
|
2016-07-06 19:18:10 +00:00
|
|
|
int result = false;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
if (i > 0){
|
|
|
|
Cpp_Token *doc_token = token-1;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String doc_string = make_string(data + doc_token->start, doc_token->size);
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
if (check_and_fix_docs(&doc_string)){
|
|
|
|
macro_set.doc_string[sig_count] = doc_string;
|
2016-07-06 19:18:10 +00:00
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
break;
|
2016-07-06 19:18:10 +00:00
|
|
|
}
|
2016-07-12 22:17:45 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count && (token->flags & CPP_TFLAG_PP_BODY)){
|
2016-07-16 18:40:26 +00:00
|
|
|
macro_set.name[sig_count] = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
++i, ++token;
|
2016-07-06 19:18:10 +00:00
|
|
|
if (i < count){
|
2016-07-12 22:17:45 +00:00
|
|
|
Cpp_Token *args_start_token = token;
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
2016-07-06 19:18:10 +00:00
|
|
|
|
2016-06-27 15:52:58 +00:00
|
|
|
if (i < count){
|
2016-07-12 22:17:45 +00:00
|
|
|
int start = args_start_token->start;
|
|
|
|
int end = token->start + token->size;
|
2016-07-16 18:40:26 +00:00
|
|
|
macro_set.args[sig_count] = make_string(data + start, end - start);
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
Argument_Breakdown *breakdown = ¯o_set.breakdown[sig_count];
|
2016-07-16 18:40:26 +00:00
|
|
|
*breakdown = do_parameter_parse(data, args_start_token, token);
|
2016-07-12 22:17:45 +00:00
|
|
|
|
|
|
|
++i, ++token;
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *body_start = token;
|
|
|
|
|
|
|
|
if (body_start->flags & CPP_TFLAG_PP_BODY){
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY)){
|
|
|
|
break;
|
|
|
|
}
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
2016-07-12 22:17:45 +00:00
|
|
|
|
|
|
|
--i, --token;
|
|
|
|
|
|
|
|
Cpp_Token *body_end = token;
|
|
|
|
|
|
|
|
start = body_start->start;
|
|
|
|
end = body_end->start + body_end->size;
|
2016-07-16 18:40:26 +00:00
|
|
|
macro_set.body[sig_count] = make_string(data + start, end - start);
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
|
|
|
}
|
2016-07-12 22:17:45 +00:00
|
|
|
|
|
|
|
macro_set.is_macro[sig_count] = true;
|
|
|
|
macro_set.valid[sig_count] = true;
|
|
|
|
result = true;
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
2016-07-06 19:18:10 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
struct String_Function_Marker{
|
|
|
|
int parse_function;
|
|
|
|
int is_inline;
|
|
|
|
int parse_doc;
|
|
|
|
};
|
|
|
|
|
|
|
|
static String_Function_Marker
|
|
|
|
do_string_function_marker_check(String lexeme){
|
|
|
|
String_Function_Marker result = {0};
|
|
|
|
|
|
|
|
if (match(lexeme, "FSTRING_INLINE")){
|
|
|
|
result.is_inline = true;
|
|
|
|
result.parse_function = true;
|
|
|
|
}
|
|
|
|
else if (match(lexeme, "FSTRING_LINK")){
|
|
|
|
result.parse_function = true;
|
|
|
|
}
|
|
|
|
else if (match(lexeme, "DOC_EXPORT")){
|
|
|
|
result.parse_doc = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
return(result);
|
|
|
|
}
|
|
|
|
|
|
|
|
static String
|
|
|
|
get_string(char *data, int start, int end){
|
|
|
|
return(make_string(data + start, end - start));
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_str(FILE *file, String str){
|
|
|
|
if (str.size > 0){
|
|
|
|
fprintf(file, "%.*s", str.size, str.str);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
print_function_body_code(FILE *file, int *index, Cpp_Token **token_ptr, int count, String *code,
|
|
|
|
int start){
|
|
|
|
int i = *index;
|
|
|
|
Cpp_Token *token = *token_ptr;
|
|
|
|
|
|
|
|
String pstr = {0};
|
|
|
|
|
|
|
|
int nest_level = 0;
|
|
|
|
int finish = false;
|
|
|
|
int do_whitespace_print = false;
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (do_whitespace_print){
|
|
|
|
pstr = get_string(code->str, start, token->start);
|
|
|
|
print_str(file, pstr);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
do_whitespace_print = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
int do_print = true;
|
|
|
|
if (token->type == CPP_TOKEN_COMMENT){
|
|
|
|
String lexeme = make_string(code->str + token->start, token->size);
|
|
|
|
if (check_and_fix_docs(&lexeme)){
|
|
|
|
do_print = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_BRACE_OPEN){
|
|
|
|
++nest_level;
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_BRACE_CLOSE){
|
|
|
|
--nest_level;
|
|
|
|
if (nest_level == 0){
|
|
|
|
finish = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
if (do_print){
|
|
|
|
pstr = make_string(code->str + token->start, token->size);
|
|
|
|
print_str(file, pstr);
|
|
|
|
}
|
|
|
|
|
|
|
|
start = token->start + token->size;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (finish){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
*index = i;
|
|
|
|
*token_ptr = token;
|
|
|
|
}
|
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
static void
|
|
|
|
print_function_docs(FILE *file, Partition *part, String name, String doc_string){
|
|
|
|
if (doc_string.size == 0){
|
|
|
|
fprintf(file, "No documentation generated for this function, assume it is non-public.\n");
|
|
|
|
fprintf(stderr, "warning: no documentation string for %.*s\n", name.size, name.str);
|
|
|
|
}
|
|
|
|
|
|
|
|
Documentation doc_ = {0};
|
|
|
|
Documentation *doc = &doc_;
|
|
|
|
|
|
|
|
perform_doc_parse(part, doc_string, doc);
|
|
|
|
|
|
|
|
int doc_param_count = doc->param_count;
|
|
|
|
if (doc_param_count > 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Parameters"DOC_HEAD_CLOSE);
|
|
|
|
|
|
|
|
for (int j = 0; j < doc_param_count; ++j){
|
|
|
|
String param_name = doc->param_name[j];
|
|
|
|
String param_docs = doc->param_docs[j];
|
|
|
|
|
|
|
|
// TODO(allen): check that param_name is actually
|
|
|
|
// a parameter to this function!
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<div>\n"
|
|
|
|
DOC_ITEM_HEAD_OPEN"%.*s"DOC_ITEM_HEAD_CLOSE"\n"
|
|
|
|
"<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
|
|
|
|
"</div>\n",
|
|
|
|
param_name.size, param_name.str,
|
|
|
|
param_docs.size, param_docs.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
String ret_doc = doc->return_doc;
|
|
|
|
if (ret_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Return"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
ret_doc.size, ret_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
String main_doc = doc->main_doc;
|
|
|
|
if (main_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
main_doc.size, main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
print_see_also(file, doc);
|
|
|
|
}
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
char*
|
|
|
|
generate_custom_headers(){
|
|
|
|
#define API_H "4coder_custom_api.h"
|
|
|
|
#define API_DOC "4coder_API.html"
|
|
|
|
#define STRING_H "4coder_string.h"
|
|
|
|
|
|
|
|
int size = Mbytes(512);
|
|
|
|
void *mem = malloc(size);
|
|
|
|
memset(mem, 0, size);
|
|
|
|
|
|
|
|
Partition part_ = make_part(mem, size);
|
|
|
|
Partition *part = &part_;
|
|
|
|
|
|
|
|
char *filename = API_H " & " API_DOC " & " STRING_H;
|
|
|
|
|
|
|
|
String string_code = file_dump("internal_4coder_string.cpp");
|
|
|
|
Cpp_Token_Stack string_tokens = {0};
|
|
|
|
|
|
|
|
int string_function_count = 0;
|
|
|
|
|
|
|
|
{
|
|
|
|
String *code = &string_code;
|
|
|
|
Cpp_Token_Stack *token_stack = &string_tokens;
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data = code->str;
|
|
|
|
int size = code->size;
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
*token_stack = cpp_make_token_stack(1024);
|
2016-07-16 18:40:26 +00:00
|
|
|
cpp_lex_file(data, size, token_stack);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
|
|
|
|
int count = token_stack->count;
|
|
|
|
Cpp_Token *tokens = token_stack->tokens;
|
|
|
|
Cpp_Token *token = tokens;
|
|
|
|
|
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER &&
|
|
|
|
!(token->flags & CPP_TFLAG_PP_BODY)){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
String_Function_Marker marker =
|
|
|
|
do_string_function_marker_check(lexeme);
|
|
|
|
|
|
|
|
if (marker.parse_function){
|
|
|
|
if (do_function_parse_check(&i, &token, count)){
|
|
|
|
++string_function_count;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (marker.parse_doc){
|
|
|
|
if (do_macro_parse_check(&i, &token, count)){
|
|
|
|
++string_function_count;
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-07-06 19:18:10 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
Function_Set string_function_set = allocate_function_set(string_function_count);
|
|
|
|
int string_sig_count = 0;
|
|
|
|
|
|
|
|
{
|
|
|
|
String *code = &string_code;
|
|
|
|
Cpp_Token_Stack *token_stack = &string_tokens;
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data = code->str;
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
int count = token_stack->count;
|
|
|
|
Cpp_Token *tokens = token_stack->tokens;
|
|
|
|
Cpp_Token *token = tokens;
|
|
|
|
|
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER &&
|
|
|
|
!(token->flags & CPP_TFLAG_PP_BODY)){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
String_Function_Marker marker =
|
|
|
|
do_string_function_marker_check(lexeme);
|
|
|
|
|
|
|
|
if (marker.parse_function){
|
2016-07-16 18:40:26 +00:00
|
|
|
if (do_full_function_parse(&i, &token, count, data,
|
2016-07-06 19:18:10 +00:00
|
|
|
string_function_set, string_sig_count)){
|
|
|
|
++string_sig_count;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (marker.parse_doc){
|
|
|
|
if (do_macro_parse_check(&i, &token, count)){
|
2016-07-16 18:40:26 +00:00
|
|
|
do_macro_parse(&i, &token, count, data,
|
|
|
|
string_function_set, string_sig_count);
|
2016-07-06 19:18:10 +00:00
|
|
|
++string_sig_count;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
//
|
|
|
|
// App API parsing
|
|
|
|
//
|
|
|
|
|
|
|
|
String code_data[2];
|
|
|
|
code_data[0] = file_dump("4ed_api_implementation.cpp");
|
|
|
|
code_data[1] = file_dump("win32_api_impl.cpp");
|
|
|
|
Parse parses[2];
|
|
|
|
|
|
|
|
int line_count = 0;
|
|
|
|
|
|
|
|
for (int J = 0; J < 2; ++J){
|
|
|
|
String *code = &code_data[J];
|
|
|
|
Parse *parse = &parses[J];
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data = code->str;
|
|
|
|
int size = code->size;
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
parse->tokens = cpp_make_token_stack(512);
|
2016-07-16 18:40:26 +00:00
|
|
|
cpp_lex_file(data, size, &parse->tokens);
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
int count = parse->tokens.count;
|
|
|
|
Cpp_Token *tokens = parse->tokens.tokens;
|
|
|
|
Cpp_Token *token = tokens;
|
2016-06-27 15:52:58 +00:00
|
|
|
|
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER &&
|
|
|
|
!(token->flags & CPP_TFLAG_PP_BODY)){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-06-27 15:52:58 +00:00
|
|
|
if (match(lexeme, "API_EXPORT")){
|
2016-07-06 19:18:10 +00:00
|
|
|
if (do_function_parse_check(&i, &token, count)){
|
|
|
|
++line_count;
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
2016-07-06 19:18:10 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
Function_Set function_set = allocate_function_set(line_count);
|
|
|
|
App_API app_function_set = allocate_app_api(line_count);
|
|
|
|
int sig_count = 0;
|
|
|
|
|
|
|
|
for (int J = 0; J < 2; ++J){
|
|
|
|
String *code = &code_data[J];
|
|
|
|
Parse *parse = &parses[J];
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data = code->str;
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
int count = parse->tokens.count;
|
|
|
|
Cpp_Token *tokens = parse->tokens.tokens;
|
|
|
|
|
|
|
|
// NOTE(allen): Header Parse
|
|
|
|
Cpp_Token *token = tokens;
|
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER &&
|
|
|
|
!(token->flags & CPP_TFLAG_PP_BODY)){
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-06 19:18:10 +00:00
|
|
|
if (match(lexeme, "API_EXPORT")){
|
2016-07-16 18:40:26 +00:00
|
|
|
do_full_function_parse(&i, &token, count, data, function_set, sig_count);
|
2016-07-06 19:18:10 +00:00
|
|
|
if (!function_set.valid[sig_count]){
|
|
|
|
zero_index(function_set, sig_count);
|
|
|
|
// TODO(allen): get warning file name and line numbers
|
|
|
|
fprintf(stderr, "generator warning : invalid function signature\n");
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
2016-07-06 19:18:10 +00:00
|
|
|
++sig_count;
|
2016-06-27 15:52:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-05-25 22:43:58 +00:00
|
|
|
|
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-06-24 19:33:37 +00:00
|
|
|
String name_string = function_set.name[i];
|
2016-07-06 19:18:10 +00:00
|
|
|
String *macro = app_function_set.macros + i;
|
|
|
|
String *public_name = app_function_set.public_name + i;
|
2016-05-25 22:43:58 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
macro->size = 0;
|
|
|
|
macro->memory_size = name_string.size+4;
|
2016-05-25 22:43:58 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
macro->str = (char*)malloc(macro->memory_size);
|
|
|
|
copy(macro, name_string);
|
|
|
|
to_upper(macro);
|
|
|
|
append(macro, make_lit_string("_SIG"));
|
|
|
|
|
|
|
|
|
|
|
|
public_name->size = 0;
|
|
|
|
public_name->memory_size = name_string.size;
|
|
|
|
|
|
|
|
public_name->str = (char*)malloc(public_name->memory_size);
|
|
|
|
copy(public_name, name_string);
|
|
|
|
to_lower(public_name);
|
|
|
|
}
|
|
|
|
|
2016-06-27 15:52:58 +00:00
|
|
|
// NOTE(allen): Header
|
|
|
|
FILE *file = fopen(API_H, "wb");
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
for (int i = 0; i < sig_count; ++i){
|
|
|
|
String ret_string = function_set.ret[i];
|
|
|
|
String args_string = function_set.args[i];
|
2016-07-06 19:18:10 +00:00
|
|
|
String macro_string = app_function_set.macros[i];
|
2016-06-24 19:33:37 +00:00
|
|
|
|
|
|
|
fprintf(file, "#define %.*s(n) %.*s n%.*s\n",
|
|
|
|
macro_string.size, macro_string.str,
|
|
|
|
ret_string.size, ret_string.str,
|
|
|
|
args_string.size, args_string.str
|
2016-05-25 22:43:58 +00:00
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "extern \"C\"{\n");
|
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-06-24 19:33:37 +00:00
|
|
|
String name_string = function_set.name[i];
|
2016-07-06 19:18:10 +00:00
|
|
|
String macro_string = app_function_set.macros[i];
|
2016-05-25 22:43:58 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
fprintf(file, " typedef %.*s(%.*s_Function);\n",
|
|
|
|
macro_string.size, macro_string.str,
|
|
|
|
name_string.size, name_string.str);
|
2016-05-25 22:43:58 +00:00
|
|
|
}
|
|
|
|
fprintf(file, "}\n");
|
|
|
|
|
|
|
|
fprintf(file, "struct Application_Links{\n");
|
|
|
|
fprintf(file,
|
|
|
|
" void *memory;\n"
|
|
|
|
" int memory_size;\n"
|
|
|
|
);
|
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-06-24 19:33:37 +00:00
|
|
|
String name_string = function_set.name[i];
|
2016-07-06 19:18:10 +00:00
|
|
|
String public_string = app_function_set.public_name[i];
|
2016-05-25 22:43:58 +00:00
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
fprintf(file, " %.*s_Function *%.*s;\n",
|
|
|
|
name_string.size, name_string.str,
|
|
|
|
public_string.size, public_string.str);
|
2016-05-25 22:43:58 +00:00
|
|
|
}
|
|
|
|
fprintf(file,
|
|
|
|
" void *cmd_context;\n"
|
|
|
|
" void *system_links;\n"
|
|
|
|
" void *current_coroutine;\n"
|
|
|
|
" int type_coroutine;\n"
|
|
|
|
);
|
|
|
|
fprintf(file, "};\n");
|
|
|
|
|
2016-06-13 18:54:26 +00:00
|
|
|
fprintf(file, "#define FillAppLinksAPI(app_links) do{");
|
2016-05-31 01:22:55 +00:00
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-06-27 15:52:58 +00:00
|
|
|
String name = function_set.name[i];
|
2016-07-06 19:18:10 +00:00
|
|
|
String public_string = app_function_set.public_name[i];
|
2016-05-31 01:22:55 +00:00
|
|
|
|
|
|
|
fprintf(file,
|
2016-06-13 16:56:33 +00:00
|
|
|
"\\\n"
|
2016-06-27 15:52:58 +00:00
|
|
|
"app_links->%.*s = %.*s;",
|
2016-06-24 19:33:37 +00:00
|
|
|
public_string.size, public_string.str,
|
2016-06-27 15:52:58 +00:00
|
|
|
name.size, name.str
|
2016-06-13 16:56:33 +00:00
|
|
|
);
|
2016-05-31 01:22:55 +00:00
|
|
|
}
|
2016-06-13 18:54:26 +00:00
|
|
|
fprintf(file, " } while(false)\n");
|
2016-06-07 18:52:40 +00:00
|
|
|
|
2016-05-25 22:43:58 +00:00
|
|
|
fclose(file);
|
|
|
|
|
2016-06-24 19:33:37 +00:00
|
|
|
// NOTE(allen): Documentation
|
2016-07-02 14:15:15 +00:00
|
|
|
if (global_settings.generate_docs){
|
|
|
|
Typedef_Set typedef_set = {0};
|
|
|
|
Struct_Set struct_set = {0};
|
|
|
|
Enum_Set flag_set = {0};
|
|
|
|
Enum_Set enum_set = {0};
|
|
|
|
|
|
|
|
|
|
|
|
String type_code = file_dump("4coder_types.h");
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
char *data = type_code.str;
|
|
|
|
int size = type_code.size;
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
Cpp_Token_Stack types_tokens = cpp_make_token_stack(512);
|
2016-07-16 18:40:26 +00:00
|
|
|
cpp_lex_file(data, size, &types_tokens);
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
int typedef_count = 0;
|
|
|
|
int struct_count = 0;
|
|
|
|
int flag_count = 0;
|
|
|
|
int enum_count = 0;
|
|
|
|
|
|
|
|
{
|
|
|
|
int count = types_tokens.count;
|
|
|
|
Cpp_Token *tokens = types_tokens.tokens;
|
|
|
|
Cpp_Token *token = tokens;
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
static String type_spec_keys[] = {
|
|
|
|
make_lit_string("typedef"),
|
|
|
|
make_lit_string("struct"),
|
|
|
|
make_lit_string("union"),
|
|
|
|
make_lit_string("ENUM"),
|
|
|
|
make_lit_string("FLAGENUM"),
|
|
|
|
};
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY) &&
|
|
|
|
(token->type == CPP_TOKEN_KEY_TYPE_DECLARATION ||
|
|
|
|
token->type == CPP_TOKEN_IDENTIFIER)){
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-02 14:15:15 +00:00
|
|
|
int match_index = 0;
|
|
|
|
if (string_set_match(type_spec_keys, ArrayCount(type_spec_keys),
|
|
|
|
lexeme, &match_index)){
|
|
|
|
switch (match_index){
|
|
|
|
case 0: //typedef
|
|
|
|
++typedef_count; break;
|
|
|
|
|
|
|
|
case 1: case 2: //struct/union
|
|
|
|
++struct_count; break;
|
|
|
|
|
|
|
|
case 3: //ENUM
|
|
|
|
++enum_count; break;
|
|
|
|
|
|
|
|
case 4: //FLAGENUM
|
|
|
|
++flag_count; break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
if (typedef_count > 0){
|
|
|
|
typedef_set.type = push_array(part, String, typedef_count);
|
|
|
|
typedef_set.name = push_array(part, String, typedef_count);
|
|
|
|
typedef_set.doc_string = push_array(part, String, typedef_count);
|
|
|
|
}
|
2016-06-27 19:45:15 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
if (struct_count > 0){
|
|
|
|
struct_set.structs = push_array(part, Struct_Member, struct_count);
|
|
|
|
}
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
if (enum_count > 0){
|
|
|
|
enum_set.name = push_array(part, String, enum_count);
|
|
|
|
enum_set.type = push_array(part, String, enum_count);
|
|
|
|
enum_set.first_member = push_array(part, Enum_Member*, enum_count);
|
|
|
|
enum_set.doc_string = push_array(part, String, enum_count);
|
|
|
|
}
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
if (flag_count > 0){
|
|
|
|
flag_set.name = push_array(part, String, flag_count);
|
|
|
|
flag_set.first_member = push_array(part, Enum_Member*, flag_count);
|
|
|
|
flag_set.doc_string = push_array(part, String, flag_count);
|
|
|
|
}
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
int typedef_index = 0;
|
|
|
|
int struct_index = 0;
|
|
|
|
int flag_index = 0;
|
|
|
|
int enum_index = 0;
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
token = tokens;
|
|
|
|
for (int i = 0; i < count; ++i, ++token){
|
|
|
|
Assert(i == (i32)(token - tokens));
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY) &&
|
|
|
|
(token->type == CPP_TOKEN_KEY_TYPE_DECLARATION ||
|
|
|
|
token->type == CPP_TOKEN_IDENTIFIER)){
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String lexeme = make_string(data + token->start, token->size);
|
2016-07-02 14:15:15 +00:00
|
|
|
int match_index = 0;
|
|
|
|
if (string_set_match(type_spec_keys, ArrayCount(type_spec_keys),
|
|
|
|
lexeme, &match_index)){
|
|
|
|
switch (match_index){
|
|
|
|
case 0: //typedef
|
|
|
|
{
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
int start_i = i;
|
|
|
|
Cpp_Token *start_token = token;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_SEMICOLON){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
Cpp_Token *token_j = token;
|
|
|
|
|
|
|
|
for (int j = i; j > start_i; --j, --token_j){
|
|
|
|
if (token_j->type == CPP_TOKEN_IDENTIFIER){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
String name = make_string(data + token_j->start, token_j->size);
|
2016-07-02 14:15:15 +00:00
|
|
|
name = skip_chop_whitespace(name);
|
|
|
|
|
|
|
|
int type_start = start_token->start + start_token->size;
|
|
|
|
int type_end = token_j->start;
|
2016-07-16 18:40:26 +00:00
|
|
|
String type = make_string(data + type_start, type_end - type_start);
|
2016-07-02 14:15:15 +00:00
|
|
|
type = skip_chop_whitespace(type);
|
|
|
|
|
|
|
|
typedef_set.type[typedef_index] = type;
|
|
|
|
typedef_set.name[typedef_index] = name;
|
|
|
|
typedef_set.doc_string[typedef_index] = doc_string;
|
|
|
|
++typedef_index;
|
|
|
|
}
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case 1: case 2: //struct/union
|
|
|
|
{
|
|
|
|
if (parse_struct(part, (match_index == 1),
|
2016-07-16 18:40:26 +00:00
|
|
|
data, tokens, count, &token,
|
2016-07-02 14:15:15 +00:00
|
|
|
struct_set.structs + struct_index)){
|
|
|
|
++struct_index;
|
|
|
|
}
|
|
|
|
i = (int)(token - tokens);
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case 3: //ENUM
|
|
|
|
{
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
int start_i = i;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
if (parse_enum(part, data,
|
2016-07-02 14:15:15 +00:00
|
|
|
tokens, count,
|
|
|
|
&token, start_i,
|
|
|
|
enum_set, enum_index)){
|
|
|
|
enum_set.doc_string[enum_index] = doc_string;
|
|
|
|
++enum_index;
|
|
|
|
}
|
|
|
|
i = (i32)(token - tokens);
|
|
|
|
}break;
|
|
|
|
|
|
|
|
case 4: //FLAGENUM
|
|
|
|
{
|
|
|
|
String doc_string = {0};
|
2016-07-16 18:40:26 +00:00
|
|
|
get_type_doc_string(data, tokens, i, &doc_string);
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
int start_i = i;
|
|
|
|
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-16 18:40:26 +00:00
|
|
|
if (parse_enum(part, data,
|
2016-07-02 14:15:15 +00:00
|
|
|
tokens, count,
|
|
|
|
&token, start_i,
|
|
|
|
flag_set, flag_index)){
|
|
|
|
flag_set.doc_string[flag_index] = doc_string;
|
|
|
|
++flag_index;
|
|
|
|
}
|
|
|
|
i = (i32)(token - tokens);
|
|
|
|
}break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
typedef_count = typedef_index;
|
|
|
|
struct_count = struct_index;
|
|
|
|
enum_count = enum_index;
|
|
|
|
flag_count = flag_index;
|
2016-06-27 14:25:17 +00:00
|
|
|
}
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
//
|
|
|
|
// Output 4coder_string.h
|
|
|
|
//
|
|
|
|
|
|
|
|
file = fopen(STRING_H, "wb");
|
|
|
|
|
|
|
|
{
|
|
|
|
String *code = &string_code;
|
|
|
|
Cpp_Token_Stack *token_stack = &string_tokens;
|
|
|
|
|
|
|
|
int start = 0;
|
|
|
|
|
|
|
|
int count = token_stack->count;
|
|
|
|
Cpp_Token *tokens = token_stack->tokens;
|
|
|
|
Cpp_Token *token = tokens;
|
|
|
|
int i = 0;
|
|
|
|
|
|
|
|
for (i = 0; i < count; ++i, ++token){
|
|
|
|
if (token->type == CPP_TOKEN_IDENTIFIER &&
|
|
|
|
!(token->flags & CPP_TFLAG_PP_BODY)){
|
|
|
|
String lexeme = make_string(code->str + token->start, token->size);
|
|
|
|
if (match(lexeme, "FSTRING_BEGIN")){
|
|
|
|
start = token->start + token->size;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
String pstr = {0};
|
|
|
|
int do_whitespace_print = true;
|
|
|
|
|
|
|
|
for(++i, ++token; i < count; ++i, ++token){
|
|
|
|
if (do_whitespace_print){
|
|
|
|
pstr = get_string(code->str, start, token->start);
|
|
|
|
print_str(file, pstr);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
do_whitespace_print = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
String lexeme = make_string(code->str + token->start, token->size);
|
|
|
|
|
|
|
|
int do_print = true;
|
|
|
|
if (match(lexeme, "FSTRING_DECLS")){
|
|
|
|
fprintf(file, "#ifndef FCODER_STRING_H\n#define FCODER_STRING_H\n\n");
|
|
|
|
|
|
|
|
do_print = false;
|
|
|
|
for (int j = 0; j < string_sig_count; ++j){
|
|
|
|
char line_space[2048];
|
|
|
|
String line = make_fixed_width_string(line_space);
|
|
|
|
|
|
|
|
if (!string_function_set.is_macro[j]){
|
|
|
|
String marker = string_function_set.marker[j];
|
|
|
|
String ret = string_function_set.ret[j];
|
|
|
|
String name = string_function_set.name[j];
|
|
|
|
String args = string_function_set.args[j];
|
|
|
|
|
|
|
|
append(&line, marker);
|
|
|
|
append_padding(&line, ' ', 16);
|
|
|
|
append(&line, ret);
|
|
|
|
append_padding(&line, ' ', 30);
|
|
|
|
append(&line, name);
|
|
|
|
append(&line, args);
|
|
|
|
terminate_with_null(&line);
|
|
|
|
|
|
|
|
fprintf(file, "%s;\n", line.str);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
String name = string_function_set.name[j];
|
|
|
|
String args = string_function_set.args[j];
|
|
|
|
String body = string_function_set.body[j];
|
|
|
|
|
|
|
|
append(&line, "#ifndef ");
|
|
|
|
append_padding(&line, ' ', 10);
|
|
|
|
append(&line, name);
|
|
|
|
terminate_with_null(&line);
|
|
|
|
fprintf(file, "%s\n", line.str);
|
|
|
|
line.size = 0;
|
|
|
|
|
|
|
|
append(&line, "# define ");
|
|
|
|
append_padding(&line, ' ', 10);
|
|
|
|
append(&line, name);
|
|
|
|
append(&line, args);
|
|
|
|
append(&line, ' ');
|
|
|
|
append(&line, body);
|
|
|
|
terminate_with_null(&line);
|
|
|
|
fprintf(file, "%s\n", line.str);
|
|
|
|
line.size = 0;
|
|
|
|
|
|
|
|
append(&line, "#endif");
|
|
|
|
terminate_with_null(&line);
|
|
|
|
fprintf(file, "%s\n", line.str);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "\n#endif\n");
|
|
|
|
}
|
|
|
|
else if (match(lexeme, "DOC_EXPORT")){
|
|
|
|
++i, ++token;
|
|
|
|
if (i < count && token->type == CPP_TOKEN_COMMENT){
|
|
|
|
++i, ++token;
|
|
|
|
if (i < count && token->type == CPP_PP_DEFINE){
|
|
|
|
++i, ++token;
|
|
|
|
for (; i < count; ++i, ++token){
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY)){
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
--i, --token;
|
|
|
|
do_print = false;
|
|
|
|
do_whitespace_print = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (match(lexeme, "FSTRING_INLINE")){
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY)){
|
|
|
|
fprintf(file, "#ifndef FSTRING_GUARD\n");
|
|
|
|
|
|
|
|
print_function_body_code(file, &i, &token, count, code, start);
|
|
|
|
|
|
|
|
fprintf(file, "\n#endif");
|
|
|
|
do_print = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (match(lexeme, "FSTRING_LINK")){
|
|
|
|
if (!(token->flags & CPP_TFLAG_PP_BODY)){
|
|
|
|
fprintf(file, "#ifdef FSTRING_IMPLEMENTATION\n");
|
|
|
|
|
|
|
|
print_function_body_code(file, &i, &token, count, code, start);
|
|
|
|
|
|
|
|
fprintf(file, "\n#endif");
|
|
|
|
do_print = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (token->type == CPP_TOKEN_COMMENT){
|
|
|
|
lexeme = make_string(code->str + token->start, token->size);
|
|
|
|
if (check_and_fix_docs(&lexeme)){
|
|
|
|
do_print = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (i < count){
|
|
|
|
if (do_print){
|
|
|
|
pstr = make_string(code->str + token->start, token->size);
|
|
|
|
print_str(file, pstr);
|
|
|
|
}
|
|
|
|
|
|
|
|
start = token->start + token->size;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
pstr = get_string(code->str, start, code->size);
|
|
|
|
print_str(file, pstr);
|
|
|
|
}
|
|
|
|
|
|
|
|
fclose(file);
|
|
|
|
|
|
|
|
//
|
|
|
|
// Output Docs
|
|
|
|
//
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
file = fopen(API_DOC, "wb");
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<html lang=\"en-US\">\n"
|
|
|
|
"<head>\n"
|
|
|
|
"<title>4coder API Docs</title>\n"
|
|
|
|
"<style>\n"
|
|
|
|
|
|
|
|
"body { "
|
|
|
|
"background: " BACK_COLOR "; "
|
|
|
|
"color: " TEXT_COLOR "; "
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
// H things
|
|
|
|
"h1,h2,h3,h4 { "
|
|
|
|
"color: " POP_COLOR_1 "; "
|
|
|
|
"margin: 0; "
|
|
|
|
"}\n"
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
"h2 { "
|
|
|
|
"margin-top: 6mm; "
|
|
|
|
"}\n"
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
"h3 { "
|
|
|
|
"margin-top: 5mm; margin-bottom: 5mm; "
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
"h4 { "
|
|
|
|
"font-size: 1.1em; "
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
// ANCHORS
|
|
|
|
"a { "
|
|
|
|
"color: " POP_COLOR_1 "; "
|
|
|
|
"text-decoration: none; "
|
|
|
|
"}\n"
|
|
|
|
"a:visited { "
|
|
|
|
"color: " VISITED_LINK "; "
|
|
|
|
"}\n"
|
|
|
|
"a:hover { "
|
|
|
|
"background: " POP_BACK_1 "; "
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
// LIST
|
|
|
|
"ul { "
|
|
|
|
"list-style: none; "
|
|
|
|
"padding: 0; "
|
|
|
|
"margin: 0; "
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
"</style>\n"
|
|
|
|
"</head>\n"
|
|
|
|
"<body>\n"
|
|
|
|
"<div style='font-family:Arial; margin: 0 auto; "
|
2016-07-02 14:56:50 +00:00
|
|
|
"width: 800px; text-align: justify; line-height: 1.25;'>\n"
|
2016-07-02 14:15:15 +00:00
|
|
|
"<h1 style='margin-top: 5mm; margin-bottom: 5mm;'>4coder API</h1>\n"
|
2016-07-01 05:42:19 +00:00
|
|
|
);
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
struct Section{
|
|
|
|
char *id_string;
|
|
|
|
char *display_string;
|
|
|
|
};
|
|
|
|
|
|
|
|
static Section sections[] = {
|
|
|
|
{"introduction", "Introduction"},
|
|
|
|
{"4coder_systems", "4coder Systems"},
|
|
|
|
{"types_and_functions", "Types and Functions"},
|
|
|
|
{"string_library", "String Library"}
|
|
|
|
};
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<h3 style='margin:0;'>Table of Contents</h3>\n"
|
|
|
|
"<ul>\n");
|
|
|
|
|
|
|
|
int section_count = ArrayCount(sections);
|
|
|
|
for (int i = 0; i < section_count; ++i){
|
|
|
|
fprintf(file,
|
|
|
|
"<li><a href='#section_%s'>§%d %s</a></li>",
|
|
|
|
sections[i].id_string,
|
|
|
|
i+1,
|
|
|
|
sections[i].display_string);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"</ul>\n"
|
|
|
|
);
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
#define MAJOR_SECTION "1"
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file,
|
2016-07-06 19:18:10 +00:00
|
|
|
"<h2 id='section_%s'>§"MAJOR_SECTION" %s</h2>\n"
|
2016-07-02 14:15:15 +00:00
|
|
|
"<div>\n"
|
|
|
|
|
|
|
|
"<p>\n"
|
2016-07-02 14:56:50 +00:00
|
|
|
"This is the documentation for " VERSION " The documentation is still under "
|
|
|
|
"construction so some of the links are linking to sections that have not "
|
|
|
|
"been written yet. What is here should be correct and I suspect useful "
|
|
|
|
"even without some of the other sections. "
|
2016-07-02 14:15:15 +00:00
|
|
|
"</p>\n"
|
|
|
|
|
|
|
|
"<p>\n"
|
2016-07-02 14:56:50 +00:00
|
|
|
"If you have questions or discover errors please contact "
|
|
|
|
"<span style='"CODE_STYLE"'>editor@4coder.net</span> or "
|
|
|
|
"to get help from community members you can post on the "
|
|
|
|
"4coder forums hosted on handmade.network at "
|
|
|
|
"<span style='"CODE_STYLE"'>4coder.handmade.network</span>"
|
2016-07-02 14:15:15 +00:00
|
|
|
"</p>\n"
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
"</div>\n",
|
|
|
|
sections[0].id_string,
|
|
|
|
sections[0].display_string
|
|
|
|
);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
#undef MAJOR_SECTION
|
|
|
|
#define MAJOR_SECTION "2"
|
|
|
|
// TODO(allen): Write the 4coder system descriptions.
|
2016-07-06 19:18:10 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<h2 id='section_%s'>§"MAJOR_SECTION" %s</h2>\n",
|
|
|
|
sections[1].id_string,
|
|
|
|
sections[1].display_string);
|
2016-07-12 22:17:45 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
{
|
2016-07-02 14:56:50 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<div><i>\n"
|
|
|
|
"Coming Soon"
|
|
|
|
"</i><div>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
#undef MAJOR_SECTION
|
|
|
|
#define MAJOR_SECTION "3"
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<h2 id='section_%s'>§"MAJOR_SECTION" %s</h2>\n",
|
|
|
|
sections[2].id_string,
|
|
|
|
sections[2].display_string);
|
2016-07-02 14:15:15 +00:00
|
|
|
{
|
2016-07-01 05:42:19 +00:00
|
|
|
#undef SECTION
|
2016-07-02 14:15:15 +00:00
|
|
|
#define SECTION MAJOR_SECTION".1"
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-06-27 19:45:15 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<h3>§"SECTION" Function List</h3>\n"
|
|
|
|
"<ul>\n");
|
2016-06-27 14:25:17 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-07-06 19:18:10 +00:00
|
|
|
String name = app_function_set.public_name[i];
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
2016-06-27 19:45:15 +00:00
|
|
|
}
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file, "</ul>\n");
|
|
|
|
|
|
|
|
#undef SECTION
|
|
|
|
#define SECTION MAJOR_SECTION".2"
|
2016-06-27 19:45:15 +00:00
|
|
|
|
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<h3>§"SECTION" Type List</h3>\n"
|
|
|
|
"<ul>\n"
|
|
|
|
);
|
2016-06-27 19:45:15 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < typedef_count; ++i){
|
|
|
|
String name = typedef_set.name[i];
|
|
|
|
fprintf(file,
|
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
2016-06-27 19:45:15 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < enum_count; ++i){
|
|
|
|
String name = enum_set.name[i];
|
|
|
|
fprintf(file,
|
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
2016-06-27 19:45:15 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < flag_count; ++i){
|
|
|
|
String name = flag_set.name[i];
|
2016-06-27 19:45:15 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
2016-06-27 19:45:15 +00:00
|
|
|
);
|
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < struct_count; ++i){
|
|
|
|
String name = struct_set.structs[i].name;
|
2016-06-27 19:45:15 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
2016-06-27 19:45:15 +00:00
|
|
|
);
|
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file, "</ul>\n");
|
|
|
|
|
|
|
|
#undef SECTION
|
|
|
|
#define SECTION MAJOR_SECTION".3"
|
|
|
|
|
|
|
|
fprintf(file, "<h3>§"SECTION" Function Descriptions</h3>\n");
|
|
|
|
for (int i = 0; i < sig_count; ++i){
|
2016-07-06 19:18:10 +00:00
|
|
|
String name = app_function_set.public_name[i];
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
|
2016-07-02 14:15:15 +00:00
|
|
|
name.size, name.str, i+1,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
2016-07-06 19:18:10 +00:00
|
|
|
print_function_html(file, function_set, i, name, "app->");
|
|
|
|
fprintf(file, "</div>\n");
|
2016-06-27 19:45:15 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
String doc_string = function_set.doc_string[i];
|
2016-07-12 22:17:45 +00:00
|
|
|
print_function_docs(file, part, name, doc_string);
|
2016-07-02 14:15:15 +00:00
|
|
|
|
|
|
|
fprintf(file, "</div><hr>\n");
|
2016-06-27 19:45:15 +00:00
|
|
|
}
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
#undef SECTION
|
2016-07-02 14:15:15 +00:00
|
|
|
#define SECTION MAJOR_SECTION".4"
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file, "<h3>§"SECTION" Type Descriptions</h3>\n");
|
|
|
|
int I = 1;
|
|
|
|
for (int i = 0; i < typedef_count; ++i, ++I){
|
|
|
|
String name = typedef_set.name[i];
|
|
|
|
String type = typedef_set.type[i];
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
|
2016-07-02 14:15:15 +00:00
|
|
|
name.size, name.str, I,
|
2016-07-01 05:42:19 +00:00
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
// NOTE(allen): Code box
|
|
|
|
{
|
|
|
|
fprintf(file,
|
|
|
|
"typedef %.*s %.*s;",
|
|
|
|
type.size, type.str,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>\n");
|
|
|
|
|
|
|
|
// NOTE(allen): Descriptive section
|
|
|
|
{
|
|
|
|
String doc_string = typedef_set.doc_string[i];
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, doc_string, &doc);
|
|
|
|
|
|
|
|
String main_doc = doc.main_doc;
|
|
|
|
if (main_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
main_doc.size, main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
print_see_also(file, &doc);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div><hr>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < enum_count; ++i, ++I){
|
|
|
|
String name = enum_set.name[i];
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
|
2016-07-02 14:15:15 +00:00
|
|
|
name.size, name.str, I,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
|
|
|
|
// NOTE(allen): Code box
|
|
|
|
{
|
|
|
|
fprintf(file,
|
|
|
|
"enum %.*s;",
|
|
|
|
name.size, name.str);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>\n");
|
|
|
|
|
|
|
|
// NOTE(allen): Descriptive section
|
|
|
|
{
|
|
|
|
String doc_string = enum_set.doc_string[i];
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, doc_string, &doc);
|
|
|
|
|
|
|
|
String main_doc = doc.main_doc;
|
|
|
|
if (main_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
main_doc.size, main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (enum_set.first_member[i]){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Values"DOC_HEAD_CLOSE);
|
|
|
|
for (Enum_Member *member = enum_set.first_member[i];
|
|
|
|
member;
|
|
|
|
member = member->next){
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, member->doc_string, &doc);
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<div>\n"
|
|
|
|
"<div><span style='"CODE_STYLE"'>"DOC_ITEM_HEAD_INL_OPEN
|
|
|
|
"%.*s"DOC_ITEM_HEAD_INL_CLOSE"</span></div>\n"
|
|
|
|
"<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
|
|
|
|
"</div>\n",
|
|
|
|
member->name.size, member->name.str,
|
|
|
|
doc.main_doc.size, doc.main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
print_see_also(file, &doc);
|
|
|
|
}
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file, "</div><hr>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < flag_count; ++i, ++I){
|
|
|
|
String name = flag_set.name[i];
|
|
|
|
|
2016-07-01 05:42:19 +00:00
|
|
|
fprintf(file,
|
2016-07-02 14:15:15 +00:00
|
|
|
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
|
2016-07-02 14:15:15 +00:00
|
|
|
name.size, name.str, I,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
// NOTE(allen): Code box
|
|
|
|
{
|
|
|
|
fprintf(file,
|
|
|
|
"enum %.*s;",
|
|
|
|
name.size, name.str);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>\n");
|
|
|
|
|
|
|
|
// NOTE(allen): Descriptive section
|
|
|
|
{
|
|
|
|
String doc_string = flag_set.doc_string[i];
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, doc_string, &doc);
|
|
|
|
|
|
|
|
String main_doc = doc.main_doc;
|
|
|
|
if (main_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
main_doc.size, main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (flag_set.first_member[i]){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Flags"DOC_HEAD_CLOSE);
|
|
|
|
for (Enum_Member *member = flag_set.first_member[i];
|
|
|
|
member;
|
|
|
|
member = member->next){
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, member->doc_string, &doc);
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<div>\n"
|
|
|
|
"<div><span style='"CODE_STYLE"'>"DOC_ITEM_HEAD_INL_OPEN
|
|
|
|
"%.*s"DOC_ITEM_HEAD_INL_CLOSE" = %.*s</span></div>\n"
|
|
|
|
"<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
|
|
|
|
"</div>\n",
|
|
|
|
member->name.size, member->name.str,
|
|
|
|
member->value.size, member->value.str,
|
|
|
|
doc.main_doc.size, doc.main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
print_see_also(file, &doc);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div><hr>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
for (int i = 0; i < struct_count; ++i, ++I){
|
|
|
|
Struct_Member *member = &struct_set.structs[i];
|
|
|
|
String name = member->name;
|
|
|
|
fprintf(file,
|
|
|
|
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
|
2016-07-02 14:15:15 +00:00
|
|
|
name.size, name.str, I,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
|
|
|
|
// NOTE(allen): Code box
|
|
|
|
{
|
|
|
|
print_struct_html(file, member);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
// NOTE(allen): Descriptive section
|
|
|
|
{
|
|
|
|
String doc_string = member->doc_string;
|
|
|
|
Documentation doc = {0};
|
|
|
|
perform_doc_parse(part, doc_string, &doc);
|
|
|
|
|
|
|
|
String main_doc = doc.main_doc;
|
|
|
|
if (main_doc.size != 0){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
|
|
|
|
fprintf(file,
|
|
|
|
DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
|
|
|
|
main_doc.size, main_doc.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (member->first_child){
|
|
|
|
fprintf(file, DOC_HEAD_OPEN"Fields"DOC_HEAD_CLOSE);
|
|
|
|
print_struct_docs(file, part, member);
|
|
|
|
}
|
|
|
|
|
|
|
|
print_see_also(file, &doc);
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div><hr>\n");
|
2016-07-01 05:42:19 +00:00
|
|
|
}
|
2016-06-27 14:25:17 +00:00
|
|
|
}
|
2016-07-02 14:15:15 +00:00
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
#undef MAJOR_SECTION
|
|
|
|
#define MAJOR_SECTION "4"
|
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<h2 id='section_%s'>§"MAJOR_SECTION" %s</h2>\n",
|
|
|
|
sections[3].id_string,
|
|
|
|
sections[3].display_string);
|
|
|
|
|
|
|
|
{
|
|
|
|
|
|
|
|
#undef SECTION
|
|
|
|
#define SECTION MAJOR_SECTION".1"
|
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<h3>§"SECTION" String Intro</h3>\n"
|
|
|
|
"<ul>\n");
|
|
|
|
|
|
|
|
{
|
|
|
|
fprintf(file,
|
|
|
|
"<div><i>\n"
|
|
|
|
"Coming Soon"
|
|
|
|
"</i><div>\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
#undef SECTION
|
|
|
|
#define SECTION MAJOR_SECTION".2"
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
fprintf(file,
|
|
|
|
"<h3>§"SECTION" String Function List</h3>\n"
|
|
|
|
"<ul>\n");
|
|
|
|
|
|
|
|
String *used_strings = 0;
|
|
|
|
int used_string_count = 0;
|
|
|
|
|
|
|
|
{
|
|
|
|
int memory_size = sizeof(String)*(string_sig_count);
|
|
|
|
used_strings = (String*)malloc(memory_size);
|
|
|
|
memset(used_strings, 0, memory_size);
|
|
|
|
}
|
|
|
|
|
|
|
|
for (int i = 0; i < string_sig_count; ++i){
|
|
|
|
String name = string_function_set.name[i];
|
|
|
|
int index = 0;
|
|
|
|
if (!string_set_match(used_strings, used_string_count, name, &index)){
|
|
|
|
fprintf(file,
|
|
|
|
"<li>"
|
|
|
|
"<a href='#%.*s_str_doc'>%.*s</a>"
|
|
|
|
"</li>\n",
|
|
|
|
name.size, name.str,
|
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
used_strings[used_string_count++] = name;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
fprintf(file, "</ul>\n");
|
|
|
|
|
|
|
|
used_string_count = 0;
|
|
|
|
|
|
|
|
#undef SECTION
|
2016-07-12 22:17:45 +00:00
|
|
|
#define SECTION MAJOR_SECTION".3"
|
2016-07-06 19:18:10 +00:00
|
|
|
|
|
|
|
fprintf(file,
|
|
|
|
"<h3>§"SECTION" String Function Descriptions</h3>\n"
|
|
|
|
"<ul>\n");
|
|
|
|
|
|
|
|
for (int i = 0; i < string_sig_count; ++i){
|
|
|
|
String name = string_function_set.name[i];
|
|
|
|
int index = 0;
|
|
|
|
int do_id = false;
|
|
|
|
if (!string_set_match(used_strings, used_string_count, name, &index)){
|
|
|
|
do_id = true;
|
|
|
|
used_strings[used_string_count++] = name;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (do_id){
|
|
|
|
fprintf(file,
|
|
|
|
"<div id='%.*s_str_doc'>",
|
|
|
|
name.size, name.str
|
|
|
|
);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
fprintf(file, "<div>");
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file,
|
2016-07-12 22:17:45 +00:00
|
|
|
"<h4>§"SECTION".%d: %.*s</h4>\n"
|
|
|
|
"<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>\n",
|
2016-07-06 19:18:10 +00:00
|
|
|
i+1, name.size, name.str);
|
|
|
|
|
|
|
|
if (string_function_set.is_macro[i]){
|
|
|
|
print_macro_html(file, string_function_set, i, name);
|
|
|
|
}
|
|
|
|
else{
|
|
|
|
print_function_html(file, string_function_set, i, name, "");
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(file, "</div>\n");
|
|
|
|
|
2016-07-12 22:17:45 +00:00
|
|
|
|
|
|
|
String doc_string = string_function_set.doc_string[i];
|
|
|
|
print_function_docs(file, part, name, doc_string);
|
|
|
|
|
2016-07-06 19:18:10 +00:00
|
|
|
fprintf(file, "</div><hr>\n");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
fprintf(file,
|
|
|
|
"</div>\n"
|
|
|
|
"</body>\n"
|
|
|
|
"</html>\n"
|
|
|
|
);
|
|
|
|
|
|
|
|
fclose(file);
|
2016-06-24 19:33:37 +00:00
|
|
|
}
|
2016-06-27 15:52:58 +00:00
|
|
|
|
2016-05-25 22:43:58 +00:00
|
|
|
return(filename);
|
|
|
|
}
|
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
int main(int argc, char **argv){
|
2016-06-24 19:33:37 +00:00
|
|
|
char *filename = 0;
|
2016-06-29 17:16:08 +00:00
|
|
|
|
2016-07-02 14:15:15 +00:00
|
|
|
memset(&global_settings, 0, sizeof(global_settings));
|
|
|
|
|
|
|
|
global_settings.generate_docs = true;
|
2016-08-22 23:54:20 +00:00
|
|
|
global_settings.generate_string = false;
|
2016-07-02 14:15:15 +00:00
|
|
|
|
2016-02-27 17:34:13 +00:00
|
|
|
filename = generate_keycode_enum();
|
2016-03-04 23:10:00 +00:00
|
|
|
filename = generate_style();
|
2016-05-25 22:43:58 +00:00
|
|
|
filename = generate_custom_headers();
|
2016-02-25 23:52:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// BOTTOM
|
|
|
|
|