Manual review of builtin functions: print-repr

Author: heikkitoivonen

docs/builtins/help.md

@@ -154,62 +154,8 @@ docstring = obj.__doc__
 help(obj)  # O(m) - slower but formatted
 ```
 
-### pydoc Module
-
-```python
-import pydoc
-
-# O(n) - more control
-docs = pydoc.getdoc(str)  # Get formatted documentation
-pydoc.render_doc(str)     # Get as HTML
-
-# Server mode - browse documentation
-pydoc.start_server(port=8000)
-```
-
-### inspect Module
-
-```python
-import inspect
-
-# O(1) - fast attribute access
-signature = inspect.signature(my_func)
-source = inspect.getsource(my_func)
-members = inspect.getmembers(obj)  # O(n)
-
-# More programmatic than help()
-```
-
-## Interactive Help System
-
-```python
-# help() without arguments
-# Starts interactive help system
-
-# help()
-# Then type:
-# >>> list.append    (shows help for list.append)
-# >>> modules        (shows all available modules)
-# >>> keywords       (shows Python keywords)
-# >>> topics         (shows special topics)
-# >>> quit           (exits help)
-```
-
 ## Practical Examples
 
-### Documentation Lookup
-
-```python
-# O(m) - find how to use a function
-def understand_function(func):
-    help(func)
-
-# Examples:
-understand_function(len)
-understand_function(str.split)
-understand_function(dict.get)
-```
-
 ### Debugging Unknown Objects
 
 ```python
@@ -267,34 +213,6 @@ def get_help(obj):
 # Faster than calling help() repeatedly
 ```
 
-## Advanced Usage
-
-### Programmatic Documentation Access
-
-```python
-# O(m) - get docs without printing
-import pydoc
-
-docs = pydoc.render_doc(str, title="String Documentation")
-# Returns formatted HTML string
-
-# Use in web server, etc.
-```
-
-### Documentation Server
-
-```python
-import pydoc
-
-# Start local documentation server
-# pydoc.start_server(port=8000)
-# Then visit http://localhost:8000
-
-# Or generate HTML
-pydoc.writedoc(str, outdir="/tmp/docs")
-# Creates HTML documentation file
-```
-
 ## Edge Cases
 
 ### Objects Without Docstrings
@@ -334,15 +252,12 @@ help(func)  # Shows custom docstring
 - Use `help()` for interactive exploration
 - Use `help(topic)` to learn about Python features
 - Check `__doc__` attribute directly in code
-- Use `inspect` module for programmatic access
-- Write clear docstrings for your functions
 
 ❌ **Avoid**:
 
 - Using `help()` in tight loops (call once, cache result)
 - Assuming `help()` output format is stable
 - Using `help()` for production code (direct access faster)
-- Forgetting to write docstrings
 
 ## Related Functions
 

docs/builtins/print.md

@@ -115,22 +115,6 @@ print("Value: %s" % value)        # O(n) - conversion cost
 
 ## I/O Considerations
 
-### Output Buffering
-
-```python
-# I/O overhead dominates over string computation
-import sys
-
-# Unbuffered output
-for i in range(1000):
-    print(i, flush=True)  # Forces write immediately
-    # Slower due to I/O flushing
-
-# Buffered output (default)
-for i in range(1000):
-    print(i)  # Buffered, faster overall
-```
-
 ### Writing to Files
 
 ```python
@@ -219,10 +203,7 @@ print(lst)  # Output: [[...]] - handles circular refs
 
 ✅ **Do**:
 
-- Use `print()` for simple output (it's designed for this)
 - Collect strings then print once for massive output
-- Use `end=""` or `sep=""` to control formatting
-- Print to file with `file=` parameter
 
 ❌ **Avoid**:
 

docs/builtins/repr.md

@@ -120,28 +120,6 @@ items = [Item(i) for i in range(10)]
 repr(items)  # O(10) - calls __repr__ on each item
 ```
 
-## Difference from str()
-
-```python
-# str() - human-readable, may be different
-class Value:
-    def __str__(self):
-        return "A nice value"
-    
-    def __repr__(self):
-        return "Value()"
-
-v = Value()
-print(str(v))   # "A nice value"
-print(repr(v))  # "Value()"
-
-# repr() should return valid Python code if possible
-x = 42
-assert eval(repr(x)) == x  # True for most cases
-
-s = "hello"
-assert eval(repr(s)) == s  # True - repr() is evaluable
-```
 
 ## String Escaping