Commit Graph

75 Commits

Author SHA1 Message Date
Titus von Boxberg
d6d670bac2 docs/overview.txt: Provide short mercurial HOWTO
The usage of hg mq is imho not very well documented.
Give a short intro for the most important use cases
for contributions to ct-ng.

yann.morin.1998@anciens.enib.fr:
Slightly rewrote the explanations for the introductory message.
2010-05-22 18:48:50 +02:00
Yann E. MORIN"
52304e2e56 docs: update the section about the wrapper
The wrapper is no longer needed when building
non-shared companion libraries. Document that.
2010-04-28 22:24:01 +02:00
Yann E. MORIN"
24cb85167d kconfig: silence a warning about undefined env variable
When using an environment variable to set a config entry,
don'twarn if it is not defined. Update doc accordingly.
2010-03-05 09:43:00 +01:00
Yann E. MORIN"
daca7d6672 config: prepare for build-system backend
When acting as a backend for a build-system, we should not build
any application that runs on the target, that is:
- no native gdb
- no companion libraries
- no binutils libraries
- no debug tools (save for gdbserver)
- ...

Here, we simply prepare the (hidden) config option that will detect
that we are acting as a back-end.

Update doc accordingly.
2010-03-05 09:19:56 +01:00
Yann E. MORIN"
013230cda9 scripts: add action to extract config from a build.log file
That got removed quite some time ago, but is really usefull to get the
configuration from a build.log file of a failing build.
2010-02-11 21:28:10 +01:00
Yann E. MORIN"
0e2fb72a75 docs: do not document CT_KERNEL_ARCH, it's going away...
Since we merged the 32/64-bit archs, and we explicitly used
the Linux kernel arch name, we can get rid of CT_KERNEL_ARCH.
2010-01-23 16:49:56 +01:00
Richard Strand
652d8eebd9 documentation: Remove refs to seemingly native toolchains issue
Remove references to the seemingly native toolchains do not build
issue as it seems to be fixed.

Signed-off-by: Richard Strand <richard.strand@icomera.com>
2010-01-08 18:48:21 +00:00
Frederic Roussel"
6d9e27b5b7 Fix typos and adjust some documentation. 2009-11-17 10:01:22 -08:00
Yann E. MORIN"
cbbe785842 docs: adding naming conventions for crosstool-NG 2009-10-12 19:31:50 +02:00
Yann E. MORIN"
2fea2229c9 docs: fix chapter spacing 2009-10-12 19:25:41 +02:00
Yann E. MORIN"
a83479174b docs: get rid of any reference to the now long-gone svn repository 2009-10-10 13:12:28 +02:00
Yann E. MORIN"
632d59babd docs: move the "contributing" section to overview.txt 2009-10-10 12:55:17 +02:00
Yann E. MORIN"
3902827e9f docs: configure no longer accepts --with-contrib
It's been a while that configure does not recognise --with-contrib.
Applying contibutions is to be done manually, using patch.
2009-10-10 11:24:31 +02:00
Yann E. MORIN"
1e1f247acc doc: update documentation, mostly eye-candy 2009-10-03 17:23:17 +02:00
Yann E. MORIN"
443f51a2dc libc/glibc: fix building for seemingly native toolchains
Build glibc with -O2 as a fix/workaround to building
seemingly-native toolchains.

