Discussion: do not revert comments in PASS1

[fs-eire]

Do we want to preserve comments in the generated C++ code, or do we want them in the final WGSL shader?

[guschmue]

I'd vote for preserve

[fs-eire]

Now this requirement should have been fulfilled by a different approach: the --preserve-code-ref flag.

By specifying the flag, code reference is preserved in the generated code. The following is an example:

The original template file:

// This is a one line comment

@compute @workgroup_size(128)
fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {
    let buffer_count = 4;  /* This
                              is
                              a
                              multi-line
                              comment */
    let index = global_id.x;
}

Generated C++ file:

//  1 | // This is a one line comment
//  2 |
//  3 | @compute @workgroup_size(128)
(*ss_ptr) << "@compute @workgroup_size(128)\n";
//  4 | fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {
(*ss_ptr) << "fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {\n";
//  5 |     let buffer_count = 4;  /* This
(*ss_ptr) << "    let buffer_count = 4;\n";
//  6 |                               is
(*ss_ptr) << "\n";
//  7 |                               a
//  8 |                               multi-line
//  9 |                               comment */
// 10 |     let index = global_id.x;
(*ss_ptr) << "    let index = global_id.x;\n";
// 11 | }
(*ss_ptr) << "}\n";
// 12 |

Merged in #11.