03/03: bootstrappable: Add some comments: WIP: also squash into `Add Mes bootstrap.'

[Jan Nieuwenhuizen]

janneke pushed a commit to branch wip-bootstrap
in repository guix.

commit 7f6eaa97b563e820b6476a114927804eea3d0a67
Author: Jan Nieuwenhuizen <address@hidden>
Date:   Mon Sep 17 21:36:35 2018 +0200

    bootstrappable: Add some comments: WIP: also squash into `Add Mes 
bootstrap.'
---
 gnu/packages/commencement.scm | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/gnu/packages/commencement.scm b/gnu/packages/commencement.scm
index 2dbf326..551ac06 100644
--- a/gnu/packages/commencement.scm
+++ b/gnu/packages/commencement.scm
@@ -304,6 +304,12 @@
              (files '("share/mes/lib"))))))))
 
 (define tcc-boot0
+  ;; Pristine tcc cannot be built by MesCC, we are keeping a delta of 11
+  ;; patches.  In a very early form they were presented to the TinyCC
+  ;; developers, who showed no interest in the bootstrappable effort.  These
+  ;; patches have been ported to 0.9.27, alas the resulting tcc is still too
+  ;; buggy.  Once MesCC is more mature, this package should use the 0.9.27
+  ;; sources (or later).
   (let ((version "0.9.26")
         (revision "2")
         (commit "b7aa90652065279b580a414735a4363ae9112d0a"))
@@ -692,6 +698,11 @@
             "--with-sysroot=/")))))))
 
 (define gcc-core-mesboot
+  ;; Gcc-2.95.3 is the most recent GCC that is supported by what the Mes C
+  ;; Library v0.16 offers.  Gcc-3.x (and 4.x) place higher demands on a C
+  ;; library, such as dir.h/struct DIR/readdir, locales, signals...  Also,
+  ;; with gcc-2.95.3, binutils-boot-2.20.1a and glibc-2.2.5 we found a GNU
+  ;; toolchain triplet "that works".
   (package-with-bootstrap-guile
    (package
      (inherit gcc)
@@ -852,6 +863,9 @@ ac_cv_c_float_format='IEEE (little-endian)'
              (files '("include"))))))))
 
 (define glibc-mesboot0
+  ;; GNU C Library 2.2.5 is the most recent glibc that we managed to build
+  ;; using gcc-2.95.3.  Newer versions (2.3.x, 2.6, 2.1x) seem to need a newer
+  ;; gcc.
   (package-with-bootstrap-guile
    (package
      (inherit glibc)