See:
- docs/overview.txt
- docs/known-issues.txt
- http://sourceware.org/ml/crossgcc/2009-09/msg00055.html
2009-10-02 22:10:38 +02:00
Yann E. MORIN"
33144a6438 docs: typo in overview.txt 2009-09-06 10:45:31 +02:00
Yann E. MORIN"
d811941c9a config: choose whether to use the shell or the C wrapper
Offer a config choice on whether to isntall the script wrapper, or
the compiled C wrapper. Update docs/overview.txt accordingly.
2009-08-30 00:27:12 +02:00
Yann E. MORIN"
7628fa7a08 overview: fix table of content, fix the hacker's way
table of content: add missing entry
the hacker's way: no need to "make install"
2009-08-30 00:30:45 +02:00
Yann E. MORIN
a393a72f5f [populate] enhance documentation
This patch adds explanations on how
populate works internally.
2009-06-14 21:44:33 +02:00
Yann E. MORIN
bdf80a8db9 [populate] fix documentation
This patch fixes the existing documentation:
- document -l and -L
- use syntax more in line with the help entry
2009-06-14 21:43:55 +02:00
Yann E. MORIN"
683d230777 Add a bit more explanations on the meaning of OBSOLETE and EXPERIMENTAL.
-------- diffstat follows --------
 /trunk/config/global/ct-behave.in |   22    13     9     0 +++++++++++++---------
 /trunk/docs/overview.txt          |    8     6     2     0 ++++++--
 2 files changed, 19 insertions(+), 11 deletions(-)
2009-04-20 21:30:25 +00:00
Robert P. J. DAY"
6511a7787f Fix obvious "DESTDIR" misspelling. 2009-04-17 20:45:47 +00:00
Yann E. MORIN"
b8b7843bea Get rid of all stuff related to building a /delivery' traball:
- building a delivery tarball has long been broken (since crostool-Ng is installable)
- get rid of implied do_print_filename, that can be mis-leading now tarballs can not be built

 /trunk/scripts/build/kernel/bare-metal.sh  |    4     0     4     0 ----
 /trunk/scripts/build/kernel/linux.sh       |    4     0     4     0 ----
 /trunk/scripts/build/tools/000-template.sh |   11     0    11     0 -----------
 /trunk/scripts/build/tools/100-libelf.sh   |    4     0     4     0 ----
 /trunk/scripts/build/tools/200-sstrip.sh   |   11     1    10     0 +----------
 /trunk/scripts/build/binutils.sh           |    4     0     4     0 ----
 /trunk/scripts/build/cc/gcc.sh             |    5     0     5     0 -----
 /trunk/scripts/build/debug/000-template.sh |   11     0    11     0 -----------
 /trunk/scripts/build/debug/100-dmalloc.sh  |    4     0     4     0 ----
 /trunk/scripts/build/debug/400-ltrace.sh   |    4     0     4     0 ----
 /trunk/scripts/build/debug/300-gdb.sh      |    7     0     7     0 -------
 /trunk/scripts/build/debug/500-strace.sh   |    4     0     4     0 ----
 /trunk/scripts/build/debug/200-duma.sh     |    4     0     4     0 ----
 /trunk/scripts/build/libc/none.sh          |    5     0     5     0 -----
 /trunk/scripts/build/libc/glibc.sh         |   10     0    10     0 ----------
 /trunk/scripts/build/libc/uClibc.sh        |    6     0     6     0 ------
 /trunk/scripts/build/libc/eglibc.sh        |   10     0    10     0 ----------
 /trunk/scripts/build/gmp.sh                |    6     0     6     0 ------
 /trunk/scripts/build/mpfr.sh               |    6     0     6     0 ------
 /trunk/docs/overview.txt                   |    9     0     9     0 ---------
 20 files changed, 1 insertion(+), 128 deletions(-)
2009-01-03 21:11:41 +00:00
Yann E. MORIN"
4cfd308098 Move toolchain-config.in from tools/ to scripts/
Small documentation fix.

 /trunk/scripts/crosstool.sh |    2     1     1     0 +-
 /trunk/docs/overview.txt    |    1     1     0     0 +
 2 files changed, 2 insertions(+), 1 deletion(-)
2008-12-11 18:21:18 +00:00
Yann E. MORIN"
488f5d1e76 Move addToolsVersion.sh from tools/ to scripts/
/trunk/docs/overview.txt |    2     1     1     0 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
2008-12-11 18:12:04 +00:00
Yann E. MORIN"
f15b8ade72 Get rid of the local-test in Makefile.
/trunk/Makefile.in       |   30    19    11     0 +++++++++++++++++++-----------
 /trunk/docs/overview.txt |   25    13    12     0 +++++++++++++------------
 2 files changed, 32 insertions(+), 23 deletions(-)
