Skip to content

🚫 Format Exemptions

⚠️ Qué NO Formatear

╔═══════════════════════════════════════════════════════════╗ ║ Category │ Reason ║ ╠══════════════════╪════════════════════════════════════════╣ ║ Third-party code │ Don't modify external dependencies ║ ║ Generated code │ Auto-generated, will be overwritten ║ ║ Data tables │ Formatting aids readability ║ ║ Legacy code │ Touch-only policy ║ ╚═══════════════════════════════════════════════════════════╝

📋 Exemption Markers

// clang-format off
float table[16] = {
    1.0,  2.0,  3.0,  4.0,
    5.0,  6.0,  7.0,  8.0,
    9.0, 10.0, 11.0, 12.0,
   13.0, 14.0, 15.0, 16.0
};
// clang-format on

🔍 Review Process

Any new exemption requires:

  • ✓ Justification in code comment
  • ✓ Review approval
  • ✓ Document here if permanent

📝 Permanent Exemptions

Third-Party Libraries

  • external/ - All external dependencies
  • vendor/ - Vendored third-party code

Generated Code

  • *_generated.cpp - Auto-generated by build system
  • *_pb.h - Protocol buffer generated headers
  • *.ui.h - Qt UI generated files

Data Tables

  • wavetables/ - Audio wavetable data
  • tuning_tables.cpp - Musical tuning lookup tables
  • filter_coefficients.cpp - DSP coefficient tables

Legacy Code

  • legacy/ - Old code under maintenance-only mode
  • Mark specific files as needed with justification