Merge cfunctionsdocs branch into trunk. All files now pass t/codingst…

…d/c_functions_docs.t. See http://trac.parrot.org/parrot/ticket/324.

git-svn-id: https://svn.parrot.org/parrot/trunk@47917 d31e2699-5ff4-0310-a27c-f18f2fbe73fe

src/pircapi.c

@@ -17,6 +17,9 @@
 /* HEADERIZER BEGIN: static */
 /* Don't modify between HEADERIZER BEGIN / HEADERIZER END.  Your changes will be lost. */
 
+/* Don't modify between HEADERIZER BEGIN / HEADERIZER END.  Your changes will be lost. */
+/* HEADERIZER END: static */
+
 
 /*
 
@@ -72,16 +75,14 @@ open_file(ARGIN(char const * const filename), ARGIN(char const * const mode))
 =item C<void parse_file(PARROT_INTERP, int flexdebug, FILE *infile, char * const
 filename, int flags, int thr_id, unsigned macro_size, char * const outputfile)>
 
-=cut
-
 This will be the proper declaration after testing for thread-safety:
 
 void parse_file(int flexdebug, FILE *infile, char * const filename, int flags,
                 char * const outputfile)
 
-*/
-
+=cut
 
+*/
 
 void
 parse_file(PARROT_INTERP, int flexdebug, ARGIN(FILE *infile),
@@ -260,6 +261,8 @@ parse_string(PARROT_INTERP, ARGIN(char *pirstring), int flags, int pasminput,
 =item C<PackFile_ByteCode * pirc_compile_file(PARROT_INTERP, const char
 *filename, STRING **error_message)>
 
+Returns NULL.
+
 =cut
 
 */
@@ -274,8 +277,6 @@ pirc_compile_file(SHIM_INTERP, SHIM(const char *filename),
 }
 
 
-/* HEADERIZER END: static */
-
 
 /*