Merge branch 'master' into generated_name_override

Author: justsmth

.github/workflows/bindgen.yml

@@ -68,7 +68,7 @@ jobs:
 
       # TODO: Actually run quickchecks once `bindgen` is reliable enough.
       - name: Build quickcheck tests
-        run: cd tests/quickchecking && cargo test
+        run: cd bindgen-tests/tests/quickchecking && cargo test
 
   test-expectations:
     runs-on: ${{matrix.os}}
@@ -88,7 +88,7 @@ jobs:
           override: true
 
       - name: Test expectations
-        run: cd tests/expectations && cargo test
+        run: cd bindgen-tests/tests/expectations && cargo test
 
   test:
     runs-on: ${{matrix.os}}

.gitignore

@@ -2,7 +2,8 @@
 target/
 *~
 bindgen-integration/Cargo.lock
-tests/expectations/Cargo.lock
+bindgen-tests/tests/expectations/Cargo.lock
+bindgen-tests/tests/quickchecking/Cargo.lock
 #*#
 
 # Test script output

CONTRIBUTING.md

@@ -318,7 +318,19 @@ parameters a given type uses. The analyses are defined in
 
 The final phase is generating Rust source text from the analyzed IR, and it is
 defined in `src/codegen/*`. We use the `quote` crate, which provides the `quote!
-{ ... }` macro for quasi-quoting Rust forms.
+{ ... }` macro for quasi-quoting Rust forms. Some options that affect the
+generated Rust code are implemented using the [`syn`](https://docs.rs/syn) crate.
+
+### Implementing new options using `syn`
+
+If a new option can be implemented using the `syn` crate it should be added to
+the `codegen::postprocessing` module by following these steps:
+
+- Introduce a new field to `BindgenOptions` for the option.
+- Write a free function inside `codegen::postprocessing` implementing the
+  option. This function with the same name of the `BindgenOptions` field.
+- Add a new value to the `codegen::postprocessing::PASSES` for the option using
+  the `pass!` macro.
 
 ## Pull Requests and Code Reviews