pinctrl: re-order struct pinctrl_map

The lookup key in struct pinctrl_map is (.dev_name, .name). Re-order the
struct definition to put the lookup key fields first, and the result
values afterwards. To me at least, this slightly better reflects the
lookup process.

Update the documentation in a similar fashion.

Note: PIN_MAP*() macros aren't updated; I plan to update this once later
when enhancing the mapping table format to support pin config to reduce
churn.

Signed-off-by: Stephen Warren <swarren@nvidia.com>
Acked-by: Dong Aisheng <dong.aisheng@linaro.org>
[Rebased for cherry-picking]
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>

1 files changed, 5 insertions, 5 deletions

diff --git a/include/linux/pinctrl/machine.h b/include/linux/pinctrl/machine.h
index 400f1926b234..73fbb2745301 100644
--- a/include/linux/pinctrl/machine.h
+++ b/include/linux/pinctrl/machine.h
@@ -14,6 +14,10 @@
 
 /**
  * struct pinctrl_map - boards/machines shall provide this map for devices
+ * @dev_name: the name of the device using this specific mapping, the name
+ *      must be the same as in your struct device*. If this name is set to the
+ *      same name as the pin controllers own dev_name(), the map entry will be
+ *      hogged by the driver itself upon registration
  * @name: the name of this specific map entry for the particular machine.
  *      This is the second parameter passed to pinmux_get() when you want
  *      to have several mappings to the same device
@@ -25,17 +29,13 @@
  * @group: sometimes a function can map to different pin groups, so this
  *      selects a certain specific pin group to activate for the function, if
  *      left as NULL, the first applicable group will be used
- * @dev_name: the name of the device using this specific mapping, the name
- *      must be the same as in your struct device*. If this name is set to the
- *      same name as the pin controllers own dev_name(), the map entry will be
- *      hogged by the driver itself upon registration
  */
 struct pinctrl_map {
+        const char *dev_name;
         const char *name;
         const char *ctrl_dev_name;
         const char *function;
         const char *group;
-        const char *dev_name;
 };
 
 /*