ifcquery, ifcedit: update docs for --format ids and foreach subcommand

Add --format ids to the ifcquery.rst format description and a new
"Scripting with ifcedit" section showing composition examples.  Add
the foreach subcommand to ifcedit.rst with usage examples.

src/ifcopenshell-python/docs/ifcedit.rst

@@ -10,6 +10,7 @@ you to write a Python script. It supports four subcommands:
 - **list** — list all API modules, or all functions within a module
 - **docs** — show full documentation for a function (parameters, types, descriptions)
 - **run** — execute a mutation against an IFC file
+- **foreach** — apply an API function to each element in a JSON array read from stdin
 - **quantify** — run quantity take-off using ifc5d rules; requires the IfcOpenShell C++ geometry bindings
 
 Installation
@@ -53,6 +54,17 @@ Dry-run to validate without modifying the file::
 
     $ ifcedit run model.ifc root.remove_product --dry-run --product 42
 
+Apply an API function to each element in a JSON array from stdin (``{field}``
+placeholders are substituted from each item; model is opened and saved once)::
+
+    $ ifcquery model.ifc select 'IfcWindow' | ifcedit foreach model.ifc root.remove_product --product {id}
+    $ ifcquery model.ifc select 'IfcDoor' | ifcedit foreach model.ifc attribute.edit_attributes \
+        --product {id} --attributes '{"Name": "Door"}'
+
+Write to a separate output file instead of overwriting::
+
+    $ ifcquery model.ifc select 'IfcWall' | ifcedit foreach model.ifc root.remove_product -o output.ifc --product {id}
+
 Quantity take-off (writes ``IfcElementQuantity`` psets back to the file; requires C++ geometry bindings)::
 
     $ ifcedit quantify list