xref: /aosp_15_r20/external/angle/doc/64BitSafety.md (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1*8975f5c5SAndroid Build Coastguard Worker# 64-bit Safety In the Compiler
2*8975f5c5SAndroid Build Coastguard Worker
3*8975f5c5SAndroid Build Coastguard WorkerAn issue that has arisen recently for contributors making changes to the GLSL ES
4*8975f5c5SAndroid Build Coastguard Workergrammar files has been that certain versions of flex, the lexer on which ANGLE
5*8975f5c5SAndroid Build Coastguard Workerrelies, produce outputs which are not safe in 64-bit builds.
6*8975f5c5SAndroid Build Coastguard Worker
7*8975f5c5SAndroid Build Coastguard WorkerTo address this issue, ANGLE has added a step to its generation scripts to apply
8*8975f5c5SAndroid Build Coastguard Worker64-bit safety fixes to newly regenerated outputs. This should be unnoticeable to
9*8975f5c5SAndroid Build Coastguard Workerdevelopers invoking flex via the generate\_parser.sh scripts in the relevant
10*8975f5c5SAndroid Build Coastguard Workercompiler directories, as the fixes will be applied by the patch utility as part
11*8975f5c5SAndroid Build Coastguard Workerof that script.
12*8975f5c5SAndroid Build Coastguard Worker
13*8975f5c5SAndroid Build Coastguard WorkerWhen making code contributions that affect the grammar files, please ensure that
14*8975f5c5SAndroid Build Coastguard Workeryou've generated the outputs using the script, to make certain that the 64-bit
15*8975f5c5SAndroid Build Coastguard Workersafety fixes are applied.
16