<div dir="ltr">Sorry, I did not look into it deeply enough. I will make the necessary changes.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Mar 26, 2020 at 1:44 AM 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">short commit message is a bit wordy. It doesn't need to be a sentence.<br>
We know it is a patch/commit.<br>
<br>
See <a href="https://devel.rtems.org/wiki/Developer/Git#GitCommits" rel="noreferrer" target="_blank">https://devel.rtems.org/wiki/Developer/Git#GitCommits</a> (which<br>
should probably be in the docs, it is linked from<br>
<a href="https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch</a>)<br>
<br>
On Wed, Mar 25, 2020 at 12:58 PM <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..c3147e8 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>
space after comma<br>
<br>
<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>
> +  GCC support threading libraries such as ``pthread.h`` provide threading<br>
> +  support to an application; these libraries are tailored according to RTEMS using<br>
> +  the RTEMS cross-compiler.<br>
This paragraph looks wrong to me. I don't think pthread.h comes<br>
through gcc. We get it from newlib. But there are other threading<br>
packages in gcc that we need to make "RTEMS-friendly" for languages<br>
with threads such as Go threads (libgo) , openmp (libgomp), and maybe<br>
others. if you want to provide one example do a bit of research to get<br>
it right. It would also be possible to try to identify the exhaustive<br>
set but that doesn't seem necessary.<br>
<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>
space after comma<br>
<br>
I don't think we actually multilib any 32/64 bit targets, but that's<br>
probably fine to leave be.<br>
<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>