DOC: Add doctests for fiddly ReconAll invocations

Author: effigies

nipype/interfaces/freesurfer/preprocess.py

@@ -712,6 +712,34 @@ class ReconAll(CommandLine):
     >>> reconall.cmdline # doctest: +ALLOW_UNICODE
     'recon-all -all -i structural.nii -subjid foo -sd .'
 
+    Hemisphere may be specified regardless of directive:
+
+    >>> reconall_left = reconall.copy()
+    >>> reconall_left.inputs.hemi = 'lh'
+    >>> reconall_left.cmdline # doctest: +ALLOW_UNICODE
+    'recon-all -all -hemi lh -i structural.nii -subjid foo -sd .'
+
+    ``-autorecon-hemi`` uses the ``-hemi`` input to specify the hemisphere
+    to operate upon:
+
+    >>> reconall_left.inputs.directive = 'autorecon-hemi'
+    >>> reconall_left.cmdline # doctest: +ALLOW_UNICODE
+    'recon-all -autorecon-hemi lh -i structural.nii -subjid foo -sd .'
+
+    Hippocampal subfields can accept T1 and T2 images:
+
+    >>> reconall_subfields = reconall.copy()
+    >>> reconall_subfields.inputs.hippocampal_subfields_T1 = True
+    >>> reconall_subfields.cmdline # doctest: +ALLOW_UNICODE
+    'recon-all -all -i structural.nii -subjid foo -hippocampal-subfields-T1 -sd .'
+    >>> reconall_subfields.inputs.hippocampal_subfields_T2 = (
+    ... 'structural.nii', 'test')
+    >>> reconall_subfields.cmdline # doctest: +ALLOW_UNICODE
+    'recon-all -all -i structural.nii -subjid foo -hippocampal-subfields-T1T2 structural.nii test -sd .'
+    >>> reconall_subfields.inputs.hippocampal_subfields_T1 = False
+    >>> reconall_subfields.cmdline # doctest: +ALLOW_UNICODE
+    'recon-all -all -i structural.nii -subjid foo -hippocampal-subfields-T2 structural.nii test -sd .'
+
     """
 
     _cmd = 'recon-all'