scripts/build/debug.sh
author Michael Hope <michael.hope@linaro.org>
Wed Nov 16 10:06:21 2011 +1300 (2011-11-16)
changeset 2765 6c5658b8b588
parent 483 99724e410693
permissions -rw-r--r--
scripts: add support for building manuals

Add support for building the HTML and PDF manuals for the major
components. Implement for binutils, GCC, GDB, and GLIBC.

Always build all manuals and install a subset. Be explicit about the
subset to reduce the clutter and to avoid getting copies of common
manuals like bfd from all of the sourceware based components. Downside of
being explicit is that you need to update it when a new component
comes along.

Build the manuals as part of the last GCC build, namely 'cc' for glibc
based ones and cc_core_pass_2 for baremetal.

An example of the output is at:
http://people.linaro.org/~michaelh/incoming/crosstool-NG/

Signed-off-by: Michael Hope <michael.hope@linaro.org>
[yann.morin.1998@anciens.enib.fr: depends on ! remove docs; gold manual install]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
yann@96
     1
# Wrapper to build the debug facilities
yann@96
     2
yann@96
     3
# List all debug facilities, and parse their scripts
yann@96
     4
CT_DEBUG_FACILITY_LIST=
yann@182
     5
for f in "${CT_LIB_DIR}/scripts/build/debug/"*.sh; do
yann@916
     6
    _f="$(basename "${f}" .sh)"
yann@916
     7
    _f="${_f#???-}"
yann@916
     8
    __f="CT_DEBUG_${_f}"
yann@916
     9
    if [ "${!__f}" = "y" ]; then
yann@916
    10
        CT_DoLog DEBUG "Enabling debug '${_f}'"
yann@916
    11
        . "${f}"
yann@916
    12
        CT_DEBUG_FACILITY_LIST="${CT_DEBUG_FACILITY_LIST} ${_f}"
yann@916
    13
    else
yann@916
    14
        CT_DoLog DEBUG "Disabling debug '${_f}'"
yann@96
    15
    fi
yann@96
    16
done
yann@96
    17
yann@96
    18
# Download the debug facilities
yann@96
    19
do_debug_get() {
yann@96
    20
    for f in ${CT_DEBUG_FACILITY_LIST}; do
yann@96
    21
        do_debug_${f}_get
yann@96
    22
    done
yann@96
    23
}
yann@96
    24
yann@96
    25
# Extract and patch the debug facilities
yann@96
    26
do_debug_extract() {
yann@96
    27
    for f in ${CT_DEBUG_FACILITY_LIST}; do
yann@96
    28
        do_debug_${f}_extract
yann@96
    29
    done
yann@96
    30
}
yann@96
    31
yann@96
    32
# Build the debug facilities
yann@96
    33
do_debug() {
yann@96
    34
    for f in ${CT_DEBUG_FACILITY_LIST}; do
yann@96
    35
        do_debug_${f}_build
yann@96
    36
    done
yann@96
    37
}
yann@96
    38