Doc Smallfix: Updated the BIDSPath in-place update method example (#1026

)

* Updated the BIDSPath in-place update example

I updated the `BIDSPath` in-place update example to perhaps make it clearer to users what in-place updating means.
It's a small change, but should make the message clearer.

* Missing printout in BIDSPath example and indentation

* Remove additional tab at EOL

* Added datatype to BIDSPath update after #1030

Co-authored-by: Stefan Appelhoff <stefan.appelhoff@mailbox.org>

* Added BHV name to CITATION.cff

Co-authored-by: Stefan Appelhoff <stefan.appelhoff@mailbox.org>

CITATION.cff

@@ -143,6 +143,10 @@ authors:
       orcid: 'https://orcid.org/0000-0001-8316-7436'
     - given-names: Anand
       family-names: Saini
+    - given-names: Bruno
+      family-names: Hebling Vieira
+      affiliation: 'Methods of Plasticity Research, Department of Psychology, University of Zurich, Zurich, Switzerland'
+      orcid: 'https://orcid.org/0000-0002-8770-7396'
     - given-names: Alexandre
       family-names: Gramfort
       affiliation: 'Université Paris-Saclay, Inria, CEA, Palaiseau, France'

mne_bids/path.py

@@ -666,8 +666,13 @@ def update(self, *, check=None, **kwargs):
         >>> print(bids_path.basename)
         sub-test_ses-two_task-mytask_channels.tsv
         >>> # Then, one can update this `BIDSPath` object in place
-        >>> bids_path = bids_path.update(acquisition='test', suffix='ieeg',
-        ...                              extension='.vhdr', task=None)
+        >>> bids_path.update(acquisition='test', suffix='ieeg',
+        ...                  datatype='ieeg',
+        ...                  extension='.vhdr', task=None)
+        BIDSPath(
+        root: None
+        datatype: ieeg
+        basename: sub-test_ses-two_acq-test_ieeg.vhdr)
         >>> print(bids_path.basename)
         sub-test_ses-two_acq-test_ieeg.vhdr
         """