Commit Graph

34 Commits

Author SHA1 Message Date
Xi Ruoyao
decf315c6d
toolchaintechnotes: fix a typo 2022-10-30 22:30:53 +08:00
Xi Ruoyao
6b052ef554
toolchaintechnotes: reword the reason "cc-lfs not usable on pc"
The problem is not "gcc building system doesn't know cc-lfs can run on
pc", but "cc-lfs really cannot run on pc".

Let's stop anyone from thinking about "why not just tell the gcc
building system the fact".
2022-10-30 22:29:24 +08:00
David Bryant
019499e43b Patched up an ambiguous sentence. Thank you for pointing it out, Xi. 2022-10-30 07:31:31 -05:00
David Bryant
c389124842 Orthography: spell cross-compile and its derived forms consistently.
Add some paragraph breaks to enhance readability. Correct English idiom
here and there. Capitalize titles consistently, fix punctuation.
2022-10-28 13:46:11 -05:00
Pierre Labastie
8b539af84d First attempt at clarifying "Important Preliminary Material" 2022-10-09 18:46:28 +02:00
Bruce Dubbs
b6d3512cc5 Typo 2022-10-06 10:07:36 -05:00
Pierre Labastie
b3daf01578 Typos reported by "rhubarbpieguy" 2022-10-02 09:49:12 +02:00
Xi Ruoyao
543c94cb9c
libstdc++ "stage 3" is not rebuilt for the same reason as "stage 2"
I'm pretty sure "stage 2" libstdc++ (installed in ch6) is already fully
featured.  The reason to rebuild the stage 3 libstdc++ (or entire
stage 3 gcc) is same as the reason to rebuild every packages in multiple
chapters: to "settle down" it.

Merge the content of
https://www.linuxfromscratch.org/lfs/faq.html#rebuild-ch8 into the book
as an explanation.
2022-09-30 17:10:06 +08:00
Xi Ruoyao
77b46db0a8
toolchaintechnotes: highlight why the example (ubuntu vs android) needs "os" field 2022-09-30 16:24:55 +08:00
Xi Ruoyao
e18ba697eb
toolchain technical note: rewrite the descrption for triplet
- Don't say "most building system", refine the dicussion for autoconf.
  Other building systems may use a variant of triplet, or use a
  completely different system designation.
- Explain why a triplet may contain 4 fields in detail. "Histroical
  reason" is not really correct because 3-field triplet is still used
  today for BSD, Fuchsia, IOS, Mac OS X (darwin), Solaris, etc.
- "machine" triplet to "system" triplet (strictly speaking, only the
  first field in the triplet is for the machine).

Why we need to say "vendor can be omitted" explicitly: we mention "gcc
-dumpmachine".  On some distros (like Ubuntu) the output has no vendor
field.  If you think this is too nasty, please remove both.
2022-09-30 10:43:19 +08:00
David Bryant
cc0e77d267 Fix English idiom / clarify "General Instructions" section. 2022-09-29 16:30:17 -05:00
David Bryant
3c4e129d8c Make minor corrections to English idiom / style. 2022-09-29 14:12:10 -05:00
Xi Ruoyao
891b48b84b
toolchaintechnotes: update description about libstdc++
Since r11.0-r199, libstdc++ pass 2 is built as a part of gcc pass 2, not
in chroot.
2022-09-29 20:08:56 +08:00
Xi Ruoyao
de94423625
toolchaintechnotes: revert "second pass" -> "second version" change
"Pass 1" and "Pass 2" have specific meaning in LFS.
2022-09-29 19:43:54 +08:00
Xi Ruoyao
ea9263cbf0
toolchaintechnotes: add the rationale for cross compiling ch6 packages
"need to be cross compiled" alone does not make too much sense: we
compile these packages in chapter 8 anyway.  The real reason forcing a
cross compilation is circular dependency: if building A needs B but
building B needs A, we'll have to cross compile at least one of A and B
or we won't be able to build either in the chroot.
2022-09-29 19:38:47 +08:00
Xi Ruoyao
a243b36b8b
toolchaintechnotes: gcc -dumpmachine is similar to config.guess, but not same
Many distros have some customized things in gcc -dumpmachine.  RHEL uses
x86_64-redhat-linux-gnu, and Ubuntu uses x86_64-linux-gnu ("vendor"
field omitted).  So don't use "same" here, and also mention the "vendor"
field is sometimes omitted.
2022-09-29 19:12:18 +08:00
David Bryant
562062295e Polish up the prose in "Toolchain Technical Notes". Fix capitalization.
Rough edges remain. For instance, $LFS_TGT-ld is referenced, but not
clearly defined. Will need to discuss wirh other editors to resolve.
2022-09-28 14:56:52 -05:00
David Bryant
dd7f9df19f Cleaned up verbiage in unnumbered intro to part 3 (chapters 5 et seq). 2022-09-28 11:26:36 -05:00
Pierre Labastie
c37e846f4b Replace tabs with spaces 2022-09-11 18:42:58 +02:00
Xi Ruoyao
25dc9a8cfa
part 3 intro: warn that don't copy source tree with cp -R 2022-02-22 13:34:36 +08:00
Pierre Labastie
ab824a51d1 Fix a missing space 2022-02-11 18:29:12 +01:00
Xi Ruoyao
d48d1c2d91
toolchain note: add a disclaimer for the purpose of the book
There are some discussion on gcc-help from someone (mis)using LFS to
build a "general" toolchain.  Let's stop it before off-topic message got
into lfs-support.
2021-11-12 17:47:16 +08:00
Xi Ruoyao
859d839d50
remove trailing spaces 2021-09-21 19:03:30 +08:00
Bruce Dubbs
7e62bbc506 Tweak toolchain technical notes wording 2021-09-17 21:43:15 -05:00
Pierre Labastie
a665a20066 Remove spaces at end o lines - part3intro 2021-09-07 22:47:52 +02:00
Pierre Labastie
00e20beef4 Remove an inaccuracy in toolchain technical notes:
packages used for tests are now installed in chapter 8

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@12056 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-10-27 09:47:21 +00:00
Xi Ruoyao
c0c616a439 fix some typos
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@12029 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-08-19 15:31:33 +00:00
Xi Ruoyao
3543e03800 do not hardcode chapter numbers in General Compilation Instructions
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11962 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-19 12:54:28 +00:00
Pierre Labastie
c68e018aab Various text fixes:
- a wrong chapter in toolchain notes, and various text precisions
the option explanations of chapter 8 glibc (was labelled WIP)

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11961 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-19 08:13:06 +00:00
Xi Ruoyao
0e59da9828 fix two wrong hardcoded Chapter numbers, replacing with xrefs
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11958 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-19 03:47:58 +00:00
Pierre Labastie
c3471cf463 Fix several typos in toolchaintechnotes
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11955 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-18 10:00:48 +00:00
Xi Ruoyao
80f8c02437 toolchain notes: 'this chapter' -> 'chapter 5', as there is no 'this chapter'
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11954 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-18 08:42:46 +00:00
Xi Ruoyao
6481cf977e custom xreflabel for toolchaintechnotes: 'section ii' is really stupid
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11951 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-18 04:01:43 +00:00
Pierre Labastie
12fff1eb8d Slightly change the layout in part III, so that the preliminary material
appear separated. Minor rewrites for accounting for the new layout

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11949 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2020-06-17 20:50:25 +00:00