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 -- http://lists.linuxfromscratch.org/listinfo/lfs-dev FAQ: http://www.linuxfromscratch.org/faq/ Unsubscribe: See the above information page
