[PATCH v2 modular 3/3] build.sh: comment the supported systems and how they are detected

[Mark Kettenis]

> From: Gaetan Nadon <memsize at videotron.ca>
> Date: Mon, 03 Jan 2011 18:08:11 -0500
> 
> For many, build.sh is the first encounter to X.Org or even UNIX code.
> This comment should help them understand why certain packages cannot be
> built on thier system.

Sorry, but I think this list is incomplete, and the descriptions
inconsistent and perhaps even wrong.  I think you're better off not
taking on the burden of maintaining it.  People who don't know what
these terms mean and don't know how to use google don't really have a
chance of building Xorg from source.

> Signed-off-by: Gaetan Nadon <memsize at videotron.ca>
> ---
>  build.sh |   28 ++++++++++++++++++++++++++--
>  1 files changed, 26 insertions(+), 2 deletions(-)
> 
> diff --git a/build.sh b/build.sh
> index f996a0f..3f66d44 100755
> --- a/build.sh
> +++ b/build.sh
> @@ -1,10 +1,34 @@
>  #!/bin/sh
> -#
> -# Note on portability:
> +
> +# Script Portability
>  # This script is intended to run on any platform supported by X.Org.
>  # The Autoconf generated configure script is a good reference as to what is permitted.
>  # Basically, it should be able to run in a Bourne shell.
>  
> +# Build Exceptions
> +# Not all packages can be built on all systems.
> +# uname -s   Description
> +# --------   --------------------------------------------------------------------------
> +# CYGWIN*    a Unix-like environment and command-line interface for Microsoft Windows
> +# Darwin     a layer of Mac OS X comprising the kernel, drivers and BSD technologies
> +# Dragonfly  a Unix-like operating system created as a fork of FreeBSD 4.8
> +# FreeBSD    a free Unix-like operating system descended from AT&T UNIX via BSD UNIX
> +# Linux      a Unix-like operating systems with GNU software and Linux kernel
> +# GNU        a Unix-like operating system developed by the GNU project - Hurd microkernel
> +# GNU/*      a Unix-like operating system with GNU software but a non Linux kernel
> +# NetBSD     an open source version of the Unix-derivative Berkeley Software Distribution
> +# OpenBSD    a Unix-like operating system descended from Berkeley Software Distribution
> +# SunOS      a Unix system developed by Sun Microsystems under the Solaris brand
> +#
> +# Not all packages can be built on all cpus.
> +# uname -m   Description
> +# --------   --------------------------------------------------------------------------
> +# i*86       CPUs supporting the Intel 8086 instruction set architecture (ISA)
> +# x86_64     CPUs supporting x86 ISA with 64 bit extensions
> +# amd64      CPUs supporting x86 ISA with 64 bit extensions
> +# sparc      a RISC instruction set architecture (ISA) developed by Sun Microsystems
> +# sparc64    a RISC instruction set architecture (ISA) developed by Sun Microsystems
> +
>  envoptions() {
>  cat << EOF
>  Environment variables specific to build.sh:
> -- 
> 1.6.0.4
> 
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel
>