2008-11-16 22:19:57 +00:00
Yann E. MORIN"
81f9d4d73e Honor the DESTDIR variable to install out-of-place (Eg. for packaging).
/trunk/configure         |   10    10     0     0 +++++++++
 /trunk/Makefile.in       |   62    36    26     0 +++++++++++++++++++++++++++++++-----------------------
 /trunk/docs/overview.txt |   12    12     0     0 ++++++++++
 3 files changed, 58 insertions(+), 26 deletions(-)
2008-11-16 21:55:46 +00:00
Yann E. MORIN"
301fbac58e Merge 1199 and 1200 from /devel/YEM-build_host_target_cleanup:
- Allow hand-indentation in the kconfig prompts
- Start documenting the kconfig deviations from the kernel's version

 /trunk/kconfig/menu.c    |   10     8     2     0 ++++++++--
 /trunk/docs/overview.txt |    6     6     0     0 ++++++
 2 files changed, 14 insertions(+), 2 deletions(-)
2008-11-13 17:55:16 +00:00
Yann E. MORIN"
f9f70c5ad6 Do not autodetect 64-bit archs, have them tell be 'select'-ing ARCH_64 in the configuration.
/trunk/scripts/crosstool.sh  |   12     5     7     0 +++++-------
 /trunk/docs/overview.txt     |    6     6     0     0 ++++++
 /trunk/config/target.in      |    4     4     0     0 ++++
 /trunk/config/arch/x86_64.in |    1     1     0     0 +
 /trunk/config/arch/ia64.in   |    1     1     0     0 +
 5 files changed, 17 insertions(+), 7 deletions(-)
2008-11-07 08:09:42 +00:00
Yann E. MORIN"
ea9b9ea07b Remove regtest actions, introduce build-all actions:
- regtest was not easy to use
- one may wish to simply build all samples
- introduce a per-sample automatic build

 /trunk/docs/overview.txt  |   19    14     5     0 ++++++++---
 /trunk/samples/samples.mk |   92    49    43     0 ++++++++++++++++++++++++++++-------------------------
 /trunk/ct-ng.comp         |    8     5     3     0 +++--
 3 files changed, 68 insertions(+), 51 deletions(-)
2008-10-31 18:31:01 +00:00
Yann E. MORIN"
1c625d676c Push the calculation of the tuple's kernel part down to kernel's build scripts:
- update the kernel script's API with the function CT_DiKernelTupleValues
- update doc accordingly (also with the architecture change, missing in the previous commit)
- small clean-up in the main script, remove useless test

 /trunk/scripts/build/kernel/bare-metal.sh |    5     5     0     0 +++++
 /trunk/scripts/build/kernel/linux.sh      |    5     5     0     0 +++++
 /trunk/scripts/crosstool.sh               |   31    13    18     0 +++++++++++++------------------
 /trunk/scripts/functions                  |   15     8     7     0 ++++++++-------
 /trunk/docs/overview.txt                  |   13     9     4     0 +++++++++----
 5 files changed, 40 insertions(+), 29 deletions(-)
2008-10-23 13:45:48 +00:00
Yann E. MORIN"
4a1f2bf705 Remove CT_BROKEN.
Only one component is actually BROKEN (libelf), make it depend on EXPERIMENTAL, but state BROKEN in the prompt.
ltrace (which depends on libelf) is now marked as EXPERIMENTAL, with the reference to the BROKEN libelf in the help entry.

 /trunk/docs/overview.txt          |    6     0     6     0 ------
 /trunk/config/debug/ltrace.in     |    7     4     3     0 ++++---
 /trunk/config/global/ct-behave.in |    8     0     8     0 --------
 /trunk/config/tools/libelf.in     |    5     3     2     0 +++--
 4 files changed, 7 insertions(+), 19 deletions(-)
