Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

powerpc/512x: clk: minor comment updates

adjust (expand on or move) a few comments,
add markers for easier navigation around helpers

Signed-off-by: Gerhard Sittig <gsi@denx.de>
Acked-by: Mike Turquette <mturquette@linaro.org>
Signed-off-by: Anatolij Gustschin <agust@denx.de>

authored by

Gerhard Sittig and committed by
Anatolij Gustschin
2a2b9ff8 20755f85

+11 -3
+11 -3
arch/powerpc/platforms/512x/clock-commonclk.c
··· 76 76 static struct mpc512x_ccm __iomem *clkregs; 77 77 static DEFINE_SPINLOCK(clklock); 78 78 79 + /* common clk API wrappers {{{ */ 80 + 79 81 /* convenience wrappers around the common clk API */ 80 82 static inline struct clk *mpc512x_clk_fixed(const char *name, int rate) 81 83 { ··· 140 138 parent_names, parent_count, clkflags, 141 139 reg, pos, len, muxflags, &clklock); 142 140 } 141 + 142 + /* }}} common clk API wrappers */ 143 143 144 144 /* helper to isolate a bit field from a register */ 145 145 static inline int get_bit_field(uint32_t __iomem *reg, uint8_t pos, uint8_t len) ··· 312 308 } 313 309 } 314 310 311 + /* MCLK helpers {{{ */ 312 + 315 313 /* 316 314 * helper code for the MCLK subtree setup 317 315 * ··· 344 338 345 339 /* 346 340 * note that this declaration raises a checkpatch warning, but 347 - * it's the very data type which <linux/clk-provider.h> expects, 348 - * making this declaration pass checkpatch will break compilation 341 + * it's the very data type dictated by <linux/clk-provider.h>, 342 + * "fixing" this warning will break compilation 349 343 */ 350 344 static const char *parent_names_mux0[] = { 351 345 "sys", "ref", "psc-mclk-in", "spdif-tx", ··· 518 512 } 519 513 } 520 514 515 + /* }}} MCLK helpers */ 516 + 521 517 static void mpc512x_clk_setup_clock_tree(struct device_node *np, int busfreq) 522 518 { 523 519 int sys_mul, sys_div, ips_div; ··· 557 549 clks[MPC512x_CLK_IPS] = mpc512x_clk_divtable("ips", "csb", 558 550 &clkregs->scfr1, 23, 3, 559 551 divtab_2346); 560 - 561 552 /* now setup anything below SYS and CSB and IPS */ 553 + 562 554 clks[MPC512x_CLK_DDR_UG] = mpc512x_clk_factor("ddr-ug", "sys", 1, 2); 563 555 clks[MPC512x_CLK_SDHC_x4] = mpc512x_clk_factor("sdhc-x4", "csb", 4, 1); 564 556 clks[MPC512x_CLK_SDHC_UG] = mpc512x_clk_divider("sdhc-ug", "sdhc-x4", 0,