How am I supposed to include the autodocs in module.pmod.in to the modref, then? Shall I copy module.pmod.in to a c file or create a dummy c file (bad idea becaue i got MODULE_CLEAN_EXTRA=*.cmod.compiled *.c and don't want to list every single c file except for the dummy file) Everything would work fine if lib/modules/Tools.pmod/Standalone.pmod/extract_autodoc.pike wouldn't care about the file extension.
The autodoc generator at modules.gotpike.org works a bit different. It evaluates every file until it comes to module.pmod.in, drops all other files after that and starts joining the already evaluated docs, which leaves the modref uncompleted.
- Sebastian
Bill Welliver wrote:
you don't want to include module.pmod.in in your autodoc source... that setting is only for c language file extraction where it's not possible to perform a scan for all files.
Bill
On Tue, 29 Mar 2005, Sebastian Kaminski wrote:
hi, when I change AUTODOC_SRC_IN=*.c to AUTODOC_SRC_IN=*.c module.pmod.in in Makefile.in of a third-party module I get
Extracting file "entry.c"... Extracting file "module.pmod.in"... Unknown module parent name. /usr/local/pike/7.7.13/lib/modules/Tools.pmod/Standalone.pmod/extract_autodoc.pike:210:
/main()->extract("module.pmod.in",0,"/home/kaugume/hacking/pgtk2/plib/refd oc/",({"predef::"}))
/usr/local/pike/7.7.13/lib/modules/Tools.pmod/Standalone.pmod/extract_autodoc.pike:75:
/main()->main(24,({"alignment.c","bin.c","box.c","button.c","container.c",
"dialog.c","entry.c","fixed.c","gtk2.c","gtk2_glue.c","hbox.c","hseparator
.c","label.c","misc.c","module.pmod.in.c","object.c","separator.c",,,4}))
make: *** [extract_autodoc] Fehler 1
it's not a problem, with my autodoc comments within my module.pmod.in, because when I copy it to module.pmod.in.c and only extract *.c files everything works fine.
- Sebastian