<div dir="ltr">Yes, I did. They looked good to me, although I am willing to change the format based on further feedback.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Mar 26, 2020 at 10:49 PM Gedare Bloom <<a href="mailto:gedare@rtems.org">gedare@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Utkarsh,<br>
<br>
Thank you this looks pretty good. Did you build the docs with your<br>
changes to see they look right to you?<br>
<br>
On Thu, Mar 26, 2020 at 10:57 AM <a href="mailto:utkarsh.rai60@gmail.com" target="_blank">utkarsh.rai60@gmail.com</a><br>
<<a href="mailto:utkarsh.rai60@gmail.com" target="_blank">utkarsh.rai60@gmail.com</a>> wrote:<br>
><br>
> ---<br>
>  user/start/tools.rst | 31 +++++++++++++++++++++++++++++++<br>
>  1 file changed, 31 insertions(+)<br>
><br>
> diff --git a/user/start/tools.rst b/user/start/tools.rst<br>
> index c3f039b..63b6d17 100644<br>
> --- a/user/start/tools.rst<br>
> +++ b/user/start/tools.rst<br>
> @@ -76,3 +76,34 @@ source code used.<br>
><br>
><br>
>  Add ``--verbose`` to the GCC command for the the verbose version details.<br>
> +<br>
> +Need for RTEMS-Specific Cross-Compiler<br>
> +--------------------------------------------<br>
> +<br>
> +New users are often confused as to why they can't use their distribution's<br>
> +cross-compiler for their target on rtems, e.g., the riscv64-linux-gnu or the<br>
> +arm-none-eabi-gcc. Below mentioned are some of the reasons for using the RTEMS<br>
> +cross-compiler.<br>
> +<br>
> + ``Correct configuration of newlib -``<br>
> +  Newlib is a C standard library implementation intended for use on embedded<br>
> +  systems. Most of the POSIX and libc support for RTEMS is derived from newlib.<br>
> +  The RTEMS cross-compiler configures newlib correctly for RTEMS.<br>
> +<br>
> + ``Threading in GCC support libraries -``<br>
> +  Several threading packages in GCC such as Go threads (libgo), openmp<br>
> +  (libgomp), and openacc need to be customized according to RTEMS. This is done<br>
> +  by the RTEMS specific cross-compiler.<br>
> +<br>
> + ``Provide preprocessor define __rtems__ -``<br>
> +  The  ``__rtems__``  preprocessor define is used to provide conditional code<br>
> +  compilation in source files that are shared with other projects e.g. in newlib<br>
> +  or imported code from freebsd.<br>
> +<br>
> + ``Multilib variants to match the BSP -``<br>
> +  RTEMS configures GCC to create separate runtime libraries for each supported<br>
> +  instruction set, floating point unit, vector unit, word size (e.g. 32-bit and<br>
> +  64-bit), endianness, ABI, processor errata workarounds, and so on in the<br>
> +  architecture. These libraries are termed multilib variants. Multilibs variants<br>
> +  to match the BSP are set by selecting a specific set of machine options using<br>
> +  the RTEMS cross-compiler.<br>
> --<br>
> 2.17.1<br>
><br>
> _______________________________________________<br>
> devel mailing list<br>
> <a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
> <a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div>