docs: execute context.clear() in doctests for Sphinx 9 compatibility

[bobo-xxx]

Summary

In Sphinx 9, doctest blocks marked with :hide: are not executed. This causes context.clear() calls in hidden blocks to be skipped, leading to assembler tests using the wrong architecture (arm instead of i386).

Fix

This change moves context.clear() out of hidden doctest blocks into visible doctest lines, ensuring they are executed properly in Sphinx 9+.

Changes

• docs/source/intro.rst: Replaced two hidden doctest blocks containing context.clear() with visible doctest lines.

Testing

The issue manifests when running doctests with Sphinx 9+, where hidden blocks are not executed. This fix ensures the context clearing happens as part of the visible doctest flow.

Fixes #2711

[Copilot]

Pull request overview

Updates the introductory documentation doctests to remain compatible with Sphinx 9’s behavior change where .. doctest:: blocks marked :hide: are no longer executed, which previously caused context.clear() to be skipped and subsequent assembler examples to run under the wrong architecture.

Changes:

• Removed two hidden .. doctest:: :hide: blocks that contained context.clear().
• Placed >>> context.clear() as regular visible doctest lines so they execute under Sphinx 9+ doctest runs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.