On Tue, 2020-06-16 at 19:58 +0800, Kevin Buckley via lfs-dev wrote: > On Mon, 15 Jun 2020 at 20:01, Bruce Dubbs via lfs-dev > <lfs-dev@lists.linuxfromscratch.org> wrote: > > > I'd like to see the "cross-compiling 101" sections, so > > > > > > Introduction > > > Toolchain Technical Notes > > > General Compilation Instructions > > > > > > in "chapter" 5, separated out from the package build sections > > > there. > > > > We can possibly put a header in the table of contents like we do > > for > > Java in > > http://www.linuxfromscratch.org/blfs/view/stable/general/prog.html, > > but > > the new Chapter 5 is now only 8 pages long. A separate chapter > > doesn't > > make sense to me. > > > > > Appreciate they would make for a very small introductory chapter > > > but it somehow feels wrong as it is. > > > > > > Not sure if I'd favour the Pass1 and Pass2 sections all being > > > within > > > the same chapter or not though, or how one would entitle a > > > chapter > > > that just contained just those five package builds, plus yet > > > another > > > Introduction. > > > > The pass1/pass2 titles are all in Part III. In the full book there > > are > > really three builds for some packages. The -pass titles are really > > to > > emphasize that the same packages are being built with different > > procedures fo rthe creation of the tools. > > Yes: all in Part III but is there a need for the Pass1 and Pass2 > sections > to be separate chapters within that Part. > > In the "old" LFS, the Pass1 and Pass2 sections were both in Chapter > 5. > In the proposed LFS, Pass 1 and Pass 2 get separate chapters, one of > which, as you state, is now just 8 pages long. > > What I was trying to get at before was that these three sections > > > > Introduction > > > Toolchain Technical Notes > > > General Compilation Instructions > > are not really an introduction to Chapter 5, so to just the Pass-1 > build instructions, but are really the introduction to Chapters 5 and > 6, as in to cross-compiling in general. > > As someone else suggested, they might even be "generic" (my wording) > enough to not need to be in the "building" Parts but be moved up into > one > of the "backgrounding" Parts. > > Does that make more sense ? You still don't have to agree with the > premise > but I'm not sure I got my view across as well as I might have before, > in which > case your reluctance to collapse the new 5 and 6 back into the one > Chapter > might not be a response to the right question. > > I think I am trying to take your admission that Chapter 5 is only > eight pages long and use that as the basis for it not needing to > be a separate Chapter, just for Pass-1 instructions, in the first > place. > > To look at this in another way, at the end of the "old" Chapter 5 > you had something you could tar up, move around and use > elsewhere but at the end the proposed Chapter 5, you have nothing > (OK, not nothing) that is of any use without the Chapter 6 Pass-2 > bits, so why split them out into separate Chapters. > > > Can you not have an introduction to a Part in DocBook? If so then > those three non-build sections would go in there and the Pass1 and > Pass2 > sections would just go back to being in a Chapter 5, with the chroot > build > in Chapter 6. > > > Note also that whilst Part III has the title > > Building the LFS Cross Toolchain and Temporary Tools > > it actually contains three Chapters > > Cross-Toolchain > Temporary Tools > Chroot/Additional Tools > > so why doesn't the third of those chapters get an honourable > mention in the Part title? > > Maybe the last of thoise three should have a nod to the "Temporary" > so > > Cross-Toolchain > Base Temporary Tools > Chroot/Additional Temporary Tools > > or similar. > > Then again, using the BLFS Java "bridgehead" example as one way to do > things > > III Constructing the Temporary, Cross-Compiled, Build Environment > > Chapter 5 Building the Cross-Compiled Tools > > Bridgehead:Intro to Cross-Compilng > > 5.1 Toolchain Technical Notes > 5. 2 General Compilation Instructions > > Bridgehead: Compiling a Cross-Toolchain > > 5.3 onwards: Pass -1 sections > > Bridgehead: Cross Compiling Temporary Tools > > Tools for Pass-2 sections > Pass-2 sections > > Chapter 6: Creating the host-isolated (chroot) Build Environment > > ... > > IV. Building the LFS System > > Or something like that anyway. > > Hoping that's useful, > Kevin
Please tell us what you think of: http://www.linuxfromscratch.org/~pierre/lfs-svn/index.html (I've not bee able to remove the latin numbering in the "Preliminary material") Personally, I do not care much about small chapters: chapter 3 is only three pages... I really think the the building of temporary tools is done in three stages. Regards Pierre -- http://lists.linuxfromscratch.org/listinfo/lfs-dev FAQ: http://www.linuxfromscratch.org/faq/ Unsubscribe: See the above information page