2008-10-09 19:17:49 +00:00
Yann E. MORIN"
b8d189b296 Separate the architecture config file and function script.
/trunk/kconfig/kconfig.mk   |   46    23    23     0 +++++++++++++++++++++++-----------------------
 /trunk/scripts/crosstool.sh |    2     1     1     0 +-
 /trunk/docs/overview.txt    |   28    11    17     0 +++++++++++-----------------
 3 files changed, 35 insertions(+), 41 deletions(-)
2008-10-05 15:32:00 +00:00
Yann E. MORIN"
229aa8fe54 Update the internals documentation, adding the kernel API.
Update the internals architecture documentation.

 /trunk/docs/overview.txt |   75    67     8     0 ++++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 67 insertions(+), 8 deletions(-)
2008-10-03 20:00:36 +00:00
Yann E. MORIN"
16c6cc994f Save the toolchain configuration to its own file, as an auto-extracting shell script:
- get rid of the 'extractconfig' action, it was cumbersome to use, and badly documented,
 - introduce a skeleton for the config script,
 - update auto-completion,
 - document the config script.

 /trunk/kconfig/kconfig.mk        |    9     2     7     0 ++-------
 /trunk/scripts/crosstool.sh      |    6     5     1     0 +++++-
 /trunk/docs/overview.txt         |   21     9    12     0 +++++++++------------
 /trunk/tools/toolchain-config.in |    8     8     0     0 ++++++++
 /trunk/ct-ng.comp                |    2     1     1     0 +-
 5 files changed, 25 insertions(+), 21 deletions(-)
2008-10-01 18:10:40 +00:00
Yann E. MORIN"
cce0841d96 Rework the way EXPERIMENTAL kernels are marked as such.
/trunk/kconfig/kconfig.mk          |   51    25    26     0 ++++++++++++++++++++++----------------------
 /trunk/docs/overview.txt           |   47    47     0     0 +++++++++++++++++++++++++++++++++++++++++
 /trunk/config/kernel/bare-metal.in |    1     1     0     0 +
 3 files changed, 73 insertions(+), 26 deletions(-)
2008-09-29 20:19:45 +00:00
Yann E. MORIN"
b1459a8862 Update docs/overview.txt with the script shell fragment that defines bash completion.
/trunk/docs/overview.txt |   14    14     0     0 ++++++++++++++
 1 file changed, 14 insertions(+)
2008-09-05 10:57:06 +00:00
Yann E. MORIN"
ef0f400c26 Introduce four new ARCH specific variables that CT_DoArchValues can set if they want:
- CT_ARCH_CC_CORE_EXTRA_CONFIG
  - CT_ARCH_CC_EXTRA_CONFIG
  - CT_ARCH_TARGET_CLFAGS
  - CT_ARCH_TARGET_LDFLAGS
This will hopefully enable architectures to specify specific flags.
PowerPC will need them to introduce SPE (coming RSN).

 /trunk/scripts/crosstool.sh |    2     2     0     0 ++
 /trunk/scripts/functions    |    4     2     2     0 ++--
 /trunk/docs/overview.txt    |   45    22    23     0 ++++++++++++++++++++++-----------------------
 /trunk/config/target.in     |   10    10     0     0 ++++++++++
 4 files changed, 36 insertions(+), 25 deletions(-)
2008-08-07 15:18:18 +00:00
Yann E. MORIN"
69c2df0e18 Update CREDITS.
Eye-candy on overview.txt.

 /trunk/docs/overview.txt |    4     2     2     0 ++--
 /trunk/docs/CREDITS      |    1     1     0     0 +
 2 files changed, 3 insertions(+), 2 deletions(-)
2008-07-20 16:59:04 +00:00
Yann E. MORIN"
4b7c2e32ac Update the architecture API: architecture help is mandatory.
Update all architectures (some with pointer to the specs, when available).

 /trunk/docs/overview.txt      |    8     8     0     0 ++++++++
 /trunk/arch/arm/config.in     |    3     3     0     0 +++
 /trunk/arch/powerpc/config.in |    3     3     0     0 +++
 /trunk/arch/ia64/config.in    |    3     3     0     0 +++
 /trunk/arch/alpha/config.in   |    2     2     0     0 ++
 /trunk/arch/x86/config.in     |    3     3     0     0 +++
 /trunk/arch/mips/config.in    |    3     3     0     0 +++
 /trunk/arch/sh/config.in      |    3     3     0     0 +++
 /trunk/arch/x86_64/config.in  |    3     3     0     0 +++
 9 files changed, 31 insertions(+)
