From 625630f4d9a1fe5813ad91deefb8490d464d0ff8 Mon Sep 17 00:00:00 2001
From: moon2 <moon2protonmail@protonmail.com>
Date: Fri, 11 Aug 2023 17:49:36 +0200
Subject: [PATCH] docs update

---
 docs/badge/bl00mbox.rst                     | 11 +++++++++--
 python_payload/mypystubs/bl00mbox/_user.pyi |  4 ++--
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/docs/badge/bl00mbox.rst b/docs/badge/bl00mbox.rst
index 9f2b1f0ee7..d67269e06c 100644
--- a/docs/badge/bl00mbox.rst
+++ b/docs/badge/bl00mbox.rst
@@ -190,8 +190,15 @@ and we can get them individually:
       [channel mixer] (1 connections)
         output in [bud 1] lowpass
 
-As we can see this channel has quite a lot going on. Ideally each application should have
-its own channel(s), so in order to get a free one we'll create a new one without argument:
+As we can see this channel has quite a lot going on. Each application should have its own
+channel(s), so in order to get a free one we'll request a free one from the backend by
+skipping the argument:
+
+.. note::
+    Do not use .Channel(n) in application code, it's for REPL purposes only. Each
+    application manages their own channel(s), so they might clear out your plugins
+    or drag down your performance or other kinds of nasty interferences. Don't do it.
+    
 
 .. code-block:: pycon
 
diff --git a/python_payload/mypystubs/bl00mbox/_user.pyi b/python_payload/mypystubs/bl00mbox/_user.pyi
index 4d059c5d79..5b49f53d52 100644
--- a/python_payload/mypystubs/bl00mbox/_user.pyi
+++ b/python_payload/mypystubs/bl00mbox/_user.pyi
@@ -49,8 +49,8 @@ class Channel:
     free: bool
 
     def clear(self) -> None: ...
-    def new_patch(self, patch: Type[T], init_var: Optional[Any] = None) -> T: ...
-    def new_bud(
+    def _new_patch(self, patch: Type[T], init_var: Optional[Any] = None) -> T: ...
+    def _new_bud(
         self,
         thing: bl00mbox._plugins._Plugin | int,
         init_var: Optional[int | float] = None,
-- 
GitLab