Manual review of builtin functions: hex-int

Author: heikkitoivonen

docs/builtins/bin.md

@@ -114,33 +114,6 @@ value = int("1010", 2)  # Also O(log n)
 assert value == 10
 ```
 
-## Comparison with Alternatives
-
-### bin() vs format()
-
-```python
-# bin() - returns string with '0b' prefix
-bin(255)           # '0b11111111'
-
-# format() - more flexible
-format(255, 'b')   # '11111111' (no prefix)
-format(255, '#b')  # '0b11111111' (with prefix)
-
-# Performance - both O(log n), similar speed
-```
-
-### bin() vs bit_length()
-
-```python
-# bin() - string representation, O(log n)
-s = bin(255)        # '0b11111111'
-
-# bit_length() - O(1) operation
-bits = (255).bit_length()  # 8
-
-# Use bit_length() for count, bin() for display
-```
-
 ## Bit Manipulation Operations
 
 ```python
@@ -259,35 +232,6 @@ my_set &= ~(1 << 3)
 print(bin(my_set))  # '0b100000'
 ```
 
-## Special Cases
-
-### Zero
-
-```python
-# O(1)
-bin(0)  # '0b0'
-```
-
-### Powers of Two
-
-```python
-# O(log n) - shows single bit set
-bin(1)      # '0b1'
-bin(2)      # '0b10'
-bin(4)      # '0b100'
-bin(8)      # '0b1000'
-bin(2**10)  # Single '1' followed by zeros
-```
-
-### All Ones
-
-```python
-# O(log n) - all bits set
-bin(0xFF)      # '0b11111111' (255)
-bin(0xFFFF)    # 16 ones
-bin((1 << 32) - 1)  # 32 ones
-```
-
 ## Best Practices
 
 ✅ **Do**:

docs/builtins/breakpoint.md

@@ -9,247 +9,6 @@ The `breakpoint()` function drops into the Python debugger (pdb by default) for
 | `breakpoint()` | O(1) | O(1) | Pauses execution |
 | Debugger session | O(n) | O(n) | n = time spent debugging |
 
-## Basic Usage
-
-### Simple Breakpoint
-
-```python
-def process_data(data):
-    print(f"Input: {data}")
-    breakpoint()  # Drop into debugger
-    print(f"Processed: {data.upper()}")
-
-process_data("hello")
-
-# At debugger:
-# (Pdb) data
-# 'hello'
-# (Pdb) continue
-```
-
-### Conditional Breakpoint
-
-```python
-def find_error(items):
-    for i, item in enumerate(items):
-        if item < 0:
-            print(f"Found negative at index {i}")
-            breakpoint()  # Debug only on error
-        print(item)
-
-find_error([1, 2, -3, 4])
-```
-
-### Debugging Inside Function
-
-```python
-def calculate(a, b, c):
-    result = a + b
-    breakpoint()  # Inspect variables
-    result *= c
-    return result
-
-value = calculate(1, 2, 3)
-
-# At debugger:
-# (Pdb) result
-# 3
-# (Pdb) a, b, c
-# (1, 2, 3)
-# (Pdb) continue
-```
-
-## Debugger Commands
-
-### Common PDB Commands
-
-```python
-value = 42
-breakpoint()
-
-# Commands at (Pdb) prompt:
-# l (list) - Show source code
-# n (next) - Execute next line
-# s (step) - Step into function
-# c (continue) - Resume execution
-# u (up) - Go up stack frame
-# d (down) - Go down stack frame
-# p variable - Print variable
-# pp variable - Pretty print
-# h (help) - Show help
-# q (quit) - Exit debugger
-```
-
-### Example Debugging Session
-
-```python
-def buggy_function(x, y):
-    result = x + y
-    breakpoint()  # Stop here
-    result *= 2
-    return result
-
-buggy_function(10, 20)
-
-# Session output:
-# > /path/to/file.py:4in buggy_function()
-# -> result *= 2
-# (Pdb) x
-# 10
-# (Pdb) y
-# 20
-# (Pdb) result
-# 30
-# (Pdb) continue
-```
-
-## Custom Debugger
-
-### Using Different Debugger
-
-```python
-import pdb
-
-# Use custom debugger instead of default pdb
-def custom_debugger():
-    debugger = pdb.Pdb()
-    debugger.set_trace()
-
-custom_debugger()
-```
-
-### Disabling Breakpoints
-
-```python
-import sys
-
-# Disable all breakpoints
-def no_breakpoint(*args, **kwargs):
-    pass
-
-# PYTHONBREAKPOINT=0 environment variable also disables
-
-# Or set in code
-sys.__breakpointhook__ = no_breakpoint
-breakpoint()  # Does nothing
-```
-
-## Environment Control
-
-### Disable Via Environment
-
-```bash
-# Disable all breakpoints
-export PYTHONBREAKPOINT=0
-python script.py
-
-# Use custom debugger
-export PYTHONBREAKPOINT=mymodule.debugger
-python script.py
-```
-
-### Programmatic Control
-
-```python
-import sys
-
-# Custom breakpoint handler
-def my_breakpoint(*args, **kwargs):
-    print("Breakpoint hit!")
-    # Custom logic
-    import pdb
-    pdb.set_trace(*args, **kwargs)
-
-sys.breakpointhook = my_breakpoint
-
-breakpoint()  # Uses custom handler
-```
-
-## Best Practices
-
-```python
-# ✅ DO: Use for development debugging
-def complex_calculation(data):
-    processed = preprocess(data)
-    breakpoint()  # Inspect intermediate result
-    return postprocess(processed)
-
-# ❌ DON'T: Leave breakpoints in production
-# Use logging instead for production debugging
-
-import logging
-logging.debug(f"Value: {x}")
-
-# ✅ DO: Remove before committing
-# Use version control to track breakpoints
-
-# ✅ DO: Use conditional breakpoints
-if condition:
-    breakpoint()
-
-# ✅ DO: Use logging for production
-try:
-    operation()
-except Exception as e:
-    logging.exception("Operation failed")
-```
-
-## Debugging Techniques
-
-### Inspect Call Stack
-
-```python
-def level3():
-    breakpoint()
-
-def level2():
-    level3()
-
-def level1():
-    level2()
-
-level1()
-
-# At breakpoint:
-# (Pdb) bt  # Backtrace - show call stack
-# > /path/file.py:2in level3()
-# > /path/file.py:5in level2()
-# > /path/file.py:8in level1()
-# > /path/file.py:11in <module>()
-```
-
-### Watch Variables
-
-```python
-def process_list(items):
-    total = 0
-    for i, item in enumerate(items):
-        total += item
-        if total > 10:
-            breakpoint()  # When threshold reached
-            # (Pdb) total
-            # (Pdb) i, item
-            # (Pdb) pp items
-
-process_list([1, 2, 3, 4, 5, 6])
-```
-
-### Execute Code in Debugger
-
-```python
-def debug_example():
-    x = 10
-    y = 20
-    breakpoint()
-    # At (Pdb), you can:
-    # (Pdb) z = x + y
-    # (Pdb) z
-    # 30
-    # (Pdb) import json
-    # (Pdb) json.dumps({'x': x})
-
-debug_example()
-```
 
 ## Related Modules
 

docs/builtins/hex.md

@@ -112,52 +112,6 @@ print(hex(id(obj2)))
 # Different addresses shown in hex
 ```
 
