Bicep build does not build multiple files (even though examples say it's supported)

[NWiddup]

Bicep version
0.3.126

Describe the bug
According to the AZ CLI Bicep help and public documentation, Bicep supports building multiple files using the --files parameter. Yet when using Bicep in the way the samples indicate, it gives an error The input file path cannot be specified multiple times..
az bicep docs says it supports az bicep build --files {bicep_file1} {bicep_file2}

To Reproduce
Install latest version of AZ CLI
Install latest version of BICEP
try to build multiple files using syntax az bicep build --files file1.bicep file2.bicep file3.bicep

Additional context
This may be an issue with the AZ CLI, however raising here as it was originally an option in BICEP.

• Need confirmation whether this is going to be deprecated/removed.
• Need to get the doco updated to reflect the expected behaviour.

[anthony-c-martin]

@shenglol I know we've talked about fixing this. Do you know if we have an issue/PR to link this to?

[shenglol]

@NWiddup This is going to be deprecated. We dropped the support of building multiple files since Bicep CLI 0.3.1 because in some cases it can produce inconsistent/unnecessary JSON templates (@anthony-c-martin please correct me if I'm wrong). I updated the Azure CLI module to remove multi-file support in Azure/azure-cli#17547, which will be a breaking change.