[RFC PATCH v3 1/4] branch: improve documentation and naming of 'create_branch()'

2017-11-01 Thread Kaartic Sivaraam
From: Kaartic Sivaraam The documentation for 'create_branch()' was incomplete as it didn't say what certain parameters were used for. Further a parameter name wasn't very communicative. So, add missing documentation for the sake of completeness and easy reference. Also, rename the concerned para

[RFC PATCH v3 1/4] branch: improve documentation and naming of 'create_branch()'

2017-11-01 Thread Kaartic Sivaraam
From: Kaartic Sivaraam The documentation for 'create_branch()' was incomplete as it didn't say what certain parameters were used for. Further a parameter name wasn't very communicative. So, add missing documentation for the sake of completeness and easy reference. Also, rename the concerned para