Dokan 1.1.0 - Breaking API

[Liryna]

DokanMapStandardToGenericAccess has been merged with DokanMapKernelToUserCreateFileFlags.

We need to reflect this change on dokan-dotnet for 1.1.1.0

See dokan-dev/dokany@0da7787

[kyanha]

Did this break binary compatibility? If so, it should have bumped to version 2, not just 1.1.

[Liryna]

Yes, we should have up to 2.1.1.0 😢 ...too late to do it ? even changelog seems to have missed it.
Versioning of dokan-dotnet is for now dokan-net major version + dokany version
(next version will be 2.1.3.0 for example) Yes, that's not the best I know but it started like this before me...I do not know if it can still be improved

[kyanha]

Ideally, we'd have dokan-dotnet and dokany have the same major and minor versions, with the patch number of dokan-dotnet incrementing whenever it needs to be re-released for some reason.

I think the DokanMapStandardToGenericAccess roll into DokanMapKernelToUserCreateFileFlags might have also impacted the C API?

[Liryna]

Yes, this would be the best 👍 It can even be done now as latest version is 1.1.2.1 We can release a 1.3.0.0 and the last number will be used for patch as you said. I think we can even do the release now, I do not see something missing.

You are right, this change impacted the C API. Dokan has move his MINOR version at this moment. (https://github.com/dokan-dev/dokany/wiki/How-to-package-your-application-with-Dokan#dokan-versioning)

[kyanha]

By breaking the binary API, you broke adherence to semantic versioning.

And by breaking the source API for dokan-dotnet, we're also breaking adherence to semantic versioning.

Can we maybe just push v2 much more quickly than originally planned, for both? What would that break?

[Liryna]

Yes, It can be see in this way but the dokan library <-> kernel is still compatible thats our point of view of "major break changes". As an example the dokan device name used for the communication to init the mount use the major api version to be sure that only dokan library 1.x.x can talk to driver 1.x.x
https://github.com/dokan-dev/dokany/blob/master/sys/dokan.h#L46-L52

For 2.x.x there is still some work and hands needed. Help would be very appreciated.

[Liryna]

https://github.com/dokan-dev/dokan-dotnet/releases/tag/v1.3.0.0

1.3.0.0 is now released following this discussion. Glad we left this broken semantic version 😎

This can probably be closed @kyanha or if you wanna continue the v2 discussion I would be glad.