On Mon, Mar 9, 2020 at 9:12 PM Peter Maydell <peter.mayd...@linaro.org> wrote:
> On Mon, 9 Mar 2020 at 20:05, Niek Linnenbank <nieklinnenb...@gmail.com> > wrote: > > Ah now I see what is going on here. So the new rst files are ment to > automatically generate > > documentation in various formats using the Python sphinx tool, correct? > > Yep. Assuming you have Sphinx installed, "make" should build the > documentation as well as the executables (ie you don't need > specifically 'make html'). > > > I played around a bit with running 'make html' and using the include > directive you suggested in > > the target-arm.rst file like: > > > > .. include:: orangepi.rst > > I'm currently writing a patchset which splits the existing > target-arm.rst into a bunch of per-board files in > docs/system/arm/. If that patchset goes in before you > roll the next verison of the series then it should > just be a matter of putting orangepi.rst in the > docs/system/arm/ directory and adding a line to the > table-of-contents in docs/system/target-arm.rst. > Ah yes, that makes sense indeed. I'll keep an eye out for your new patchset. > If you're ready to send out the next version before that, > then leave it with the include:: directive and we can > fix it up to the new structure later. > OK Peter! Regards, Niek > thanks > -- PMM > -- Niek Linnenbank
