Here’s a method that pretty much WORKED to document Python function Arguments for use with Eclipse. It is based on A Guide to NumPy/SciPy Documentation.
Here’s a sample.
def chordAscore(score, startMeasureNum, endMeasureNum, sharpFlatNonePref, stripOctaveInfo): """Returns a string of the chordnames for an excerpt from a Music21 score. Parameters ---------- score : music21.stream.Score the Music21 score. startMeasureNum : int [1-Number of Measures in the Music21 score.] start Measure Number of the excerpt. endMeasureNum : int [1-Number of Measures in the Music21 score.] end Measure Number of the excerpt. sharpFlatNonePref : string ['sharp':PreferSharp, 'flat':PreferSharp, 'none':PreferNeitherSharpNorFlat] Chordnames. stripOctaveInfo : boolean True: strips the octave information, False: does NOT strip the octave information """