Summary of Changes

Hello @lebao3105, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly improves Pascal language support within Xmake by introducing a comprehensive set of new configuration options and the underlying logic to translate these options into Free Pascal Compiler (FPC) specific flags. This enhancement allows users to precisely control various aspects of Pascal compilation, such as managing search paths for units and includes, defining or undefining preprocessor macros, and specifying the desired Pascal language dialect, thereby offering greater flexibility and compatibility for Pascal projects.

Highlights

• Expanded Pascal API: New API functions have been introduced for target, option, package, and toolchain scopes, enabling more granular control over Pascal compilation settings such as unit directories, include directories, preprocessor defines/undefines, and language modes.
• Enhanced Configuration Flags: The set_nameflags configuration in xmake/languages/pascal/xmake.lua has been updated to recognize and apply the newly added Pascal-specific settings for both object and binary targets, ensuring these configurations are properly propagated during the build process.
• Free Pascal Compiler (FPC) Integration: New utility functions have been added to xmake/modules/core/tools/fpc.lua to translate Xmake's Pascal configuration options into the corresponding Free Pascal Compiler (FPC) command-line flags, including -FI for include directories, -Fu for unit directories, -d for defines, -u for undefines, and -M for language modes.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Please do not add new apis. set_languagemode, add_unitdirs

Any new API should have its design discussed in detail in issues, and a decision made on whether it is truly necessary, rather than being added arbitrarily to a PR.

In addition, the design of APIs should be as abstract as possible and be universal, rather than being provided for use by a specific language such as Pascal.

If it's only used for a specific language, I usually recommend using add_fcflags to set it directly.

Known issue(s):

Introduced via the code below.

Flags are somehow re-added

lebao3105@ultramarine Commands-collection on  master [✘!?] via 🌙 
❯ XMAKE_PROGRAM_DIR=$(pwd)/../xmake/xmake xmake b -v selected
[ 27%]: archiving.release libcustcustc.a
/usr/bin/ar -cr build/linux/x86_64/release/libcustcustc.a build/.objs/custcustc/linux/x86_64/release/include/custcustc.c.o
[ 54%]: linking.release dir
/usr/bin/fpc -dbg:=begin -ded:=end -dretn:=procedure -dfn:=function -dlong:=longint -dulong:=longword -dint:=integer -dbool:=boolean -dreturn:=exit -Fiinclude -Fuinclude -Mfpc -O3 -Sa -Si -Sm -Sc -Sx -Co -CO -Cr -CR -gl -k-lc -k-Lbuild/linux/x86_64/release -Xs -dbg:=begin -ded:=end -dretn:=procedure -dfn:=function -dlong:=longint -dulong:=longword -dint:=integer -dbool:=boolean -dreturn:=exit -Fiinclude -Fuinclude -Mfpc -k-lcustcustc -obuild/linux/x86_64/release/dir src/dir/dir.pp
error: Free Pascal Compiler version 3.2.2 [2025/08/02] for x86_64
Copyright (c) 1993-2021 by Florian Klaempfl and others
Target OS: Linux for x86-64
Compiling src/dir/dir.pp
dir.pp(48,9) Error: Identifier not found "try"
dir.pp(49,13) Fatal: Syntax error, ";" expected but "identifier ISNAMEVALID" found
Fatal: Compilation aborted
Error: /usr/bin/ppcx64 returned an error exitcode

Notice how definitions (ones starting with -d) and more get duplicated (add_includedirs, add_unitdirs, set_languages).

Example(s)

add_rules("mode.debug", "mode.release", "mode.releasedbg")
add_rules("plugin.compile_commands.autoupdate")

target("dir")
	set_kind("binary")
	set_languages("pascal")

	add_files("src/dir/dir.pp")
	add_rules("pascal")
	add_deps("custcustc")
	add_defines(
		"bg:=begin", "ed:=end", "retn:=procedure",
		"fn:=function", "long:=longint", "ulong:=longword",
                "int:=integer", "bool:=boolean", "return:=exit"
	) -- add -d<definition> flags
	add_pcflags("-Sa", "-Si", "-Sm", "-Sc",
             "-Sx", "-Co", "-CO", "-Cr", "-CR", "-gl") -- add flags into the compiler as-is
	add_includedirs("include") -- add -Fi<includedir> flags
	add_unitdirs("include") -- add -Fu<unitdir> flags

/gemini review

add_unitdirs is only for pascal, However, all abstract APIs should be able to be used in multiple languages, not just Pascal.

However, all abstract APIs should be able to be used in multiple languages, not just Pascal.

unitfile appears to correspond to objectfile in other languages, but currently no other language requires support for configuring search directories for individual objectfiles.

#7260

done #7260