2008-06-27 14:55:22 +00:00
Yann E. MORIN"
62744e84e7 Autogenerate the architecture selection choice menu.
Update architectures definition files accordingly.
Update documentation accordingly.
Use makefile syntax when listing arch/, tools/ and debug/ config files.

 /trunk/kconfig/kconfig.mk     |   32    29     3     0 +++++++++++++++--
 /trunk/docs/overview.txt      |   75    67     8     0 +++++++++++++++++++++++++++++++++++----
 /trunk/config/target.in       |   94    16    78     0 ++++++++-----------------------------------------
 /trunk/arch/arm/config.in     |    6     5     1     0 +++
 /trunk/arch/powerpc/config.in |    2     2     0     0 +
 /trunk/arch/ia64/config.in    |    4     4     0     0 ++
 /trunk/arch/alpha/config.in   |    2     1     1     0
 /trunk/arch/x86/config.in     |    3     3     0     0 ++
 /trunk/arch/mips/config.in    |    5     5     0     0 +++
 /trunk/arch/sh/config.in      |    4     3     1     0 ++
 /trunk/arch/x86_64/config.in  |    3     3     0     0 ++
 11 files changed, 138 insertions(+), 92 deletions(-)
2008-06-27 13:58:53 +00:00
Yann E. MORIN"
1b6adf776f Update documentation.
/trunk/docs/overview.txt |   37    27    10     0 +++++++++++++++++++++++++++----------
 /trunk/docs/ct-ng.1.in   |   18     1    17     0 +-----------------
 2 files changed, 28 insertions(+), 27 deletions(-)
2008-06-25 14:06:49 +00:00
Yann E. MORIN"
9d8b0a6829 Rework a little bit the steps and samples help entries.
/trunk/docs/overview.txt  |    2     1     1     0 +-
 /trunk/steps.mk           |    7     5     2     0 +++++--
 /trunk/samples/samples.mk |    8     5     3     0 +++++---
 /trunk/ct-ng.in           |    5     3     2     0 +++--
 4 files changed, 14 insertions(+), 8 deletions(-)
2008-06-01 21:12:00 +00:00
Yann E. MORIN"
f29a7d4335 Better explain why populate exists.
New entry for how to add a new component version.
Some homogeneisation in style.

 /trunk/docs/overview.txt |   44    30    14     0 ++++++++++++++++++++++++++++++--------------
 1 file changed, 30 insertions(+), 14 deletions(-)
2008-05-02 21:53:09 +00:00
Yann E. MORIN"
4e3f85be75 Document the contrib/ sub-directory.
Fixed the documentation for the arch-dpecific 'CT_DoArchValues' function.

 /trunk/docs/overview.txt |   20    13     7     0 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)
2008-04-27 09:57:50 +00:00
Yann E. MORIN"
5ff9c06cf3 - Rewrite some parts of history: some sentences could have been considered rude, which was not my intention.
- Fix a few typoes at the same time.
2008-02-20 22:48:35 +00:00
Robert P. J. DAY"
6399c577d5 Fix some obvious typoes in docs/overview.txt 2008-02-20 08:01:12 +00:00
Yann E. MORIN"
3f09a4d4c6 Further improve the architecture-specific framework.
Apply this framework into building of glibc and gcc.

(Whoo! 500th commit! Yeah!)
2007-09-15 21:44:18 +00:00
Yann E. MORIN"
672f596f8b Another little fix in the documentation. 2007-09-14 21:58:55 +00:00
Yann E. MORIN"
6069957d44 A little fix in the documentation. 2007-09-14 21:57:17 +00:00