RB_Say ("generating documentation for \"%s\"\n", cur_header->name);
+#if 1
+ /* If MAIN_HEADER, do not create file */
+ if (cur_header->type == MAIN_HEADER)
+ continue;
+#endif
+
if (output_mode == HTML)
{
- sprintf(fname, "%s_%s.html", doc_base, cur_header->function_name);
+ sprintf(fname, "%s-%s.html", doc_base, cur_header->function_name);
dest_doc = fopen(fname, "w");
if (!dest_doc)
{
}
}
- RB_Generate_Header_Start (dest_doc, cur_header);
+ RB_Generate_Header_Start (dest_doc, cur_header, src_name);
next_line = cur_header->contents;
item_type = RB_Find_Item (&next_line, &item_line);
else
fprintf (dest_doc, "@database %s\n", name);
fprintf (dest_doc, "@rem Source: %s\n", src_name);
- fprintf (dest_doc, "@rem " COMMENT_ROBODOC);
+/* fprintf (dest_doc, "@rem " COMMENT_ROBODOC); */
fprintf (dest_doc, "@rem " COMMENT_COPYRIGHT);
fprintf (dest_doc, "@node Main %s\n", name);
fprintf (dest_doc, "@{jcenter}\n");
#endif
/* Generate quick index file, for fast referencing */
- sprintf(iname, "%s_index.tmpl", doc_base);
+ sprintf(iname, "%s-index.tmpl", doc_base);
index = fopen(iname, "w");
if (!index)
{
{
char fname[256];
- sprintf(fname, "%s_%s.html", RB_FilePart(doc_base),
+ sprintf(fname, "%s-%s.html", RB_FilePart(doc_base),
cur_header->function_name);
if (cur_header->name && cur_header->function_name)
int item_type;
char *next_line, *item_line = NULL;
- RB_Generate_Header_Start (dest_doc, cur_header);
+ RB_Generate_Header_Start (dest_doc, cur_header,
+ src_name);
next_line = cur_header->contents;
item_type = RB_Find_Item (&next_line, &item_line);
if (index)
{
- fprintf (index, " >> <A HREF=\"%s\">%s</A><BR>\n",
+ fprintf (index, "<A HREF=\"%s\"><IMG SRC=\"index_pic.gif\" BORDER=\"0\" ALT=\"\">%s</A><BR>\n",
name, cur_header->function_name);
}
fprintf (dest_doc, "<LI><A HREF=\"%s\">%s</A>\n",
fname, cur_header->function_name);
if (index)
- fprintf (index, " >> <A HREF=\"%s\">%s</A><BR>\n",
+ fprintf (index, "<A HREF=\"%s\"><IMG SRC=\"index_pic.gif\" BORDER=\"0\" ALT=\"\">%s</A><BR>\n",
fname, cur_header->function_name);
}
}
case LATEX:
fprintf (dest_doc, "%% Document: %s\n", name);
- fprintf (dest_doc, "%% Source: %s\n", src_name);
- fprintf (dest_doc, "%% " COMMENT_ROBODOC);
+ fprintf (dest_doc, "%% Source: %s\n", src_name);
+/* fprintf (dest_doc, "%% " COMMENT_ROBODOC);*/
fprintf (dest_doc, "%% " COMMENT_COPYRIGHT);
if (course_of_action & DO_SINGLEDOC) {
- fprintf (dest_doc, "\\section{%s}\n", src_name);
+ if (!strchr(src_name, '_')) {
+ fprintf (dest_doc, "\\section{%s}\n", src_name);
+ } else {
+ char *tmp = calloc(strlen(src_name) + 2, sizeof(*tmp));
+ *strchr(src_name, '_') = '\\';
+ strncat(tmp, src_name, strcspn(src_name, "\\") + 1);
+ strncat(tmp, "_", 1);
+ strncat(tmp, src_name + strcspn(src_name, "\\") + 1,
+ strlen(src_name) - strcspn(src_name, "\\") - 1);
+ fprintf (dest_doc, "\\section{%s}\n", tmp);
+ free(tmp);
+ }
} else {
fprintf (dest_doc, "\\documentclass{article}\n");
fprintf (dest_doc, "\\usepackage{makeidx}\n");
} else {
fprintf (dest_doc, "\\title{API Reference}\n");
}
- fprintf (dest_doc, "\\author{%s}\n", COMMENT_ROBODOC);
+/* fprintf (dest_doc, "\\author{%s}\n", COMMENT_ROBODOC); */
fprintf (dest_doc, "\\makeindex\n");
fprintf (dest_doc, "\\begin{document}\n");
fprintf (dest_doc, "\\maketitle\n");
"{\\title %s}"
"{\\comment\n"
" Source: %s\n"
- " " COMMENT_ROBODOC
" " COMMENT_COPYRIGHT
"}"
"}", name, src_name);
*/
void
-RB_Generate_Header_Start (FILE * dest_doc, struct RB_header *cur_header)
+RB_Generate_Header_Start (FILE * dest_doc, struct RB_header *cur_header,
+ const char *src_name)
{
char *cook_link;
#endif
if (cur_header->type == FUNCTION_HEADER)
fprintf (dest_doc,
- "\n<FONT SIZE=\"+3\" COLOR=\"#000044\"><B>"
+ "\n<FONT SIZE=\"+2\" COLOR=\"#000055\"><B>"
"Function <A NAME=\"%s\">%s</A>"
"</FONT></B><BR><BR>\n\n",
cur_header->function_name,
cur_header->function_name);
else if (cur_header->type == STRUCT_HEADER)
fprintf (dest_doc,
- "\n<FONT SIZE=\"+3\" COLOR=\"#000044\"><B>"
+ "\n<FONT SIZE=\"+2\" COLOR=\"#000055\"><B>"
"Structure <A NAME=\"%s\">%s</A>"
"</FONT></B><BR><BR>\n\n",
cur_header->function_name,
cur_header->function_name);
else if (cur_header->type == VARIABLE_HEADER)
fprintf (dest_doc,
- "\n<FONT SIZE=\"+3\" COLOR=\"#000044\"><B>"
+ "\n<FONT SIZE=\"+2\" COLOR=\"#000055\"><B>"
"Variable <A NAME=\"%s\">%s</A>"
"</FONT></B><BR><BR>\n\n",
cur_header->function_name,
cur_header->function_name);
+ else if (cur_header->type == MAIN_HEADER)
+ fprintf (dest_doc,
+ "\n<FONT SIZE=\"+2\" COLOR=\"#000055\"><B>"
+ "<A NAME=\"%s\">%s</A>"
+ "</FONT></B><BR><SMALL>Header: %s</SMALL><BR><BR>\n\n",
+ cur_header->function_name,
+ cur_header->function_name, src_name);
else
fprintf (dest_doc,
- "\n<FONT SIZE=\"+3\" COLOR=\"#000044\"><B>"
+ "\n<FONT SIZE=\"+2\" COLOR=\"#000055\"><B>"
"<A NAME=\"%s\">%s</A>"
"</FONT></B><BR><BR>\n\n",
cur_header->function_name,
fprintf (dest_doc, format_str,
att_start_command[MAKE_BOLD][output_mode]);
if (output_mode == HTML)
- fprintf (dest_doc, "\n<FONT COLOR=\"#000044\">");
+ fprintf (dest_doc, "\n<FONT COLOR=\"#000055\">");
fprintf (dest_doc, format_str, item_names[item_type]);
if (output_mode == HTML)
fprintf (dest_doc, "\n</FONT>");
}
else if (file_name && strcmp (file_name, dest_name))
{
+#if 0
fprintf (dest_doc, "<A HREF=\"%s#%s\">%s</A>",
file_name, label_name, label_name);
+#endif
+ fprintf (dest_doc, "<A HREF=\"%s-%s.html\">%s</A>",
+ RB_FilePartStart(file_name), label_name,
+ label_name);
}
else
{
fprintf (dest_doc, "<A HREF=\"#%s\">%s</A>",
label_name, label_name);
#endif
- fprintf (dest_doc, "<A HREF=\"%s_%s.html\">%s</A>",
+ fprintf (dest_doc, "<A HREF=\"%s-%s.html\">%s</A>",
RB_FilePart(doc_base), label_name,
label_name);
}
if (strncmp ("http://", cur_char, strlen ("http://")) == 0)
{
- sscanf (cur_char, "%s", link);
+ sscanf (cur_char, "%1023s", link);
RB_Say ("found link %s\n", link);
res = (strlen (link) - 1);
fprintf (dest_doc, "<A HREF=\"%s\">%s</A>", link, link);
else if (strncmp ("href:", cur_char, strlen ("href:")) == 0)
{
/* handy in relative hyperlink paths, e.g. href:../../modulex/ */
- sscanf ((cur_char + strlen ("href:")), "%s", link);
+ sscanf ((cur_char + strlen ("href:")), "%1023s", link);
RB_Say ("found link %s\n", link);
res = (strlen (link) + strlen ("href:") - 1);
fprintf (dest_doc, "<A HREF=\"%s\">%s</A>", link, link);
}
else if (strncmp ("mailto:", cur_char, strlen ("mailto:")) == 0)
{
- sscanf ((cur_char + strlen ("mailto:")), "%s", link);
+ sscanf ((cur_char + strlen ("mailto:")), "%1023s", link);
RB_Say ("found mail to %s\n", link);
res = (strlen (link) + strlen ("mailto:") - 1);
fprintf (dest_doc, "<A HREF=\"mailto:%s\">%s</A>", link, link);
fprintf (dest, "<H1>Master Index File</H1>\n");
}
if (RB_Number_Of_Links (MAIN_HEADER, NULL))
- RB_Generate_Index_Table (dest, MAIN_HEADER, "Project Modules");
- RB_Generate_Index_Table (dest, NO_HEADER, "Source Files");
+ RB_Generate_Index_Table (dest, MAIN_HEADER, "Modules");
+// RB_Generate_Index_Table (dest, NO_HEADER, "Source Files");
if (RB_Number_Of_Links (CLASS_HEADER, NULL))
RB_Generate_Index_Table (dest, CLASS_HEADER, "Classes");
if (RB_Number_Of_Links (METHOD_HEADER, NULL))
if (RB_Number_Of_Links (FUNCTION_HEADER, NULL))
RB_Generate_Index_Table (dest, FUNCTION_HEADER, "Functions");
if (RB_Number_Of_Links (VARIABLE_HEADER, NULL))
- RB_Generate_Index_Table (dest, VARIABLE_HEADER, "Variables");
+ RB_Generate_Index_Table (dest, VARIABLE_HEADER, "Global Variables");
if (RB_Number_Of_Links (CONSTANT_HEADER, NULL))
RB_Generate_Index_Table (dest, CONSTANT_HEADER, "Constants");
if (RB_Number_Of_Links (GENERIC_HEADER, NULL))
if (RB_Number_Of_Links (NO_HEADER, cur_link->file_name) > 1)
{
fprintf (dest,
- "<TD><A HREF=\"%s#%s\"><TT>%s</TT></A></TD>\n",
- cur_link->file_name, cur_link->label_name,
+ "<TD><A HREF=\"%s-%s.html\"><TT>%s</TT></A></TD>\n",
+ RB_FilePartStart(cur_link->file_name),
+ cur_link->label_name,
cur_link->label_name);
}
else
}
else
{
- fprintf (dest, "<TD><A HREF=\"%s#%s\"><TT>%s</TT></A></TD>\n",
- cur_link->file_name, cur_link->label_name,
+ if (type == MAIN_HEADER)
+ {
+ fprintf (dest, "<TD><A HREF=\"%s.html\"><TT>%s</TT></A></TD>\n",
+ RB_FilePartStart(cur_link->file_name),
cur_link->label_name);
+ }
+ else
+ {
+ fprintf (dest, "<TD><A HREF=\"%s-%s.html\"><TT>%s</TT></A></TD>\n",
+ RB_FilePartStart(cur_link->file_name),
+ cur_link->label_name,
+ cur_link->label_name);
+ }
};
cur_column++;
if (cur_column > number_of_columns)