paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-04-09 01:28:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

Fixes missing links from LazUtils to LCL topics in output formats.

Browse Source 
* Depends on 5e581ce9, 2f595455, b0d263f1.
* LazUtils was never built with external links to LCL (See Also and source declarations) because lcl.xct could not be imported. The file does not exist when LazUtils is built.

To solve this problem, the output format for LazUtils is built twice. It is the smaller of the two packages. Building LazUtils twice ensures that the "chicken or the egg" problem with inter-file links is avoided.

* Build LazUtils WITHOUT any external links (faster).
* Build LCL with links to RTL, FCL, LazUtils.
* Build LazUtils with links to RTL, FCL, LCL.
This commit is contained in:
dsiders 2022-02-24 17:49:10 +00:00
parent 4aedc7625b
commit 7cf2b7390c
1 changed files with 28 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
docs/html/build_lcl_docs.lpr
View File

@ -621,15 +621,30 @@ var
begin
ReadOptions;
{
LazUtils was never built with external links to LCL (See Also and source
declarations) because lcl.xct could not be imported. The file does not exist
when LazUtils is built.
To solve this problem, the output format for LazUtils is built twice. It is the
smaller of the two packages. Building LazUtils twice ensures that the
"chicken or the egg" problem with inter-file links is avoided.
Build LazUtils WITHOUT any external links (faster).
Build LCL with links to RTL, FCL, LazUtils.
Build LazUtils with links to RTL, FCL, LCL.
}
// build lazutils WITHOUT any external links
Run:=TFPDocRun.Create('lazutils');
Run.ExtraOptions:='-MObjFPC -Scghi'; // extra options from in lazutils makefile.
Run.UsedPkgs.Add('rtl');
Run.UsedPkgs.Add('fcl');
// Run.UsedPkgs.Add('rtl');
// Run.UsedPkgs.Add('fcl');
Run.XMLSrcDir := '..'+PathDelim+'xml'+PathDelim+'lazutils';
Run.PasSrcDir := '..'+PathDelim+'..'+PathDelim+'components'+PathDelim+'lazutils';
Run.Execute;
Run.Free;
// build lcl with links to rtl, fcl, lazutils
Run:=TFPDocRun.Create('lcl');
Run.ExtraOptions:='-MObjFPC -Sic'; // extra options from in LCL makefile.
Run.UsedPkgs.Add('rtl');
@ -641,6 +656,17 @@ begin
Run.Execute;
Run.Free;
// build lazutils with links to rtl, fcl, lcl
Run:=TFPDocRun.Create('lazutils');
Run.ExtraOptions:='-MObjFPC -Scghi'; // extra options from in lazutils makefile.
Run.UsedPkgs.Add('rtl');
Run.UsedPkgs.Add('fcl');
Run.UsedPkgs.Add('lcl');
Run.XMLSrcDir := '..'+PathDelim+'xml'+PathDelim+'lazutils';
Run.PasSrcDir := '..'+PathDelim+'..'+PathDelim+'components'+PathDelim+'lazutils';
Run.Execute;
Run.Free;
if ShowCmd then
writeln('Not executed... simulation ended');
end.