visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commits
1 Branch
Branch: main
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gccint/Front-End-Makefile.html

187 lines
8.3KB
Raw Permalink Blame History 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- Copyright (C) 1988-2020 Free Software Foundation, Inc.

  4. 

  5. Permission is granted to copy, distribute and/or modify this document

  6. under the terms of the GNU Free Documentation License, Version 1.3 or

  7. any later version published by the Free Software Foundation; with the

  8. Invariant Sections being "Funding Free Software", the Front-Cover

  9. Texts being (a) (see below), and with the Back-Cover Texts being (b)

  10. (see below).  A copy of the license is included in the section entitled

  11. "GNU Free Documentation License".

  12. 

  13. (a) The FSF's Front-Cover Text is:

  14. 

  15. A GNU Manual

  16. 

  17. (b) The FSF's Back-Cover Text is:

  18. 

  19. You have freedom to copy and modify this GNU Manual, like GNU

  20.      software.  Copies published by the Free Software Foundation raise

  21.      funds for GNU development. -->

  22. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  23. <head>

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  25. <title>Front End Makefile (GNU Compiler Collection (GCC) Internals)</title>

  26. 

  27. <meta name="description" content="Front End Makefile (GNU Compiler Collection (GCC) Internals)">

  28. <meta name="keywords" content="Front End Makefile (GNU Compiler Collection (GCC) Internals)">

  29. <meta name="resource-type" content="document">

  30. <meta name="distribution" content="global">

  31. <meta name="Generator" content="makeinfo">

  32. <link href="index.html#Top" rel="start" title="Top">

  33. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">

  34. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  35. <link href="Front-End.html#Front-End" rel="up" title="Front End">

  36. <link href="Back-End.html#Back-End" rel="next" title="Back End">

  37. <link href="Front-End-Config.html#Front-End-Config" rel="prev" title="Front End Config">

  38. <style type="text/css">

  39. <!--

  40. a.summary-letter {text-decoration: none}

  41. blockquote.indentedblock {margin-right: 0em}

  42. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  43. blockquote.smallquotation {font-size: smaller}

  44. div.display {margin-left: 3.2em}

  45. div.example {margin-left: 3.2em}

  46. div.lisp {margin-left: 3.2em}

  47. div.smalldisplay {margin-left: 3.2em}

  48. div.smallexample {margin-left: 3.2em}

  49. div.smalllisp {margin-left: 3.2em}

  50. kbd {font-style: oblique}

  51. pre.display {font-family: inherit}

  52. pre.format {font-family: inherit}

  53. pre.menu-comment {font-family: serif}

  54. pre.menu-preformatted {font-family: serif}

  55. pre.smalldisplay {font-family: inherit; font-size: smaller}

  56. pre.smallexample {font-size: smaller}

  57. pre.smallformat {font-family: inherit; font-size: smaller}

  58. pre.smalllisp {font-size: smaller}

  59. span.nolinebreak {white-space: nowrap}

  60. span.roman {font-family: initial; font-weight: normal}

  61. span.sansserif {font-family: sans-serif; font-weight: normal}

  62. ul.no-bullet {list-style: none}

  63. -->

  64. </style>

  65. 

  66. 

  67. </head>

  68. 

  69. <body lang="en">

  70. <a name="Front-End-Makefile"></a>

  71. <div class="header">

  72. <p>

  73. Previous: <a href="Front-End-Config.html#Front-End-Config" accesskey="p" rel="prev">Front End Config</a>, Up: <a href="Front-End.html#Front-End" accesskey="u" rel="up">Front End</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>

  74. </div>

  75. <hr>

  76. <a name="The-Front-End-Make_002dlang_002ein-File"></a>

  77. <h4 class="subsubsection">6.3.8.3 The Front End <samp>Make-lang.in</samp> File</h4>

  78. 

  79. <p>Each language subdirectory contains a <samp>Make-lang.in</samp> file.  It contains

  80. targets <code><var>lang</var>.<var>hook</var></code> (where <code><var>lang</var></code> is the

  81. setting of <code>language</code> in <samp>config-lang.in</samp>) for the following

  82. values of <code><var>hook</var></code>, and any other Makefile rules required to

  83. build those targets (which may if necessary use other Makefiles

  84. specified in <code>outputs</code> in <samp>config-lang.in</samp>, although this is

  85. deprecated).  It also adds any testsuite targets that can use the

  86. standard rule in <samp>gcc/Makefile.in</samp> to the variable

  87. <code>lang_checks</code>.

  88. </p>

  89. <dl compact="compact">

  90. <dt><code>all.cross</code></dt>

  91. <dt><code>start.encap</code></dt>

  92. <dt><code>rest.encap</code></dt>

  93. <dd><p>FIXME: exactly what goes in each of these targets?

  94. </p></dd>

  95. <dt><code>tags</code></dt>

  96. <dd><p>Build an <code>etags</code> <samp>TAGS</samp> file in the language subdirectory

  97. in the source tree.

  98. </p></dd>

  99. <dt><code>info</code></dt>

  100. <dd><p>Build info documentation for the front end, in the build directory.

  101. This target is only called by &lsquo;<samp>make bootstrap</samp>&rsquo; if a suitable

  102. version of <code>makeinfo</code> is available, so does not need to check

  103. for this, and should fail if an error occurs.

  104. </p></dd>

  105. <dt><code>dvi</code></dt>

  106. <dd><p>Build DVI documentation for the front end, in the build directory.

  107. This should be done using <code>$(TEXI2DVI)</code>, with appropriate

  108. <samp>-I</samp> arguments pointing to directories of included files.

  109. </p></dd>

  110. <dt><code>pdf</code></dt>

  111. <dd><p>Build PDF documentation for the front end, in the build directory.

  112. This should be done using <code>$(TEXI2PDF)</code>, with appropriate

  113. <samp>-I</samp> arguments pointing to directories of included files.

  114. </p></dd>

  115. <dt><code>html</code></dt>

  116. <dd><p>Build HTML documentation for the front end, in the build directory.

  117. </p></dd>

  118. <dt><code>man</code></dt>

  119. <dd><p>Build generated man pages for the front end from Texinfo manuals

  120. (see <a href="Man-Page-Generation.html#Man-Page-Generation">Man Page Generation</a>), in the build directory.  This target

  121. is only called if the necessary tools are available, but should ignore

  122. errors so as not to stop the build if errors occur; man pages are

  123. optional and the tools involved may be installed in a broken way.

  124. </p></dd>

  125. <dt><code>install-common</code></dt>

  126. <dd><p>Install everything that is part of the front end, apart from the

  127. compiler executables listed in <code>compilers</code> in

  128. <samp>config-lang.in</samp>.

  129. </p></dd>

  130. <dt><code>install-info</code></dt>

  131. <dd><p>Install info documentation for the front end, if it is present in the

  132. source directory.  This target should have dependencies on info files

  133. that should be installed.

  134. </p></dd>

  135. <dt><code>install-man</code></dt>

  136. <dd><p>Install man pages for the front end.  This target should ignore

  137. errors.

  138. </p></dd>

  139. <dt><code>install-plugin</code></dt>

  140. <dd><p>Install headers needed for plugins.

  141. </p></dd>

  142. <dt><code>srcextra</code></dt>

  143. <dd><p>Copies its dependencies into the source directory.  This generally should

  144. be used for generated files such as Bison output files which are not

  145. version-controlled, but should be included in any release tarballs.  This

  146. target will be executed during a bootstrap if

  147. &lsquo;<samp>--enable-generated-files-in-srcdir</samp>&rsquo; was specified as a

  148. <samp>configure</samp> option.

  149. </p></dd>

  150. <dt><code>srcinfo</code></dt>

  151. <dt><code>srcman</code></dt>

  152. <dd><p>Copies its dependencies into the source directory.  These targets will be

  153. executed during a bootstrap if &lsquo;<samp>--enable-generated-files-in-srcdir</samp>&rsquo;

  154. was specified as a <samp>configure</samp> option.

  155. </p></dd>

  156. <dt><code>uninstall</code></dt>

  157. <dd><p>Uninstall files installed by installing the compiler.  This is

  158. currently documented not to be supported, so the hook need not do

  159. anything.

  160. </p></dd>

  161. <dt><code>mostlyclean</code></dt>

  162. <dt><code>clean</code></dt>

  163. <dt><code>distclean</code></dt>

  164. <dt><code>maintainer-clean</code></dt>

  165. <dd><p>The language parts of the standard GNU

  166. &lsquo;<samp>*clean</samp>&rsquo; targets.  See <a href="http://www.gnu.org/prep/standards/html_node/Standard-Targets.html#Standard-Targets">Standard Targets for

  167. Users</a> in <cite>GNU Coding Standards</cite>, for details of the standard

  168. targets.  For GCC, <code>maintainer-clean</code> should delete

  169. all generated files in the source directory that are not version-controlled,

  170. but should not delete anything that is.

  171. </p></dd>

  172. </dl>

  173. 

  174. <p><samp>Make-lang.in</samp> must also define a variable <code><var>lang</var>_OBJS</code>

  175. to a list of host object files that are used by that language.

  176. </p>

  177. <hr>

  178. <div class="header">

  179. <p>

  180. Previous: <a href="Front-End-Config.html#Front-End-Config" accesskey="p" rel="prev">Front End Config</a>, Up: <a href="Front-End.html#Front-End" accesskey="u" rel="up">Front End</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>

  181. </div>

  182. 

  183. 

  184. 

  185. </body>

  186. </html>