4  *	docproc is used for documentation-frontend and
5  *      dependency-generator.
10  *	documentation-frontend
11  *		Scans the template file and call kernel-doc for
17  *		This is used to create proper -function and
18  *		-nofunction arguments in calls to kernel-doc.
21  *	dependency-generator:
25  *		Writes dependency information to stdout
48 /* exitstatus is used to keep track of any failing calls to kernel-doc,
69 #define KERNELDOC     "kernel-doc"
70 #define DOCBOOK       "-docbook"
71 #define LIST          "-list"
72 #define FUNCTION      "-function"
73 #define NOFUNCTION    "-nofunction"
74 #define NODOCSECTIONS "-no-doc-sections"
98 	fprintf(stderr, "Input is read from file.tmpl. Output is sent to stdout\n");  in usage()
101 	fprintf(stderr, "Environment variable SRCTREE: absolute path to sources.\n");  in usage()
102 	fprintf(stderr, "                     KBUILD_SRC: absolute path to kernel source tree.\n");  in usage()
106  * Execute kernel-doc with parameters given in svec
114 	fflush(stdout);  in exec_kernel_doc()
116 		case -1:  in exec_kernel_doc()
123 					PATH_MAX - strlen(real_filename));  in exec_kernel_doc()
155 	sym->symbollist =  in add_new_symbol()
156           realloc(sym->symbollist, (sym->symbolcnt + 1) * sizeof(char *));  in add_new_symbol()
157 	sym->symbollist[sym->symbolcnt++].name = strdup(symname);  in add_new_symbol()
164 	return &symfilelist[symfilecnt - 1];  in add_new_file()
203 		strncat(real_filename, "/", PATH_MAX - strlen(real_filename));  in find_export_symbols()
205 				PATH_MAX - strlen(real_filename));  in find_export_symbols()
243  * Call kernel-doc with following parameters:
244  * kernel-doc -docbook -nofunction function_name1 filename
247  * intfunc uses -nofunction
248  * extfunc uses -function
269 		for (j=0; j < sym->symbolcnt; j++) {  in docfunctions()
271 			consume_symbol(sym->symbollist[j].name);  in docfunctions()
272 			vec[idx++] = sym->symbollist[j].name;  in docfunctions()
277 	printf("<!-- %s -->\n", filename);  in docfunctions()
279 	fflush(stdout);  in docfunctions()
287  * Call kernel-doc with the following parameters:
288  * kernel-doc -docbook -function function1 [-function function2]
323  * Call kernel-doc with the following parameters:
324  * kernel-doc -docbook -function "doc section" filename
328 	char *vec[6]; /* kerneldoc -docbook -function "section" file NULL */  in docsect()
353 	char *vec[4]; /* kerneldoc -list file NULL */  in find_all_symbols()
372 		case -1:  in find_all_symbols()
381 					PATH_MAX - strlen(real_filename));  in find_all_symbols()
396 			} while (ret == -EAGAIN);  in find_all_symbols()
437  * 7) Default lines - lines not matching the above
493 	fflush(stdout);  in parse_file()
526 		 * and exported in different files :-((  in main()
574 	fflush(stdout);  in main()