shared-bindings: Update docs to remove with statements from examples but add more detail to the design guide about their use.

1 files changed, 7 insertions, 6 deletions

diff --git a/shared-bindings/busio/OneWire.c b/shared-bindings/busio/OneWire.c
index 52aed2135..f270d9d92 100644
--- a/shared-bindings/busio/OneWire.c
+++ b/shared-bindings/busio/OneWire.c
@@ -55,11 +55,11 @@
 //|     import busio
 //|     import board
 //|
-//|     with busio.OneWire(board.D7) as onewire:
-//|       onewire.reset()
-//|       onewire.write_bit(True)
-//|       onewire.write_bit(False)
-//|       print(onewire.read_bit())
+//|     onewire = busio.OneWire(board.D7)
+//|     onewire.reset()
+//|     onewire.write_bit(True)
+//|     onewire.write_bit(False)
+//|     print(onewire.read_bit())
 //|
 STATIC mp_obj_t busio_onewire_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *pos_args) {
     mp_arg_check_num(n_args, n_kw, 1, MP_OBJ_FUN_ARGS_MAX, true);
@@ -101,7 +101,8 @@ STATIC MP_DEFINE_CONST_FUN_OBJ_1(busio_onewire_deinit_obj, busio_onewire_deinit)
 
 //|   .. method:: __exit__()
 //|
-//|      Automatically deinitializes the hardware when exiting a context.
+//|      Automatically deinitializes the hardware when exiting a context. See
+//|      :ref:`lifetime-and-contextmanagers` for more info.
 //|
 STATIC mp_obj_t busio_onewire_obj___exit__(size_t n_args, const mp_obj_t *args) {
     (void)n_args;