Clarify bugpoint documentation regarding output
authorIris Johnson <iris@modwiz.com>
Wed, 24 Mar 2021 21:24:33 +0000 (16:24 -0500)
committerGitHub <noreply@github.com>
Wed, 24 Mar 2021 21:24:33 +0000 (16:24 -0500)
Bugpoint's current documentation does specify that the result of a run is stored as the current design,
however it's easy to skim over what that means in practice.

Add a documentation comment to explain specifically that an after bugpoint `write_xyz` pass is required to save
the reduced design.

passes/cmds/bugpoint.cc

index 70c002c44a1eb9777c153c63cac955e28fa8b5e2..c782d9a385801c56eb0bf398c9b92b2ec1edf0d4 100644 (file)
@@ -38,6 +38,8 @@ struct BugpointPass : public Pass {
                log("and the same script, repeating these steps while it can find a smaller design that\n");
                log("still causes a crash. Once this command finishes, it replaces the current design\n");
                log("with the smallest testcase it was able to produce.\n");
+               log("In order to save the reduced testcase you must write this out to a file with\n");
+               log("another command after `bugpoint` like `write_rtlil` or `write_verilog`.\n");
                log("\n");
                log("    -script <filename> | -command \"<command>\"\n");
                log("        use this script file or command to crash Yosys. required.\n");