Message ID | 20210116101254.51624-1-xypron.glpk@gmx.de |
---|---|
State | Changes Requested, archived |
Delegated to: | Simon Glass |
Headers | show |
Series | [1/1] dm: core: describe uclass_root_s | expand |
On Sat, Jan 16, 2021 at 6:13 PM Heinrich Schuchardt <xypron.glpk@gmx.de> wrote: > > make htmldocs creates a warning: > > ./include/asm-generic/global_data.h:443: > warning: Function parameter or member 'uclass_root_s' > not described in 'global_data' > > Correct the member descriptions. > > Fixes: 8a715530bb1f ("dm: core: Allow the uclass list to move") > Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> > --- > include/asm-generic/global_data.h | 8 ++++---- > 1 file changed, 4 insertions(+), 4 deletions(-) > > diff --git a/include/asm-generic/global_data.h b/include/asm-generic/global_data.h > index efa09a1943..9fa9a17003 100644 > --- a/include/asm-generic/global_data.h > +++ b/include/asm-generic/global_data.h > @@ -198,13 +198,13 @@ struct global_data { > */ > struct udevice *dm_root_f; > /** > - * @uclass_root: head of core tree > + * @uclass_root_s: static head of core tree, if uclasses are in > + * read-only memory and cannot be adjusted to use @uclass_root as a > + * list head. > */ > struct list_head uclass_root_s; _s stands for static? If so, I suspect the comment was just the opposite? > /** > - * @uclass_root: pointer to head of core tree, if uclasses are in > - * read-only memory and cannot be adjusted to use @uclass_root as a > - * list head. > + * @uclass_root: pointer to the head of core tree > */ > struct list_head *uclass_root; > # if CONFIG_IS_ENABLED(OF_PLATDATA) > -- Regards, Bin
Hi Bin, On Sat, 16 Jan 2021 at 03:59, Bin Meng <bmeng.cn@gmail.com> wrote: > > On Sat, Jan 16, 2021 at 6:13 PM Heinrich Schuchardt <xypron.glpk@gmx.de> wrote: > > > > make htmldocs creates a warning: > > > > ./include/asm-generic/global_data.h:443: > > warning: Function parameter or member 'uclass_root_s' > > not described in 'global_data' > > > > Correct the member descriptions. > > > > Fixes: 8a715530bb1f ("dm: core: Allow the uclass list to move") > > Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> > > --- > > include/asm-generic/global_data.h | 8 ++++---- > > 1 file changed, 4 insertions(+), 4 deletions(-) > > > > diff --git a/include/asm-generic/global_data.h b/include/asm-generic/global_data.h > > index efa09a1943..9fa9a17003 100644 > > --- a/include/asm-generic/global_data.h > > +++ b/include/asm-generic/global_data.h > > @@ -198,13 +198,13 @@ struct global_data { > > */ > > struct udevice *dm_root_f; > > /** > > - * @uclass_root: head of core tree > > + * @uclass_root_s: static head of core tree, if uclasses are in > > + * read-only memory and cannot be adjusted to use @uclass_root as a > > + * list head. > > */ > > struct list_head uclass_root_s; > > _s stands for static? > > If so, I suspect the comment was just the opposite? Yes. I inserted the new variable but did not move the comment... > > > /** > > - * @uclass_root: pointer to head of core tree, if uclasses are in > > - * read-only memory and cannot be adjusted to use @uclass_root as a > > - * list head. > > + * @uclass_root: pointer to the head of core tree > > */ > > struct list_head *uclass_root; > > # if CONFIG_IS_ENABLED(OF_PLATDATA) > > -- > Regards, Simon
Am 19. Januar 2021 01:49:28 MEZ schrieb Simon Glass <sjg@chromium.org>: >Hi Bin, > >On Sat, 16 Jan 2021 at 03:59, Bin Meng <bmeng.cn@gmail.com> wrote: >> >> On Sat, Jan 16, 2021 at 6:13 PM Heinrich Schuchardt ><xypron.glpk@gmx.de> wrote: >> > >> > make htmldocs creates a warning: >> > >> > ./include/asm-generic/global_data.h:443: >> > warning: Function parameter or member 'uclass_root_s' >> > not described in 'global_data' >> > >> > Correct the member descriptions. >> > >> > Fixes: 8a715530bb1f ("dm: core: Allow the uclass list to move") >> > Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> >> > --- >> > include/asm-generic/global_data.h | 8 ++++---- >> > 1 file changed, 4 insertions(+), 4 deletions(-) >> > >> > diff --git a/include/asm-generic/global_data.h >b/include/asm-generic/global_data.h >> > index efa09a1943..9fa9a17003 100644 >> > --- a/include/asm-generic/global_data.h >> > +++ b/include/asm-generic/global_data.h >> > @@ -198,13 +198,13 @@ struct global_data { >> > */ >> > struct udevice *dm_root_f; >> > /** >> > - * @uclass_root: head of core tree >> > + * @uclass_root_s: static head of core tree, if uclasses >are in >> > + * read-only memory and cannot be adjusted to use >@uclass_root as a >> > + * list head. >> > */ >> > struct list_head uclass_root_s; >> >> _s stands for static? >> >> If so, I suspect the comment was just the opposite? > >Yes. I inserted the new variable but did not move the comment... > Hello Simon, do you mean the patch is wrong? What should the comments look like? Best regards Heinrich > >> >> > /** >> > - * @uclass_root: pointer to head of core tree, if uclasses >are in >> > - * read-only memory and cannot be adjusted to use >@uclass_root as a >> > - * list head. >> > + * @uclass_root: pointer to the head of core tree >> > */ >> > struct list_head *uclass_root; >> > # if CONFIG_IS_ENABLED(OF_PLATDATA) >> > -- >> > >Regards, >Simon
Hi Heinrich, On Mon, 18 Jan 2021 at 20:18, Heinrich Schuchardt <xypron.glpk@gmx.de> wrote: > > Am 19. Januar 2021 01:49:28 MEZ schrieb Simon Glass <sjg@chromium.org>: > >Hi Bin, > > > >On Sat, 16 Jan 2021 at 03:59, Bin Meng <bmeng.cn@gmail.com> wrote: > >> > >> On Sat, Jan 16, 2021 at 6:13 PM Heinrich Schuchardt > ><xypron.glpk@gmx.de> wrote: > >> > > >> > make htmldocs creates a warning: > >> > > >> > ./include/asm-generic/global_data.h:443: > >> > warning: Function parameter or member 'uclass_root_s' > >> > not described in 'global_data' > >> > > >> > Correct the member descriptions. > >> > > >> > Fixes: 8a715530bb1f ("dm: core: Allow the uclass list to move") > >> > Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> > >> > --- > >> > include/asm-generic/global_data.h | 8 ++++---- > >> > 1 file changed, 4 insertions(+), 4 deletions(-) > >> > > >> > diff --git a/include/asm-generic/global_data.h > >b/include/asm-generic/global_data.h > >> > index efa09a1943..9fa9a17003 100644 > >> > --- a/include/asm-generic/global_data.h > >> > +++ b/include/asm-generic/global_data.h > >> > @@ -198,13 +198,13 @@ struct global_data { > >> > */ > >> > struct udevice *dm_root_f; > >> > /** > >> > - * @uclass_root: head of core tree > >> > + * @uclass_root_s: static head of core tree, if uclasses > >are in > >> > + * read-only memory and cannot be adjusted to use > >@uclass_root as a > >> > + * list head. > >> > */ > >> > struct list_head uclass_root_s; > >> > >> _s stands for static? > >> > >> If so, I suspect the comment was just the opposite? > > > >Yes. I inserted the new variable but did not move the comment... > > > > Hello Simon, > > do you mean the patch is wrong? > > What should the comments look like? > > Best regards > > Heinrich > > > > > >> > >> > /** > >> > - * @uclass_root: pointer to head of core tree, if uclasses > >are in > >> > - * read-only memory and cannot be adjusted to use > >@uclass_root as a > >> > - * list head. > >> > + * @uclass_root: pointer to the head of core tree uclass_root is used when described in the removed lines above. When uclasses are in read-only memory, uclass_root_s is not used and uclass_root points to the root node generated by dtoc When not in read-only memory, uclass_root_s is used to hold the uclass root, and uclass_root points to &uclass_root_s. > >> > */ > >> > struct list_head *uclass_root; > >> > # if CONFIG_IS_ENABLED(OF_PLATDATA) > >> > -- > >> > Regards, Simon
diff --git a/include/asm-generic/global_data.h b/include/asm-generic/global_data.h index efa09a1943..9fa9a17003 100644 --- a/include/asm-generic/global_data.h +++ b/include/asm-generic/global_data.h @@ -198,13 +198,13 @@ struct global_data { */ struct udevice *dm_root_f; /** - * @uclass_root: head of core tree + * @uclass_root_s: static head of core tree, if uclasses are in + * read-only memory and cannot be adjusted to use @uclass_root as a + * list head. */ struct list_head uclass_root_s; /** - * @uclass_root: pointer to head of core tree, if uclasses are in - * read-only memory and cannot be adjusted to use @uclass_root as a - * list head. + * @uclass_root: pointer to the head of core tree */ struct list_head *uclass_root; # if CONFIG_IS_ENABLED(OF_PLATDATA)
make htmldocs creates a warning: ./include/asm-generic/global_data.h:443: warning: Function parameter or member 'uclass_root_s' not described in 'global_data' Correct the member descriptions. Fixes: 8a715530bb1f ("dm: core: Allow the uclass list to move") Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> --- include/asm-generic/global_data.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.29.2