Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJon Turney <jon.turney@dronecode.org.uk>2021-07-22 18:23:31 +0300
committerJon Turney <jon.turney@dronecode.org.uk>2021-12-30 01:45:04 +0300
commita4e734fcdbfaee60455eeb7bc08255bb6c1e8729 (patch)
tree2b61980a68fa1b533f8bc3308572a7f1404f9627 /newlib/README
parent8e166351b3079f19154666943673604382d9ec87 (diff)
newlib: Remove automake option 'cygnus'
The 'cygnus' option was removed from automake 1.13 in 2012, so the presence of this option prevents that or a later version of automake being used. A check-list of the effects of '--cygnus' from the automake 1.12 documentation, and steps taken (where possible) to preserve those effects (See also this thread [1] for discussion on that): [1] https://lists.gnu.org/archive/html/bug-automake/2012-03/msg00048.html 1. The foreign strictness is implied. Already present in AM_INIT_AUTOMAKE in newlib/acinclude.m4 2. The options no-installinfo, no-dependencies and no-dist are implied. Already present in AM_INIT_AUTOMAKE in newlib/acinclude.m4 Future work: Remove no-dependencies and any explicit header dependencies, and use automatic dependency tracking instead. Are there explicit rules which are now redundant to removing no-installinfo and no-dist? 3. The macro AM_MAINTAINER_MODE is required. Already present in newlib/acinclude.m4 Note that maintainer-mode is still disabled by default. 4. Info files are always created in the build directory, and not in the source directory. This appears to be an error in the automake documentation describing '--cygnus' [2]. newlib's info files are generated in the source directory, and no special steps are needed to keep doing that. [2] https://lists.gnu.org/archive/html/bug-automake/2012-04/msg00028.html 5. texinfo.tex is not required if a Texinfo source file is specified. (The assumption is that the file will be supplied, but in a place that automake cannot find.) This effect is overriden by an explicit setting of the TEXINFO_TEX variable (the directory part of which is fed into texi2X via the TEXINPUTS environment variable). 6. Certain tools will be searched for in the build tree as well as in the user's PATH. These tools are runtest, expect, makeinfo and texi2dvi. For obscure automake reasons, this effect of '--cygnus' is not active for makeinfo in newlib's configury. However, there appears to be top-level configury which selects in-tree runtest, expect and makeinfo, if present. So, if that works as it appears, this effect is preserved. If not, this may cause problem if anyone is building those tools in-tree. This effect is not preserved for texi2dvi. This may cause problems if anyone is building texinfo in-tree. If needed, explicit checks for those tools looking in places relative to $(top_srcdir)/../ as well as in PATH could be added. 7. The check target doesn't depend on all. This effect is not preseved. The check target now depends on the all target. This concern seems somewhat academic given the current state of the testsuite. Also note that this doesn't touch libgloss.
Diffstat (limited to 'newlib/README')
-rw-r--r--newlib/README13
1 files changed, 7 insertions, 6 deletions
diff --git a/newlib/README b/newlib/README
index eac9f0045..8ed1871bd 100644
--- a/newlib/README
+++ b/newlib/README
@@ -576,9 +576,10 @@ from the newlib/libc/machine/arm directory.
If you have regenerated a configure file or if you have modified a Makefile.am
file, you will need to regenerate the appropriate Makefile.in file(s).
-For newlib, automake is a bit trickier. First of all, all Makefile.in
-files in newlib (and libgloss) are generated using the --cygnus option
-of automake.
+For newlib, automake is a bit trickier.
+
+First of all, note that all the Makefile.in files in libgloss must be
+generated using the --cygnus option of automake.
Makefile.in files are generated from the nearest directory up the chain
which contains a configure.ac file. In most cases, this is the same
@@ -590,21 +591,21 @@ which is the nearest parent directory that contains a configure.ac.
When you issue the automake command, you specify the subdirectory for
the Makefile.in you are regenerating. For example:
- automake --cygnus stdio/Makefile stdlib/Makefile
+ automake stdio/Makefile stdlib/Makefile
Note how multiple Makefile.in files can be created in the same step. You
would not specify machine/Makefile or sys/Makefile in the previous example
because both of these subdirectories contain their own configure.ac files.
One would change to each of these subdirectories and in turn issue:
- automake --cygnus Makefile
+ automake Makefile
Let's say you create a new machine directory XXXX off of newlib/libc/machine.
After creating a new configure.ac and Makefile.am file, you would issue:
aclocal -I ../../..
autoconf
- automake --cygnus Makefile
+ automake Makefile
from newlib/libc/machine/XXXX