Make function helptext more concise with a +bids/Contents.m

+bids/+util/tsvread.m

@@ -1,12 +1,13 @@
 function x = tsvread(f,v,hdr)
-% Load text and numeric data from file
+% Load text and numeric data from tab-separated-value or other file
 % FORMAT x = tsvread(f,v,hdr)
 % f   - filename (can be gzipped) {txt,mat,csv,tsv,json}
 % v   - name of field to return if data stored in a structure [default: '']
 %       or index of column if data stored as an array
 % hdr - detect the presence of a header row for csv/tsv [default: true]
 %
 % x   - corresponding data array or structure
+
 %__________________________________________________________________________
 %
 % Based on spm_load.m from SPM12.

+bids/Contents.m

@@ -0,0 +1,22 @@
+% +BIDS - The bids-matlab library
+%
+% Contents
+%   layout   - Parse a directory structure formated according to the BIDS standard
+%   query    - Query a directory structure formated according to the BIDS standard
+%   report   - Create a short summary of the acquisition parameters of a BIDS dataset
+%   validate - BIDS Validator
+%   util.jsondecode - Decode JSON-formatted file
+%   util.jsonencode - Encode JSON-formatted file
+%   util.tsvread - Load text and numeric data from tab-separated-value or other file
+%
+%__________________________________________________________________________
+%
+% BIDS (Brain Imaging Data Structure): https://bids.neuroimaging.io/
+%   The brain imaging data structure, a format for organizing and
+%   describing outputs of neuroimaging experiments.
+%   K. J. Gorgolewski et al, Scientific Data, 2016.
+%__________________________________________________________________________
+%
+% BIDS-MATLAB is a library that aims at centralising MATLAB/Octave tools
+% for interacting with datasets conforming to the BIDS format.
+% See https://github.com/bids-standard/bids-matlab for more details.

+bids/layout.m

@@ -3,6 +3,10 @@
 % FORMAT BIDS = bids.layout(root)
 % root   - directory formated according to BIDS [Default: pwd]
 % BIDS   - structure containing the BIDS file layout
+%
+% See also:
+% bids
+
 %__________________________________________________________________________
 %
 % BIDS (Brain Imaging Data Structure): https://bids.neuroimaging.io/

+bids/query.m

@@ -5,6 +5,10 @@
 % query  - type of query: {'data', 'metadata', 'sessions', 'subjects',
 %          'runs', 'tasks', 'runs', 'types', 'modalities'}
 % result - outcome of query
+%
+% See also:
+% bids
+
 %__________________________________________________________________________
 %
 % BIDS (Brain Imaging Data Structure): https://bids.neuroimaging.io/

+bids/report.m

@@ -16,6 +16,10 @@ function report(BIDS, Subj, Ses, Run, ReadNII)
 % Unless specified the function will only read the data from the first
 % subject, session, and run (for each task of BOLD). This can be an issue
 % if different subjects/sessions contain very different data.
+%
+% See also:
+% bids
+
 %__________________________________________________________________________
 %
 % BIDS (Brain Imaging Data Structure): https://bids.neuroimaging.io/

+bids/validate.m

@@ -12,6 +12,9 @@
 % Web version: 
 %   https://bids-standard.github.io/bids-validator/
 %__________________________________________________________________________
+%
+% See also:
+% bids
 
 % Copyright (C) 2018, Guillaume Flandin, Wellcome Centre for Human Neuroimaging
 % Copyright (C) 2018--, BIDS-MATLAB developers