.secret property special case, updated documentation oidc code flow

* The DocumentationGenerator now generates "or ..._FILE" headings also
for properties ending in .secret
* Update the recommendation for
dev.dsf.server.auth.oidc.authorization.code.flow to reflect the
generator change.

cherry-picked from DSF 1.7.1

Author: hhund

dsf-common/dsf-common-jetty/src/main/java/dev/dsf/common/config/AbstractJettyConfig.java

@@ -115,7 +115,7 @@ public abstract class AbstractJettyConfig
 	@Value("${dev.dsf.server.certificate.key.password:#{null}}")
 	private char[] serverCertificateKeyFilePassword;
 
-	@Documentation(description = "Set to `true` to enable OIDC authorization code flow", recommendation = "Requires *DEV_DSF_SERVER_AUTH_OIDC_PROVIDER_REALM_BASE_URL*, *DEV_DSF_SERVER_AUTH_OIDC_CLIENT_ID* and *DEV_DSF_SERVER_AUTH_OIDC_CLIENT_SECRET* to be specified")
+	@Documentation(description = "Set to `true` to enable OIDC authorization code flow", recommendation = "Requires *DEV_DSF_SERVER_AUTH_OIDC_PROVIDER_REALM_BASE_URL*, *DEV_DSF_SERVER_AUTH_OIDC_CLIENT_ID* and *DEV_DSF_SERVER_AUTH_OIDC_CLIENT_SECRET* or *DEV_DSF_SERVER_AUTH_OIDC_CLIENT_SECRET_FILE* to be specified")
 	@Value("${dev.dsf.server.auth.oidc.authorization.code.flow:false}")
 	private boolean oidcAuthorizationCodeFlowEnabled;
 

dsf-tools/dsf-tools-documentation-generator/src/main/java/dev/dsf/tools/generator/DocumentationGenerator.java

@@ -222,7 +222,7 @@ private Function<Field, DocumentationEntry> processDocumentationGenerator(List<S
 			String property = getDocumentationString("Property", initialProperty);
 
 			String initialEnvironment = initialProperty.replace(".", "_").toUpperCase();
-			String environment = initialProperty.endsWith(".password")
+			String environment = initialProperty.endsWith(".password") || initialProperty.endsWith(".secret")
 					? String.format("%s or %s_FILE", initialEnvironment, initialEnvironment)
 					: initialEnvironment;
 
@@ -261,7 +261,7 @@ private Function<Field, DocumentationEntry> dsfDocumentationGenerator()
 			String property = getDocumentationString("Property", initialProperty);
 
 			String initialEnvironment = initialProperty.replace(".", "_").toUpperCase();
-			String environment = initialProperty.endsWith(".password")
+			String environment = initialProperty.endsWith(".password") || initialProperty.endsWith(".secret")
 					? String.format("%s or %s_FILE", initialEnvironment, initialEnvironment)
 					: initialEnvironment;