Konvensjoner brukt i denne boken

Typografiske konvensjoner

For å gjøre boken enkel å følge, brukes en rekke konvensjoner gjennom hele boken. Her er noen eksempler:

./configure --prefix=/usr

Denne teksttypen skal skrives nøyaktig som vist, med mindre annet er angitt i den omkringliggende teksten. Den brukes også til å identifisere referanser til spesifikke kommandoer.

install-info: unknown option
`--dir-file=/mnt/lfs/usr/info/dir'

Denne tekstformen (skrift med fast bredde) viser skjermutdata, sannsynligvis resultatet av å utstede en kommando. Den brukes også til å vise filnavn som /boot/grub/grub.conf

[Notat]

Notat

Vennligst konfigurer nettleseren din til å vise tekst med fast bredde med en god monospace skrifttype, så du kan skille mellom tegnene Il1 eller O0 tydelig.

Uthevet

Denne tekstformen brukes til flere formål, men hovedsakelig for å understreke viktige poeng, eller for å gi eksempler på hva man skal skrive.

https://www.lfs.freding.no/

Denne tekstformen brukes til hypertekstlenker utenfor boken, for eksempel veiledninger, nedlastingssteder, nettsteder osv.

«Be om hjelp»

Denne tekstformen brukes til lenker internt i boken, for eksempel en annen seksjon som beskriver en annen pakke.

cat > $LFS/etc/group << "EOF"
root:x:0:
bin:x:1:
......
EOF

Denne stilen brukes hovedsakelig når man oppretter konfigurasjonsfiler. Den første kommandoen (i fet skrift) ber systemet opprette filen. $LFS/etc/group fra det som er skrevet på de følgende linjene, til sekvensen EOF påtreffes. Derfor skrives hele denne delen vanligvis nøyaktig som vist. Husk at kopier og lim inn er din venn!

<ERSTATTET TEKST>

Denne tekstformen brukes til å innkapsle tekst som skal endres, og skal ikke skrives som vist, eller kopieres og limes inn. Vinkelparentesene er ikke en del av den bokstavelige teksten; de er en del av substitusjonen.

root

Denne teksttypen brukes til å vise en spesifikk systembruker eller gruppe referanse i instruksjonene.

 

Konvensjoner brukt for pakkeavhengigheter

Når nye pakker opprettes, er programvarens forfattere avhengige av tidligere arbeid. For å bygge en pakke i LFS bøkene må disse avhengighetene bygges før den ønskede pakken kan kompileres. For hver pakke er forutsetningene oppført i en eller flere separate seksjoner: Påkrevd, Anbefalt og Valgfri.

Påkrevd Avhengigheter

Disse avhengighetene er det absolutte minimum som trengs for å bygge pakken. Pakker i LFS, og de nødvendige avhengighetene til disse pakkene, er utelatt fra denne listen. Husk alltid å sjekke for nestede avhengigheter. Hvis en avhengighet sies å være «kjøretid», da er den ikke nødvendig for å bygge pakken, men bare for å bruke den etter installasjon.

Anbefalt Avhengigheter

Dette er avhengigheter som SLFS redaktørene har bestemt er viktige for å gi pakken rimelige funksjoner. Hvis en anbefalt avhengighet ikke sies å være «kjøretid», installasjonsinstruksjonene for pakken forutsetter at den er installert. Hvis den ikke er installert, kan det hende at instruksjonene må endres for å tilpasse den manglende pakken. En anbefalt «kjøretid» avhengigheten trenger ikke å installeres før pakken bygges, men må bygges etterpå for å kjøre pakken med rimelige muligheter.

Valgfri Avhengigheter

Dette er avhengigheter pakken kan bruke. Integrering av valgfrie avhengigheter kan være automatisk av pakken, eller ytterligere trinn som ikke presenteres av SLFS kan være nødvendige. Valgfrie avhengigheter er noen ganger oppført uten eksplisitte SLFS instruksjoner. I dette tilfellet må du bestemme hvordan du skal utføre installasjonen selv.

 

Konvensjoner brukt for kjernekonfigurasjonsalternativer

Noen pakker krever spesifikke kjernekonfigurasjonsalternativer. Den generelle layouten for disse ser slik ut:

Master section --->
  Subsection --->
    [*]     Required parameter                                        [REQU_PAR]
    <*>     Required parameter (not as module)                   [REQU_PAR_NMOD]
    <*/M>   Required parameter (could be a module)                [REQU_PAR_MOD]
    <M>     Required parameter (as a module)                 [REQU_PAR_MOD_ONLY]
    < /*/M> Optional parameter                                         [OPT_PAR]
    < /M>   Optional parameter (as a module if enabled)       [OPT_PAR_MOD_ONLY]
    [ ]     Incompatible parameter                                  [INCOMP_PAR]
    < >     Incompatible parameter (even as module)             [INCOMP_PAR_MOD]

[...] til høyre viser det symbolske navnet på alternativet, slik at du enkelt kan sjekke om det er angitt i din .config fil. Merk at .config filen inneholder en CONFIG_ prefiks foran alle symbolske navn. Betydningen av de ulike oppføringene er:

Master section menyelement på øverste nivå
Subsection undermenyelement
Required parameter alternativet kan enten være innebygd eller ikke valgt: det må være valgt
Required parameter (not as module) alternativet kan være innebygd, en modul eller ikke valgt (tri-state): det må velges som innebygd
Required parameter (could be a module) alternativet kan være innebygd, en modul eller ikke valgt: det må velges, enten som innebygd eller som en modul
Required parameter (as a module) Alternativet kan være innebygd, en modul eller ikke valgt: det må velges som en modul; å velge det som innebygd kan forårsake uønskede effekter
Optional parameter alternativet kan være innebygd, en modul eller ikke valgt: det kan velges som en modul eller innebygd hvis du trenger det for å drive maskinvaren eller valgfrie kjernefunksjoner
Optional parameter (as a module if enabled) Alternativet kan være innebygd, en modul eller ikke valgt: det kan velges som en modul hvis du trenger det for å drive maskinvaren eller valgfrie kjernefunksjoner, men å velge det som innebygd kan forårsake uønskede effekter
Incompatible parameter alternativet kan enten være innebygd eller ikke valgt: det må ikke bli valgt
Incompatible parameter (even as module) alternativet kan være innebygd, en modul eller ikke valgt: det må ikke bli valgt

Merk at vinkelparentesene, avhengig av andre valg, (<>) i konfigurasjonsmenyen kan vises som klammeparenteser ({}) hvis alternativet ikke kan velges bort, eller til og med som bindestreker (-*- or -M-), når valget pålegges. Hjelpeteksten som beskriver alternativet spesifiserer de andre valgene som dette alternativet er avhengig av, og hvordan disse andre valgene er angitt.

Bokstaven i blå er hurtigtasten for dette alternativet. Hvis du kjører make menuconfig, kan du trykke på en tast for å raskt bla gjennom alle alternativene med denne tasten som hurtigtast på skjermen.