Update docs; add equality test

docs/user/cropping-and-transforming.md

@@ -46,8 +46,7 @@ page_base = reader_base.pages[0]
 reader = PdfFileReader("box.pdf")
 page_box = reader.pages[0]
 
-# Apply the transformation: Be aware, that this is an in-place operation
-page_base.mergeTransformedPage(page_box, Transformation())
+page_base.mergePage(page_box)
 
 # Write the result back
 writer = PdfFileWriter()
@@ -70,9 +69,10 @@ page_base = reader_base.pages[0]
 reader = PdfFileReader("box.pdf")
 page_box = reader.pages[0]
 
-# Apply the transformation: Be aware, that this is an in-place operation
-op = Transformation().rotate(45)
-page_base.mergeTransformedPage(page_box, op)
+# Apply the transformation
+transformation = Transformation().rotate(45)
+page_box.add_transformation(transformation)
+page_base.mergePage(page_box)
 
 # Write the result back
 writer = PdfFileWriter()
@@ -84,8 +84,9 @@ with open("merged-foo.pdf", "wb") as fp:
 If you add the expand parameter:
 
 ```python
-op = Transformation().rotate(45)
-page_base.mergeTransformedPage(page_box, op, expand=True)
+transformation = Transformation().rotate(45)
+page_box.add_transformation(transformation)
+page_base.mergePage(page_box)
 ```
 
 you get:

tests/test_generic.py

@@ -65,6 +65,18 @@ def test_boolean_object_write():
     assert stream.read() == b"false"
 
 
+def test_boolean_eq():
+    boolobj = BooleanObject(True)
+    assert (boolobj == True) is True
+    assert (boolobj == False) is False
+    assert (boolobj == "True") is False
+
+    boolobj = BooleanObject(False)
+    assert (boolobj == True) is False
+    assert (boolobj == False) is True
+    assert (boolobj == "True") is False
+
+
 def test_boolean_object_exception():
     stream = BytesIO(b"False")
     with pytest.raises(PdfReadError) as exc: