[fpc-pascal] Trouble integrating examples into fpcdoc

Michael Van Canneyt michael at freepascal.org
Mon Apr 5 08:53:52 CEST 2021



On Mon, 5 Apr 2021, Noel Duffy via fpc-pascal wrote:

> 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?

It is 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.

None of the examples are compiled when you make the documentation.

>
> 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.
> #######################################################################

The OBJECTS= line should be before that remark.

Michael.


More information about the fpc-pascal mailing list