mr4th-public
/
4coder
1
Fork 0
Code Issues Releases Activity

finished up string docs, enhanced the match check rule

master
Allen Webster 2016-07-12 18:17:45 -04:00
parent 37a8609e5b
commit 92014e2ee8
7 changed files with 1199 additions and 652 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

761
4coder_API.html
View File

File diff suppressed because it is too large Load Diff

9
4coder_default_building.cpp
View File

@ -283,9 +283,18 @@ parse_error(String line, Jump_Location *location,
else{ else{
int colon_pos1 = find(line, 0, ':'); int colon_pos1 = find(line, 0, ':');
if (colon_pos1 == 1){
if (line.size > colon_pos1+1){
if (char_is_slash(line.str[colon_pos1+1])){
colon_pos1 = find(line, colon_pos1+1, ':');
}
}
}
int colon_pos2 = find(line, colon_pos1+1, ':'); int colon_pos2 = find(line, colon_pos1+1, ':');
int colon_pos3 = find(line, colon_pos2+1, ':'); int colon_pos3 = find(line, colon_pos2+1, ':');
if (gcc_style_verify(line, colon_pos3)){ if (gcc_style_verify(line, colon_pos3)){
String filename = substr(line, 0, colon_pos1); String filename = substr(line, 0, colon_pos1);
String line_number = substr(line, colon_pos1+1, colon_pos2 - colon_pos1 - 1); String line_number = substr(line, colon_pos1+1, colon_pos2 - colon_pos1 - 1);

15
4coder_search.cpp
View File

@ -207,12 +207,23 @@ match_check(Application_Links *app, Search_Range *range, int *pos, Search_Match
} }
} }
else{ else{
char prev = buffer_get_char(app, &result.buffer, result.start - 1); char first = word.str[0];
char prev = ' ';
if (char_is_alpha_numeric(first)){
prev = buffer_get_char(app, &result.buffer, result.start - 1);
}
if (!char_is_alpha_numeric(prev)){ if (!char_is_alpha_numeric(prev)){
result.end = result.start + word.size; result.end = result.start + word.size;
if (result.end <= end_pos){ if (result.end <= end_pos){
char next = buffer_get_char(app, &result.buffer, result.end); char last = word.str[word.size-1];
char next = ' ';
if (char_is_alpha_numeric(last)){
next = buffer_get_char(app, &result.buffer, result.end);
}
if (!char_is_alpha_numeric(next)){ if (!char_is_alpha_numeric(next)){
result.found_match = true; result.found_match = true;
found_match = FindResult_FoundMatch; found_match = FindResult_FoundMatch;

151
4coder_string.h
View File

@ -40,17 +40,16 @@ struct Offset_String{
#ifndef FCODER_STRING_H #ifndef FCODER_STRING_H
#define FCODER_STRING_H #define FCODER_STRING_H
FSTRING_INLINE fstr_bool char_not_slash(char c);
FSTRING_INLINE fstr_bool char_is_slash(char c); FSTRING_INLINE fstr_bool char_is_slash(char c);
FSTRING_INLINE char char_to_upper(char c); FSTRING_INLINE char char_to_upper(char c);
FSTRING_INLINE char char_to_lower(char c); FSTRING_INLINE char char_to_lower(char c);
FSTRING_INLINE fstr_bool char_is_whitespace(char c); FSTRING_INLINE fstr_bool char_is_whitespace(char c);
FSTRING_INLINE fstr_bool char_is_alpha_numeric(char c); FSTRING_INLINE fstr_bool char_is_alpha_numeric(char c);
FSTRING_INLINE fstr_bool char_is_hex(char c); FSTRING_INLINE fstr_bool char_is_alpha_numeric_true(char c);
FSTRING_INLINE fstr_bool char_is_numeric(char c);
FSTRING_INLINE fstr_bool char_is_alpha(char c); FSTRING_INLINE fstr_bool char_is_alpha(char c);
FSTRING_INLINE fstr_bool char_is_alpha_true(char c); FSTRING_INLINE fstr_bool char_is_alpha_true(char c);
FSTRING_INLINE fstr_bool char_is_alpha_numeric_true(char c); FSTRING_INLINE fstr_bool char_is_hex(char c);
FSTRING_INLINE fstr_bool char_is_numeric(char c);
FSTRING_INLINE String string_zero(); FSTRING_INLINE String string_zero();
FSTRING_INLINE String make_string(void *str, int32_t size, int32_t mem_size); FSTRING_INLINE String make_string(void *str, int32_t size, int32_t mem_size);
FSTRING_INLINE String make_string(void *str, int32_t size); FSTRING_INLINE String make_string(void *str, int32_t size);
@ -67,10 +66,10 @@ FSTRING_LINK int32_t str_size(char *str);
FSTRING_INLINE String make_string_slowly(void *str); FSTRING_INLINE String make_string_slowly(void *str);
FSTRING_INLINE String substr(String str, int32_t start); FSTRING_INLINE String substr(String str, int32_t start);
FSTRING_INLINE String substr(String str, int32_t start, int32_t size); FSTRING_INLINE String substr(String str, int32_t start, int32_t size);
FSTRING_INLINE String tailstr(String str);
FSTRING_LINK String skip_whitespace(String str); FSTRING_LINK String skip_whitespace(String str);
FSTRING_LINK String chop_whitespace(String str); FSTRING_LINK String chop_whitespace(String str);
FSTRING_LINK String skip_chop_whitespace(String str); FSTRING_LINK String skip_chop_whitespace(String str);
FSTRING_INLINE String tailstr(String str);
FSTRING_LINK fstr_bool match(char *a, char *b); FSTRING_LINK fstr_bool match(char *a, char *b);
FSTRING_LINK fstr_bool match(String a, char *b); FSTRING_LINK fstr_bool match(String a, char *b);
FSTRING_INLINE fstr_bool match(char *a, String b); FSTRING_INLINE fstr_bool match(char *a, String b);
@ -109,7 +108,7 @@ FSTRING_INLINE fstr_bool has_substr(String s, String seek);
FSTRING_INLINE fstr_bool has_substr_insensitive(char *s, String seek); FSTRING_INLINE fstr_bool has_substr_insensitive(char *s, String seek);
FSTRING_INLINE fstr_bool has_substr_insensitive(String s, String seek); FSTRING_INLINE fstr_bool has_substr_insensitive(String s, String seek);
FSTRING_LINK int32_t copy_fast_unsafe(char *dest, char *src); FSTRING_LINK int32_t copy_fast_unsafe(char *dest, char *src);
FSTRING_LINK void copy_fast_unsafe(char *dest, String src); FSTRING_LINK int32_t copy_fast_unsafe(char *dest, String src);
FSTRING_LINK fstr_bool copy_checked(String *dest, String src); FSTRING_LINK fstr_bool copy_checked(String *dest, String src);
FSTRING_LINK fstr_bool copy_partial(String *dest, char *src); FSTRING_LINK fstr_bool copy_partial(String *dest, char *src);
FSTRING_LINK fstr_bool copy_partial(String *dest, String src); FSTRING_LINK fstr_bool copy_partial(String *dest, String src);
@ -160,78 +159,81 @@ FSTRING_LINK fstr_bool string_set_match(String *str_set, int32_t count, S
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_not_slash(char c){ char_is_slash(char c)
return (c != '\\' && c != '/'); {
}
#endif
#ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool
char_is_slash(char c){
return (c == '\\' || c == '/'); return (c == '\\' || c == '/');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE char FSTRING_INLINE char
char_to_upper(char c){ char_to_upper(char c)
{
return (c >= 'a' && c <= 'z') ? c + (char)('A' - 'a') : c; return (c >= 'a' && c <= 'z') ? c + (char)('A' - 'a') : c;
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE char FSTRING_INLINE char
char_to_lower(char c){ char_to_lower(char c)
{
return (c >= 'A' && c <= 'Z') ? c - (char)('A' - 'a') : c; return (c >= 'A' && c <= 'Z') ? c - (char)('A' - 'a') : c;
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_whitespace(char c){ char_is_whitespace(char c)
{
return (c == ' ' || c == '\n' || c == '\r' || c == '\t'); return (c == ' ' || c == '\n' || c == '\r' || c == '\t');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_alpha_numeric(char c){ char_is_alpha_numeric(char c)
{
return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9' || c == '_'); return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9' || c == '_');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_hex(char c){ char_is_alpha_numeric_true(char c)
return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f'; {
return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_numeric(char c){ char_is_alpha(char c)
return (c >= '0' && c <= '9'); {
}
#endif
#ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool
char_is_alpha(char c){
return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c == '_'); return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c == '_');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_alpha_true(char c){ char_is_alpha_true(char c)
{
return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z'); return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z');
} }
#endif #endif
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool FSTRING_INLINE fstr_bool
char_is_alpha_numeric_true(char c){ char_is_hex(char c)
return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9'); {
return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f';
}
#endif
#ifndef FSTRING_GUARD
FSTRING_INLINE fstr_bool
char_is_numeric(char c)
{
return (c >= '0' && c <= '9');
} }
#endif #endif
@ -242,7 +244,8 @@ char_is_alpha_numeric_true(char c){
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE String FSTRING_INLINE String
string_zero(){ string_zero()
{
String str={0}; String str={0};
return(str); return(str);
} }
@ -250,7 +253,8 @@ string_zero(){
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE String FSTRING_INLINE String
make_string(void *str, int32_t size, int32_t mem_size){ make_string(void *str, int32_t size, int32_t mem_size)
{
String result; String result;
result.str = (char*)str; result.str = (char*)str;
result.size = size; result.size = size;
@ -272,7 +276,8 @@ make_string(void *str, int32_t size){
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK int32_t FSTRING_LINK int32_t
str_size(char *str){ str_size(char *str)
{
int32_t i = 0; int32_t i = 0;
while (str[i]) ++i; while (str[i]) ++i;
return i; return i;
@ -281,7 +286,8 @@ str_size(char *str){
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE String FSTRING_INLINE String
make_string_slowly(void *str){ make_string_slowly(void *str)
{
String result; String result;
result.str = (char*)str; result.str = (char*)str;
result.size = str_size((char*)str); result.size = str_size((char*)str);
@ -292,11 +298,12 @@ make_string_slowly(void *str){
// TODO(allen): I don't love the substr rule, I chose // TODO(allen): I don't love the substr rule, I chose
// substr(String, start) and substr(String, start, size) // substr(String, start) and substr(String, start, size)
// but I wish I had substr(String, end) and substr(String, start, end) // but I wish I had substr(String, start) and substr(String, start, end)
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE String FSTRING_INLINE String
substr(String str, int32_t start){ substr(String str, int32_t start)
{
String result; String result;
result.str = str.str + start; result.str = str.str + start;
result.size = str.size - start; result.size = str.size - start;
@ -307,7 +314,8 @@ substr(String str, int32_t start){
#ifndef FSTRING_GUARD #ifndef FSTRING_GUARD
FSTRING_INLINE String FSTRING_INLINE String
substr(String str, int32_t start, int32_t size){ substr(String str, int32_t start, int32_t size)
{
String result; String result;
result.str = str.str + start; result.str = str.str + start;
result.size = size; result.size = size;
@ -319,20 +327,10 @@ substr(String str, int32_t start, int32_t size){
} }
#endif #endif
#ifndef FSTRING_GUARD
FSTRING_INLINE String
tailstr(String str){
String result;
result.str = str.str + str.size;
result.memory_size = str.memory_size - str.size;
result.size = 0;
return(result);
}
#endif
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK String FSTRING_LINK String
skip_whitespace(String str){ skip_whitespace(String str)
{
String result = {0}; String result = {0};
int i = 0; int i = 0;
for (; i < str.size && char_is_whitespace(str.str[i]); ++i); for (; i < str.size && char_is_whitespace(str.str[i]); ++i);
@ -343,7 +341,8 @@ skip_whitespace(String str){
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK String FSTRING_LINK String
chop_whitespace(String str){ chop_whitespace(String str)
{
String result = {0}; String result = {0};
int i = str.size; int i = str.size;
for (; i > 0 && char_is_whitespace(str.str[i-1]); --i); for (; i > 0 && char_is_whitespace(str.str[i-1]); --i);
@ -354,13 +353,26 @@ chop_whitespace(String str){
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK String FSTRING_LINK String
skip_chop_whitespace(String str){ skip_chop_whitespace(String str)
{
str = skip_whitespace(str); str = skip_whitespace(str);
str = chop_whitespace(str); str = chop_whitespace(str);
return(str); return(str);
} }
#endif #endif
#ifndef FSTRING_GUARD
FSTRING_INLINE String
tailstr(String str)
{
String result;
result.str = str.str + str.size;
result.memory_size = str.memory_size - str.size;
result.size = 0;
return(result);
}
#endif
// //
// String Comparison // String Comparison
@ -914,18 +926,19 @@ copy_fast_unsafe(char *dest, char *src){
++dest; ++dest;
++src; ++src;
} }
return (int)(dest - start); return (int32_t)(dest - start);
} }
#endif #endif
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK void FSTRING_LINK int32_t
copy_fast_unsafe(char *dest, String src){ copy_fast_unsafe(char *dest, String src){
int32_t i = 0; int32_t i = 0;
while (i != src.size){ while (i != src.size){
dest[i] = src.str[i]; dest[i] = src.str[i];
++i; ++i;
} }
return(src.size);
} }
#endif #endif
@ -967,23 +980,17 @@ copy_partial(String *dest, char *src){
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK fstr_bool FSTRING_LINK fstr_bool
copy_partial(String *dest, String src){ copy_partial(String *dest, String src){
fstr_bool result;
int32_t memory_size = dest->memory_size;
char *dest_str = dest->str; char *dest_str = dest->str;
if (memory_size < src.size){ int32_t memory_size = dest->memory_size;
result = 0; fstr_bool result = false;
if (memory_size >= src.size){
result = true;
memory_size = src.size;
}
for (int32_t i = 0; i < memory_size; ++i){ for (int32_t i = 0; i < memory_size; ++i){
dest_str[i] = src.str[i]; dest_str[i] = src.str[i];
} }
dest->size = memory_size; dest->size = memory_size;
}
else{
result = 1;
for (int32_t i = 0; i < src.size; ++i){
dest_str[i] = src.str[i];
}
dest->size = src.size;
}
return result; return result;
} }
#endif #endif
@ -1069,7 +1076,8 @@ append(String *dest, char *src){
#endif #endif
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK fstr_bool terminate_with_null(String *str){ FSTRING_LINK fstr_bool
terminate_with_null(String *str){
fstr_bool result = 0; fstr_bool result = 0;
if (str->size < str->memory_size){ if (str->size < str->memory_size){
str->str[str->size] = 0; str->str[str->size] = 0;
@ -1084,7 +1092,7 @@ FSTRING_LINK fstr_bool
append_padding(String *dest, char c, int32_t target_size){ append_padding(String *dest, char c, int32_t target_size){
fstr_bool result = 1; fstr_bool result = 1;
int32_t offset = target_size - dest->size; int32_t offset = target_size - dest->size;
int32_t r; int32_t r = 0;
if (offset > 0){ if (offset > 0){
for (r = 0; r < offset; ++r){ for (r = 0; r < offset; ++r){
if (append(dest, c) == 0){ if (append(dest, c) == 0){
@ -1106,8 +1114,7 @@ append_padding(String *dest, char c, int32_t target_size){
FSTRING_LINK void FSTRING_LINK void
replace_char(String *str, char replace, char with){ replace_char(String *str, char replace, char with){
char *s = str->str; char *s = str->str;
int32_t i; int32_t i = 0;
for (i = 0; i < str->size; ++i, ++s){ for (i = 0; i < str->size; ++i, ++s){
if (*s == replace) *s = with; if (*s == replace) *s = with;
} }
@ -1364,7 +1371,7 @@ str_to_int(String str){
#ifdef FSTRING_IMPLEMENTATION #ifdef FSTRING_IMPLEMENTATION
FSTRING_LINK int32_t FSTRING_LINK int32_t
hexchar_to_int(char c){ hexchar_to_int(char c){
int32_t x; int32_t x = 0;
if (c >= '0' && c <= '9'){ if (c >= '0' && c <= '9'){
x = c-'0'; x = c-'0';
} }
@ -1461,7 +1468,7 @@ hexstr_to_color(String s, uint32_t *out){
FSTRING_LINK int32_t FSTRING_LINK int32_t
reverse_seek_slash(String str, int32_t pos){ reverse_seek_slash(String str, int32_t pos){
int32_t i = str.size - 1 - pos; int32_t i = str.size - 1 - pos;
while (i >= 0 && char_not_slash(str.str[i])){ while (i >= 0 && !char_is_slash(str.str[i])){
--i; --i;
} }
return i; return i;

156
4ed_metagen.cpp
View File

@ -1508,7 +1508,10 @@ do_macro_parse(int *index, Cpp_Token **token_ptr, int count,
if (i > 0){ if (i > 0){
Cpp_Token *doc_token = token-1; Cpp_Token *doc_token = token-1;
macro_set.doc_string[sig_count] = make_string(file.data + doc_token->start, doc_token->size); String doc_string = make_string(file.data + doc_token->start, doc_token->size);
if (check_and_fix_docs(&doc_string)){
macro_set.doc_string[sig_count] = doc_string;
for (; i < count; ++i, ++token){ for (; i < count; ++i, ++token){
if (token->type == CPP_TOKEN_IDENTIFIER){ if (token->type == CPP_TOKEN_IDENTIFIER){
@ -1564,6 +1567,7 @@ do_macro_parse(int *index, Cpp_Token **token_ptr, int count,
} }
} }
} }
}
*index = i; *index = i;
*token_ptr = token; *token_ptr = token;
@ -1662,6 +1666,61 @@ print_function_body_code(FILE *file, int *index, Cpp_Token **token_ptr, int coun
*token_ptr = token; *token_ptr = token;
} }
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);
}
char* char*
generate_custom_headers(){ generate_custom_headers(){
#define API_H "4coder_custom_api.h" #define API_H "4coder_custom_api.h"
@ -2407,6 +2466,7 @@ generate_custom_headers(){
"<h2 id='section_%s'>&sect;"MAJOR_SECTION" %s</h2>\n", "<h2 id='section_%s'>&sect;"MAJOR_SECTION" %s</h2>\n",
sections[1].id_string, sections[1].id_string,
sections[1].display_string); sections[1].display_string);
{ {
fprintf(file, fprintf(file,
"<div><i>\n" "<div><i>\n"
@ -2504,8 +2564,8 @@ generate_custom_headers(){
fprintf(file, fprintf(file,
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n" "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
name.size, name.str, i+1, name.size, name.str, i+1,
name.size, name.str name.size, name.str
); );
@ -2513,55 +2573,7 @@ generate_custom_headers(){
fprintf(file, "</div>\n"); fprintf(file, "</div>\n");
String doc_string = function_set.doc_string[i]; String doc_string = function_set.doc_string[i];
if (doc_string.size == 0){ print_function_docs(file, part, name, doc_string);
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 = &function_set.doc[i];
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);
fprintf(file, "</div><hr>\n"); fprintf(file, "</div><hr>\n");
} }
@ -2577,8 +2589,8 @@ generate_custom_headers(){
fprintf(file, fprintf(file,
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n" "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
name.size, name.str, I, name.size, name.str, I,
name.size, name.str name.size, name.str
); );
@ -2620,8 +2632,8 @@ generate_custom_headers(){
fprintf(file, fprintf(file,
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n" "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
name.size, name.str, I, name.size, name.str, I,
name.size, name.str name.size, name.str
); );
@ -2681,8 +2693,8 @@ generate_custom_headers(){
fprintf(file, fprintf(file,
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n" "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
name.size, name.str, I, name.size, name.str, I,
name.size, name.str name.size, name.str
); );
@ -2743,8 +2755,8 @@ generate_custom_headers(){
String name = member->name; String name = member->name;
fprintf(file, fprintf(file,
"<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n" "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
name.size, name.str, I, name.size, name.str, I,
name.size, name.str name.size, name.str
); );
@ -2796,6 +2808,20 @@ generate_custom_headers(){
#undef SECTION #undef SECTION
#define SECTION MAJOR_SECTION".1" #define SECTION MAJOR_SECTION".1"
fprintf(file,
"<h3>&sect;"SECTION" String Intro</h3>\n"
"<ul>\n");
{
fprintf(file,
"<div><i>\n"
"Coming Soon"
"</i><div>\n");
}
#undef SECTION
#define SECTION MAJOR_SECTION".2"
fprintf(file, fprintf(file,
"<h3>&sect;"SECTION" String Function List</h3>\n" "<h3>&sect;"SECTION" String Function List</h3>\n"
"<ul>\n"); "<ul>\n");
@ -2828,7 +2854,7 @@ generate_custom_headers(){
used_string_count = 0; used_string_count = 0;
#undef SECTION #undef SECTION
#define SECTION MAJOR_SECTION".2" #define SECTION MAJOR_SECTION".3"
fprintf(file, fprintf(file,
"<h3>&sect;"SECTION" String Function Descriptions</h3>\n" "<h3>&sect;"SECTION" String Function Descriptions</h3>\n"
@ -2854,8 +2880,8 @@ generate_custom_headers(){
} }
fprintf(file, fprintf(file,
" <h4>&sect;"SECTION".%d: %.*s</h4>\n" "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
" <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>\n", "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>\n",
i+1, name.size, name.str); i+1, name.size, name.str);
if (string_function_set.is_macro[i]){ if (string_function_set.is_macro[i]){
@ -2867,6 +2893,10 @@ generate_custom_headers(){
fprintf(file, "</div>\n"); fprintf(file, "</div>\n");
String doc_string = string_function_set.doc_string[i];
print_function_docs(file, part, name, doc_string);
fprintf(file, "</div><hr>\n"); fprintf(file, "</div><hr>\n");
} }
} }

144
README.txt
View File

@ -1,4 +1,4 @@
Distribution Date: 11.7.2016 (dd.mm.yyyy) Distribution Date: 12.7.2016 (dd.mm.yyyy)
Thank you for contributing to the 4coder project! Thank you for contributing to the 4coder project!
@ -27,63 +27,6 @@ if you start digging and pressing hard enough.
INSTRUCTIONS FOR USE INSTRUCTIONS FOR USE
----------------------------------------------------- -----------------------------------------------------
****Changes in 4.0.7****
Right clicking in a buffer now sets the mark.
alt + d: brings up the debug view from which there are several options:
i - input
m - memory and threads
v - views
more debug features coming in the future. This is mostly here so that
I can help everyone gather better data for bug reports and get them
fixed more easily.
****Changes in 4.0.5****
Improved indentation rule
****Changes in 4.0.3****
4coder now uses 0% CPU when you are not using it.
There is a scrollbar on files now. (It is not the nicest scrollbar to use in the world,
but the real purpose it serves is to indicate where in a file you are. I imagine most
scrolling will still happen with the wheel or cursor navigation.)
File lists are now arrow navigatable and scrollable... these two systems do no work
together very well yet.
Color adjusting is possible again, but the UI is heavily downgraded from the fancieness
of the old system.
While editing:
alt + Z: execute command line with the same output buffer and same command
as in the previous use of "alt + z".
****Changes in 4.0.2****
The previous file limit of 128 has been raised to something over 8 million.
A *messages* buffer is now opened on launch to provide some information about
new features and messages will be posted there to report events sometimes.
subst and link directories no longer confuse the system, it treats them as one file.
on the command line: -f <N> sets the font size, the default is 16
ctrl + e: centers the view on the cursor
****Changes in 4.0.0****
alt + x: changed to arbitrary command (NOW WORKS ANYWHERE!)
Opens a command prompt from which you can execute:
"open menu" to open the menu (old behavior of alt+x)
"open all code" loads all cpp and h files in current directory
"close all code" closes all cpp and h files currently open
"open in quotes" opens the file who's name under the cursor is surrounded by quotes
"dos lines" dosify the file end of iles
"nix lines" nixify the file end of iles
alt + z: execute arbitrary command-line command
Specify an output buffer and a command to execute
and the results will be dropped into the specified buffer.
****Command line options**** ****Command line options****
4ed [<files-to-open>] [options] 4ed [<files-to-open>] [options]
@ -101,12 +44,13 @@ and the results will be dropped into the specified buffer.
-T -- invoke special tool isntead of launching 4coder normally -T -- invoke special tool isntead of launching 4coder normally
-T version : prints the 4coder version string -T version : prints the 4coder version string
****Old Information**** ****Command Bindings****
Basic Navigation: Basic Navigation:
mouse click - move cursor mouse left click - move cursor
mouse right click - set mark
arrows - move cursor arrows - move cursor
home & end - move cursor to beginning/end of line home & end - move cursor to beginning/end of line
page up & page down - page up & page down respectively page up & page down - move up/down by close to the height of the entire screen
control + left/right - move cursor left/right to first whitespace control + left/right - move cursor left/right to first whitespace
control + up/down - move cursor up or down to first blank line control + up/down - move cursor up or down to first blank line
@ -114,13 +58,21 @@ Fancy Navigation:
control + f : begin find mode, uses interaction bar control + f : begin find mode, uses interaction bar
control + r : begin reverse-find mode, uses interaction bar control + r : begin reverse-find mode, uses interaction bar
control + F : list all locations of a word in all open buffers, uses interaction bar
> This command creates a *search* buffer that displays the locations and the line of each
> occurence of the requested word. By positioning the cursor and pressing return the user
> jump to the word's occurence.
While in find mode or reverse-find mode, pressing enter ends the mode While in find mode or reverse-find mode, pressing enter ends the mode
leaving the cursor wherever the find highlighter is, and pressing escape leaving the cursor wherever the find highlighter is, and pressing escape
ends the mode leaving the cursor wherever it was before the find mode began. ends the mode leaving the cursor wherever it was before the find mode began.
control + g - goto line number control + g - goto line number, uses interaction bar
control + m - swap cursor and mark control + m - swap cursor and mark
control + e - center the view vertically on the cursor
control + E - in a view with unwrapped lines move the view to a position just left of the cursor
Basic Editing: Basic Editing:
characters keys, delete, and backspace characters keys, delete, and backspace
control + c : copy between cursor and mark control + c : copy between cursor and mark
@ -129,29 +81,32 @@ control + v : paste at cursor
control + V : use after normal paste to cycle through older copied text control + V : use after normal paste to cycle through older copied text
control + d : delete between cursor and mark control + d : delete between cursor and mark
control + SPACE : set mark to cursor control + SPACE : set mark to cursor
control + backspace : backspace one word
control + delete : delete one word
alt + backspace : snipe one word
Undo and History: Undo and History:
control + z : undo control + z : undo
control + y : redo control + y : redo
control + Z: undo / history timelines
control + h: history back step control + h: history back step
control + H: history forward step control + H: history forward step
alt + left: increase rewind speed (through undo)
alt + right: increase fastforward speed (through redo)
alt + down: stop redining / fastforwarding
Fancy Editing: Fancy Editing:
control + u : to uppercase between cursor and mark control + u : to uppercase between cursor and mark
control + j : to lowercase between cursor and mark control + j : to lowercase between cursor and mark
control + q: query replace control + q : query replace
control + a: replace in range control + a : replace in range
control + =: write increment control + ~ : clean the trailing whitespace off of all lines
control + -: decrement increment
control + [: write {} pair with cursor in line between Fancy Editing in Code Files:
control + {: as <control + [> with a semicolon after "}" control + [ : write "{}" pair with cursor in line between
control + }: as <control + [> with a "break;" after "}" control + { : as control + [ with a semicolon after "}"
control + 9: wrap the range specified by mark and cursor in parens control + } : as control + [ with a "break;" after "}"
control + i: wrap the range specified by mark and cursor in #if 0 #endif control + 0 : write "= {0};" at the cursor
control + i : wrap the range specified by mark and cursor in #if 0 #endif
alt + 1 : if cursor is inside a string, treat the string as a filename and
> try to open the file with that name in the other panel
Whitespace Boringness: Whitespace Boringness:
Typing characters: },],),; and inserting newlines cause the line to autotab Typing characters: },],),; and inserting newlines cause the line to autotab
@ -163,25 +118,42 @@ control + ! : set the flie to nix mode for writing to disk
Viewing Options: Viewing Options:
alt + c - open theme selection UI alt + c - open theme selection UI
alt + d - open debug view
control + p : vertically split the current panel (max 16) control + p : vertically split the current panel (max 16)
control + '-' : horizontally split the current panel (max 16) control + _ : horizontally split the current panel (max 16)
control + P : close the currently selected panel control + P : close the currently selected panel
control + , : switch to another panel control + , : switch to another panel
control + l : toggle line wrapping control + l : toggle line wrapping
control + L : toggle end of line mode
mode 1: treat all \r\n and all \n as newline, show \r when not followed by \n
mode 2: treat all \r and \n as newline
mode 3: treat all \n as newline, show all \r
control + ? : toggle highlight whitespace mode control + ? : toggle highlight whitespace mode
Tools: f2 : toggle mouse suppresion mode
alt + m : search in the current hot directory and up through all parent
alt + s : show the scrollbar in this view
alt + w : hide the scrollbar in this view
Build Tools:
alt + m :
[On Windows] search in the current hot directory and up through all parent
> directories for a build.bat, and execute that bat if it discovered, sending > directories for a build.bat, and execute that bat if it discovered, sending
> output to the buffer *compilation* > output to the buffer *compilation*
[On Linux] The behavior is similar but the search looks for build.sh and if that
> fails it looks for a Makefile
alt + . : change to the build panel
alt + , : close the build panel
alt + n : goto the next error listed in the build panel
alt + N : goto the previous error listed in the build panel
alt + M : goto the first error listed in the build panel
alt + z : execute any command line command you specify and send the output to the buffer you specify
alt + Z : repeat the command previously executed by the alt + z command
File Managing: File Managing:
control + n : create a new file, begins interactive input mode control + n : create a new file, begins interactive input mode
control + o : open file, begins interactive input mode control + o : open file, begins interactive input mode
alt + o : open file in other panel, same as control + o but runs first changes the active view
control + O : reopen the current file control + O : reopen the current file
(discarding any differences the live version has from the file system's version) (discarding any differences the live version has from the file system's version)
control + s : save control + s : save
@ -190,10 +162,10 @@ control + i : switch active file in this panel, begins interactive input mode
control + k : kill (close) a file, begins interactive input mode control + k : kill (close) a file, begins interactive input mode
control + K : kill (close) the file being viewed in the currently active panel control + K : kill (close) the file being viewed in the currently active panel
While in interactive input mode, pressing enter confirms the input for the command, and While in interactive input mode, there are several ways to select an option.
pressing escape (once) will end the input mode and abort the command. If the file does The options can be clicked. One option is always highlighted and pressing
not exist either the nearest match will be opened, or no file will be opened if none is return or tab will select the highlighted option. Arrow keys navigate the
considered a match. Use backspace to go back through directories. highlighted option. Typing in characters narrows down the list of options.
Menu UI Menu UI
Keyboard options: Keyboard options:

521
internal_4coder_string.cpp
View File

File diff suppressed because it is too large Load Diff