[dm-devel] [PATCH v2 3/4] Documentation: add version history entries for raid0 support _and_ forgotten devices_handle_discards_safely module paramater

[Heinz Mauelshagen]

On 05/08/2015 06:03 PM, Brassow Jonathan wrote:
>> On Apr 29, 2015, at 7:03 AM, heinzm at redhat.com wrote:
>>
>> From: Heinz Mauelshagen <heinzm at redhat.com>
>>
>> This patch adds version history for md raid0 to dm-raid.txt
>> _and_
>> adds forgotten doc for the 1.6.0 version change as well
>>
>> Signed-off-by: Heinz Mauelshagen <heinzm at redhat.com>
>>
>> ---
>> Documentation/device-mapper/dm-raid.txt | 3 +++
>> 1 file changed, 3 insertions(+)
>>
>> diff --git a/Documentation/device-mapper/dm-raid.txt b/Documentation/device-mapper/dm-raid.txt
>> index ef8ba9f..bceb865 100644
>> --- a/Documentation/device-mapper/dm-raid.txt
>> +++ b/Documentation/device-mapper/dm-raid.txt
>> @@ -224,3 +224,6 @@ Version History
>> 	New status (STATUSTYPE_INFO) fields: sync_action and mismatch_cnt.
>> 1.5.1   Add ability to restore transiently failed devices on resume.
>> 1.5.2   'mismatch_cnt' is zero unless [last_]sync_action is "check".
>> +1.6.0   Add devices_handle_discards_safely module parameter to
>> +	allow discards on disks announcing uncertain discard_zeroes_data
>> +1.7.0   Add support for MD RAID0 mappings
>> -- 
>> 2.1.0
> I was hoping for a new section(e.g. “DISCARDS”) to be added to the doc file for the ‘devices_handle_discards_safely’.
>
> Wasn’t 1.6.0 where discard support was added?  If so, 1.6.0 should just be “Add discard support”.  The new section should explain all the short-comings and issues with discards + parity RAID.
>
>   brassow

Yes, 1.6.0 added discard support for raid1/10 and disabled it for raid4/5/6
with commit upstream 75b8e04bbf01bdd5c42a1d8ac54abf757196ce49

Let's add more docuemtnation with a followup patch then

Heinz