Commit Graph

43 Commits

Author SHA1 Message Date
Xi Ruoyao
c87106896c
English grammar fixes
Suggested-by: †KJM† <biz@k-1.me>
2024-12-06 17:05:02 +08:00
Xi Ruoyao
653ead1781
toolchaintechnotes: Refer to Glibc wiki instead of shlib-versions
The list of dynamic linkers is removed in shlib-versions since 2014.

Link: https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=ba90e05052ce
2024-08-05 12:08:18 +08:00
Xi Ruoyao
678acc1775
toolchaintechnotes: Update the paragraph describing ch05 glibc
We no longer pass CC="$LFS_TGT-gcc -nostdinc -isysroot" since
cross-chap5.
2024-08-05 12:02:35 +08:00
Xi Ruoyao
9977b8f05b
generalinstructions: Remove a false statement about "cp -R destroys symlink"
It's just wrong (at least with all recent Coreutils releases).

Note that hard links are really destroyed, but AFAIK tar does not keep
hard links correctly anyway and destroying hard links won't cause
packages fail to build at all.
2024-04-06 17:39:05 +08:00
Pierre Labastie
360fdfca9c Fix punctuation in quotes, and quote signs
- period and comma inside quotes
- " to <quote>
- some " to <literal> when it is a var value
2024-01-26 18:28:53 +01:00
Pierre Labastie
7152faa5fa Change all xml files to utf-8 encoding 2024-01-18 20:53:23 +01:00
Bruce Dubbs
1ec60f1daf Move a caution to a better page.
Move caution regarding building by mixing
different versions of LFS to General Compilation Instructions.
2023-09-04 15:08:43 -05:00
David Bryant
f84d8a6f28 Edited for clarity, punctuation, and English idiom. 2022-11-03 13:12:33 -05:00
Xi Ruoyao
61f825108e
toolchaintechnotes: reword the explanation about rebuild libstdc++ in gcc pass 2 2022-10-31 14:50:35 +08:00
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