[rtems-docs commit] Update build system related sections for RTEMS 6

[Chris Johns]

On 11/11/22 6:39 pm, Sebastian Huber wrote:
> On 10/11/2022 01:30, Chris Johns wrote:
>> The first is the maintenance of embedded the version numbers in the
>> documentation. If we can avoid doing that the work per release or dot release
>> is less.
> 
> We could use a simple search and replace for this. Searching for 'rtems[0-9]'
> shows a couple of spots which need a more through rework. We even have stuff
> with rtems4.10.

That may work for some places but I found it useful to review the documentation
at the same time given things may have changed. In the end I am not fussed how
we make the change. :)

>> The second is the changing of `kernel` to `src`. The use of `kernel` was
>> specific because it removes any ambiguity when a new user attempts to build a
>> package like libbsd in the same tree. Source can mean it is the place where
>> all source is placed. I think `kernel` should be used and returned.
> 
> I usually place all Git repositories in a "src" directory.

Is there a per repo directory under src? I am fine with that. The important
point is having a consistent arrangement that can be used when building other
things like libbsd or the examples without needing to delete or change anything.

Chris