Merge pull request #9664 from rouault/doc_ignored_fields

Doc: SetIgnoredFields(): clarify interaction with SetAttributeFilter()
OSGeo · Apr 17, 2024 · 4480d72 · 4480d72
2 parents 03f30b1 + 1ad1455
commit 4480d72
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/ogr/ogrsf_frmts/ogrsf_frmts.dox b/ogr/ogrsf_frmts/ogrsf_frmts.dox
@@ -3147,6 +3147,10 @@ form depending on the limitations of the format driver.
 
  By default, no fields are ignored.
 
+ Note that fields that are used in an attribute filter should generally not be set as
+ ignored fields, as most drivers (such as those relying on the OGR SQL engine)
+ will be unable to correctly evaluate the attribute filter.
+
  This method is the same as the C function OGR_L_SetIgnoredFields()
 
  @param papszFields an array of field names terminated by NULL item. If NULL is passed, the ignored list is cleared.
@@ -3167,6 +3171,10 @@ form depending on the limitations of the format driver.
 
  By default, no fields are ignored.
 
+ Note that fields that are used in an attribute filter should generally not be set as
+ ignored fields, as most drivers (such as those relying on the OGR SQL engine)
+ will be unable to correctly evaluate the attribute filter.
+
  This method is the same as the C++ method OGRLayer::SetIgnoredFields()
 
  @param hLayer handle to the layer