-
Notifications
You must be signed in to change notification settings - Fork 2
/
texinfo-ed.7.1-pt_BR.texi
23810 lines (18895 loc) · 885 KB
/
texinfo-ed.7.1-pt_BR.texi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
\input texinfo.tex @c -*-texinfo-*-
@setfilename texinfo-ed.6.1-pt_BR.info
@documentlanguage pt_BR
@documentencoding UTF-8
@c Automake automaticamente atualiza version-pt_BR.texi @set VERSION e
@c @set UPDATED com os valores apropriados.
@include version-pt_BR.texi
@settitle GNU Texinfo @value{VERSION}
@afourpaper
@c Define um novo índice para opções de linha de comando.
@defcodeindex op
@c Coloca tudo, exceto nomes (comando, nesse caso) de função em um
@c índice (arbitrariamente escolhido para ser o índice de conceito).
@syncodeindex op cp
@syncodeindex vr cp
@syncodeindex pg cp
@c final
@c sinaliza para indexar nomes de comandos sem texto extra na entrada
@ifinfo
@set commandlookup
@end ifinfo
@ifhtml
@set commandlookup
@end ifhtml
@microtype on
@copying
Este manual é para GNU Texinfo (versão @value{VERSION}, @value{UPDATED}), um
sistema de documentação que consegue produzir informações online e um manual
impresso a partir de um fonte usando marcação semântica.
Copyright @copyright{} 2016-2024 da ``versão modificada'' traduzida para o
idioma português escrito e falado no Brasil: Jamenson Ferreira Espindula de
Almeida Melo <@email{jafesp@@gmail.com}>.
Copyright @copyright{} 1988-2023 da versão original escrita em inglês: Free
Software Foundation, Inc.
@quotation
É concedida permissão para copiar, distribuir e (ou) mudar este documento sob
os termos da Licença GNU de Documentação Livre, versão 1.3 ou qualquer versão
posterior publicada pela Free Software Foundation; sem Seções Invariantes, com
os Textos de Capa Frontal sendo ``Um Manual GNU'', e com os Textos de Quarta
Capa como em (a) abaixo. Uma cópia da licença está incluída na seção
intitulada ``Licença GNU de Documentação Livre''.
@end quotation
@end copying
@dircategory Sistema Texinfo de documentação
@direntry
* Texinfo: (texinfo). O formato de documentação GNU.
* install-info: (texinfo)Invocando install-info. Atualizar entradas info/dir.
* texi2any: (texinfo)Invocando texi2any. Traduzir fonte do Texinfo.
* makeinfo: (texinfo)Invocando makeinfo. Traduzir fonte do Texinfo.
* pod2texi: (pod2texi)Invocando pod2texi. Traduzir POD Perl para Texinfo.
* texi2dvi: (texinfo)Formatar com texi2dvi. Imprimir documentos Texinfo.
* texi2pdf: (texinfo)Saída PDF. Saída PDF para Texinfo.
* pdftexi2dvi: (texinfo)Saída PDF. Saída PDF para Texinfo.
* texindex: (texinfo)Formatar com tex/texindex. Ordena arquivos de índice Texinfo.
@end direntry
@set txiindexatsignignore
@set txiindexbackslashignore
@set txiindexlessthanignore
@set txiindexhyphenignore
@titlepage
@title Texinfo
@subtitle O Formato da Documentação GNU
@subtitle para Texinfo versão @value{VERSION}, @value{UPDATED}
@author Robert James Chassell
@author Richard Matthew Stallman
@page
@vskip 0pt plus 1filll
@insertcopying
@sp 1
Publicado pela Free Software Foundation @*
51 Franklin St, Fifth Floor @*
Boston, MA 02110-1301 @*
USA @*
ISBN 1-882114-67-1 @c para a versão 4.0, Setembro de 1999.
@c ISBN 1-882114-65-5 é para a versão 3.12, Março de 1998.
@c ISBN 1-882114-64-7 é para a edição 2.24 de Novembro de 1996.
@c ISBN 1-882114-63-9 é para a edição 2.20 de 28 de fevereiro de 1995.
@ignore
@sp 1
Arte da capa por Etienne Suvasa.
@end ignore
@end titlepage
@summarycontents
@contents
@node Top
@top Texinfo
Este manual é para GNU Texinfo (versão @value{VERSION}, @value{UPDATED}), um
sistema de documentação que pode produzir ambos informação online e um manual
impresso a partir de um fonte único usando marcação semântica.
@ifinfo
A primeira parte deste menu mestre lista os nós principais neste documento do
Info, incluindo o comando @@ e índices de conceito. O restante do menu lista
todos os nós de baixo nível no documento.
@end ifinfo
@node Condições de Cópia
@nodedescription Teus direitos.
@unnumbered Condições de Cópia do Texinfo
@cindex Condições de cópia
@cindex Condições para copiar Texinfo
@cindex Software livre
@cindex Livre, software
GNU Texinfo é @dfn{software livre}; isso significa que qualquer pessoa é livre
para usá-lo e livre para redistribuí-lo sob certas condições. Texinfo não está
em domínio público; ele está sob direitos autorais e existem restrições acerca
da distribuição dele; porém essas restrições estão projetadas para permitir
qualquer coisa que um(a) bom(a) cidadão(ã) cooperador(a) desejasse fazer. O que
não for permitido é para tentar impedir que outros(as) adicionalmente
compartilhem qualquer versão de Texinfo que eles(as) possam obter de você.
Especificamente, nós queremos ter certeza que você tem o direito de doar cópias
dos programas que se relacionem a Texinfo; que você receba código fonte ou, do
contrário, possa obtê-lo se assim o desejar; que você pode mudar esses
programas ou usar pedaços deles em novos programas livres; e que você sabe que
pode fazer essas coisas.
Para ter certeza de que qualquer pessoa tem tais direitos, nós temos que
proibir que você prive alguém mais desses direitos. Por exemplo, se você
distribuir cópias dos programas relacionados a Texinfo, você precisa dar para
os(as) receptores(as) todos os direitos que você tem. Você precisa assegurar-se
de que eles(as), também, recebam ou possam conseguir o código fonte. E você
precisa informá-los(as) dos direitos deles(as).
Além disso, para nossa própria proteção, nós devemos estar certos(as) de que
qualquer pessoa sabe que não existe garantia para os programas que se
relacionem a Texinfo. Se esses programas forem modificados por qualquer outra
pessoa e passados adiante, nós queremos que os(as) receptores(as) deles saibam
que o que eles(as) tem não é o que nós distribuímos, de forma que quaisquer
problemas introduzidos por outros(as) não refletirão na nossa reputação.
As condições precisas das licenças para os programas atualmente sendo
distribuídos que se relacionem com Texinfo são encontradas nas Licenças Gerais
Públicas que os acompanham. Este manual está coberto pela Licença GNU de
Documentação Livre (@pxref{Licença GNU de Documentação Livre}).
@node Visão Geral
@chapter Visão Geral do Texinfo @c Capítulo 1
@cindex Visão Geral do Texinfo
@cindex Texinfo visão geral
@cindex Usando Texinfo em geral
@cindex Texinfo, introdução a
@cindex Introdução a Texinfo
@anchor{Usando Texinfo} @c nó mesclado
@dfn{Texinfo} é um sistema de documentação que usa um arquivo fonte único para
produzir informações online e saída impressa. Isso significa que, em vez de
escrever vários documentos, um para cada formato de saída, você precisa
escrever somente um documento.
Usando Texinfo, você consegue criar um documento impresso (via sistema
tipográfico @TeX{}) em formato PDF, incluindo capítulos, seções,
referências cruzadas e índices. A partir do mesmo arquivo fonte do Texinfo,
você consegue criar saída HTML adequada para uso com um navegador
web; você consegue criar um arquivo do Info para uso no GNU Emacs ou outros
programas de leitura do Info; e também criar arquivos Docbook, EPUB 3 ou
@LaTeX{}.
@cindex Formato do arquivo fonte
@cindex Marcação semântica
Um arquivo fonte do Texinfo é um arquivo de texto simples contendo texto
intercalado com @dfn{comandos @@} (palavras precedidas por um @samp{@@}) que
informam aos processadores Texinfo o que fazer. Os comandos de marcação do
Texinfo são quase inteiramente @dfn{semânticos}; isto é, eles especificam o
significado pretendido do texto no documento, em vez de instruções de
formatação física.
O GNU Emacs tem um modo especial, chamado modo Texinfo, que fornece vários
recursos relacionados ao Texinfo. (@xref{Modo Texinfo}.)
@cindex Escopo limitado do Texinfo
Texinfo foi concebido especificamente para o propósito de escrever documentação
de software e manuais. Se você quer escrever um bom manual para teu programa,
Texinfo tem muitos recursos que nós esperamos que tornarão teu trabalho mais
fácil. No entanto, Texinfo não é destinado para ser um programa de formatação
de propósito geral. Ele quase não fornece comandos para controlar a formatação
final, de forma que pode ser inapropriado para tuas necessidades se você quiser
esquematizar um jornal, conceber um anúncio brilhante de revista ou seguir as
exigências exatas de formatação de uma editora.
@cindex Escrita de Texinfo
@cindex Pronúncia de Texinfo
Escreva-se ``Texinfo'' com um ``T'' maiúsculo e as outras letras em minúsculas.
A primeira silaba de ``Texinfo'' é pronunciada como ``speck'', e não ``hex''.
Essa pronúncia estranha é derivada da pronúncia de @TeX{}. Pronuncie-se @TeX{}
como se o @samp{X} fosse o último som no nome `Bach'. Na palavra @TeX{}, o
@samp{X} é, em vez da letra do Inglês ``ex'', na verdade a letra Grega ``chi''.
Texinfo é o formato oficial de documentação do projeto GNU. Mais informações,
incluindo manuais para pacotes GNU, estão disponíveis na
@uref{http://www.gnu.org/doc/, página web da documentação GNU}.
@node Informando Defeitos
@nodedescription Submetendo informes eficazes de defeitos.
@section Informando Defeitos
@cindex Defeitos, informando
@cindex Sugestões para Texinfo, fazendo
@cindex Informando Defeitos
Nós apreciamos informes de defeitos e de sugestões para qualquer aspecto do
sistema Texinfo: programas, documentação, instalação, etc. Por favor, envie-os
para @email{bug-texinfo@@gnu.org}. Você consegue obter a versão mais recente do
Texinfo por meio da página inicial dele,
@uref{http://www.gnu.org/software/texinfo}.
@cindex Lista de verificação para informes de defeitos
Para informes de defeitos, por favor, inclua informações suficientes para
os(as) mantenedores(as) reproduzirem o problema. Falando genericamente, isso
significa:
@itemize @bullet
@item O número da versão do Texinfo e o(s) programa(s) ou manual(is) envolvido(s).
@item O conteúdo de quaisquer arquivos de entrada necessários para reproduzir o defeito.
@item Precisamente como você executou quaisquer programa(s) envolvido(s).
@item Uma descrição do problema e amostras de quaisquer saídas errôneas.
@item Nomes e versões do hardware e do sistema operacional.
@item Qualquer outra coisa que você pense que pudesse ajudar.
@end itemize
Quando em dúvida se alguma coisa é necessária ou não, inclua-a. É melhor
incluir muito mais que deixar de fora algo importante.
É crítico enviar um arquivo de entrada atual que reproduza o problema.
Quaisquer problemas com o leitor do Info no Emacs deveriam ser informados para
os(as) desenvolvedores(as) do Emacs:
veja-se @ref{Bugs,,, emacs, O Manual do GNU Emacs}.
@cindex Remendos, contribuindo
Remendos são bem-vindos; se possível, por favor, faça-os com @samp{@w{diff
-c}}, @samp{@w{diff -u}}
(@pxref{,,, diffutils, Comparando e Mesclando Arquivos}), ou @samp{git diff} e
inclua entradas de @file{ChangeLog}
(@pxref{Change Log,,, standards, Padrões GNU de Codificação}), e siga o estilo
existente de codificação.
@node Formatos de Saída
@nodedescription Visão geral dos formatos suportados de saída.
@section Formatos de Saída
@cindex Formatos de saída
@cindex Estrutura de retaguarda, formatos de saída
Aqui está uma visão geral dos formatos de saída atualmente suportados por
Texinfo.
@table @asis
@cindex Saída do Info, visão geral
@item Info
(Gerado via @command{texi2any}.). O formato Info é em sua maior parte
transliteração de texto plano do fonte Texinfo. Ele adiciona uns
poucos caracteres de controle para prover informação de navegação para
referências cruzadas, índices, e assim por diante. O subsistema Emacs
Info (veja-se @ref{Top,,, info, Info}), e o programa autônomo @command{info}
(@pxref{Top,,, info-stnd, GNU Info}), entre outros, podem ler esses
arquivos. Veja-se @ref{Arquivos do Info}, e
@ref{Criando e Instalando Arquivos Info}.
@cindex Saída gerada de texto simples, visão geral
@item Texto simples
(Gerado via @command{texi2any --plaintext}.). Essa é quase a mesma que
a saída Info com os caracteres de controle de navegação omitidos.
@cindex Saída gerada de HTML, visão geral
@item HTML
@c @cindex Mozilla
@c @cindex Lynx
@c @cindex Emacs-W3
(Gerado via @command{texi2any --html}.). HTML, que significa Hyper Text Markup
Language, é a linguagem para escrever documentos na World Wide Web. Os
navegadores da Web conseguem renderizar essa linguagem online. Existem muitas
versões de HTML, tanto diferentes usos mais comuns quanto variações específicas
de navegador. @command{texi2any} usa um subconjunto da linguagem que consegue
ser interpretado por qualquer navegador comum, intencionalmente não usando
muitas etiquetas mais novas ou menos amplamente suportadas. Embora a saída
nativa seja, portanto, bastante simples, ela pode ser personalizada em vários
níveis, se desejado. @xref{Gerando HTML}.
@cindex Saída EPUB 3, visão geral
@item EPUB 3
(Gerada via @command{texi2any --epub3}.). EPUB é um formato projetado para
leitura de livros eletrônicos em dispositivos portáteis. É um derivado do
HTML@. O formato foi desenvolvido pelo International Digital Publishing Forum
(IDPF), que agora faz parte do World Wide Web Consortium (W3C)@. A mais recente
grande revisão, EPUB 3, data de 2011.
@cindex Saída DVI, visão geral
@pindex dvips @r{(programa)}
@pindex xdvi
@item DVI
(Gerada via @command{texi2dvi}.). O formato binário ``DeVIce Independent''
é liberado pelo programa tipográfico @TeX{} (@uref{http://tug.org}).
Essa é então lida por um `controlador' DVI, o qual conhece os comandos
específicos de dispositivo atuais que podem ser visualizados ou
impressos, notadamente Dvips para tradução para PostScript
(veja-se @ref{Top,,, dvips, Dvips}) e Xdvi para visualização em uma tela X
(@uref{http://sourceforge.net/projects/xdvi/}). Veja-se @ref{Impresso com @TeX{}}.
(Esteja avisado(a) de que a linguagem do Texinfo é muito diferente das
linguagens usuais de @TeX{}: @TeX{} simples, @LaTeX{}, Con@TeX{}t, etc.).
@cindex Saída gerada PostScript, visão geral
@item PostScript
(Gerada via @command{texi2dvi --ps}.). PostScript é uma linguagem de
descrição de página que se tornou amplamente usada por volta de 1985
e ainda é usada hoje em dia.
@uref{https://en.wikipedia.org/wiki/PostScript} dá uma descrição básica e
mais preferências. Por padrão, Texinfo usa o programa
@command{dvips} para converter a saída DVI de @TeX{} para PostScript.
Veja-se @ref{Top,,, dvips, Dvips}.
@cindex Saída gerada PDF, visão geral
@cindex Beebe, Nelson
@item PDF
(Gerada via @command{texi2dvi --pdf} ou @command{texi2pdf}). Esse
formato foi desenvolvido por Adobe Systems para troca de documento
portável, baseado na linguagem PostScript prévia deles. O formato pode
representar a exata aparência de um documento, incluindo fontes e
gráficos, e suportar escalonamento arbitrário. Ele é entendido como
sendo independente de plataforma e facilmente visualizável, entre outros
objetivos de design;
@uref{https://en.wikipedia.org/wiki/Portable_Document_Format} e
@uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} tem algum
conhecimento. Por padrão, Texinfo usa o programa @command{pdftex},
uma extensão de @TeX{}, para liberar PDF; veja-se
@uref{http://tug.org/applications/pdftex}. Veja-se @ref{Saída PDF}.
@cindex Saída LaTeX, visão geral
@item @LaTeX{}
(Gerada via @command{texi2any --latex}.). Esse é um sistema de tipografia
construído sobre o @TeX{}. Foi lançado originalmente por Leslie Lamport em
1984. O @LaTeX{} adiciona mais definições para aquelas do @TeX{} e tem uma
ampla gama de pacotes construídos sobre ele. O @LaTeX{} é onipresente na
literatura acadêmica. A versão atual do @LaTeX{} está sob desenvolvimento
ativo; mais informações estão disponíveis online em
@uref{https://www.latex-project.org/}.
A saída do @LaTeX{} pode ser processada posteriormente em DVI, PostScript ou
PDF@. Em teoria, a saída do @LaTeX{} deveria permitir muito mais personalização
da saída do que seria possível com a implementação @TeX{} simples do Texinfo.
@cindex Saída Docbook, visão geral
@cindex Saída XML Docbook, visão geral
@item Docbook
(Gerada via @command{texi2any --docbook}.). Esse é um formato baseado em XML
desenvolvido, primariamente para documentação técnica. Ele por conseguinte
assume alguma semelhança, em linhas gerais, com Texinfo. Veja-se
@uref{http://www.docbook.org}. Vários conversores de Docbook @emph{para}
Texinfo também foram desenvolvidos; veja-se as páginas web Texinfo.
@cindex Saída XML Texinfo, visão geral
@cindex Saída Texinfo XML, visão geral
@cindex DTD, para Texinfo XML
@pindex texinfo.dtd
@pindex txixml2texi
@item XML
(Gerada via @command{texi2any --xml}.). A saída XML do @command{texi2any},
diferente de todos os outros formatos de saída, é uma transliteração do fonte
do Texinfo, em vez de uma saída finalizada. Os arquivos XML do Texinfo não
podem ser visualizados em navegadores da web ou outros programas.
XML é uma especificação de sintaxe genérica usável para qualquer tipo de
conteúdo. (Uma referência está em @uref{http://www.w3.org/XML}.). O propósito
da saída XML do Texinfo é o de permitir processamento posterior por ferramentas
XML. A sintaxe de saída é definida em um DTD de XML, que está contido em um
arquivo @file{texinfo.dtd} incluído na distribuição do fonte do Texinfo.
A distribuição do fonte do Texinfo inclui um script utilitário
@file{txixml2texi} para fazer uma transformação reversa para recriar o conteúdo
Texinfo original (exceto para macros e condicionais do Texinfo).
@end table
@node Arquivos do Info
@nodedescription O que é um arquivo do Info?
@section Arquivos do Info
@cindex Arquivos Info
Conforme mencionado acima, o formato Info é em sua maioria uma
transliteração de texto plano do fonte Texinfo, com a adição de uns
poucos caracteres de controle para separar nós e prover informação de
navegação, de forma que os programas de leitura Info possam operar sobre
ele.
Os arquivos Info são quase sempre criados pelo processamento de um
documento fonte Texinfo. O comando @command{texi2any}, também
conhecido como @command{makeinfo}, é o comando principal que converte um
arquivo Texinfo em um arquivo Info; veja-se
@ref{Tradutor Genérico @command{texi2any}}.
Geralmente, você adentra um arquivo Info via um nó que, por convenção,
é chamado `Top'. Esse nó normalmente contém somente um sumário curto
do propósito do arquivo, e um menu amplo por meio do qual o restante do
arquivo é alcançado. A partir desse nó, você ou pode atravessar o
arquivo sistematicamente, indo de nó a nó; ou você pode ir até um
nó específico listado no menu principal, ou você pode pesquisar no
menu de índice e então ir diretamente ao nó que tenha a informação que
você deseja. Alternativamente, com programa autônomo Info, você pode
especificar itens de menu na linha de comando
(veja-se @ref{Top,,, info, Info}).
Se você desejar ler ao longo de um arquivo Info em sequência, como se
ele fosse um manual impresso, você pode teclar @key{ESPAÇO} repetidamente,
ou você percorre o arquivo inteiro com o comando Info avançado @kbd{g *}.
(Veja-se @ref{Advanced,, Advanced Info commands, info, Info}).
O arquivo @file{dir} no diretório @file{info} serve como o ponto de
chegada para o sistema Info inteiro. A partir dele, você pode alcançar
os nós `Top' de cada um dos documentos em um sistema Info completo.
@cindex Sintaxe URI para Info
Se você desejar se referir a um arquivo Info via URI, você pode usar
a sintaxe (não oficial) exemplificada pelo seguinte. Isto funciona com
Emacs/W3, por exemplo:
@example
info:emacs#Dissociated%20Press
info:///usr/info/emacs#Dissociated%20Press
info://localhost/usr/info/emacs#Dissociated%20Press
@end example
O próprio programa @command{info} não segue URIs de qualquer tipo.
@node Livros Impressos
@nodedescription Características de um livro ou manual impresso.
@section Livros Impressos
@cindex Manual e livro impresso, características
@cindex Características de manual, impresso
@cindex Características de livro, impresso
@cindex Características de livro impresso Texinfo
@cindex Características, manuais e livros impressos
@cindex Knuth, Donald
Um arquivo Texinfo pode ser formatado e composto como um livro impresso
ou um manual. Para fazer isso, você precisa de @TeX{}, um sofisticado
programa de tipografia escrito por Donald Knuth da Universidade Stanford.
O Texinfo fornece um arquivo @file{texinfo.tex} que contém as definições que o
@TeX{} usa quando tipografa um arquivo do Texinfo. Você pode obter a versão
mais recente do @file{texinfo.tex} a partir da página inicial do Texinfo,
@uref{http://www.gnu.org/software/texinfo/}.
Um livro baseado em Texinfo é similar a qualquer outro composto,
trabalho impresso: ele pode ter uma página de título, página de direitos
autorais, sumário, e prefácio, bem como capítulos, seções e subseções
numeradas ou não numeradas, cabeçalhos de páginas, referências cruzadas,
notas de rodapé, e índices.
@TeX{} é muito poderoso e tem muitos recursos ótimos. No entanto, como um
arquivo do Texinfo precisa ser capaz de apresentar informações tanto em um
terminal somente de caracteres no formato do Info quanto em um livro
tipografado, os comandos de formatação que o Texinfo suporta são
necessariamente limitados.
@xref{Impresso com @TeX{}}, para mais informações sobre o processamento de um
manual com @TeX{}.
@node Adicionando Formatos de Saída
@nodedescription Páginas de manual e implementando novos formatos.
@section Adicionando Formatos de Saída
@cindex Formatos de saída adicionais
Os formatos de saída nas seções anteriores lidam com uma variedade ampla
de usos, porém, certamente, sempre existe espaço para mais.
@cindex Formatos de saída, suportando mais
@cindex Ferramentas SGML, formatos de saída
Se você for um programador e gostaria de contribuir para com o projeto
GNU implementando formatos de saída adicionais para Texinfo, isso seria
excelente. A maneira de fazer isso que seria mais útil é escrever uma
infraestrutura nova para @command{texi2any}, nossa implementação de
referência de um analisador Texinfo; ela cria uma representação de
árvore da entrada de Texinfo que você pode usar para a conversão.
A documentação no arquivo fonte
@file{tp/Texinfo/Convert/Converter.pm} é um bom lugar para começar
(@pxref{Texinfo::Convert::Converter,,,texi2any_internals,documentação dos módulos do Texinfo}).
@ref{Tradutor Genérico @command{texi2any}}.
Outra abordagem viável é usar a saída XML de Texinfo oriunda de
@command{texi2any} como sua entrada. Esse XML é uma representação
essencialmente completa da entrada, porém sem a sintaxe de Texinfo
e as peculiaridades de opção, conforme descrito acima.
@cindex Analisadores Texinfo, desencorajando mais
Se você ainda não conseguir resistir à tentação de escrever um programa
novo que leia o fonte Texinfo diretamente, permita-nos te dar mais
algumas advertências: por favor não subestime a quantidade de trabalho
exigida. Texinfo não é de forma alguma uma linguagem simples de se
analisar corretamente, e permanece sob desenvolvimento, de maneira que
você estaria se comprometendo com uma tarefa em andamento. Você está
aconselhado a verificar se os testes da linguagem que vem com
@command{texi2any} dão resultados corretos com o seu programa novo.
@cindex Saída de página de manual, não suportada
De tempos em tempos, propostas são feitas para gerar páginas de manual
Unix tradicionais a partir do fonte Texinfo. Entretanto, pelo motivo
de que as páginas de manual tem um formato convencional estrito, criar
uma página de manual boa exige um fonte completamente diferente daquele
necessário para as aplicações Texinfo típicas de escrita de um tutorial
de usuário bom e/ou um bom manual de referência. Isso torna a geração
de páginas de manual incompatível com o objetivo do desenho de Texinfo
de não ter de documentar a mesma informação em maneiras diferentes para
diferentes formatos de saída. Você poderia também escrever a página de
manual diretamente.
@pindex help2man
@cindex O'Dea, Brendan
Como um meio alternativo para suportar páginas de manual, você pode
achar que o programa @command{help2man} seja útil. Ele gera uma página
de manual tradicional a partir da saída @samp{--help} de um programa.
De fato, as páginas de manual para os programas na distribuição Texinfo
são geradas com isso.
Ele é software GNU escrito por Brendan O'Dea, disponível a partir de
@uref{http://www.gnu.org/software/help2man}.
@node Histórico
@nodedescription Agradecimentos, colaboradores(as) e gênese.
@section Histórico
@cindex Stallman, Richard M.
@cindex Chassell, Robert J.
@cindex Fox, Brian
@cindex Berry, Karl
@cindex Smith, Gavin
Richard M. Stallman inventou o formato Texinfo, escreveu os processadores
iniciais e criou a Edição 1.0 deste manual. Robert@tie{}J. Chassell revisou e
estendeu muito o manual, começando com a Edição 1.1. Brian Fox foi responsável
pela distribuição autônoma do Texinfo até a versão 3.8. Karl Berry continuou a
manutenção a partir do Texinfo 3.8 (edição do manual 2.22), e Gavin Smith
continuou a manutenção desde o Texinfo 6.0.
@cindex Histórico do Texinfo
@cindex Texinfo, estória
@subheading Começo
@cindex NLS
Richard Stallman incluiu um sistema de ajuda de hipertexto on-line chamado Info
na implementação original do Emacs (em 1975/6). Stallman foi inspirado depois
de ver uma apresentação alguns anos antes acerca do sistema de hipertexto
``NLS'' de Douglas Engelbart.
@ignore
From rms@santafe.edu Sat Jan 23 03:41:05 1999
Status: RO
X-VM-v5-Data: ([nil nil nil nil nil nil nil nil nil]
[nil nil nil nil nil nil nil nil nil nil nil nil "^Date:" nil nil nil ni
+l nil nil nil nil]
nil)
Reply-to: rms@gnu.org
Content-Length: 331
Date: Sat, 23 Jan 1999 01:40:59 -0700 (MST)
From: Richard Stallman <rms@gnu.org>
To: bob@rattlesnake.com
CC: karl@cs.umb.edu, kama@hippo.fido.de, bug-texinfo@gnu.org
Subject: Re: Q: Algumas questões de história
Pessoas no MIT também desenvolveram um formato bacana de ajuda on-line chamado Info.
Esse fui eu. Eu desenvolvi o Info como uma espécie de "hipertexto do homem
pobre" depois que vi uma apresentação acerca do NLS (sistema de hipertexto de
Englebart). EU PENSO que isso foi em 1974, na verdade antes do Emacs, e que
depois de desenvolver o Emacs em 1975 eu adaptei o Info para trabalhar com ele.
@end ignore
@cindex Scribe
@cindex Reid, Brian
Em outro desenvolvimento, na década de 1970 na CMU, Brian Reid desenvolveu um
programa e formato chamado Scribe para marcar documentos para impressão. Ele
usava o caractere @code{@@} para introduzir comandos, como o Texinfo faz. Muito
mais consequentemente, ele se esforçou para descrever o conteúdo do documento
em vez da formatação, uma ideia adotada de todo o coração pelo Texinfo.
@cindex Bolio
@cindex Bo@TeX{}
Enquanto isso, pessoas no MIT desenvolveram outro formato chamado Bolio.
Richard Stallman (RMS) trabalhou na conversão do Bolio para usar @TeX{} como a
linguagem dele de tipografia, resultando no Bo@TeX{}. A versão mais antiga do
Bo@TeX{} parece ter sido 0.02 em 31 de outubro de 1984.
O Bo@TeX{} só podia ser usado como uma linguagem de marcação para documentos a
serem impressos, não para documentos online. RMS combinou o Bo@TeX{} e o Info
para criar o Texinfo, uma linguagem de marcação para texto que se destina a ser
lido online e como cópia impressa.
O tradutor original para criar o Info foi escrito (principalmente por RMS e Bob
Chassell) em Emacs Lisp, ou seja, o @code{texinfo-format-buffer} e outras
funções. No início da década de 1990, Brian Fox reimplementou o programa de
conversão em C, agora chamado @command{makeinfo}, bem como o programa autônomo
@command{info}.
@subheading Reimplementando in Perl
@cindex Cons, Lionel
@cindex Dumas, Patrice
Em 2012, o @command{makeinfo} do C foi substituído por uma implementação Perl
genericamente chamada @command{texi2any}. Essa versão suporta o mesmo nível de
personalização de saída que @command{texi2html}, um programa independente
escrito originalmente por Lionel Cons, mais tarde com trabalho substancial de
muitos(as) outros(as). Os muitos recursos adicionais necessários para tornar
@command{texi2html} um substituto para @command{makeinfo} foram implementados
por Patrice Dumas. A primeira versão, nunca lançada, do @command{texi2any} foi
baseada no código do @command{texi2html}.
@cindex Representação em árvore de documentos
@cindex Representação de árvore de sintaxe de documentos
@cindex Representação abstrata de documentos em árvore de sintaxe
Essa implementação, no entanto, foi abandonada em favor do programa atual
(também escrito por Patrice Dumas), que analisa a entrada do Texinfo em uma
árvore para processamento. Ele herdou o projeto de personalização e outros
recursos do @command{texi2html} (para mais informações acerca da
compatibilidade do @command{texi2html}, @pxref{@command{texi2html}}). No
entanto, o @command{texi2any} é uma reimplementação completa: ele constrói uma
representação baseada em árvore do documento de entrada para todas as
estruturas de retaguarda trabalharem.
O novo programa Perl é muito mais lento que o antigo programa C. A lacuna de
velocidade foi parcialmente fechada desde o primeiro lançamento, mas pode nunca
ser totalmente comparável. Então, por que nós comutamos? Em resumo, nós
pretendemos e esperamos que o programa atual seja muito mais fácil que a
implementação C anterior do @command{makeinfo} para estender a diferentes
estilos de saída, formatos de saída de estrutura de retaguarda e todas as
outras personalizações. Em mais detalhes:
@itemize @bullet
@item Personalização de HTML. Muitos GNU e outros pacotes de software
livre tem sido felizes no uso das características de
personalização de HTML em @command{texi2html} por anos. Assim, na
verdade, duas implementações independentes da linguagem Texinfo foram
desenvolvidas, e mantê-las em sincronia não foi simples. Adicionar a
possibilidade de personalização de HTML em @command{texi2html} a um
programa C tem sido um esforço enorme.
@item Unicode e suporte multilíngue em geral, especialmente de idiomas do leste
asiático. Naquela época, fazer isso em C teria sido equivalente a reescrever o
programa inteiro. Desde então, o analisador e os bits das estruturas de
retaguarda do conversor foram reescritos em C, mas as estruturas de retaguarda
do conversor ainda estão principalmente em Perl, que tem um bom suporte
multilíngue integrado.
@item Estruturas adicionais de retaguarda. O código do @command{makeinfo}
tornou-se tão complicado a ponto de adicionar uma nova estrutura de retaguarda
ser bastante complexo, exigindo interações complexas com estruturas de
retaguarda existentes. Em contraste, a nova implementação fornece uma
representação limpa baseada em árvore para todas as estruturas de retaguarda
trabalharem. As pessoas solicitaram numerosas estruturas de retaguarda
(@LaTeX{}, o mais recente (X)HTML, @dots{}); essa mudança os tornou muito mais
viáveis de implementar. O que nos leva ao último item:
@item Facilitando as contribuições. Em geral, devido à estrutura mais limpa, a
implementação separada do analisador/estruturas de retaguarda deveria ser
consideravelmente mais fácil que a implementação anterior do @command{makeinfo}
do C para qualquer um(a) ler e contribuir, com os benefícios óbvios
resultantes. Depois de dez anos, as estruturas de retaguarda contribuídas ainda
estavam para acontecer, mas ainda se acredita que essa estrutura poderia, em
teoria, se prestar melhor às contribuições.
@end itemize
@cindex @command{texi2any}, como implementação de referência
@cindex Implementação de referência
@cindex Implementação, @command{texi2any} como referência
@cindex Testes de linguagem do Texinfo
@cindex Testes, da linguagem do Texinfo
@anchor{Implementação de referência}@c
@command{texi2any} é destinado a ser uma implementação de referência que define
partes da linguagem não totalmente especificadas pelo manual. Sem tal
referência, implementações alternativas muito provavelmente teriam diferenças
sutis, ou não tão sutis, no comportamento, e assim os documentos do Texinfo se
tornariam dependentes do processador. Também é importante ter opções de linha
de comando consistentes para todos os processadores. Testes extensivos da
linguagem e do processador foram desenvolvidos ao mesmo tempo que
@command{texi2any}; nós encorajamos qualquer um(a) que esteja pensando em
escrever um programa para analisar a entrada do Texinfo a fazer uso desses
testes.
@cindex Futuro das implementações do Texinfo
Com o lançamento do @command{texi2any} como implementação de referência, o
desenvolvimento tanto da implementação C do @command{makeinfo} quanto do
@command{texi2html} foi interrompido. Daqui para frente, nós pedimos para
os(as) autores(as) de documentos do Texinfo que usem somente o
@command{texi2any}.
@node Escrevendo um Arquivo do Texinfo
@anchor{Iniciando e Terminando um Arquivo}@c nome antigo
@nodedescription Formato de um arquivo fonte do Texinfo.
@chapter Escrevendo um Arquivo do.Texinfo @c Capítulo 2
Este capítulo descreve a sintaxe Texinfo e o que é exigido em um arquivo
Texinfo, e dá um arquivo curto de amostra.
@node Convenções
@nodedescription Regras gerais para escrever um arquivo do Texinfo.
@section Convenções Sintáticas Gerais
@cindex Convenções sintáticas gerais
@cindex Sintáticas, convenções
@cindex Convenções, sintáticas
@cindex Caracteres, entrada básica
@anchor{Comandos de Formatação} @c nome antigo
Esta seção descreve as convenções gerais usadas em todos os
documentos Texinfo.
@itemize @bullet
@item
@cindex Arquivos fonte, caracteres usados
Todos os caracteres ASCII imprimíveis, exceto @samp{@@}, @samp{@{} e
@samp{@}}, podem aparecer em um arquivo Texinfo e representam eles
mesmos.
@samp{@@} é o caractere de encapsulamento que introduz comandos, enquanto
@samp{@{} e @samp{@}} são usados para envolver argumentos a certos
comandos. Para colocar um desses caracteres especiais no documento,
coloque um caractere @samp{@@} em frente a ele, como isto: @samp{@@@@},
@samp{@@@{}, e @samp{@@@}}.
@item
@cindex @sortas{at} Comandos @@
@cindex Formatando, comandos
Em um arquivo do Texinfo, os comandos que você escreve para descrever o
conteúdo do manual são precedidos por um caractere @samp{@@}; eles são
chamados @dfn{comandos @@}. (O @samp{@@} no Texinfo tem o mesmo
significado que @samp{\} tem no @TeX{} simples).
@cindex Chaves, quando usar
Dependendo do que eles fazem ou de quais argumentos recebam, você precisa
escrever comandos @@ em linhas próprias, ou como parte de frases. Como regra
geral, um comando exige chaves se ele se misturar com outro texto; mas não
precisa de chaves se estiver em uma linha própria. Para mais detalhes da
sintaxe de comandos do Texinfo, veja-se @ref{Sintaxe do Comando}.
@item
Espaço em branco seguindo um nome de comando @@ é opcional e
(normalmente) ignorado se presente. As exceções são contextos quando o
espaço em branco é significativo, por exemplo, um ambiente de
@code{@@example}.
@item
Texinfo suporta as marcações normais de encapsulamento usados em
Inglês e em outras linguagens; veja-se @ref{Inserindo Aspas}.
@item
@cindex Vários traços no fonte
@cindex Traços no fonte
@cindex Hifens no fonte, dois ou três em uma linha
@cindex Travessão, produzindo
@cindex Em dash, produzir
Use três hifens em uma linha, @samp{---}, para produzir um traço
longo---como esse (chamado um @dfn{travessão}), usado para pontuação
em sentenças. Use dois hifens, @samp{--}, para produzir um traço
médio (chamado um @dfn{traço de ligação}), usado primariamente para
intervalos numéricos, como em ``Junho 25--26''. Use um hífen
simples, @samp{-}, para produzir um hífen padrão usado em palavras
compostas. Para exibir na tela, Info reduz três hifens para dois e dois
hifens para um (não transitivamente!). Certamente, qualquer número de
hifens no fonte permanece como estiverem em contextos literais,
tais como @code{@@code} e @code{@@example}.
@item
@emph{Espaço em branco}. Arquivos do Texinfo são arquivos de texto simples
compostos de linhas terminadas pelo usual caractere de nova linha (avanço de
linha). Processadores do Texinfo leem a entrada uma linha por vez. Parágrafos
são terminados por uma linha vazia ou uma linha contendo somente espaços. Uma
sequência de vários espaços no texto geralmente é tratada da mesma forma que um
espaço (exceto em modos literais).
@cindex Caractere de avanço de formulário
@cindex @kbd{CTRL-l}
Form feed (@kbd{CTRL-l}) characters in normal text end any open paragraph.
Other ASCII whitespace (tab, carriage return) may be treated the same as space
characters, although the results may differ depending on output format. Hence,
there is not much point in using these in documents. Non-ASCII spaces, such as
Unicode ``em space'', are not recognized as whitespace at all and will be
treated as regular, non-whitespace characters.
However, in verbatim modes, for example in code samples, tab characters may
produce the correct formatting in the output.
@ignore @c Excessive detail?
To avoid this problem, Texinfo mode in GNU Emacs inserts multiple spaces when
you press the @key{TAB} key. Also, you can run @code{untabify} in Emacs to
convert tabs in a region to multiple spaces, or use the @code{unexpand} command
from the shell.
@end ignore
@ignore @c too detailed for the manual, but kept for implementation tips
@item
Form feed characters outside of a paragraph are handled as follows:
Caracteres de avanço de formulário (@kbd{CTRL-l}) em texto normal encerram
qualquer parágrafo aberto. Outros espaços em branco ASCII (tabulação, retorno
de carro) podem ser tratados da mesma forma que caracteres de espaço, embora os
resultados possam diferir dependendo do formato de saída. Portanto, não existe
muito sentido em usá-los em documentos. Espaços não ASCII, como Unicode ``em
space'', não são reconhecidos como espaços em branco e serão tratados como
caracteres regulares, não espaços em branco.
No entanto, em modos literais, por exemplo, em amostras de código, caracteres
de tabulação podem produzir a formatação correta na saída.
@ignore @c Detalhes excessivos?
Para evitar esse problema, o modo Texinfo no GNU Emacs insere vários espaços
quando você pressiona a tecla @key{TAB}. Além disso, você pode executar
@code{untabify} no Emacs para converter tabulações em uma região para vários
espaços ou usar o comando @code{unexpand} a partir do shell.
@end ignore
@ignore @c muito detalhado para o manual, mas mantido para dicas de implementação
@item
Caracteres de avanço de formulário fora de um parágrafo são manuseados da
seguinte forma:
@table @asis
@item PDF/DVI
Ignorado entre parágrafos.
@item LaTeX
Ignorado em contextos onde espaços são ignorados, exceto depois de chaves de
fechamento de comandos específicos (@code{@@caption} por exemplo). Deixado como
está na saída, caso contrário.
@c Escrito como @code{\par@{@}}, uma macro do @LaTeX{} que inicia um parágrafo.
@item Info
Saída como está entre parágrafos (uso mais comum dela); ignorada em contextos
onde espaços são ignorados, exceto depois de chaves de fechamento de comandos
específicos (@code{@@caption} por exemplo). Em outros contextos, eles podem ser
tratados como espaços regulares (e, portanto, consolidados com espaços em
branco ao redor).
@item HTML
Escrito como uma entidade numérica, exceto contextos onde espaços são
ignorados; por exemplo, em @samp{@@footnote@{ ^L foo@}}, a alimentação
de formulário é ignorada.
@item XML
Mantenha-os em qualquer lugar; em atributos, encapsulados como
@samp{\f}; também, @samp{\} é encapsulado como @samp{\\} e uma nova
linha como @samp{\n}.
@item DocBook
Completamente removidos, dado que não são permitidos.
@end table
Como você pode ver, por causa dessas exigências diferentes dos formatos de
saída, não é possível se usar alimentações de formulário completamente
portáveis.
@end ignore
@end itemize
@node Comentários
@section Comentários
@cindex Comentários
@findex comment
@findex c
Você pode escrever comentários em um arquivo Texinfo usando o
comando @code{@@comment}, o qual pode ser abreviado para @code{@@c}.
Tais comentários são para uma pessoa examinando o arquivo fonte Texinfo.
Todo o texto em uma linha que se seguir ou a @code{@@comment} ou a
@code{@@c} é um comentário; o restante da linha não aparece na saída
visível. (Para ser preciso, o caractere após o @code{@@c} ou
@code{@@comment} deve necessariamente ser algo que não um traço ou
alfanumérico, ou será tomado como sendo parte do comando.)
Frequentemente, você pode escrever o @code{@@comment} ou @code{@@c} no
meio de uma linha, e somente o texto que se seguir após o comando
@code{@@comment} ou @code{@@c} não aparece; porém alguns comandos, tais
como @code{@@settitle}, funcionam sobre uma linha inteira. Você não
pode usar @code{@@comment} ou @code{@@c} dentro de uma linha que se
inicie com um tal comando.
@findex DEL @r{(caractere de comentário)}
@cindex Código de categoria para comentários no @TeX{}
Em casos de invocações de comando aninhado, definições complicadas de macro,
etc., @code{@@c} e @code{@@comment} podem provocar um erro quando do
processamento com @TeX{}. Por conseguinte, você também pode usar o caractere
@kbd{DEL} (decimal 127 ASCII, hexadecimal 0x7f, octal 0177) como um verdadeiro
caractere de comentário do @TeX{} (código de categoria 14, nos internos do
@TeX{}). Tudo na linha depois de @kbd{DEL} será ignorado e a próxima linha será
mesclada.
@cindex Texto ignorado
@cindex Texto não processado
@findex ignore
Você também pode ter trechos longos de texto ignorados pelos
processadores Texinfo com os comandos @code{@@ignore} e
@code{@@end ignore}.
Escreva cada um desses comandos em sua própria linha, iniciando cada
comando no começo da linha. O texto entre esses dois comandos não
aparece na saída processada. Você pode usar @code{@@ignore} e
@code{@@end ignore} para escrever comentários. (Para algumas
advertências relativamente ao aninhamento de tais comandos, veja-se
@ref{Aninhamento de Condicional}.)
@node Mínimo
@nodedescription O que um arquivo do Texinfo precisa ter.
@section O Que um Arquivo do Texinfo Deve Ter
@cindex Arquivo mínimo do Texinfo (exigências)
@cindex Exigido no arquivo do Texinfo
@cindex Mínimo do arquivo do Texinfo
Por convenção, o nome de um arquivo do Texinfo termina com uma das extensões
@file{.texi}, @file{.texinfo}, @file{.txi} ou @file{.tex}. Usar @file{.tex} é
desencorajado, pois essa extensão já é usada pelos arquivos de entrada do
@TeX{} e do @LaTeX{}. A extensão mais comum e recomendada é @file{.texi}. O
nome de um arquivo do Texinfo deveria conter somente caracteres ASCII.
O nome da saída gerada é baseado no nome do arquivo de entrada, no caso padrão.
Primeiro, quaisquer das extensões @file{.texi}, @file{.tex}, @file{.txi} ou
@file{.texinfo} são removidas do nome do arquivo de entrada; a seguir, a
extensão específica do formato da saída gerada é adicionada---@file{.html} ao
gerar HTML, @file{.info} ao gerar Info, etc. O nome da saída gerada deveria
conter somente caracteres ASCII@footnote{@command{texi2any} consegue manusear
caracteres não ASCII em nomes de arquivo de entrada, mas caracteres não ASCII
no nome da saída gerada criarão problemas para alguns formatos de saída,
especialmente para referências cruzadas.}.
@cindex Exigências para formatação
@cindex Exigências mínimas para formatação
@cindex Exigências de formatação
Para a finalidade de ser transformado em um manual impresso, um arquivo do
Texinfo precisa iniciar com uma linha como esta:
@example
@group
\input texinfo
@end group
@end example
@noindent
O conteúdo do arquivo segue esse início, e então você deve finalizar o
fonte Texinfo com uma linha como esta:
@example
@@bye
@end example
@findex \input @r{(iniciação do @TeX{} bruto)}
A linha @code{@@bye} no final do arquivo em uma linha própria informa ao @TeX{}
que o arquivo está terminado e para parar a formatação. Se deixar isso de fora,
você será despejado(a) no prompt do @TeX{} no final da execução.
Além disso, você normalmente fornecerá um arquivo do Texinfo com um título, uma
página de título, índices e similares, todos os quais são explicados neste
manual. Mas o mínimo, que pode ser útil para documentos curtos, é apenas a
linha no início e a linha no final.
Sem informações adicionais, as codificações de entrada e saída são assumidas
como UTF-8, um conjunto universal de códigos compatível com ASCII de 7 bits.
@node Arquivo Curto do Texinfo de Amostra
@nodedescription Um arquivo curto do Texinfo de amostra.
@anchor{Amostra Curta}@c
@anchor{Amostra de Início}@c
@section Amostra Curta
@cindex Arquivo do Texinfo de amostra, sem comentários