-## Comparison with Alternatives
-
-### hex() vs format()
-
-```python
-# hex() - returns string with '0x' prefix
-hex(255)           # '0xff'
-
-# format() - more flexible
-format(255, 'x')   # 'ff' (no prefix)
-format(255, 'X')   # 'FF' (uppercase, no prefix)
-format(255, '#x')  # '0xff' (with prefix)
-
-# Performance - both O(log n), format slightly faster
-```
-
-### hex() vs bin() vs oct()
-
-```python
-# All O(log n) but different bases
-hex(255)    # '0xff'     (base 16)
-bin(255)    # '0b11111111' (base 2)
-oct(255)    # '0o377'    (base 8)
-
-# Which base?
-# hex - most compact, good for colors/addresses
-# bin - for bit manipulation
-# oct - rare, legacy use
-```
-
-## Builtin Integer Methods
-
-```python
-# to_bytes() - O(log n) alternative
-x = 255
-hex_bytes = x.to_bytes(2, 'big')
-# b'\x00\xff'
-
-# bit_length() - O(1) related operation
-x = 255
-bits = x.bit_length()  # 8
-hex(x)  # '0xff' - 2 digits = 8 bits
-
-# Relationship: hex digits ≈ bit_length() / 4
-```
-
 ## Bidirectional Conversion
 
 ```python
@@ -199,24 +153,6 @@ hex_str = ''.join(hex(v)[2:] for v in values)
 # 'a141e28' - concatenated hex values
 ```
 
-## Special Cases
-
-### Zero
-
-```python
-# O(1)
-hex(0)  # '0x0'
-```
-
-### Powers of Two
-
-```python
-# O(log n) - still efficient even for powers
-hex(2**10)    # '0x400'
-hex(2**20)    # '0x100000'
-hex(2**100)   # Very large hex number, still O(log 2**100)
-```
-
 ## Common Use Cases
 
 ### Debug Output