API GENERATION:
    Most of the code in wx is generated.
    Users of Wx should not normally need to regenerate the generated code,
    as it is checked in by Wx developers, when changes are made.

REQUIREMENTS:
    The code generation requires doxygen (1.8.17) which is
    used to parse wxWidgets c++ interface headers and generate xml files (in
    wx_xml/).

CONFIGURATION:
    wxapi.conf contains the specification to the code generator.  The code
    generator reads the specification and parses the xml files and
    produces the erlang and the 'C' code.

    Adding/changing stuff/classes should be done by updating wxapi.conf
    and running make. Sometimes the code generator will require changes,
    I haven't thought of everything yet.

RUNNING:
    I use the following alias wxgen='make GL_DIR=/home/dgud/opengl WX_DIR=/home/dgud/src/wxWidgets'

    We have some patches in the wxWidgets interface files to be able to use it to generate the interface,
    so use our clone of wxWidgets, and checkout 'wx_api_gen' branch.

    I keep the opengl headers separate so I don't go backwards in version when generating the code
    from another machine.

    Also gl.h from different vendors differ so keep it consistent,
    I have used mesa's gl.h and the glext.h from opengl.org
    (version see GL_GLEXT_VERSION in gl.hrl)

    I also get the xml documentation from https://github.com/KhronosGroup/OpenGL-Refpages
    setup 'export GL_MAN_SRC_DIR = /home/User/src/OpenGL-Refpages'
    otherwise the OpenGL docs will not be generated.

CONTRIBUTION:
    Send me patches

> %CopyrightBegin%
>
> SPDX-License-Identifier: Apache-2.0
>
> Copyright Ericsson AB 2010-2026. All Rights Reserved.
>
> Licensed under the Apache License, Version 2.0 (the "License");
> you may not use this file except in compliance with the License.
> You may obtain a copy of the License at
>
>     http://www.apache.org/licenses/LICENSE-2.0
>
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> See the License for the specific language governing permissions and
> limitations under the License.
>
> %CopyrightEnd%
