README-builds.html
changeset 20914 5bc23ba054f0
parent 19525 9dac5000c015
child 19758 3e519fa7e632
equal deleted inserted replaced
20913:7c945e954cfe 20914:5bc23ba054f0
  1208 
  1208 
  1209             <h3><a name="faq">FAQ</a></h3>
  1209             <h3><a name="faq">FAQ</a></h3>
  1210             <blockquote>
  1210             <blockquote>
  1211 
  1211 
  1212                 <p>
  1212                 <p>
  1213                     <b>Q:</b> The <code>configure</code> file looks horrible! 
  1213                     <b>Q:</b> The <code>generated-configure.sh</code> file looks horrible! 
  1214                     How are you going to edit it?
  1214                     How are you going to edit it?
  1215                     <br>
  1215                     <br>
  1216                     <b>A:</b> The <code>configure</code> file is generated (think
  1216                     <b>A:</b> The <code>generated-configure.sh</code> file is generated (think
  1217                     "compiled") by the autoconf tools. The source code is
  1217                     "compiled") by the autoconf tools. The source code is
  1218                     in <code>configure.ac</code> various .m4 files in common/autoconf,
  1218                     in <code>configure.ac</code> and various .m4 files in common/autoconf,
  1219                     which are
  1219                     which are much more readable.
  1220                     much more readable.
       
  1221                 </p>
  1220                 </p>
  1222 
  1221 
  1223                 <p>
  1222                 <p>
  1224                     <b>Q:</b> 
  1223                     <b>Q:</b> 
  1225                     Why is the <code>configure</code> file checked in, 
  1224                     Why is the <code>generated-configure.sh</code> file checked in, 
  1226                     if it is generated?
  1225                     if it is generated?
  1227                     <br>
  1226                     <br>
  1228                     <b>A:</b> 
  1227                     <b>A:</b> 
  1229                     If it was not generated, every user would need to have the autoconf 
  1228                     If it was not generated, every user would need to have the autoconf 
  1230                     tools installed, and re-generate the <code>configure</code> file
  1229                     tools installed, and re-generate the <code>configure</code> file
  1235                 </p>
  1234                 </p>
  1236 
  1235 
  1237                 <p>
  1236                 <p>
  1238                     <b>Q:</b>
  1237                     <b>Q:</b>
  1239                     Do you require a specific version of autoconf for regenerating
  1238                     Do you require a specific version of autoconf for regenerating
  1240                     <code>configure</code>?
  1239                     <code>generated-configure.sh</code>?
  1241                     <br>
  1240                     <br>
  1242                     <b>A:</b>
  1241                     <b>A:</b>
  1243                     Currently, no, but this will likely be the case when things have 
  1242                     Yes, version 2.69 is required and should be easy
  1244                     settled down a bit more. (The reason for this is to avoid
  1243                     enough to aquire on all supported operating
  1245                     large spurious changes in <code>configure</code> 
  1244                     systems.  The reason for this is to avoid
  1246                     in commits that made small changes to <code>configure.ac</code>).
  1245                     large spurious changes in <code>generated-configure.sh</code>.
       
  1246                 </p>
       
  1247 
       
  1248                 <p>
       
  1249                     <b>Q:</b>
       
  1250                     How do you regenerate <code>generated-configure.sh</code>
       
  1251                     after making changes to the input files?
       
  1252                     <br>
       
  1253                     <b>A:</b>
       
  1254                     Regnerating <code>generated-configure.sh</code>
       
  1255                     should always be done using the
       
  1256                     script <code>common/autoconf/autogen.sh</code> to
       
  1257                     ensure that the correct files get updated. This
       
  1258                     script should also be run after mercurial tries to
       
  1259                     merge <code>generated-configure.sh</code> as a
       
  1260                     merge of the generated file is not guaranteed to
       
  1261                     be correct.
  1247                 </p>
  1262                 </p>
  1248 
  1263 
  1249                 <p>
  1264                 <p>
  1250                     <b>Q:</b> 
  1265                     <b>Q:</b> 
  1251                     What are the files in <code>common/makefiles/support/*</code> for? 
  1266                     What are the files in <code>common/makefiles/support/*</code> for?