>>> Following these notes, we need:
>>>
>>> - a document describing this in full details.
>> Would a txt file do?  Where would it go - under tools/examples where other config options are described (albeit in a config file and not a separate file)?
> 
> Yep. A text file under docs will be perfect.
> 
> 
>  
Attached is a first stab at this for your perusal.  It is mostly based on the discussion we had in this thread.  Please let me know any/all changes you would recommend.

I am sending this in advance as anything I have captured wrong here would mean it is likely that the code changes I am making right now could also be wrong!  So please do respond back if I have incorrectly captured any  conclusion we arrived at in terms of the supported/deprecated attributes for the disk configuration option.  Thanks!

Kamala