vii. Tipografia

Para tornar as coisas mais fáceis de serem seguidas, existem umas poucas convenções tipográficas usadas ao longo deste livro. Esta seção contém alguns exemplos do formato tipográfico encontrado ao longo do Linux From Scratch.

./configure --prefix=/usr

Essa forma de texto é projetada para ser digitada exatamente como vista, a menos que seja dito o contrário no texto que a envolve. Também é usada nas seções de explicação para identificar quais dos comandos estão sendo referenciados.

Em alguns casos, uma linha lógica é estendida em duas ou mais linhas físicas com uma barra invertida no final da linha.

CC="gcc -B/usr/bin/" ../binutils-2.18/configure \
  --prefix=/tools --disable-nls --disable-werror

Observe que a barra invertida precisa ser seguida por uma quebra de linha imediata. Outros caracteres de espaço em branco, como caracteres de espaços ou de tabulação criarão resultados incorretos.

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

Essa forma de texto (de largura fixa) mostra a saída gerada em tela, geralmente como o resultado de comandos emitidos. Esse formato também é usado para mostrar nomes de arquivos, tais como /etc/ld.so.conf.

Ênfase

Essa forma de texto é usada para vários propósitos no livro. O propósito principal dela é o de enfatizar pontos ou itens importantes.

https://www.linuxfromscratch.org/

Esse formato é usado para hiperlinks tanto dentro da comunidade do LFS, quanto para páginas externas. Inclui HOWTOs, locais de download e páginas da Internet.

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

Esse formato é usado quando da criação de arquivos de configuração. O primeiro comando diz ao sistema para criar o arquivo $LFS/etc/group a partir do que seja digitado nas linhas seguintes até que a sequência “End Of File” (EOF) seja encontrada. Portanto, essa seção inteira geralmente é digitada como é vista.

<TEXTO SUBSTITUÍDO>

Esse formato é usado para encapsular texto que não é para ser digitado como visto ou para operações de “copiar-e-colar”.

[TEXTO OPCIONAL]

Esse formato é usado para encapsular texto que é opcional.

passwd(5)

Esse formato é usado para referir-se a uma página de manual ("man") específica. O número dentro dos parênteses indica uma seção específica dentro dos manuais. Por exemplo, o "passwd" tem duas páginas de manual. Conforme as instruções de instalação do LFS, essas duas páginas de manual estarão localizadas em "/usr/share/man/man1/passwd.1" e "/usr/share/man/man5/passwd.5". Quando o livro usa "passwd(5)" ele está se referindo especificamente a "/usr/share/man/man5/passwd.5". "man passwd" imprimirá a primeira página de manual que achar que corresponde a “passwd”, a qual será "/usr/share/man/man1/passwd.1". Para esse exemplo, você precisará executar "man 5 passwd" para a finalidade de ler a página sendo especificada. Observe que a maioria das páginas de manual não tem nomes duplicados de páginas em diferentes seções. Portanto, "man <nome do aplicativo>" geralmente é suficiente. No livro LFS essas referências para páginas de manual também são hiperlinks, de forma que clicar-se em tal referência abrirá a página de manual renderizada em "HTML" a partir das páginas de manual do Arch Linux.