• Seth Brenith's avatar
    [torque] Clarify class annotations · 4dc59509
    Seth Brenith authored
    As Nico pointed out in [1], it is a little strange that the pair of
    annotations "@export @customCppClass" behaves similarly to the keyword
    "extern": both indicate that the class is defined in a C++ file and
    Torque generates only a base class template for it. In this change, I
    explore a possible alternative which might be more consistent.
    
    Removed annotations:
    - @customCppClass, which required @export, instructed Torque to only
      generate a base class template instead of a full class.
    - @customMap, which also required @export, instructed Torque to not emit
      code for setting up a unique Map instance for the class.
    
    Added annotations:
    - @generateUniqueMap, which requires extern, instructs Torque to emit
      code for setting up a unique Map instance for the class.
    - @generateFactoryFunction, which requires extern, instructs Torque to
      emit a function for creating a class instance.
    
    Subtracting two annotations and adding two others still leaves us with
    way too many annotations, but the usage of "extern" becomes more
    consistent and I think that the new opt-in annotations might be easier
    to understand.
    
    [1] https://docs.google.com/document/d/1q_gZLnXd4bGnCx3IUfbln46K3bSs9UHBGasy9McQtHI/edit
    
    Bug: v8:7793
    Change-Id: Ic9e147a095bc492d6645001b9275357386e8adcf
    Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/3266008Reviewed-by: 's avatarNico Hartmann <nicohartmann@chromium.org>
    Commit-Queue: Seth Brenith <seth.brenith@microsoft.com>
    Cr-Commit-Position: refs/heads/main@{#77799}
    4dc59509
Name
Last commit
Last update
..
api Loading commit data...
asmjs Loading commit data...
ast Loading commit data...
base Loading commit data...
baseline Loading commit data...
bigint Loading commit data...
builtins Loading commit data...
codegen Loading commit data...
common Loading commit data...
compiler Loading commit data...
compiler-dispatcher Loading commit data...
d8 Loading commit data...
date Loading commit data...
debug Loading commit data...
deoptimizer Loading commit data...
diagnostics Loading commit data...
execution Loading commit data...
extensions Loading commit data...
flags Loading commit data...
handles Loading commit data...
heap Loading commit data...
ic Loading commit data...
init Loading commit data...
inspector Loading commit data...
interpreter Loading commit data...
json Loading commit data...
libplatform Loading commit data...
libsampler Loading commit data...
logging Loading commit data...
numbers Loading commit data...
objects Loading commit data...
parsing Loading commit data...
profiler Loading commit data...
protobuf Loading commit data...
regexp Loading commit data...
roots Loading commit data...
runtime Loading commit data...
sanitizer Loading commit data...
security Loading commit data...
snapshot Loading commit data...
strings Loading commit data...
tasks Loading commit data...
third_party Loading commit data...
torque Loading commit data...
tracing Loading commit data...
trap-handler Loading commit data...
utils Loading commit data...
wasm Loading commit data...
web-snapshot Loading commit data...
zone Loading commit data...
DEPS Loading commit data...
DIR_METADATA Loading commit data...
OWNERS Loading commit data...