[fpc-pascal] Trouble integrating examples into fpcdoc

Noel Duffy noelduffy at xtra.co.nz
Mon Apr 5 07:40:47 CEST 2021


In the fpcdocs subversion project, there are a number of example 
directories each containing one or more small programs and a Makefile. 
My question is, is that Makefile automatically generated, or is it 
hand-crafted?

I'm writing documentation for the netdb module and want to add some 
example programs. I've created the first program and used an example tag 
to reference it within netdb.xml, and this works to show the example 
code in the generated html. But the example program isn't compiled.

Taking the fpcdocs/linuxex example directory, the Makefile references 
the single defined example, ex64.pp, at line 54:

OBJECTS=ex64

This line occurs after this warning:

#######################################################################
# No need to edit after this line.
#######################################################################

Which suggests to me that the Makefiles are generated. But if so, how? I 
can't find anything in the Makefile.fpc at the fpcdocs root to reference 
them.

On the other hand, the Makefiles are committed to the repository, which 
does somewhat suggest that they're not generated.




More information about the fpc-pascal mailing list