BibDocFile: FFT comment/description documentation

* Updates FFT documentation to harmonise the behaviour of file comments
  vs file descriptions, providing coherent usage example.  (closes #635)

Reviewed-by: Tibor Simko <tibor.simko@cern.ch>