diff options
-rw-r--r-- | Makefile.in | 10 | ||||
-rw-r--r-- | README | 83 | ||||
-rwxr-xr-x | configure | 2 | ||||
-rw-r--r-- | docs/overview.txt | 92 | ||||
-rwxr-xr-x | scripts/patch-renumber.sh | 6 |
5 files changed, 98 insertions, 95 deletions
diff --git a/Makefile.in b/Makefile.in index b0dd31d..8fe4912 100644 --- a/Makefile.in +++ b/Makefile.in @@ -195,10 +195,10 @@ install-bin: $(DESTDIR)$(BINDIR) install-lib: uninstall-lib $(DESTDIR)$(LIBDIR) install-lib-main install-lib-samples install-lib-main: $(DESTDIR)$(LIBDIR) - @for src_dir in config kconfig patches scripts; do \ - echo " INST '$${src_dir}/'"; \ - tar cf - --exclude=.svn --exclude='*.sh.in' $${src_dir} \ - |(cd "$(DESTDIR)$(LIBDIR)"; tar xf -); \ + @for src_dir in config kconfig patches scripts; do \ + echo " INST '$${src_dir}/'"; \ + tar cf - --exclude='*.sh.in' $${src_dir} \ + |(cd "$(DESTDIR)$(LIBDIR)"; tar xf -); \ done @chmod a+x $(DESTDIR)$(LIBDIR)/scripts/crosstool-NG.sh @chmod a+x $(DESTDIR)$(LIBDIR)/scripts/saveSample.sh @@ -212,7 +212,7 @@ install-lib-main: $(DESTDIR)$(LIBDIR) # - change every occurrence of CT_TOP_DIR to CT_LIB_DIR install-lib-samples: $(DESTDIR)$(LIBDIR) install-lib-main @echo " INST 'samples/'" - @tar cf - --exclude=.svn samples |(cd "$(DESTDIR)$(LIBDIR)"; tar xf -) + @tar cf - samples |(cd "$(DESTDIR)$(LIBDIR)"; tar xf -) @for samp_file in "$(DESTDIR)$(LIBDIR)/samples/"*"/crosstool.config"; do \ $(sed) -r -i -e 's,\$$\{CT_TOP_DIR\},\$$\{CT_LIB_DIR\},g;' $${samp_file}; \ $(sed) -r -i -e 's,^(CT_WORK_DIR)=.*,\1="\$${CT_TOP_DIR}/targets",;' $${samp_file}; \ @@ -4,9 +4,6 @@ TABLE OF CONTENT / ________________/ - GETTING STARTED - - CONTRIBUTING - - Sending a bug report - - Sending patches - CREDITS - KNOWN ISSUES @@ -18,77 +15,21 @@ To get you started, just enter: ./configure --help You can find a (terse and WIP) documentation in docs/overview.txt. - -You can also point your browser to +Here's a summary of what you'll find in there: + Introduction + History + Installing crosstool-NG + Configuring crosstool-NG + Running crosstool-NG + Using the toolchain + Toolchain types + Contributing + Internals + +You can also point your browser at: http://ymorin.is-a-geek.org/projects/crosstool -CONTRIBUTING / -____________/ - -Sending a bug report --------------------- - -If you need to send a bug report, please send a mail with subject -prefixed with "[CT_NG]" with to following destinations: - TO: yann.morin.1998 (at) anciens.enib.fr - CC: crossgcc (at) sourceware.org - -Sending patches ---------------- - -If you want to enhance crosstool-NG, there's a to-do list in the TODO file. - -Patches should come with the appropriate SoB line. A SoB line is typically -something like: - Signed-off-by: John DOE <john.doe@somewhere.net> - -The SoB line is clearly described in Documentation/SubmittingPatches , section -12, of your favourite Linux kernel source tree. - -Then you'll need to correctly configure Mercurial. There are two extensions -that you may find usefull: - - mq : http://mercurial.selenic.com/wiki/MqExtension - - patchbomb : http://mercurial.selenic.com/wiki/PatchbombExtension - -Commit messages should look like (without leading pipes): - |component: short, one-line description - | - |optional longer description - |on multiple lines if needed - -Here is an example commit message (see revision a53a5e1d61db): - |comp-libs/cloog: fix building - | - |For CLooG/PPL 0.15.3, the directory name was simply cloog-ppl. - |For any later versions, the directory name does have the version, such as - |cloog-ppl-0.15.4. - -Here's a typical hacking session: - hg clone http://ymorin.is-a-geek.org/hg/crosstool-ng crosstool-ng - cd crosstool-ng - hg qinit - hg qnew -D -U -e my_first_patch - *edit patch description* - *hack* *hack* *check* *fails* *hack* *hack* *check* *works* - hg qref -D -e - *edit patch description, serving as commit message* - hg qnew -D -U -e my_second_patch - *edit patch description* - *hack* *hack* *check* *fails* *hack* *hack* *check* *works* - hg qref -D -e - *edit patch description, serving as commit message* - hg email --outgoing --intro \ - --from '"Your Full NAME" <your.email (at) your.domain>' \ - --to '"Yann E. MORIN" <yann.morin.1998 (at) anciens.enib.fr>' \ - --cc 'crossgcc (at) sourceware.org' - *edit introductory message* - *wait for feedback* - *re-send if no answer for a few days* - -Note: replace' (at) ' above with a plain '@'. - - CREDITS / _______/ @@ -378,7 +378,7 @@ has_or_abort lib="${ncurses_libs}" \ #--------------------------------------------------------------------- # Compute the version string -# If this version is a svn snapshot, try to get the revision number +# If this version is n hg clone, try to get the revision number # If we can't get the revision number, use date case "${VERSION}" in *+hg|hg) diff --git a/docs/overview.txt b/docs/overview.txt index 61b4cba..6cd7726 100644 --- a/docs/overview.txt +++ b/docs/overview.txt @@ -30,6 +30,9 @@ Using the toolchain The 'populate' script Toolchain types Seemingly-native toolchains +Contributing + Sending a bug report + Sending patches Internals Makefile front-end Kconfig parser @@ -123,7 +126,7 @@ There are two ways you can use crosstool-NG: The former should be used if you got crosstool-NG from a packaged tarball, see "Install method", below, while the latter is most useful for developpers that -checked the code out from SVN, and want to submit patches, see "The Hacker's +use a clone of the repository, and want to submit patches, see "The Hacker's way", below. Install method | @@ -157,8 +160,7 @@ Stay in the directory holding the sources, and run: See below for complete usage. Now, provided you used a clone of the repository, you can send me your changes. -See the file README, at the top of crosstool-NG source, for how to submit -changees. +See the section titled CONTRIBUTING, below, for how to submit changees. Preparing for packaging | ------------------------+ @@ -188,18 +190,10 @@ Contributed code | -----------------+ Some people contibuted code that couldn't get merged for various reasons. This -code is available as patches in the contrib/ sub-directory. These patches are -to be applied to the source of crosstool-NG, prior to installing. - -An easy way to use contributed code is to pass the --with-contrib= option to -./configure. The possible values depend upon which contributions are packaged -with your version, but you can get with it with passing one of those two -special values: - --with-contrib=list - will list all available contributions - - --with-contrib=all - will select all avalaible contributions +code is available as lzma-compressed patches, in the contrib/ sub-directory. +These patches are to be applied to the source of crosstool-NG, prior to +installing, using something like the following: + lzcat contrib/foobar.patch.lzma |patch -p1 There is no guarantee that a particuliar contribution applies to the current version of crosstool-ng, or that it will work at all. Use contributions at @@ -605,6 +599,74 @@ used by the cross-compiler it is going to build. The problem seems to arise only with glibc (and eglibc?) starting with version 2.7. +________________ + / +Contributing / +_____________/ + +Sending a bug report | +---------------------+ + +If you need to send a bug report, please send a mail with subject +prefixed with "[CT_NG]" with to following destinations: + TO: yann.morin.1998 (at) anciens.enib.fr + CC: crossgcc (at) sourceware.org + +Sending patches | +----------------+ + +If you want to enhance crosstool-NG, there's a to-do list in the TODO file. + +Patches should come with the appropriate SoB line. A SoB line is typically +something like: + Signed-off-by: John DOE <john.doe@somewhere.net> + +The SoB line is clearly described in Documentation/SubmittingPatches , section +12, of your favourite Linux kernel source tree. + +Then you'll need to correctly configure Mercurial. There are two extensions +that you may find usefull: + - mq : http://mercurial.selenic.com/wiki/MqExtension + - patchbomb : http://mercurial.selenic.com/wiki/PatchbombExtension + +Commit messages should look like (without leading pipes): + |component: short, one-line description + | + |optional longer description + |on multiple lines if needed + +Here is an example commit message (see revision a53a5e1d61db): + |comp-libs/cloog: fix building + | + |For CLooG/PPL 0.15.3, the directory name was simply cloog-ppl. + |For any later versions, the directory name does have the version, such as + |cloog-ppl-0.15.4. + +Here's a typical hacking session: + hg clone http://ymorin.is-a-geek.org/hg/crosstool-ng crosstool-ng + cd crosstool-ng + hg qinit + hg qnew -D -U -e my_first_patch + *edit patch description* + *hack* *hack* *check* *fails* *hack* *hack* *check* *works* + hg qref -D -e + *edit patch description, serving as commit message* + hg qnew -D -U -e my_second_patch + *edit patch description* + *hack* *hack* *check* *fails* *hack* *hack* *check* *works* + hg qref -D -e + *edit patch description, serving as commit message* + hg email --outgoing --intro \ + --from '"Your Full NAME" <your.email (at) your.domain>' \ + --to '"Yann E. MORIN" <yann.morin.1998 (at) anciens.enib.fr>' \ + --cc 'crossgcc (at) sourceware.org' + *edit introductory message* + *wait for feedback* + *re-send if no answer for a few days* + +Note: replace '(at)' above with a plain '@'. + + _____________ / Internals / diff --git a/scripts/patch-renumber.sh b/scripts/patch-renumber.sh index f670b90..7ea2aa1 100755 --- a/scripts/patch-renumber.sh +++ b/scripts/patch-renumber.sh @@ -23,9 +23,9 @@ dir="${1}" cpt="${2}" inc="${3}" -case "$(LC_ALL=C svnversion "${dir}" 2>/dev/null)" in - exported) CMD="mv -v";; - *) CMD="svn mv";; +case "$(LC_ALL=C hg id "${dir}" 2>/dev/null)" in + "") CMD="mv -v";; + *) CMD="hg mv";; esac for p in "${dir}"/*.patch; do |