Reference to missing file

[John15213]

Several API generators fail with the relative reference to apidocs.oas2.yml in the file, below is openapitools/openapi-generator-cli's result

Exception in thread "main" org.openapitools.codegen.SpecValidationException: There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
| Error count: 1, Warning count: 0
Errors:
-Unable to load RELATIVE ref: ./apidocs.oas2.yml path: /local

    at org.openapitools.codegen.config.CodegenConfigurator.toContext(CodegenConfigurator.java:546)
    at org.openapitools.codegen.config.CodegenConfigurator.toClientOptInput(CodegenConfigurator.java:573)
    at org.openapitools.codegen.cmd.Generate.execute(Generate.java:433)
    at org.openapitools.codegen.cmd.OpenApiGeneratorCommand.run(OpenApiGeneratorCommand.java:32)
    at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:66)

[John15213]

So this seems to work (in YAML) if I replace

  parameters:
    - $ref: ''./apidocs.oas2.yml#/parameters/auth-bearer'

with

  parameters:
    - $ref: '#/parameters/auth-bearer'

on line 3284