Re: Proposal: Add BSP documentation to BSP build specification

2020-11-12 Thread Chris Johns
On 12/11/20 6:50 pm, Sebastian Huber wrote: > On 12/11/2020 08:30, Chris Johns wrote: > >> I am not sure. For example ... >> >> https://docs.rtems.org/branches/master/user/bsps/bsps-arm.html#debugging >> >> ... has a picture of the wire links needed to enable debugging. We need to be >> able to qu

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Sebastian Huber
On 12/11/2020 08:30, Chris Johns wrote: I am not sure. For example ... https://docs.rtems.org/branches/master/user/bsps/bsps-arm.html#debugging ... has a picture of the wire links needed to enable debugging. We need to be able to quickly and easily produce this sort of documentation. We need

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Chris Johns
On 12/11/20 6:13 pm, Sebastian Huber wrote: > On 11/11/2020 23:16, Chris Johns wrote: > >> On 12/11/20 3:46 am, Gedare Bloom wrote: >>> On Wed, Nov 11, 2020 at 9:36 AM Sebastian Huber >>> wrote: On 11/11/2020 17:32, Gedare Bloom wrote: > Hi Sebastian, > > What is the advan

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Sebastian Huber
On 11/11/2020 23:16, Chris Johns wrote: On 12/11/20 3:46 am, Gedare Bloom wrote: On Wed, Nov 11, 2020 at 9:36 AM Sebastian Huber wrote: On 11/11/2020 17:32, Gedare Bloom wrote: Hi Sebastian, What is the advantage of doing this? I don't immediately see the rationale. The advantage is that

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Chris Johns
On 12/11/20 3:46 am, Gedare Bloom wrote: > On Wed, Nov 11, 2020 at 9:36 AM Sebastian Huber > wrote: >> >> On 11/11/2020 17:32, Gedare Bloom wrote: >> >>> Hi Sebastian, >>> >>> What is the advantage of doing this? >>> >>> I don't immediately see the rationale. >> >> The advantage is that as soon as

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Gedare Bloom
On Wed, Nov 11, 2020 at 9:36 AM Sebastian Huber wrote: > > On 11/11/2020 17:32, Gedare Bloom wrote: > > > Hi Sebastian, > > > > What is the advantage of doing this? > > > > I don't immediately see the rationale. > > The advantage is that as soon as you add/remove a BSP family or variant > to/from

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Sebastian Huber
On 11/11/2020 17:32, Gedare Bloom wrote: Hi Sebastian, What is the advantage of doing this? I don't immediately see the rationale. The advantage is that as soon as you add/remove a BSP family or variant to/from the build you can generate an up to date user manual. Having documentation of

Re: Proposal: Add BSP documentation to BSP build specification

2020-11-11 Thread Gedare Bloom
Hi Sebastian, What is the advantage of doing this? I don't immediately see the rationale. Gedare On Wed, Nov 11, 2020 at 2:25 AM Sebastian Huber wrote: > > Hello, > > currently, we have a hand crafted chapter with the BSPs and some > documentation in the User Manual: > > https://docs.rtems.or