[fpc-pascal] Trouble integrating examples into fpcdoc

Noel Duffy noelduffy at xtra.co.nz
Mon Apr 5 10:30:04 CEST 2021


On 5/04/21 18:53, Michael Van Canneyt via fpc-pascal wrote:
> 
> 
> 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.

Great, thanks. That makes the way ahead quite straightforward.

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

Yes, I realised after I'd posted it that I should have said when running 
"make examples" or "make linuxexamples".

Anyway, I have enough information now to start adding example programs.



More information about the fpc-pascal mailing list