pytorch/docs/source/compile
William Wen f36f285953 [dynamo] change error_on_graph_break/fullgraph semantics (#161747)
This PR implements the semantics change to `torch._dynamo.error_on_graph_break`:
- ~`torch.compile` now has a new `error_on_graph_break` kwarg that serves as a lower-priority toggle for erroring/continuing on graph breaks~
- `error_on_graph_break` is a new internal `torch.compile `setting that is lower-priority than `fullgraph`. It allows the user to toggle erroring/continuing on graph breaks.
- `error_on_graph_break` does nothing when `fullgraph=True`
- `error_on_graph_break` does NOT guarantee a single graph

Followup [DONE]: need to change the programming model docs to reflect the 3 graph break modes for compilation:
- `fullgraph=True`: enforce one graph, no graph breaks, cannot be toggled
- `fullgraph=False, error_on_graph_break=True`: errors on graph breaks, latter can be toggled during compile time
- `fullgraph=False, error_on_graph_break=False`: resumes tracing on graph breaks, latter can be toggled during compile time

Pull Request resolved: https://github.com/pytorch/pytorch/pull/161747
Approved by: https://github.com/mlazos
ghstack dependencies: #161739
2025-09-04 17:10:17 +00:00
..
_static
header_code.py
programming_model.common_graph_breaks.md [docs, dynamo] add fullgraph=True, common graph breaks docs (#158055) 2025-07-29 01:53:41 +00:00
programming_model.compiler_disable.md [dynamo, docs] add fullgraph=False docs (#159050) 2025-07-29 01:53:47 +00:00
programming_model.custom_ops.md [dynamo, docs] non-strict programming model docs (#158531) 2025-07-29 01:53:47 +00:00
programming_model.dynamo_core_concepts.md [dynamo, docs] add fullgraph=False docs (#159050) 2025-07-29 01:53:47 +00:00
programming_model.dynamo_nonstrict_trace.md [dynamo, docs] non-strict programming model docs (#158531) 2025-07-29 01:53:47 +00:00
programming_model.error_on_graph_break.md [dynamo] change error_on_graph_break/fullgraph semantics (#161747) 2025-09-04 17:10:17 +00:00
programming_model.fullgraph_false.md [dynamo] change error_on_graph_break/fullgraph semantics (#161747) 2025-09-04 17:10:17 +00:00
programming_model.fullgraph_true.md [dynamo, docs] non-strict programming model docs (#158531) 2025-07-29 01:53:47 +00:00
programming_model.graph_breaks_index.md [dynamo, docs] add fullgraph=False docs (#159050) 2025-07-29 01:53:47 +00:00
programming_model.md [dynamo, docs] add recompilation, observability, reporting issues docs (#159062) 2025-07-29 23:23:51 +00:00
programming_model.nested_graph_breaks.md [dynamo, docs] add fullgraph=False docs (#159050) 2025-07-29 01:53:47 +00:00
programming_model.non_strict_tracing_model.md [dynamo, docs] non-strict programming model docs (#158531) 2025-07-29 01:53:47 +00:00
programming_model.observability.md [dynamo, docs] add recompilation, observability, reporting issues docs (#159062) 2025-07-29 23:23:51 +00:00
programming_model.recompilation.md [dynamo, docs] add recompilation, observability, reporting issues docs (#159062) 2025-07-29 23:23:51 +00:00
programming_model.reporting_issues.md [dynamo, docs] add recompilation, observability, reporting issues docs (#159062) 2025-07-29 23:23:51 +00:00
programming_model.skipped_functions.md [dynamo, docs] add recompilation, observability, reporting issues docs (#159062) 2025-07-29 23:23:51 +00:00
programming_model.where_to_apply_compile.md [dynamo, docs] add fullgraph=False docs (#159050) 2025-07-29 01:53:47 +00:00