summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/ct-ng.1.in174
-rw-r--r--docs/overview.txt18
2 files changed, 183 insertions, 9 deletions
diff --git a/docs/ct-ng.1.in b/docs/ct-ng.1.in
new file mode 100644
index 0000000..ac033dc
--- /dev/null
+++ b/docs/ct-ng.1.in
@@ -0,0 +1,174 @@
+." crosstool-ng man page
+." Copyright 2007 Yann E. MORIN
+." Licensed under the Creative Commons BY-SA, v2.5
+."
+." Beautifying URLs
+.mso www.tmac
+."
+.TH ct-ng 1 "@@CT_DATE@@" "version @@CT_VERSION@@" "User Commands"
+."
+."
+.SH NAME
+ct-ng, crosstool-ng \- Build cross-toolchains
+."
+."
+.SH SYNOPSIS
+.B ct-ng ACTION
+."
+."
+.SH DESCRIPTION
+Building a cross-toolchain can be a real pain.
+.PP
+.B ct-ng
+makes it easy to build cross-toolchains, and allows you to take all the juice
+out of your target by configuring the differents components of the toolchain
+accordingly to the targeted processor.
+."
+."
+.SH ACTIONS
+Here are the most commonly used actions. For other actions, please see
+.I @@CT_DOCDIR@@/overview.txt
+.TP
+.B help
+Prints a little help text.
+."
+.TP
+.B menuconfig
+Configures
+.B ct-ng
+using a configurator menu very similar to that of the Linux kernel.
+."
+.TP
+.B oldconfig
+Apply options found in an existing
+.I .config
+file, and ask for newer options if there are any.
+."
+.TP
+.B saveconfig
+Save the current
+.B ct-ng
+configuration, and associated components' config files, into a sample. Samples
+are saved in their own sub-directory, named after the target's triplet, in the
+.I samples
+sub-directory of the current directory.
+If that was not clear:
+.I `pwd`/samples/${CT_TARGET}/
+
+Samples can be later recalled by calling
+.B ct-ng
+with the target triplet they represent.
+."
+.TP
+.B build
+Builds the configured toolchain. If
+.B ct-ng
+is called without action, then
+.B build
+is impiled.
+."
+.TP
+.B liststeps
+Lists all build steps available (see
+.BR ENVIRONMENT,
+below).
+."
+.TP
+.B clean
+Remove files generated by
+.B ct-ng
+for itself (these are mostly the configurators' binaries).
+."
+.TP
+.B distclean
+Same as
+.B clean
+, but also removes the toolchain build directory, the downloaded files and the
+.I .config
+configuration file. The generated toolchain is left untouched, as well as
+samples which are not removed.
+."
+.TP
+.B regtest
+Calls the
+.B ct-ng
+regression test suite. All samples are build, and the regression test suite is
+run against every one of them.
+."
+.TP
+.B updatetools
+Updates the
+.I config.guess
+and
+.I config.sub
+scripts. These scripts are used by
+.B ct-ng
+to canonicalise the machines' name (host, build and target machines).
+.TP
+.B tarball
+Builds a tarball of the generated toolchain, also saving the scripts from
+.B ct-ng
+that are needed to rebuild the target, and also saving the tarballs of the
+componnents that were used.
+."
+.SH ENVIRONMENT
+.TP
+.B STOP, START
+Respectively stops and restarts the build just before this step. To restart a
+step, a previous build should have run at least to that step, or further.
+
+The list of steps is vailable with the action
+.BR liststeps .
+."
+.SH EXIT VALUE
+The
+.B ct-ng
+frontend is in fact a
+.BR make (1)
+script. See the man page for
+.BR make (1)
+to have the meaning of the exit values.
+."
+.SH BUGS
+As of today (@@CT_DATE@@), building tarballs is broken. It is difficult to
+foresee how every parts of
+.B ct-ng
+are going to be installed. Each parts is needed to build a tarball, as it
+contains all that is needed to rebuild the toolchain from scratch: toolchain
+components' sources,
+.B ct-ng
+configuration, but also all
+.B ct-ng
+scripts.
+."
+.SH SECURITY
+.B Don't run as root!
+Great care has been taken to avoid mistakes, but bug-free programs don't
+exist. During normal operation,
+.B ct-ng
+removes entire directories. If you run as root, and there is a bug or you
+mis-configured
+.BR ct-ng ,
+entire important directories could be removed (eg.
+.IR /usr ),
+although
+.B ct-ng
+will refuse to install in some well known critical directories.
+."
+.SH AUTHORS
+.MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" ""
+.URL "http://ymorin.is-a-geek.org" "" ""
+reordered
+.B crosstool
+(see section titled
+.BR "SEE ALSO" )
+scripts to be more easily maintainable, added the Kconfig configurator, some
+patches.
+
+Please consult the file
+.I @@CT_DOCDIR@@/CREDITS
+for a list of contributors.
+."
+.SH SEE ALSO
+Please have a look at the
+.URL "http://www.kegel.com/crosstool" "original crosstool" " by Daniel KEGEL"
diff --git a/docs/overview.txt b/docs/overview.txt
index cd5c9f7..14dc0a2 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -110,9 +110,9 @@ CT_TARGET:
/opt/x-tools/${CT_TARGET}
CT_TOP_DIR:
- The top directory where crosstool-NG sits. You shouldn't need it in most
- cases. There is one case where you may need it: if you have local patches
- and you store them in your copy of crosstool-NG, you can refer to them
+ The top directory where crosstool-NG is running. You shouldn't need it in
+ most cases. There is one case where you may need it: if you have local
+ patches and you store them in your running directory, you can refer to them
by using CT_TOP_DIR, such as:
${CT_TOP_DIR}/patches.myproject
@@ -274,13 +274,13 @@ Makefile-based.
Makefile front-end |
-------------------*
-The Makefile defines a set of rules to call each action. You can get the
-list, along with some terse description, by typing "make help" in your
-favourite command line.
+To Be Written later...
-The Makefile sets the version variable from the version file in ${CT_TOP_DIR}
-which is then available to others in the CT_VERSION environment variable.
+Kconfig parser |
+---------------*
The kconfig language is a hacked version, vampirised from the toybox project
-by Rob LANDLEY (http://www.landley.net/code/toybox/), adapted to my needs.
+by Rob LANDLEY (http://www.landley.net/code/toybox/), itself coming from the
+Linux kernel (http://www.linux.org/ http://www.kernel.org/), and (heavily)
+adapted to my needs.