[PATCH] Documentation: User manual, "barebox" section

[Robert P. J. Day]

On Mon, 30 Jun 2014, Sascha Hauer wrote:

> On Mon, Jun 30, 2014 at 10:41:58AM -0400, Robert P. J. Day wrote:
> >
> > Various grammar/font fixes to that section, including adding an
> > additional section describing how to properly do "out of tree"
> > configuration and building.
> >
> > Signed-off-by: Robert P. J. Day <rpjday at crashcourse.ca>
>
> Thanks for documenting the out of tree build. I always forget how to do
> this. Finally I have a place to look at ;)
>
> BTW buildinf the documentation out of tree is currently broken. This is
> because we autogenerate the command files:
>
> 	@$(srctree)/Documentation/gen_commands.py $(srctree) $(srctree)/Documentation/command
>
> We should generate them in $(objtree), but then we the autogenerated
> command files in another place than the rest of the documentation.
> sphinx expects a single directory though.
>
> I have no good idea how to solve this, other than copying all doc files
> to $(objtree)/Documentation before calling sphinxs-build.
> Sascha

  ah, i see what you mean ... i was running

  $ git status -u

to get a list of generated files in the source tree, but didn't notice
that .rst files were set as being ignored, so i can see them now with:

  $ git status -u --ignored

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================