%!PS-Adobe-3.0
%%Creator: groff version 1.19.1
%%CreationDate: Thu Jun 16 23:33:11 2005
%%DocumentNeededResources: font Courier
%%+ font Times-Italic
%%+ font Symbol
%%DocumentSuppliedResources: procset grops 1.19 1
%%Pages: 41
%%PageOrder: Ascend
%%DocumentMedia: Default 595 842 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 1
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}bind def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
clear
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Courier
%%IncludeResource: font Times-Italic
%%IncludeResource: font Symbol
grops begin/DEFS 52 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Italic@0 ENC0/Times-Italic RE/Courier@0 ENC0/Courier RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF(Network Working Group)56.692 84.944 Q(B. Lilly)309.6
E 345.6(Internet\255Draft June)56.692 96.944 R(2005)7.2 E
(Updates: 2223 \(if approved\))56.692 108.944 Q
(Intended status: Informational)56.692 120.944 Q
(Expires: December 18, 2005)56.692 132.944 Q
(Writing Internet-Drafts and Requests For Comments using troff and)
81.892 156.944 Q(nroff)297.892 168.944 Q 222.292 180.944 EBEGIN
[/Author (B. Lilly) /Title (Writing Internet-Drafts and Requests For Comments using troff and nroff) /DOCINFO pdfmark
EEND/F0 12/Courier@0 SF(draft-lilly-using-troff\25505)222.292 180.944 Q
(Status of this Memo)56.692 204.944 Q
(By submitting this Internet\255Draft, each author represents that any)
78.292 228.944 Q
(applicable patent or other IPR claims of which he or she is aware)
78.292 240.944 Q
(have been or will be disclosed, and any of which he or she becomes)
78.292 252.944 Q
(aware will be disclosed, in accordance with Section 6 of BCP 79.)78.292
264.944 Q
(Internet\255Drafts are working documents of the Internet Engineering)
78.292 288.944 Q
(Task Force \(IETF\), its areas, and its working groups.)78.292 300.944
Q(Note that)14.4 E
(other groups may also distribute working documents as)78.292 312.944 Q
(Internet\255Drafts.)78.292 324.944 Q(Internet\255Drafts are draft docu\
ments valid for a maximum of six months)78.292 348.944 Q
(and may be updated, replaced, or obsoleted by other documents at any)
78.292 360.944 Q 7.2(time. It)78.292 372.944 R
(is inappropriate to use Internet\255Drafts as reference)7.2 E
(material or to cite them other than as "work in progress.")78.292
384.944 Q(The list of current Internet\255Drafts can be accessed at)
78.292 408.944 Q(http://www.ietf.org/ietf/1id\255abstracts.txt.)78.292
420.944 Q
(The list of Internet\255Draft Shadow Directories can be accessed at)
78.292 444.944 Q(http://www.ietf.org/shadow.html.)78.292 456.944 Q
(Copyright Notice)56.692 480.944 Q 7.2(Copyright \251 The)78.292 504.944
R(Internet Society \(2005\).)7.2 E(Abstract)56.692 528.944 Q
(Internet\255Drafts and RFCs have traditionally been produced using a)
78.292 552.944 Q(variety of tools, including nroff.)78.292 564.944 Q
(This memo describes production of)14.4 E
(Internet\255Drafts and RFCs using a set of troff/nroff macros suitable)
78.292 576.944 Q(for that purpose.)78.292 588.944 Q
(Public comments regarding this memo may be sent to)14.4 E
(the rfc\255interest mailing list.)78.292 600.944 Q 126(Lilly Expires)
56.692 768.944 R(December 18, 2005)7.2 E([Page 1])111.6 E 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E(Table of Contents)
20.182 108.944 Q
(1. Introduction...................................................)
41.782 132.944 Q(3)14.4 E
(1.1. Basic Directives Are at Too Low a Level...................)63.382
144.944 Q(3)14.4 E
(1.2. Authors Specify Content Rather Than Issue Directives......)63.382
156.944 Q(3)14.4 E
(1.3. ms Macros Are Not Designed For RFCs.......................)63.382
168.944 Q(3)14.4 E
(1.4. RFC-specific Macros.......................................)63.382
180.944 Q(3)14.4 E
(2. Requirement Levels.............................................)
41.782 192.944 Q(4)14.4 E
(3. Processing.....................................................)
41.782 204.944 Q(4)14.4 E
(4. Input Format...................................................)
41.782 216.944 Q(4)14.4 E
(5. Specifics......................................................)
41.782 228.944 Q(5)14.4 E
(5.1. Loading the RFC Macros....................................)63.382
240.944 Q(5)14.4 E
(5.2. Specifying the Document Particulars.......................)63.382
252.944 Q(5)14.4 E
(5.3. Document Content..........................................)63.382
264.944 Q(9)14.4 E
(5.4. End Matter................................................ 15)
63.382 276.944 Q
(6. Acknowledgments................................................ 15)
41.782 288.944 Q
(7. Security Considerations........................................ 16)
41.782 300.944 Q
(8. Internationalization Considerations............................ 16)
41.782 312.944 Q
(9. IANA Considerations............................................ 16)
41.782 324.944 Q
(Appendix A. Esoterica............................................. 16)
41.782 336.944 Q
(A.1. Troff vs. Nroff........................................... 16)
63.382 348.944 Q
(A.2. Output Adjustments........................................ 18)
63.382 360.944 Q
(A.3. Tips and Tricks........................................... 19)
63.382 372.944 Q
(A.4. Postprocessing............................................ 28)
63.382 384.944 Q
(A.5. Proofreading and Checking Output.......................... 28)
63.382 396.944 Q
(Appendix B. Macros Specifically for the RFC Editor................ 28)
41.782 408.944 Q
(B.1. IESG Notes................................................ 28)
63.382 420.944 Q
(B.2. Alternate Document Type and Number........................ 30)
63.382 432.944 Q
(Appendix C. Document Progression Using the rfc Macros............. 30)
41.782 444.944 Q
(C.1. Initial Internet-Draft.................................... 30)
63.382 456.944 Q
(C.2. Subsequent Draft Revisions................................ 31)
63.382 468.944 Q
(C.3. Publication as an RFC..................................... 31)
63.382 480.944 Q
(Appendix D. Obtaining the rfc Macros and Related Tools............ 31)
41.782 492.944 Q
(Appendix E. Summary of Directives................................. 32)
41.782 504.944 Q
(Appendix F. Source File Directive Order........................... 33)
41.782 516.944 Q
(Appendix G. Disclaimers........................................... 34)
41.782 528.944 Q
(Appendix H. Change History........................................ 35)
41.782 540.944 Q
(Normative References.............................................. 38)
41.782 552.944 Q
(Informative References............................................ 38)
41.782 564.944 Q
(Author's Address.................................................. 40)
41.782 576.944 Q 126(Lilly Expires)20.182 768.944 R(December 18, 2005)
7.2 E([Page 2])111.6 E 0 Cg EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 56.692 108.944 EBEGIN
[/Title (1. Introduction) /Dest (S1) /OUT pdfmark
EEND 56.692 108.944 EBEGIN
[/Dest (S1) /Page 3 /View [ /FitH 720 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(1. Introduction)56.692 108.944 Q
(The Instructions to RFC Authors RFC [N1.RFC2223] describes the)78.292
132.944 Q(editorial format of RFCs and outlines editorial production of)
78.292 144.944 Q
(Internet\255Drafts and RFCs using basic troff directives [I1.CSTR54])
78.292 156.944 Q
(with the ms macro package [I2.ms] and a postprocessor which is)78.292
168.944 Q(necessitated by use of the ms macro package.)78.292 180.944 Q
(However, use of basic)14.4 E
(directives and the ms macro package is not ideal.)78.292 192.944 Q
56.692 216.944 EBEGIN
[/Title (1.1. Basic Directives Are at Too Low a Level) /Dest (S1.1) /OUT pdfmark
EEND 56.692 216.944 EBEGIN
[/Dest (S1.1) /Page 3 /View [ /FitH 612 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(1.1. Basic Directives Are at Too Low a Level)
56.692 216.944 Q
(Use of basic troff directives is not ideal for authors or editors who)
78.292 240.944 Q(are not familiar with troff arcana.)78.292 252.944 Q
(On the one hand, the example in)14.4 E
([N1.RFC2223] uses a larger variety of troff directives than some)78.292
264.944 Q(casual users might be familiar with.)78.292 276.944 Q
(On the other hand, instead of)14.4 E
(using directives such as .tl to produce first page headings, it)78.292
288.944 Q
(suggests that authors or editors should count characters to manually)
78.292 300.944 Q(justify the first page heading.)78.292 312.944 Q 56.692
336.944 EBEGIN
[/Title (1.2. Authors Specify Content Rather Than Issue Directives) /Dest (S1.2) /OUT pdfmark
EEND 56.692 336.944 EBEGIN
[/Dest (S1.2) /Page 3 /View [ /FitH 492 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(1.2. Authors Specify Content Rather Than Issue Directives)56.692
336.944 Q
(Another problem with low\255level directives is that authors are not)
78.292 360.944 Q(primarily concerned with formatting details.)78.292
372.944 Q(An author needs to)14.4 E
(indicate things like "this is the document title" or "a new section)
78.292 384.944 Q(starts here".)78.292 396.944 Q
(Authors rarely think in low\255level formatting terms)14.4 E
(such as are provided by basic troff directives, e.g. "center the next)
78.292 408.944 Q 7.2(3l)78.292 420.944 S(ines".)-7.2 E 56.692 444.944
EBEGIN
[/Title (1.3. ms Macros Are Not Designed For RFCs) /Dest (S1.3) /OUT pdfmark
EEND 56.692 444.944 EBEGIN
[/Dest (S1.3) /Page 3 /View [ /FitH 384 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(1.3. ms Macros Are Not Designed For RFCs)56.692
444.944 Q
(Macros provide a mechanism for authors to specify type of content)
78.292 468.944 Q(rather than formatting details.)78.292 480.944 Q
(However, use of the ms macro package)14.4 E(is not ideal for productio\
n of RFCs and Internet\255Drafts as that macro)78.292 492.944 Q
(package was not designed for the specific document format described)
78.292 504.944 Q(in [N1.RFC2223].)78.292 516.944 Q
(Use of some high\255level ms macros results in text)14.4 E
(which violates some provisions of the [N1.RFC2223] format, while)78.292
528.944 Q
(other ms macros are unusable due to differences between RFC document)
78.292 540.944 Q
(format and the types of documents that the ms package was designed to)
78.292 552.944 Q 7.2(produce. There)78.292 564.944 R
(are also implementation differences in different)7.2 E
(versions of "ms" macro packages.)78.292 576.944 Q
(Finally, it is the ms macro package)14.4 E
(which has stymied the RFC Editor's attempts to get a form feed)78.292
588.944 Q(character at the end of each page [N1.RFC2223], [I3.RFC1543].)
78.292 600.944 Q 56.692 624.944 EBEGIN
[/Title (1.4. RFC-specific Macros) /Dest (S1.4) /OUT pdfmark
EEND 56.692 624.944 EBEGIN
[/Dest (S1.4) /Page 3 /View [ /FitH 204 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(1.4. RFC-specific Macros)56.692 624.944 Q
(This memo describes use of a macro package which is designed)78.292
648.944 Q
(specifically for production of RFCs and Internet\255Drafts, which)
78.292 660.944 Q
(provides a high\255level abstraction to insulate authors and editors)
78.292 672.944 Q
(from many troff details and frees authors and editors from tedium)
78.292 684.944 Q(such as counting characters.)78.292 696.944 Q 126
(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 3])111.6 E
0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 20.182 108.944 EBEGIN
[/Title (2. Requirement Levels) /Dest (S2) /OUT pdfmark
EEND 20.182 108.944 EBEGIN
[/Dest (S2) /Page 4 /View [ /FitH 720 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(2. Requirement Levels)20.182 108.944 Q
(The key words "SHOULD", "SHOULD NOT" and "RECOMMENDED" in this)41.782
132.944 Q(document are to be interpreted as described in [N2.BCP14].)
41.782 144.944 Q 20.182 168.944 EBEGIN
[/Title (3. Processing) /Dest (S3) /OUT pdfmark
EEND 20.182 168.944 EBEGIN
[/Dest (S3) /Page 4 /View [ /FitH 660 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(3. Processing)20.182 168.944 Q
(Production of a document using troff and a macro package proceeds in)
41.782 192.944 Q(several stages:)41.782 204.944 Q 14.4(1. A)41.782
228.944 R
(mixture of free\255form text, processing directives, and material)7.2 E
(describing non\255textual content \(tables, diagrams, etc.\) is)77.782
240.944 Q(generated by the author.)77.782 252.944 Q 14.4
(2. Preprocessors)41.782 276.944 R
([I4.CSTR49], [I5.CSTR114], [I6.CSTR116],)7.2 E
([I7.CSTR122], [I8.eqn], [I9.CSTR142] may be used to transform)77.782
288.944 Q(descriptions of tables, diagrams, etc.)77.782 300.944 Q 14.4
(3. A)41.782 324.944 R
(formatter transforms instructions and other input into a)7.2 E
(formatted document according to rules corresponding to the)77.782
336.944 Q(desired document format.)77.782 348.944 Q 14.4(4. Some)41.782
372.944 R(postprocessing may take place to repaginate output and to)7.2
E(make final adjustments to the output format.)77.782 384.944 Q
(Tools, e.g. [I10.make], are available to automate the preprocessor,)
41.782 408.944 Q
(formatter, and postprocessing portions of document processing,)41.782
420.944 Q(freeing the author to concentrate on the document content.)
41.782 432.944 Q 20.182 456.944 EBEGIN
[/Title (4. Input Format) /Dest (S4) /OUT pdfmark
EEND 20.182 456.944 EBEGIN
[/Dest (S4) /Page 4 /View [ /FitH 372 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(4. Input Format)20.182 456.944 Q
(Input consists of text to be formatted, directives that specify)41.782
480.944 Q
(formatting parameters and actions, and special sequences that provide)
41.782 492.944 Q(access to saved strings and numbers.)41.782 504.944 Q
(Directives consist of a line)14.4 E
(beginning with a period \(also known as "dot"\).)41.782 516.944 Q
(The dot may be)14.4 E
(followed by space characters, and then a named directive.)41.782
528.944 Q(The name)14.4 E(consists of one or more printing characters.)
41.782 540.944 Q(Many directives also)14.4 E
(take arguments, which are space\255separated strings of characters.)
41.782 552.944 Q
(Unless directed otherwise, input is collected and formed into)41.782
564.944 Q(paragraphs without regard to line breaks in the input.)41.782
576.944 Q(Input text)14.4 E(consisting of the lines:)41.782 588.944 Q
(.IP)20.182 612.944 Q(All bad precedents)20.182 624.944 Q(begin with)
20.182 636.944 Q(justifiable measures. \\" Julius Caesar)20.182 648.944
Q(.\\" This is a comment.)20.182 660.944 Q 7.2(As)20.182 672.944 S
(trong conviction)-7.2 E(that something must be done)20.182 684.944 Q
(is the parent of)20.182 696.944 Q
(many bad measures. \\" Daniel Webster)20.182 708.944 Q(Any excuse)
20.182 720.944 Q(will serve)20.182 732.944 Q 7.2(at)20.182 744.944 S
(yrant. \\" Aesop)-7.2 E 126(Lilly Expires)20.182 768.944 R
(December 18, 2005)7.2 E([Page 4])111.6 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(is formatted into an indented paragraph which looks like:)78.292
108.944 Q(All bad precedents begin with justifiable measures.)78.292
132.944 Q 7.2(As)14.4 G(trong)-7.2 E
(conviction that something must be done is the parent of many bad)78.292
144.944 Q 7.2(measures. Any)78.292 156.944 R
(excuse will serve a tyrant.)7.2 E
(The character sequence \\" introduces a comment which continues to the)
78.292 180.944 Q(end of the line.)78.292 192.944 Q
(If an entire line is a comment, starting the line)14.4 E
(with a dot followed by the comment ensures that extra space does not)
78.292 204.944 Q(appear in the output.)78.292 216.944 Q
(Authors should be careful about use of the)14.4 E
(backslash, which is an escape character that introduces special)78.292
228.944 Q 7.2(sequences. If)78.292 240.944 R
(it is necessary to have a backslash appear in the)7.2 E
(formatted output, the sequence \\e, i.e. a backslash followed by a)
78.292 252.944 Q(lower\255case letter e, will produce it.)78.292 264.944
Q(Unescaped backslashes followed)14.4 E
(by double quotes have been known to cause important text to vanish)
78.292 276.944 Q(from published RFCs.)78.292 288.944 Q 56.692 312.944
EBEGIN
[/Title (5. Specifics) /Dest (S5.1) /OUT pdfmark
EEND 56.692 312.944 EBEGIN
[/Dest (S5.1) /Page 5 /View [ /FitH 516 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5. Specifics)56.692 312.944 Q 56.692 336.944
EBEGIN
[/Title (5.1. Loading the RFC Macros) /Dest (S5.1) /OUT pdfmark
EEND 56.692 336.944 EBEGIN
[/Dest (S5.1) /Page 5 /View [ /FitH 492 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.1. Loading the RFC Macros)56.692 336.944 Q
(The first directive might be the line:)78.292 360.944 Q(.so tmac.rfc)
56.692 384.944 Q
(That directs the processor to read the contents of a file named)78.292
408.944 Q
("tmac.rfc", which contains the macros that describe the RFC format,)
78.292 420.944 Q
(holds boilerplate text, and provides convenience functions.)78.292
432.944 Q(Alternate methods of using the macros might be available:)
78.292 456.944 Q 14.4(1. the)78.292 480.944 R
(file tmac.rfc can be specified on the command line before)7.2 E
(the file with source content)114.292 492.944 Q 14.4(2. the)78.292
516.944 R(rfc macros may have been locally installed in a manner that)
7.2 E(permits use of a command\255line \255mrfc argument.)114.292
528.944 Q 56.692 552.944 EBEGIN
[/Title (5.2. Specifying the Document Particulars) /Dest (S5.2) /OUT pdfmark
EEND 56.692 552.944 EBEGIN
[/Dest (S5.2) /Page 5 /View [ /FitH 276 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.2. Specifying the Document Particulars)56.692
552.944 Q
(Each RFC or Internet\255Draft has a title, one or more authors, etc.)
78.292 576.944 Q(These are specified with directives.)78.292 588.944 Q
(5.2.1. Titles, Long and Short)56.692 612.944 Q(The TL directive, as in)
78.292 636.944 Q(.TL "Writing Internet\255Drafts and Requests For Comme\
nts using troff and\\)56.692 660.944 Q(\\& nroff)56.692 672.944 Q
(specifies the document title.)78.292 696.944 Q
(The double\255quote causes the remainder)14.4 E
(of the \(logical\) line to be taken as a single argument to the TL)
78.292 708.944 Q
(macro; otherwise each space character would be taken as an argument)
78.292 720.944 Q 7.2(separator. The)78.292 732.944 R
(backslash at the end of the first line escapes the)7.2 E
(end\255of\255line, allowing the line to effectively continue with the)
78.292 744.944 Q 126(Lilly Expires)56.692 768.944 R(December 18, 2005)
7.2 E([Page 5])111.6 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(contents of the second line.)41.782 108.944 Q
(Escape sequences are discussed in)14.4 E(detail in [I1.CSTR54].)41.782
120.944 Q(There is a short title \(ST\) macro which is)14.4 E
(used to specify a short version of the document title for use in page)
41.782 132.944 Q 7.2(headings. For)41.782 144.944 R
(this document, that was specified as:)7.2 E
(.ST "Writing I\\\255Ds and RFCs using troff)20.182 168.944 Q
(Note also that a backslash character appears before the hyphen; that)
41.782 192.944 Q
(causes the hyphen to be interpreted as a normal text hyphen rather)
41.782 204.944 Q
(than as an indication of a possible hyphenation \(line\255breaking\))
41.782 216.944 Q 7.2(point. When)41.782 228.944 R 7.2(ad)7.2 G
(ocument is formatted as PostScript, a pdfmark entry)-7.2 E
(is created to indicate the document \(long\) title.)41.782 240.944 Q
(As troff escape)14.4 E
(sequences are not recognized by PostScript interpreters, the long)
41.782 252.944 Q
(title should not contain any troff escape sequences, including)41.782
264.944 Q(escaped hyphens.)41.782 276.944 Q
(As the short title isn't used by pdfmark entries,)14.4 E
(that restriction doesn't apply to it.)41.782 288.944 Q
(5.2.2. RFC or Draft Version Number)20.182 312.944 Q
(RFCs have an RFC number assigned by the RFC Editor; Internet\255Drafts)
41.782 336.944 Q(have a version number.)41.782 348.944 Q
(The number is specified with the NU macro or)14.4 E
(by setting a register with a command\255line argument as described in)
41.782 360.944 Q
(Appendix A: a negative number is interpreted as an incremental)41.782
372.944 Q(version number for a draft; \2551 for draft version \25500, \
\2552 for draft)41.782 384.944 Q(version \25501, etc.)41.782 396.944 Q
7.2(Ap)14.4 G(ositive number is interpreted as an RFC number)-7.2 E
(and SHOULD only be assigned by the RFC Editor.)41.782 408.944 Q 7.2(Az)
14.4 G(ero value is)-7.2 E
(treated like an RFC, but prints XXXX where an RFC number would)41.782
420.944 Q(appear.)41.782 432.944 Q(5.2.3. Document Category \(RFCs\))
20.182 456.944 Q
(RFCs have a category; one of Experimental, Informational, Standards)
41.782 480.944 Q(Track, or Best Current Practice [I11.BCP9].)41.782
492.944 Q(The category is)14.4 E
(specified as the argument to the CA macro; that macro directive need)
41.782 504.944 Q
(only be supplied for RFCs \(if supplied in drafts it shows as Intended)
41.782 516.944 Q(status in the first page heading\) [N3.ID].)41.782
528.944 Q(5.2.4. Updated and Obsoleted RFCs)20.182 552.944 Q
(Some RFCs update or obsolete earlier RFCs.)41.782 576.944 Q
(If an RFC is updated by)14.4 E
(the document, the number of the updated RFC should be specified as)
41.782 588.944 Q(the argument to an UP macro.)41.782 600.944 Q
(Similarly, an obsoleted RFC is)14.4 E
(indicated by an argument to an OB macro.)41.782 612.944 Q
(Multiple UP and OB macros)14.4 E
(may be used to indicate that multiple RFCs are updated or obsoleted.)
41.782 624.944 Q(5.2.5. Internet-Draft File Name)20.182 648.944 Q
(An Internet\255Draft has a file name used for retrieval; the base file)
41.782 672.944 Q
(name \(without the trailing hyphen and version number suffix\) is)
41.782 684.944 Q
(specified as the argument to the FN macro; the FN macro is not)41.782
696.944 Q(necessary \(is ignored\) for RFCs.)41.782 708.944 Q
(The file name may contain only)14.4 E
(lower\255case letters, digits, and hyphens [N3.ID].)41.782 720.944 Q
126(Lilly Expires)20.182 768.944 R(December 18, 2005)7.2 E([Page 6])
111.6 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(5.2.6. Authors or Editors)56.692 108.944 Q
(An Internet\255Draft or RFC may have up to five authors specified.)
78.292 132.944 Q
(Information for each author may be specified via the AU macro.)78.292
144.944 Q(The)14.4 E(macro takes 9 arguments:)78.292 156.944 Q 176.4
(Argument Description)78.292 180.944 R .48 LW 564.292 189.904 78.292
189.904 DL(1)103.492 204.944 Q
(First initial and surname for first page heading)153.892 204.944 Q(2)
103.492 216.944 Q
(First name and/or initials for Author's Address section)153.892 216.944
Q(3)103.492 228.944 Q
(Surname for page footer and Author's Address section)153.892 228.944 Q
(4)103.492 240.944 Q
(Gender; one of m \(male\), f \(female\), or o \(other or)153.892
240.944 Q(indeterminate\))153.892 252.944 Q 43.2(5I)103.492 264.944 S
(nternet mailbox)-43.2 E 43.2(6T)103.492 276.944 S(elephone Number)-43.2
E 43.2(7F)103.492 288.944 S(ax Number)-43.2 E 43.2(8U)103.492 300.944 S
(RL)-43.2 E 43.2(9A)103.492 312.944 S(ffiliation)-43.2 E
(The first argument for the first author or editor is used to generate)
78.292 336.944 Q
(embedded author information when a PDF format document is generated;)
78.292 348.944 Q(it should not contain any troff escape sequences.)
78.292 360.944 Q
(The author's gender was used to customize boilerplate verbiage to)
78.292 384.944 Q
(accommodate enforcers of political correctness, at least until)78.292
396.944 Q
(individual male or female authors were prohibited from submitting)
78.292 408.944 Q(Internet\255Drafts with sensible boilerplate.)78.292
420.944 Q(Arguments containing)14.4 E
(space characters must be enclosed in double quotes.)78.292 432.944 Q
(Arguments that)14.4 E
(are not used must have an empty double quoted string or other)78.292
444.944 Q(zero\255width argument as a placeholder.)78.292 456.944 Q
(Optional text following the AU)14.4 E
(macro line is collected verbatim \(without flowing into a paragraph\))
78.292 468.944 Q(as the postal address for the author.)78.292 480.944 Q
(Similar information can be)14.4 E
(provided for additional authors by additional AU macro calls.)78.292
492.944 Q
(Some documents, notably those produced by IETF Working Groups, are)
78.292 516.944 Q(prepared by a Document Editor [I12.BCP25].)78.292
528.944 Q(To distinguish an Editor)14.4 E
(from an Author, use the ED macro instead of the AU macro.)78.292
540.944 Q(There may)14.4 E(be multiple Editors.)78.292 552.944 Q
(5.2.7. Date)56.692 576.944 Q
(The date used for the document heading is normally the current date)
78.292 600.944 Q(when formatted.)78.292 612.944 Q
(It can be explicitly specified via the DT macro)14.4 E
(which takes three numeric arguments \(4\255digit year, month, and day)
78.292 624.944 Q
(respectively\), or the values may be specified via command\255line)
78.292 636.944 Q(arguments as described in Appendix A.)78.292 648.944 Q
(5.2.8. Section Headings and the Table of Contents)56.692 672.944 Q
(An RFC or Internet\255Draft may contain numbered sections.)78.292
696.944 Q(Sections may)14.4 E
(have subsections, and the section level represents the number of)78.292
708.944 Q(dot\255separated levels.)78.292 720.944 Q
(This section of this document has level 3.)14.4 E(A)14.4 E
(long document benefits from a Table of Contents.)78.292 732.944 Q
(As sections are)14.4 E
(specified, the rfc macro package collects information for a Table of)
78.292 744.944 Q 126(Lilly Expires)56.692 768.944 R(December 18, 2005)
7.2 E([Page 7])111.6 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 7.2(Contents. The)
41.782 108.944 R(TC macro takes two arguments.)7.2 E
(The first specifies the)14.4 E
(number of pages to reserve for the Table of Contents \(zero to omit)
41.782 120.944 Q
(the table\), and the second argument specifies the maximum section)
41.782 132.944 Q(level to include in the Table of Contents entries.)
41.782 144.944 Q
(These parameters may alternatively be specified via command\255line)
41.782 168.944 Q 7.2(arguments. See)41.782 180.944 R
(Appendix A for details.)7.2 E(5.2.9. Independent vs. IETF Submissions)
20.182 204.944 Q
(Internet\255Drafts and RFCs may be products of IETF Working Groups or)
41.782 228.944 Q
(other IETF entities, or they may be independent submissions.)41.782
240.944 Q(The)14.4 E
(macro IS is used to identify independent submissions, as there is a)
41.782 252.944 Q
(slight difference in the boilerplate text which accompanies them.)
41.782 264.944 Q(The IS macro takes no arguments.)41.782 276.944 Q
(Unfortunately, the IETF Secretariat rejects independent)41.782 300.944
Q(Internet\255Draft submissions that have the independent submission)
41.782 312.944 Q
(boilerplate required by the RFC Editor [I13.Instruct] \(bottom of page)
41.782 324.944 Q
(33\), probably because it is not recognized by Henrik Levkowetz')41.782
336.944 Q("idnits" program [I14.idnits].)41.782 348.944 Q
(Therefore, until the IETF Secretariat)14.4 E
(and the RFC Editor resolve their differences the IS macro SHOULD NOT)
41.782 360.944 Q(be used except by the RFC Editor.)41.782 372.944 Q
(5.2.10. Optional Notices)20.182 396.944 Q
(Certain optional notices may be placed at the front of)41.782 420.944 Q
7.2(Internet\255Drafts. The)41.782 432.944 R
(ON macro is used to specify one of the)7.2 E
(following notices via a numeric argument:)41.782 444.944 Q 216
(Type Text)41.782 468.944 R .48 LW 527.782 477.904 41.782 477.904 DL(1)
52.582 492.944 Q
(This document may not be modified, and derivative works of it)88.582
492.944 Q(may not be created.)88.582 504.944 Q
(This document may only be posted in an)14.4 E(Internet\255Draft.)88.582
516.944 Q(2)52.582 528.944 Q
(This document may not be modified, and derivative works of it)88.582
528.944 Q(may not be created, except to publish it as an RFC and to)
88.582 540.944 Q(translate it into languages other than English.)88.582
552.944 Q
(If a second argument is given to the ON macro, it is interpreted as)
41.782 576.944 Q(the number of a section that may be extracted.)41.782
588.944 Q(The text is modified)14.4 E(to reflect that.)41.782 600.944 Q
(For example:)14.4 E(.ON 1 1.2.3)20.182 624.944 Q(produces the text:)
41.782 648.944 Q
(This document may not be modified, and derivative works of it may not)
41.782 672.944 Q
(be created other than to extract section 1.2.3 as\255is for separate)
41.782 684.944 Q 7.2(use. This)41.782 696.944 R
(document may only be posted in an Internet\255Draft.)7.2 E 126
(Lilly Expires)20.182 768.944 R(December 18, 2005)7.2 E([Page 8])111.6 E
0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 56.692 108.944 EBEGIN
[/Title (5.3. Document Content) /Dest (S5.3) /OUT pdfmark
EEND 56.692 108.944 EBEGIN
[/Dest (S5.3) /Page 9 /View [ /FitH 720 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.3. Document Content)56.692 108.944 Q
(Having specified preliminary information as described above, the)78.292
132.944 Q(document content may be specified.)78.292 144.944 Q
(5.3.1. Abstract)56.692 168.944 Q
(The first item that an author might want to provide is the Abstract)
78.292 192.944 Q(for the document.)78.292 204.944 Q
(It is initiated with the AB macro, which takes no)14.4 E 7.2
(arguments. It)78.292 216.944 R
(collects text until the next macro directive into a)7.2 E
(paragraph for the document abstract.)78.292 228.944 Q
(An abstract is required for an)14.4 E
(Internet\255Draft; it is optional for an RFC.)78.292 240.944 Q
(5.3.2. Numbered and Unnumbered Sections)56.692 264.944 Q
(Additional document content is usually organized into sections.)78.292
288.944 Q(There are two types of sections: numbered and unnumbered.)
78.292 300.944 Q(For the)14.4 E
(purpose of collecting headings for the Table of Contents, unnumbered)
78.292 312.944 Q
(sections have a section "level" even though no number appears.)78.292
324.944 Q(A)14.4 E
(section is initiated with an SH macro for unnumbered sections, or an)
78.292 336.944 Q(NH macro for numbered sections.)78.292 348.944 Q
(Each macro requires two arguments:)14.4 E
(the section level and the section heading text.)78.292 360.944 Q
(Numbering for)14.4 E(numbered sections is computed automatically.)
78.292 372.944 Q(The NH macros accepts)14.4 E
(an optional third argument, to save the generated section number)78.292
384.944 Q
(string in a named string; the third argument must be 2 characters)
78.292 396.944 Q(suitable as the name of a string.)78.292 408.944 Q
(Internal string names used by the)14.4 E
(rfc macro package always begin with an upper\255case letter; it is)
78.292 420.944 Q
(generally safe to use a two\255character name that begins with a)78.292
432.944 Q
(lower\255case letter which is followed by an upper\255case letter or a)
78.292 444.944 Q
(digit \(troff internally has some strings which are named with two)
78.292 456.944 Q(lower\255case letters\).)78.292 468.944 Q
(When a document is formatted as PostScript, pdfmark entries are made)
78.292 492.944 Q
(which are intended to create corresponding "Bookmark" entries when a)
78.292 504.944 Q(PDF file is produced.)78.292 516.944 Q
(The title for the bookmark entry is taken from)14.4 E
(the section heading, which should not contain any troff special)78.292
528.944 Q(characters \(including escaped hyphens\).)78.292 540.944 Q
(5.3.3. Paragraphs)56.692 564.944 Q
(Within sections, text is organized into paragraphs.)78.292 588.944 Q
(RFCs and)14.4 E(Internet\255Drafts usually use indented block paragrap\
hs like this one;)78.292 600.944 Q
(these are introduced with the IP macro.)78.292 612.944 Q
(That macro can take two)14.4 E
(optional arguments: initial unindented text and an indent distance.)
78.292 624.944 Q
(The defaults are no unindented text and an indent distance of 3)78.292
636.944 Q(character spaces \(0.3 inch\).)78.292 648.944 Q
(Various units may be used in troff; it)14.4 E
(is strongly RECOMMENDED that horizontal distances, such as the indent)
78.292 660.944 Q
(distance, be specified in multiples of 0.1 inch so that nroff\255 and)
78.292 672.944 Q(troff\255formatted versions of documents maintain the \
same line and page)78.292 684.944 Q(breaks.)78.292 696.944 Q
(Unindented paragraphs are possible via the LP macro.)78.292 720.944 Q
126(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 9])
111.6 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(5.3.4. Special Indentation)20.182 108.944 Q
(Indentation may be controlled with RS and RE macros.)41.782 132.944 Q
(The RS macro)14.4 E
(will increase the indent level by the paragraph indentation increment)
41.782 144.944 Q
(of 3 character spaces, while the RE macro will reduce indentation by)
41.782 156.944 Q(that amount.)41.782 168.944 Q
(5.3.5. Reserving Vertical Space)20.182 192.944 Q
(Sometimes it is necessary to ensure that there is sufficient vertical)
41.782 216.944 Q
(space before the bottom of the current page for some complex output)
41.782 228.944 Q
(that cannot easily be handled with a keep or display \(see below\).)
41.782 240.944 Q
(The NS macro takes one argument specifying the number of text lines)
41.782 252.944 Q 7.2(needed. If)41.782 264.944 R
(fewer lines remain on the current page, output will)7.2 E
(continue at the top of the next page.)41.782 276.944 Q
(5.3.6. Keeps and Displays)20.182 300.944 Q
(Sometimes one has lines of text or non\255textual content which one)
41.782 324.944 Q
(would like to appear as a group, uninterrupted by page breaks.)41.782
336.944 Q(Such)14.4 E 7.2(ag)41.782 348.944 S
(roup is called a "keep" and is specified by preceding the group)-7.2 E
(with the KS macro and following it with a KE macro.)41.782 360.944 Q
(Keeps are)14.4 E
(typically used to fine\255tune formatting; they are rarely required.)
41.782 372.944 Q
(Keeps will not work with multiple paragraphs \(or list items\) between)
41.782 396.944 Q(KS and KE directives.)41.782 408.944 Q
(To force a page break if there is less than a)14.4 E
(certain amount of vertical space remaining on the current page, use)
41.782 420.944 Q(the NS macro directive to reserve space.)41.782 432.944
Q(More complex groupings can be obtained by "displays".)41.782 456.944 Q
(Displays are)14.4 E(started like keeps, using the DS macro.)41.782
468.944 Q(Display content is not)14.4 E
(filled into paragraphs; output appears like the input lines except)
41.782 480.944 Q(for indentation.)41.782 492.944 Q
(The DS macro takes an argument consisting of a)14.4 E
(single letter which identifies the type of display:)41.782 504.944 Q
186(Type Description)41.782 528.944 R .48 LW 530.182 537.904 41.782
537.904 DL(C)52.582 552.944 Q(Each line of text is centered)76.582
552.944 Q(B)52.582 564.944 Q
(The input lines are read as a block, and the block is centered)76.582
564.944 Q(L)52.582 576.944 Q(The display is left\255aligned)76.582
576.944 Q(I)52.582 588.944 Q
(The display is indented by the amount indicated by an optional)76.582
588.944 Q(second argument \(default is 3 character spaces\))76.582
600.944 Q(Displays are typically used for block quoted material and for)
41.782 624.944 Q(preventing page breaks within non\255textual material \
such as tables and)41.782 636.944 Q 7.2(diagrams. For)41.782 648.944 R
(example, the input:)7.2 E(.DS C)20.182 672.944 Q(War is Peace)20.182
684.944 Q(Freedom is Slavery)20.182 696.944 Q(Ignorance is Strength)
20.182 708.944 Q(.\\" Eric Arthur Blair, a.k.a. George Orwell)20.182
720.944 Q(.DE)20.182 732.944 Q 126(Lilly Expires)20.182 768.944 R
(December 18, 2005)7.2 E([Page 10])104.4 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(produces output in which each line is centered:)78.292 108.944 Q
(War is Peace)272.692 132.944 Q(Freedom is Slavery)251.092 144.944 Q
(Ignorance is Strength)240.292 156.944 Q(whereas the input:)78.292
180.944 Q(.DS B)56.692 204.944 Q(War can still settle problems,)56.692
216.944 Q
(but it can only settle them the wrong way. \\" Bertrand Russell)56.692
228.944 Q(.DE)56.692 240.944 Q
(produces the text lines as a centered block:)78.292 264.944 Q
(War can still settle problems,)164.692 288.944 Q
(but it can only settle them the wrong way.)164.692 300.944 Q
(Sometimes placement of a display, such as one containing a diagram,)
78.292 324.944 Q(is not critical.)78.292 336.944 Q 7.2(Af)14.4 G
(loating display allows text and non\255floating)-7.2 E
(displays which follow it in the source document to be output before)
78.292 348.944 Q(it if it will not fit on the current output page.)
78.292 360.944 Q 7.2(Af)14.4 G(loating display)-7.2 E
(begins with a DF macro call, taking the same arguments as DS and)78.292
372.944 Q(ending with a DE macro call.)78.292 384.944 Q
(Floating displays are output before the)14.4 E
(end of the section and subsection in which they are defined in the)
78.292 396.944 Q
(input, so they cannot appear in the wrong section of the formatted)
78.292 408.944 Q(document.)78.292 420.944 Q
(Text following a display or keep should be organized as a paragraph,)
78.292 444.944 Q
(to ensure that the text appears where expected on output and so that)
78.292 456.944 Q
(page breaks can be adjusted to prevent widows and orphans.)78.292
468.944 Q(5.3.7. Lists)56.692 492.944 Q(5.3.7.1. Numbered Lists)56.692
516.944 Q(The NL macro initializes a numbered list.)78.292 540.944 Q
(It takes four optional)14.4 E(arguments:)78.292 552.944 Q 14.4(1. a)
78.292 576.944 R(prefix string.)7.2 E
(The default is an empty string \(no prefix\).)14.4 E 14.4(2. a)78.292
600.944 R(one\255character numbering format; one of)7.2 E 64.8(1n)99.892
624.944 S(umber using Arabic numerals \(the default\))-64.8 E 64.8(In)
99.892 648.944 S(umber using Roman numbers expressed as upper\255case)
-64.8 E(letters)171.892 660.944 Q 64.8(in)99.892 684.944 S
(umber using Roman numbers expressed as lower\255case)-64.8 E(letters)
171.892 696.944 Q 64.8(Al)99.892 720.944 S
(etter with upper\255case letters)-64.8 E 64.8(al)99.892 744.944 S
(etter with lower\255case letters)-64.8 E 126(Lilly Expires)56.692
768.944 R(December 18, 2005)7.2 E([Page 11])104.4 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 14.4(3. a)41.782
108.944 R(suffix string.)7.2 E(The default is a period.)14.4 E 14.4
(4. the)41.782 132.944 R
(indent distance \(in characters as a dimensionless number\))7.2 E
(for running list text.)77.782 144.944 Q 7.2(As)14.4 G
(uitable value will depend on the)-7.2 E
(numbering format, length of suffix and/or prefix, and the)77.782
156.944 Q(expected number of items.)77.782 168.944 Q
(The default value is the paragraph)14.4 E(indent distance.)77.782
180.944 Q
(Each list item after the initialization is introduced by the LI \(list)
41.782 204.944 Q(item\) macro.)41.782 216.944 Q
(Text following the LI macro line is processed as an)14.4 E
(indented paragraph with the first line numbered.)41.782 228.944 Q
(The most recently started list is terminated with the LE \(list end\))
41.782 252.944 Q(macro.)41.782 264.944 Q
(Lists may be nested up to 9 levels deep.)41.782 288.944 Q
(Each level of nesting is)14.4 E
(indented by the paragraph indent value \(3 characters\).)41.782 300.944
Q(The list)14.4 E
(above has a variable list \(see description below\) inside a numbered)
41.782 312.944 Q(list.)41.782 324.944 Q(5.3.7.2. Bulleted Lists)20.182
348.944 Q 7.2(Ab)41.782 372.944 S
(ulleted list is initialized with the BL macro.)-7.2 E(List items also)
14.4 E(use the LI macro and the LE macro ends a bulleted list.)41.782
384.944 Q(The input lines:)41.782 408.944 Q(.BL)20.182 432.944 Q(.LI)
20.182 444.944 Q(first bulleted item)20.182 456.944 Q(.LI)20.182 468.944
Q(second)20.182 480.944 Q(bulleted item)20.182 492.944 Q(.LE)20.182
504.944 Q(produce the output:)41.782 528.944 Q 16.8<8366>41.782 552.944
S(irst bulleted item)-16.8 E 16.8<8373>41.782 576.944 S
(econd bulleted item)-16.8 E
(The BL macro will accept an optional argument, which is treated as a)
41.782 600.944 Q
(string to use in place of the default bullet character.)41.782 612.944
Q(5.3.7.3. Variable Lists)20.182 636.944 Q
(The VL macro initializes a variable list.)41.782 660.944 Q
(Each list item is labeled)14.4 E
(with a string supplied as an argument on that item's LI macro line.)
41.782 672.944 Q
(The VL macro takes one optional argument which specifies the indent)
41.782 684.944 Q
(distance \(in characters as a dimensionless number\) for running list)
41.782 696.944 Q 7.2(text. A)41.782 708.944 R
(suitable value will depend on the expected lengths of list)7.2 E
(item labels.)41.782 720.944 Q
(The default value is the paragraph indent distance.)14.4 E
(The LE macro terminates a variable list.)41.782 732.944 Q 126
(Lilly Expires)20.182 768.944 R(December 18, 2005)7.2 E([Page 12])104.4
E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E(5.3.8. References)
56.692 108.944 Q
(Internet\255Drafts and RFCs contain two types of references: normative)
78.292 132.944 Q(references and informative references.)78.292 144.944 Q
(Citations for the reference)14.4 E
(material appear near the end of the document and are indicated by a)
78.292 156.944 Q
(bracketed tag within the document text like this: [N1.RFC2223].)78.292
168.944 Q
(Macros are provided to automatically number and format normative and)
78.292 180.944 Q
(informative references in the style used in this document.)78.292
192.944 Q(The)14.4 E
(reference tags consist of the letter N \(for normative references\) or)
78.292 204.944 Q 7.2(I\()78.292 216.944 S
(for informative references\), followed by a sequential number)-7.2 E
(within each series, optionally followed by a dot and a string)78.292
228.944 Q
(supplied as an argument to the NR macro for normative references, IR)
78.292 240.944 Q(for informative references.)78.292 252.944 Q 7.2(As)
14.4 G(econd argument may be supplied to)-7.2 E
(save the generated reference tag in a named string; the second)78.292
264.944 Q
(argument must be 2 characters suitable as the name of a string.)78.292
276.944 Q
(Internal string names used by the rfc macro package always begin with)
78.292 288.944 Q(an upper\255case letter; it is generally safe to use a\
 two\255character)78.292 300.944 Q
(name that begins with a lower\255case letter which is followed by an)
78.292 312.944 Q(upper\255case letter or a digit \(troff internally has\
 some strings which)78.292 324.944 Q
(are named with two lower\255case letters\).)78.292 336.944 Q
(The first normative)14.4 E
(reference in this document could have been specified by the lines:)
78.292 348.944 Q(.NR RFC2223 r1)56.692 372.944 Q
(Postel, J. and J. Reynolds, "Instructions to RFC Authors", RFC\\ 2223,)
56.692 384.944 Q(October 1997.)56.692 396.944 Q(.NE)56.692 408.944 Q
(For references to RFCs, one can simply copy and paste the text made)
78.292 432.944 Q(available by the RFC Editor in the file rfc\255ref.txt\
, as has been done)78.292 444.944 Q
(in this example \(the actual reference text was on a single input)
78.292 456.944 Q
(line, though that is not required, and the backslash preceding the)
78.292 468.944 Q
(space after "RFC" prevents lines being broken at that space, i.e.)
78.292 480.944 Q(within the RFC document number\).)78.292 492.944 Q
(The reference text follows the NR)14.4 E
(or IR macro line and will be suitably formatted and placed in the)
78.292 504.944 Q
(Normative References or Informative References section of the)78.292
516.944 Q(generated document.)78.292 528.944 Q
(The reference text is ended with an NE or IE)14.4 E(macro.)78.292
540.944 Q
(The bracketed reference string appears in the text at the place where)
78.292 564.944 Q
(the NR/NE or IR/IE macros are placed, while the actual reference)78.292
576.944 Q
(citation text is saved for output in unnumbered Normative References)
78.292 588.944 Q(and Informative References sections.)78.292 600.944 Q
(No space appears after the)14.4 E
(bracketed reference, so a list of such references may appear with)
78.292 612.944 Q
(comma separators by simply placing a line containing a comma between)
78.292 624.944 Q(reference macro groups.)78.292 636.944 Q
(If a bracketed reference appears at the end)14.4 E
(of a sentence, the period marking the end of the sentence must be)
78.292 648.944 Q(provided in the input after the NE or IE macro line.)
78.292 660.944 Q(However, a line)14.4 E
(beginning with a dot is normally interpreted as a directive; to)78.292
672.944 Q
(prevent that, the line should begin with the two character sequence)
78.292 684.944 Q(\\& preceding the period.)78.292 696.944 Q
(That sequence represents a zero\255width)14.4 E
(non\255printing space which prevents interpretation of the line as a)
78.292 708.944 Q
(directive without affecting the appearance of the output.)78.292
720.944 Q 126(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E
([Page 13])104.4 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(The reference tag \(including the brackets\) generated by the example)
41.782 108.944 Q
(above is saved in the troff string named r1, which can be used to)
41.782 120.944 Q(refer to the same reference.)41.782 132.944 Q
(That reference tag can be made to)14.4 E
(subsequently appear in the document text via a reference to the saved)
41.782 144.944 Q(troff string, viz. the character sequence \\*\(r1.)
41.782 156.944 Q
(References to RFCs by number or via numeric reference to the)41.782
180.944 Q
(corresponding BCP, STD, or FYI series number can be generated by)41.782
192.944 Q(using the rfcref preprocessor.)41.782 204.944 Q
(That preprocessor takes input like:)14.4 E(.RR N 2223 r1)20.182 228.944
Q(and generates the corresponding reference text and NR/NE or IR/IE)
41.782 252.944 Q(macro directives.)41.782 264.944 Q
(That involves a little less manual work for)14.4 E
(authors; there is no need to copy reference citation text and there)
41.782 276.944 Q(is no end\255of\255reference directive.)41.782 288.944
Q(Four preprocessor directives are recognized:)41.782 312.944 Q 10.8
(Directive Document)41.782 336.944 R(Series)7.2 E .48 LW 232.582 345.904
41.782 345.904 DL 79.2(BR BCP)66.982 360.944 R 79.2(FR FYI)66.982
372.944 R 79.2(SR STD)66.982 384.944 R 79.2(RR RFC)66.982 396.944 R
(Each directive takes two or three arguments:)41.782 420.944 Q 14.4
(1. a)41.782 444.944 R
(single letter, I or N, to indicate an informative or normative)7.2 E
(reference, respectively)77.782 456.944 Q 14.4(2. the)41.782 480.944 R
(document series number)7.2 E 14.4(3. \(optional\))41.782 504.944 R 7.2
(as)7.2 G(tring name for saving the reference tag)-7.2 E
(Note that some STD documents map to multiple RFC numbers, and that)
41.782 528.944 Q
(some STD document series numbers are either reserved for future use)
41.782 540.944 Q(or are no longer in use.)41.782 552.944 Q
(The rfcref preprocessor also checks whether documents have been)41.782
576.944 Q(updated or obsoleted, and issues suitable warnings.)41.782
588.944 Q(Another preprocessor, idref, performs a similar function for)
41.782 612.944 Q(references to Internet\255Drafts.)41.782 624.944 Q
(It converts a directive DR to an)14.4 E(Internet\255Draft reference, g\
iven arguments to indicate reference type)41.782 636.944 Q
(\(I or N as above\), a reference tag string, the draft file name)41.782
648.944 Q
(\(without file type or version number suffixes\), and an optional)
41.782 660.944 Q(string name for saving the complete reference tag.)
41.782 672.944 Q(5.3.9. MIB modules, etc.)20.182 696.944 Q
(When a MIB module or similar entity is defined and there is a)41.782
720.944 Q(limitation notice \(via the ON macro\), there may need to be \
a separate)41.782 732.944 Q
(copyright notice placed in the part to be extracted per [N4.BCP78].)
41.782 744.944 Q 126(Lilly Expires)20.182 768.944 R(December 18, 2005)
7.2 E([Page 14])104.4 E 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(The IB macro may be called at the appropriate section to generate the)
78.292 108.944 Q(properly\255formatted boilerplate text.)78.292 120.944
Q(The mandatory first argument to)14.4 E
(the IB macro selects the type of statement from the ones permitted by)
78.292 132.944 Q
([N4.BCP78], and the optional second argument permits specifying)78.292
144.944 Q(something other than "MIB module".)78.292 156.944 Q
(An optional third argument may be)14.4 E
(used to specify a prefix to the statement, an optional fourth)78.292
168.944 Q
(argument may be used to specify an indent other than paragraph)78.292
180.944 Q
(indent, and an optional fifth argument may be used for a suffix.)78.292
192.944 Q(Unused arguments may be specified as empty strings or other)
78.292 204.944 Q(zero\255width items.)78.292 216.944 Q(The types are:)
14.4 E 216(Type Text)78.292 240.944 R .48 LW 564.292 249.904 78.292
249.904 DL(1)89.092 264.944 Q 7.2(Copyright \251 The)125.092 264.944 R
(Internet Society \(2005\).)7.2 E(This version of)14.4 E
(this MIB module is part of RFC XXXX; see the RFC itself for)125.092
276.944 Q(full legal notices.)125.092 288.944 Q(2)89.092 300.944 Q 7.2
(Copyright \251 The)125.092 300.944 R(Internet Society \(2005\).)7.2 E
(The initial)14.4 E
(version of this MIB module was published in RFC XXXX; for)125.092
312.944 Q(full legal notices see the RFC itself.)125.092 324.944 Q
(Supplementary)14.4 E(information may be available on)125.092 336.944 Q
(http://www.ietf.org/copyrights/ianamib.html.)125.092 348.944 Q
(The correct year is used, and when an RFC number is assigned by the)
78.292 372.944 Q
(RFC Editor, the RFC number will appear in place of XXXX.)78.292 384.944
Q(As noted)14.4 E
(above, alternate text may be substituted for "MIB module".)78.292
396.944 Q(5.3.10. Document Appendices)56.692 420.944 Q(Appendices appea\
r like numbered sections, except that the first\255level)78.292 444.944
Q(consists of upper\255case letters rather than numbers.)78.292 456.944
Q(Each appendix to)14.4 E
(appear in the document should be introduced with the AP macro, which)
78.292 468.944 Q(causes such numbering to take place.)78.292 480.944 Q
(The AP macro requires one)14.4 E(argument, the appendix heading text.)
78.292 492.944 Q(An optional second argument may)14.4 E
(be specified as a string name for saving the appendix, as with)78.292
504.944 Q(numbered sections.)78.292 516.944 Q
(Subdivided sections within an appendix can be)14.4 E(introduced with s\
econd\255, third\255level, etc. numbering via NH macros as)78.292
528.944 Q(with document body sections.)78.292 540.944 Q 56.692 564.944
EBEGIN
[/Title (5.4. End Matter) /Dest (S5.4) /OUT pdfmark
EEND 56.692 564.944 EBEGIN
[/Dest (S5.4) /Page 15 /View [ /FitH 264 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.4. End Matter)56.692 564.944 Q
(At the very end of the input file describing the document, the author)
78.292 588.944 Q(should place an EM macro directive.)78.292 600.944 Q
(That causes output of)14.4 E
(references, author's address \(or authors' addresses\), and IPR)78.292
612.944 Q(boilerplate sections.)78.292 624.944 Q
(If a TC macro was provided at the beginning of)14.4 E(the document inp\
ut with a non\255zero first argument, or if the document)78.292 636.944
Q(is more than 15 pages in length, a Table of Contents is also)78.292
648.944 Q(produced.)78.292 660.944 Q 56.692 684.944 EBEGIN
[/Title (6. Acknowledgments) /Dest (S6) /OUT pdfmark
EEND 56.692 684.944 EBEGIN
[/Dest (S6) /Page 15 /View [ /FitH 144 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(6. Acknowledgments)56.692 684.944 Q
(The author gratefully acknowledges the discussions of RFC formatting)
78.292 708.944 Q(on the rfc\255interest mailing list.)78.292 720.944 Q
126(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 15])
104.4 E 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(The format for references was inspired by Keith Moore's draft)41.782
108.944 Q(subsequently published as [I15.RFC3834].)41.782 120.944 Q
20.182 144.944 EBEGIN
[/Title (7. Security Considerations) /Dest (S7) /OUT pdfmark
EEND 20.182 144.944 EBEGIN
[/Dest (S7) /Page 16 /View [ /FitH 684 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(7. Security Considerations)20.182 144.944 Q
(No security considerations are addressed by this memo.)41.782 168.944 Q
20.182 192.944 EBEGIN
[/Title (8. Internationalization Considerations) /Dest (S8) /OUT pdfmark
EEND 20.182 192.944 EBEGIN
[/Dest (S8) /Page 16 /View [ /FitH 636 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(8. Internationalization Considerations)20.182
192.944 Q(This memo raises no new internationalization considerations.)
41.782 216.944 Q 20.182 240.944 EBEGIN
[/Title (9. IANA Considerations) /Dest (S9) /OUT pdfmark
EEND 20.182 240.944 EBEGIN
[/Dest (S9) /Page 16 /View [ /FitH 588 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(9. IANA Considerations)20.182 240.944 Q
(This memo adds no new IANA considerations.)41.782 264.944 Q 20.182
288.944 EBEGIN
[/Title (Appendix A. Esoterica) /Dest (SA.1) /OUT pdfmark
EEND 20.182 288.944 EBEGIN
[/Dest (SA.1) /Page 16 /View [ /FitH 540 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix A. Esoterica)20.182 288.944 Q 20.182
312.944 EBEGIN
[/Title (A.1. Troff vs. Nroff) /Dest (SA.1) /OUT pdfmark
EEND 20.182 312.944 EBEGIN
[/Dest (SA.1) /Page 16 /View [ /FitH 516 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.1. Troff vs. Nroff)20.182 312.944 Q
(RFCs and Internet\255Drafts are produced as text documents.)41.782
336.944 Q(It is)14.4 E
(sometimes desirable to produce a formatted version for improved)41.782
348.944 Q(rendition of diagrams, etc.)41.782 360.944 Q
(The rfc macro package has been designed)14.4 E
(so that troff formatted output resembles the text version as closely)
41.782 372.944 Q
(as possible; it utilizes a monospaced font for text, does not)41.782
384.944 Q
(embolden section headings \(unlike the ms macro package\), and centers)
41.782 396.944 Q(each page within 8.5 by 11 inch page boundaries.)41.782
408.944 Q(Other than improved)14.4 E
(appearance of non\255textual matter, troff and nroff versions of)41.782
420.944 Q
(documents produced with the rfc macro package should appear nearly)
41.782 432.944 Q
(identical after postprocessing, including page and line breaks.)41.782
444.944 Q(One)14.4 E
(subtlety is that centered text with an odd number of characters is)
41.782 456.944 Q
(offset left or right in nroff output, whereas it is truly centered in)
41.782 468.944 Q(troff output.)41.782 480.944 Q
(Output processed with nroff for text production)14.4 E
(includes a form feed character after each page \(the "fix.pl" script)
41.782 492.944 Q(specified in [N1.RFC2223] is not necessary\).)41.782
504.944 Q
(Separate processing can be performed by troff and nroff by using)41.782
528.944 Q(nroff/troff conditionals, e.g.:)41.782 540.944 Q(.ie t \\{ \\)
20.182 564.944 Q(<troff input goes here>)20.182 576.944 Q(.\\})20.182
588.944 Q(.el \\{ \\)20.182 600.944 Q(<nroff input goes here>)20.182
612.944 Q(.\\})20.182 624.944 Q(For a more complete example, consider:)
41.782 648.944 Q 126(Lilly Expires)20.182 768.944 R(December 18, 2005)
7.2 E([Page 16])104.4 E 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E .56 LW 227.404 144.944
173.404 144.944 DL 227.404 108.944 227.404 144.944 DL 173.404 108.944
227.404 108.944 DL 173.404 144.944 173.404 108.944 DL/F1 14/Courier@0 SF
(a)195.7 130.384 Q 191.404 216.944 137.404 216.944 DL 191.404 180.944
191.404 216.944 DL 137.404 180.944 191.404 180.944 DL 137.404 216.944
137.404 180.944 DL(c)159.7 202.384 Q 190.18 147.392 191.404 144.944 DL
188.884 149.984 190.18 147.392 DL 187.588 152.648 188.884 149.984 DL
186.22 155.312 187.588 152.576 DL 184.78 158.048 186.22 155.312 DL
183.34 160.856 184.78 158.048 DL 181.9 163.664 183.34 160.856 DL 180.388
166.472 181.9 163.664 DL 178.876 169.208 180.388 166.472 DL 177.364
171.944 178.876 169.208 DL 173.404 180.944 180.388 172.952 DL 174.412
169.928 173.404 180.944 DL 180.388 172.952 174.412 169.928 DL 263.404
216.944 209.404 216.944 DL 263.404 180.944 263.404 216.944 DL 209.404
180.944 263.404 180.944 DL 209.404 216.944 209.404 180.944 DL(d)232.204
202.384 Q 210.628 147.392 209.404 144.944 DL 211.924 149.984 210.628
147.392 DL 213.22 152.648 211.924 149.984 DL 214.588 155.312 213.22
152.576 DL 216.028 158.048 214.588 155.312 DL 217.468 160.856 216.028
158.048 DL 218.908 163.664 217.468 160.856 DL 220.42 166.472 218.908
163.664 DL 221.932 169.208 220.42 166.472 DL 223.444 171.944 221.932
169.208 DL 227.404 180.944 226.396 169.928 DL 220.42 172.952 227.404
180.944 DL 226.396 169.928 220.42 172.952 DL 409.42 144.944 355.42
144.944 DL 409.42 108.944 409.42 144.944 DL 355.42 108.944 409.42
108.944 DL 355.42 144.944 355.42 108.944 DL(q)378.22 130.384 Q 373.42
216.944 319.42 216.944 DL 373.42 180.944 373.42 216.944 DL 319.42
180.944 373.42 180.944 DL 319.42 216.944 319.42 180.944 DL(r)342.22
202.384 Q 372.196 147.392 373.42 144.944 DL 370.9 149.984 372.196
147.392 DL 369.604 152.648 370.9 149.984 DL 368.164 155.312 369.532
152.576 DL 366.724 158.048 368.164 155.312 DL 365.356 160.856 366.796
158.048 DL 363.916 163.664 365.356 160.856 DL 362.332 166.472 363.844
163.664 DL 360.892 169.208 362.404 166.472 DL 359.38 171.944 360.892
169.208 DL 355.42 180.944 362.404 172.952 DL 356.428 169.928 355.42
180.944 DL 362.404 172.952 356.428 169.928 DL 445.42 216.944 391.42
216.944 DL 445.42 180.944 445.42 216.944 DL 391.42 180.944 445.42
180.944 DL 391.42 216.944 391.42 180.944 DL(s)414.22 202.384 Q 392.644
147.392 391.42 144.944 DL 393.94 149.984 392.644 147.392 DL 395.236
152.648 393.94 149.984 DL 396.604 155.312 395.236 152.576 DL 398.044
158.048 396.604 155.312 DL 399.484 160.856 398.044 158.048 DL 400.924
163.664 399.484 160.856 DL 402.436 166.472 400.924 163.664 DL 403.948
169.208 402.436 166.472 DL 405.388 171.944 403.876 169.208 DL 409.42
180.944 408.412 169.928 DL 402.436 172.952 409.42 180.944 DL 408.412
169.928 402.436 172.952 DL 191.404 288.944 137.404 288.944 DL 191.404
252.944 191.404 288.944 DL 137.404 252.944 191.404 252.944 DL 137.404
288.944 137.404 252.944 DL(h)159.7 274.384 Q 164.404 219.392 164.404
216.944 DL 164.404 221.84 164.404 219.392 DL 164.404 224.36 164.404
221.84 DL 164.404 226.952 164.404 224.36 DL 164.404 229.544 164.404
226.952 DL 164.404 232.208 164.404 229.544 DL 164.404 234.872 164.404
232.208 DL 164.404 237.536 164.404 234.872 DL 164.404 240.2 164.404
237.536 DL 164.404 242.936 164.404 240.272 DL 164.404 252.944 168.436
242.936 DL 161.38 242.936 164.404 252.944 DL 168.364 242.936 161.38
242.936 DL 373.42 288.944 319.42 288.944 DL 373.42 252.944 373.42
288.944 DL 319.42 252.944 373.42 252.944 DL 319.42 288.944 319.42
252.944 DL(t)341.716 274.384 Q 346.42 219.392 346.42 216.944 DL 346.42
221.84 346.42 219.392 DL 346.42 224.36 346.42 221.84 DL 346.42 226.952
346.42 224.36 DL 346.42 229.544 346.42 226.952 DL 346.42 232.208 346.42
229.544 DL 346.42 234.872 346.42 232.208 DL 346.42 237.536 346.42
234.872 DL 346.42 240.2 346.42 237.536 DL 346.42 242.936 346.42 240.272
DL 346.348 252.944 350.38 242.936 DL 343.396 242.936 346.42 252.944 DL
350.38 242.936 343.396 242.936 DL 263.404 288.944 209.404 288.944 DL
263.404 252.944 263.404 288.944 DL 209.404 252.944 263.404 252.944 DL
209.404 288.944 209.404 252.944 DL(i)232.204 274.384 Q 236.404 219.392
236.404 216.944 DL 236.404 221.84 236.404 219.392 DL 236.404 224.36
236.404 221.84 DL 236.404 226.952 236.404 224.36 DL 236.404 229.544
236.404 226.952 DL 236.404 232.208 236.404 229.544 DL 236.404 234.872
236.404 232.208 DL 236.404 237.536 236.404 234.872 DL 236.404 240.2
236.404 237.536 DL 236.404 242.936 236.404 240.272 DL 236.404 252.944
240.436 242.936 DL 233.38 242.936 236.404 252.944 DL 240.364 242.936
233.38 242.936 DL 326.404 360.944 272.404 360.944 DL 326.404 324.944
326.404 360.944 DL 272.404 324.944 326.404 324.944 DL 272.404 360.944
272.404 324.944 DL(j)295.204 346.384 Q 252.532 220.04 250.372 216.944 DL
254.764 223.28 252.532 220.04 DL 257.14 226.664 254.836 223.28 DL
259.444 230.192 257.14 226.664 DL 261.748 233.792 259.444 230.192 DL
264.052 237.536 261.748 233.792 DL 266.284 241.352 264.052 237.536 DL
268.516 245.168 266.356 241.352 DL 270.532 249.056 268.516 245.168 DL
272.404 252.944 270.532 249.056 DL 275.068 259.064 272.404 252.944 DL
277.588 265.328 275.068 259.064 DL 279.964 271.736 277.588 265.328 DL
282.268 278.216 279.964 271.736 DL 284.428 284.696 282.268 278.216 DL
286.444 291.104 284.428 284.696 DL 288.388 297.368 286.444 291.104 DL
290.188 303.488 288.388 297.368 DL 291.844 309.392 290.188 303.488 DL
293.428 314.936 291.844 309.392 DL 295.372 324.944 296.38 314.936 DL
290.404 315.944 295.372 324.944 DL 296.38 314.936 290.404 315.944 DL
445.42 288.944 391.42 288.944 DL 445.42 252.944 445.42 288.944 DL 391.42
252.944 445.42 252.944 DL 391.42 288.944 391.42 252.944 DL(u)413.716
274.384 Q 418.42 219.392 418.42 216.944 DL 418.42 221.84 418.42 219.392
DL 418.42 224.36 418.42 221.84 DL 418.42 226.952 418.42 224.36 DL 418.42
229.544 418.42 226.952 DL 418.42 232.208 418.42 229.544 DL 418.42
234.872 418.42 232.208 DL 418.42 237.536 418.42 234.872 DL 418.42 240.2
418.42 237.536 DL 418.42 242.936 418.42 240.272 DL 418.348 252.944
422.38 242.936 DL 415.396 242.936 418.42 252.944 DL 422.38 242.936
415.396 242.936 DL 494.38 360.944 440.38 360.944 DL 494.38 324.944
494.38 360.944 DL 440.38 324.944 494.38 324.944 DL 440.38 360.944 440.38
324.944 DL(w)462.676 346.384 Q 435.556 220.04 433.396 216.944 DL 437.788
223.28 435.556 220.04 DL 440.092 226.664 437.788 223.28 DL 442.396
230.192 440.092 226.664 DL 444.7 233.792 442.396 230.192 DL 446.86
237.536 444.628 233.792 DL 448.948 241.352 446.86 237.536 DL 451.036
245.168 449.02 241.352 DL 452.764 249.056 450.964 245.168 DL 454.348
252.944 452.764 249.056 DL 456.652 259.064 454.42 252.944 DL 458.596
265.328 456.652 259.064 DL 460.324 271.736 458.596 265.328 DL 461.764
278.216 460.324 271.736 DL 462.988 284.696 461.764 278.216 DL 464.068
291.104 463.06 284.696 DL 464.932 297.368 464.068 291.104 DL 465.508
303.488 464.86 297.368 DL 466.012 309.392 465.508 303.488 DL 466.372
314.936 466.012 309.392 DL 467.38 324.944 469.396 314.936 DL 463.348
314.936 467.38 324.944 DL 469.396 314.936 463.42 314.936 DL 254.404
360.944 200.404 360.944 DL 254.404 324.944 254.404 360.944 DL 200.404
324.944 254.404 324.944 DL 200.404 360.944 200.404 324.944 DL(k)222.7
346.384 Q 182.836 291.68 180.388 288.944 DL 185.284 294.488 182.836
291.68 DL 187.804 297.224 185.284 294.416 DL 190.324 300.032 187.804
297.224 DL 192.844 302.984 190.324 300.104 DL 195.22 305.792 192.772
302.912 DL 197.596 308.6 195.22 305.792 DL 200.044 311.408 197.668 308.6
DL 202.204 314.216 199.972 311.408 DL 204.436 316.952 202.276 314.216 DL
211.42 324.944 207.388 314.936 DL 202.42 319.976 211.42 324.944 DL
207.388 315.008 202.42 319.976 DL 403.372 360.944 349.372 360.944 DL
403.372 324.944 403.372 360.944 DL 349.372 324.944 403.372 324.944 DL
349.372 360.944 349.372 324.944 DL(v)372.172 346.384 Q 355.348 291.392
354.412 288.944 DL 356.356 293.912 355.348 291.392 DL 357.292 296.576
356.284 293.984 DL 358.3 299.24 357.292 296.576 DL 359.452 301.904
358.372 299.24 DL 360.46 304.64 359.38 301.976 DL 361.468 307.304 360.46
304.64 DL 362.476 309.896 361.468 307.304 DL 363.484 312.488 362.476
309.968 DL 364.42 314.936 363.484 312.488 DL 368.38 324.944 368.38
313.928 DL 361.396 316.952 368.38 324.944 DL 368.38 313.928 361.396
316.952 DL 234.1 291.392 234.388 288.944 DL 233.812 293.84 234.1 291.392
DL 233.524 296.36 233.812 293.84 DL 233.236 298.952 233.524 296.36 DL
232.948 301.544 233.236 298.952 DL 232.588 304.208 232.876 301.544 DL
232.3 306.872 232.588 304.208 DL 232.012 309.536 232.3 306.872 DL
231.724 312.2 232.012 309.536 DL 231.436 314.936 231.724 312.272 DL
229.42 324.944 234.388 315.944 DL 228.412 314.936 229.42 324.944 DL
234.388 315.944 228.412 314.936 DL 406.18 291.392 407.404 288.944 DL
404.812 293.984 406.18 291.392 DL 403.372 296.648 404.812 293.984 DL
401.788 299.312 403.3 296.576 DL 400.204 302.048 401.788 299.312 DL
398.476 304.856 400.132 302.048 DL 396.748 307.664 398.476 304.856 DL
395.02 310.472 396.748 307.664 DL 393.22 313.208 395.02 310.472 DL
391.42 315.944 393.22 313.208 DL 386.38 324.944 394.372 317.96 DL
388.396 314.936 386.38 324.944 DL 394.372 317.96 388.396 314.936 DL
326.404 432.944 272.404 432.944 DL 326.404 396.944 326.404 432.944 DL
272.404 396.944 326.404 396.944 DL 272.404 432.944 272.404 396.944 DL(l)
295.204 418.384 Q 248.14 363.68 245.404 360.944 DL 250.948 366.488
248.14 363.68 DL 253.756 369.296 250.948 366.488 DL 256.636 372.176
253.756 369.296 DL 259.516 375.056 256.636 372.176 DL 262.468 378.008
259.516 375.056 DL 265.42 380.96 262.468 378.008 DL 268.372 383.912
265.42 380.96 DL 271.468 387.008 268.444 383.984 DL 274.42 389.96
271.396 386.936 DL 281.404 396.944 276.436 386.936 DL 271.396 391.976
281.404 396.944 DL 276.364 387.008 271.396 391.976 DL 299.404 363.392
299.404 360.944 DL 299.404 365.84 299.404 363.392 DL 299.404 368.36
299.404 365.84 DL 299.404 370.952 299.404 368.36 DL 299.404 373.544
299.404 370.952 DL 299.404 376.208 299.404 373.544 DL 299.404 378.872
299.404 376.208 DL 299.404 381.536 299.404 378.872 DL 299.404 384.2
299.404 381.536 DL 299.404 386.936 299.404 384.272 DL 299.404 396.944
303.436 386.936 DL 296.38 386.936 299.404 396.944 DL 303.364 386.936
296.38 386.936 DL 403.372 432.944 349.372 432.944 DL 403.372 396.944
403.372 432.944 DL 349.372 396.944 403.372 396.944 DL 349.372 432.944
349.372 396.944 DL(x)371.668 418.384 Q 441.028 363.68 444.412 360.944 DL
437.5 366.56 441.028 363.68 DL 433.828 369.512 437.5 366.56 DL 430.084
372.536 433.828 369.512 DL 426.268 375.56 430.084 372.536 DL 422.452
378.656 426.268 375.56 DL 418.636 381.752 422.452 378.656 DL 414.82
384.848 418.636 381.752 DL 411.076 387.944 414.82 384.848 DL 407.404
390.968 411.076 387.944 DL 399.412 396.944 409.42 393.92 DL 405.388
387.944 399.412 396.944 DL 409.42 393.92 405.388 387.944 DL 376.372
363.392 376.372 360.944 DL 376.372 365.84 376.372 363.392 DL 376.372
368.36 376.372 365.84 DL 376.372 370.952 376.372 368.36 DL 376.372
373.544 376.372 370.952 DL 376.372 376.208 376.372 373.544 DL 376.372
378.872 376.372 376.208 DL 376.372 381.536 376.372 378.872 DL 376.372
384.2 376.372 381.536 DL 376.372 386.936 376.372 384.272 DL 376.372
396.944 380.404 386.936 DL 373.348 386.936 376.372 396.944 DL 380.404
386.936 373.42 386.936 DL 364.42 504.944 310.42 504.944 DL 364.42
468.944 364.42 504.944 DL 310.42 468.944 364.42 468.944 DL 310.42
504.944 310.42 468.944 DL(z)332.716 490.384 Q 310.636 435.392 309.412
432.944 DL 311.932 437.984 310.636 435.392 DL 313.228 440.648 311.932
437.984 DL 314.596 443.312 313.228 440.576 DL 316.036 446.048 314.596
443.312 DL 317.476 448.856 316.036 446.048 DL 318.916 451.664 317.476
448.856 DL 320.428 454.472 318.916 451.664 DL 321.94 457.208 320.428
454.472 DL 323.452 459.944 321.94 457.208 DL 328.42 468.944 326.404
458.936 DL 320.428 461.96 328.42 468.944 DL 326.404 458.936 320.428
461.96 DL 365.212 435.392 366.436 432.944 DL 363.844 437.984 365.14
435.392 DL 362.62 440.648 363.916 437.984 DL 361.18 443.312 362.548
440.576 DL 359.74 446.048 361.18 443.312 DL 358.372 448.856 359.812
446.048 DL 356.932 451.664 358.372 448.856 DL 355.348 454.472 356.86
451.664 DL 353.908 457.208 355.42 454.472 DL 352.396 459.944 353.908
457.208 DL 347.428 468.944 355.42 461.96 DL 349.444 458.936 347.428
468.944 DL 355.348 461.96 349.372 458.936 DL F0
(Diagrams imported from some sources which generate pic may require a)
78.292 528.944 Q
(reset, and in some cases setting of pic variables such as maxpsht and)
78.292 540.944 Q(maxpswid.)78.292 552.944 Q(To conform page breaks betw\
een troff\255 and nroff\255generated documents,)78.292 576.944 Q(the he\
ight of troff\255 and nroff\255produced output should be the same.)
78.292 588.944 Q
(In the example above, that is implemented with an invisible pic box)
78.292 600.944 Q
(in the nroff\255processed version which contains the text referring to)
78.292 612.944 Q(the troff\255formatted versions.)78.292 624.944 Q
(Some implementations fake text formatting with "troff \255a" or)78.292
648.944 Q("troff \255N" rather than a true nroff.)78.292 660.944 Q
(That generally works poorly,)14.4 E
(particularly if tables, diagrams, etc. are included in the document.)
78.292 672.944 Q
(Some troff implementations can produce PostScript directly; others)
78.292 696.944 Q(require a separate postprocessor.)78.292 708.944 Q
(PostScript produced by some troff)14.4 E
(implementations is not amenable to postprocessing to repaginate)78.292
720.944 Q(\(relocate the table of contents\).)78.292 732.944 Q 126
(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 17])104.4
E 0 Cg EP
%%Page: 18 18
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 20.182 108.944 EBEGIN
[/Title (A.2. Output Adjustments) /Dest (SA.2) /OUT pdfmark
EEND 20.182 108.944 EBEGIN
[/Dest (SA.2) /Page 18 /View [ /FitH 720 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.2. Output Adjustments)20.182 108.944 Q
(Formatting may be adjusted by setting registers using command\255line)
41.782 132.944 Q(arguments [I1.CSTR54].)41.782 144.944 Q
(Register names and default values are:)14.4 E 10.8(Name Default)41.782
168.944 R 10.8(Value Function)7.2 F .48 LW 516.982 177.904 41.782
177.904 DL 28.8(C0)52.582 192.944 S(\(zero\))-21.6 E
(Table of Contents length \(pages\))200.182 192.944 Q(D)52.582 204.944 Q
(Current day)88.582 204.944 Q(of month)88.582 216.944 Q
(Day of month used as publication date.)200.182 204.944 Q
(Overridden by DT macro.)200.182 216.944 Q 28.8(H2)52.582 228.944 S
(Highest section heading level to include in)200.182 228.944 Q
(Table of Contents)200.182 240.944 Q 28.8(I0)52.582 252.944 S(.3i)-28.8
E(Paragraph indent increment.)200.182 252.944 Q(Each character)14.4 E
(is 0.1i wide.)200.182 264.944 Q 28.8(L7)52.582 276.944 S(.2i)-28.8 E
(Text line length.)200.182 276.944 Q(Each character is 0.1i)14.4 E 7.2
(wide. The)200.182 288.944 R(default value provides 72)7.2 E
(characters per line and may not be exceeded.)200.182 300.944 Q(M)52.582
312.944 Q(Current month)88.582 312.944 Q
(Month number \(January = 1\) used as)200.182 312.944 Q
(publication date.)200.182 324.944 Q(Overridden by DT macro.)14.4 E 28.8
(N0)52.582 336.944 S(\(zero\))-21.6 E
(RFC or Draft version number \(negative for)200.182 336.944 Q 7.2
(drafts\). Overrides)200.182 348.944 R(NU macro if non\255zero.)7.2 E
28.8(O2)52.582 360.944 S(Minimum number of continued running text)
200.182 360.944 Q(lines at bottom of page \(anything less is)200.182
372.944 Q(considered an orphan\).)200.182 384.944 Q 28.8(P1)52.582
396.944 S(2)-28.8 E(Text point size \(troff\).)200.182 396.944 Q 28.8
(Q5)52.582 408.944 S(8)-28.8 E(Printed lines per page.)200.182 408.944 Q
(The default value)14.4 E(is the maximum permitted.)200.182 420.944 Q(R)
52.582 432.944 Q(for centered)88.582 432.944 Q(text \(troff\))88.582
444.944 Q(Page offset for odd\255numbered \(recto\) pages.)200.182
432.944 Q(Always zero for nroff \(text output\).)200.182 444.944 Q 28.8
(S1)52.582 456.944 S(P)-28.8 E(Interparagraph vertical space.)200.182
456.944 Q(The default)14.4 E(is equivalent to one text line.)200.182
468.944 Q(For)14.4 E(nroff/troff consistency, the value should be)
200.182 480.944 Q(an integral multiple of 1P.)200.182 492.944 Q(T)52.582
504.944 Q(for centered)88.582 504.944 Q(text \(troff\))88.582 516.944 Q
(Top margin.)200.182 504.944 Q(Always zero for nroff \(text)14.4 E
(output\).)200.182 516.944 Q(V)52.582 528.944 Q(for centered)88.582
528.944 Q(text \(troff\))88.582 540.944 Q
(Page offset for even\255numbered \(verso\) pages.)200.182 528.944 Q
(Always zero for nroff \(text output\).)200.182 540.944 Q 28.8(W2)52.582
552.944 S(Minimum number of continued running text)200.182 552.944 Q
(lines at top of page \(anything less is)200.182 564.944 Q
(considered a widow\).)200.182 576.944 Q 28.8(X8)52.582 588.944 S(.5i)
-28.8 E(Physical page width \(troff\).)200.182 588.944 Q(Y)52.582
600.944 Q(Current year)88.582 600.944 Q
(4\255digit year number used as publication)200.182 600.944 Q 7.2
(date. Overridden)200.182 612.944 R(by DT macro.)7.2 E 28.8(Z1)52.582
624.944 S(1i)-28.8 E(Physical page height \(troff\).)200.182 624.944 Q
(A.2.1. Formatting for Specific Paper Sizes)20.182 648.944 Q
(By default, output processed by troff \(as distinct from text output)
41.782 672.944 Q
(produced by nroff\) is formatted for economical ANSI standard A)41.782
684.944 Q
(\(8.5 x 11 inches\) [I16.ANSI151] paper, with the printed content)
41.782 696.944 Q(centered on each page.)41.782 708.944 Q
(Output may instead be formatted for other)14.4 E
(paper sizes by setting troff registers listed above \(as these all)
41.782 720.944 Q(have one\255letter names, they can be set by command\
\255line arguments;)41.782 732.944 Q
(they SHOULD NOT be set in the source file as that would adversely)
41.782 744.944 Q 126(Lilly Expires)20.182 768.944 R(December 18, 2005)
7.2 E([Page 18])104.4 E 0 Cg EP
%%Page: 19 19
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(affect output produced from that source file, e.g. by the RFC)78.292
108.944 Q 7.2(Editor\). For)78.292 120.944 R
(example, to produce output formatted for ISO)7.2 E
([I17.ISO216] A4 paper, with a 20mm margin for hole punches for ring)
78.292 132.944 Q
(binder filing, registers X, Z, R, and V would be set with)78.292
144.944 Q
(command\255line arguments \255rX21c \255rZ29.7c \255rR2c \255rV0.712c.)
78.292 156.944 Q 56.692 180.944 EBEGIN
[/Title (A.3. Tips and Tricks) /Dest (SA.3) /OUT pdfmark
EEND 56.692 180.944 EBEGIN
[/Dest (SA.3) /Page 19 /View [ /FitH 648 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.3. Tips and Tricks)56.692 180.944 Q
(Handling non\255textual material is simplified by using preprocessors.)
78.292 204.944 Q
(However, there are some subtleties that can cause frustration for)
78.292 216.944 Q 7.2(authors. Some)78.292 228.944 R
(tips regarding preprocessors and a few tricks to)7.2 E
(ensure satisfactory formatting follow.)78.292 240.944 Q
(A.3.1. Mathematics and Chemistry)56.692 264.944 Q
(While eqn [I8.eqn] is capable of setting complex equations, many)78.292
288.944 Q(symbols cannot be adequately represented in plain text.)78.292
300.944 Q(so, while)14.4 E/F1 12/Times-Italic@0 SF(x)261.526 324.944 Q
/F2 12/Symbol SF(=)5.238 E F1 5.886(f\()7.962 G -4.62 3.252(y/ 2)-2.46 H
(\))-.618 E F2(+)4.62 E F1 -4.62 3.252(y/ 2)4.77 H F0
(can be approximated, complex mathematics cannot be represented well)
78.292 348.944 Q(in plain text.)78.292 360.944 Q
(Subscripts and superscripts pose problems, and for)14.4 E
(that reason chemical formulae cannot be represented well except for)
78.292 372.944 Q(trivial cases.)78.292 384.944 Q
(Chem [I7.CSTR122] also tends to emit excess vertical)14.4 E
(space before a formula not containing a carbon ring and tends to)78.292
396.944 Q
(screw up subsequent diagrams unless at least the first diagram after)
78.292 408.944 Q 7.2(ac)78.292 420.944 S
(hemical formula contains a pic "reset" directive.)-7.2 E(That can be)
14.4 E(accomplished with an otherwise empty pic diagram.)78.292 432.944
Q(A.3.2. Data Formats)56.692 456.944 Q
(The DFORMAT program [I9.CSTR142] produces output suitable for)78.292
480.944 Q
(processing by pic [I6.CSTR116] to generate data format layouts.)78.292
492.944 Q(For)14.4 E(example:)78.292 504.944 Q
(Formatted data format diagram:)78.292 528.944 Q .48 LW 135.892 576.92
78.292 576.92 DL 135.892 552.944 135.892 576.92 DL 78.292 552.944
135.892 552.944 DL 78.292 576.92 78.292 552.944 DL(Version)85.492
567.608 Q/F3 8/Courier@0 SF(0)81.492 575.6 Q(3)127.892 575.6 Q 193.492
576.92 135.892 576.92 DL 193.492 552.944 193.492 576.92 DL 135.892
552.944 193.492 552.944 DL 135.892 576.92 135.892 552.944 DL F0(IHL)
153.892 567.608 Q F3(4)139.092 575.6 Q(7)185.492 575.6 Q 308.692 576.92
193.492 576.92 DL 308.692 552.944 308.692 576.92 DL 193.492 552.944
308.692 552.944 DL 193.492 576.92 193.492 552.944 DL F0(Type of Service)
200.692 567.608 Q F3(8)196.692 575.6 Q 2.4(15)293.492 575.6 S 539.092
576.92 308.692 576.92 DL 539.092 552.944 539.092 576.92 DL 308.692
552.944 539.092 552.944 DL 308.692 576.92 308.692 552.944 DL F0
(Total Length)380.692 567.608 Q F3 2.4(16)311.892 575.6 S 2.4(31)523.892
575.6 S 308.692 600.968 78.292 600.968 DL 308.692 576.992 308.692
600.968 DL 78.292 576.92 308.692 576.92 DL 78.292 600.896 78.292 576.92
DL F0(Identification)143.092 591.584 Q F3(0)81.492 599.648 Q 2.4(15)
293.492 599.648 S 351.892 600.968 308.692 600.968 DL 351.892 576.992
351.892 600.968 DL 308.692 576.92 351.892 576.92 DL 308.692 600.896
308.692 576.92 DL F0(Flags)315.892 591.584 Q F3 2.4(16)311.892 599.648 S
2.4(18)336.692 599.648 S 539.092 600.968 351.892 600.968 DL 539.092
576.992 539.092 600.968 DL 351.892 576.92 539.092 576.92 DL 351.892
600.896 351.892 576.92 DL F0(Fragment Offset)391.492 591.584 Q F3 2.4
(19)355.092 599.648 S 2.4(31)523.892 599.648 S 193.492 624.944 78.292
624.944 DL 193.492 600.968 193.492 624.944 DL 78.292 600.968 193.492
600.968 DL 78.292 624.944 78.292 600.968 DL F0(Time to Live)92.692
615.56 Q F3(0)81.492 623.624 Q(7)185.492 623.624 Q 308.692 624.944
193.492 624.944 DL 308.692 600.968 308.692 624.944 DL 193.492 600.968
308.692 600.968 DL 193.492 624.944 193.492 600.968 DL F0(Protocol)
222.292 615.56 Q F3(8)196.692 623.624 Q 2.4(15)293.492 623.624 S 539.092
624.944 308.692 624.944 DL 539.092 600.968 539.092 624.944 DL 308.692
600.968 539.092 600.968 DL 308.692 624.944 308.692 600.968 DL F0
(Header Checksum)369.892 615.56 Q F3 2.4(16)311.892 623.624 S 2.4(31)
523.892 623.624 S 539.092 648.92 78.292 648.92 DL 539.092 624.944
539.092 648.92 DL 78.292 624.944 539.092 624.944 DL 78.292 648.92 78.292
624.944 DL F0(Source Address)258.292 639.608 Q F3(0)81.492 647.6 Q 2.4
(31)523.892 647.6 S 539.092 672.968 78.292 672.968 DL 539.092 648.992
539.092 672.968 DL 78.292 648.92 539.092 648.92 DL 78.292 672.896 78.292
648.92 DL F0(Destination Address)240.292 663.584 Q F3(0)81.492 671.648 Q
2.4(31)523.892 671.648 S 423.892 696.944 78.292 696.944 DL 423.892
672.968 423.892 696.944 DL 78.292 672.968 423.892 672.968 DL 78.292
696.944 78.292 672.968 DL F0(Options)225.892 687.56 Q F3(0)81.492
695.624 Q 2.4(23)408.692 695.624 S 539.092 696.944 423.892 696.944 DL
539.092 672.968 539.092 696.944 DL 423.892 672.968 539.092 672.968 DL
423.892 696.944 423.892 672.968 DL F0(Padding)456.292 687.56 Q F3 2.4
(24)427.092 695.624 S 2.4(31)523.892 695.624 S F0
(Note that dimensions are specified to dformat in inches, and in the)
78.292 720.944 Q
(example suitable dimensions were chosen to match text format)78.292
732.944 Q(character width \(multiples of 0.1 inch\) and line height \(1\
/6 inch\) so)78.292 744.944 Q 126(Lilly Expires)56.692 768.944 R
(December 18, 2005)7.2 E([Page 19])104.4 E 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(that text and troff\255formatted versions are reasonably consistent.)
41.782 108.944 Q(The \\0 sequences are invisible character\255width spa\
ces which improve)41.782 120.944 Q(the text \(nroff\) output.)41.782
132.944 Q(Source:)41.782 156.944 Q(.DS B)20.182 168.944 Q
(.begin dformat)20.182 180.944 Q(style fill off)20.182 192.944 Q
(style bitwid 0.20)20.182 204.944 Q(style recspread 0)20.182 216.944 Q
(style recht 0.33333)20.182 228.944 Q(noname)20.182 240.944 Q
(0\2553 \\0Version)27.382 252.944 Q(4\2557 IHL)27.382 264.944 Q
(8\25515 \\0Type of Service)27.382 276.944 Q(16\25531 Total Length)
27.382 288.944 Q(noname)20.182 300.944 Q(0\25515 Identification)27.382
312.944 Q(16\25518 \\0Flags)27.382 324.944 Q(19\25531 Fragment Offset)
27.382 336.944 Q(noname)20.182 348.944 Q(0\2557 Time to Live)27.382
360.944 Q(8\25515 Protocol)27.382 372.944 Q(16\25531 Header Checksum)
27.382 384.944 Q(noname)20.182 396.944 Q(0\25531 Source Address)27.382
408.944 Q(noname)20.182 420.944 Q(0\25531 Destination Address)27.382
432.944 Q(noname)20.182 444.944 Q(0\25523 Options)27.382 456.944 Q
(24\25531 Padding)27.382 468.944 Q(.end)20.182 480.944 Q(.DE)20.182
492.944 Q(A.3.3. Graphs and charts)20.182 516.944 Q
(Graphs and charts may be generated from data using the grap)41.782
540.944 Q(preprocessor 5.2.10.)41.782 552.944 Q
(For example, the following graph:)14.4 E 126(Lilly Expires)20.182
768.944 R(December 18, 2005)7.2 E([Page 20])104.4 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E .48 LW 193.492 120.968
193.492 336.968 DL 481.492 120.968 193.492 120.968 DL 481.492 336.968
481.492 120.968 DL 193.492 336.968 481.492 336.968 DL
(Number of RFC documents per YEAR)222.292 111.584 Q(YEAR)323.092 363.584
Q(Number)99.892 225.608 Q(of RFCs)96.292 237.608 Q 200.692 336.968
193.492 336.968 DL(0)186.292 339.608 Q 200.692 300.968 193.492 300.968
DL(50)179.092 303.608 Q 200.692 264.968 193.492 264.968 DL(100)171.892
267.608 Q 200.692 228.968 193.492 228.968 DL(150)171.892 231.608 Q
200.692 192.968 193.492 192.968 DL(200)171.892 195.608 Q 200.692 156.968
193.492 156.968 DL(250)171.892 159.608 Q 200.692 120.968 193.492 120.968
DL(300)171.892 123.608 Q 474.292 336.968 481.492 336.968 DL 474.292
300.968 481.492 300.968 DL 474.292 264.968 481.492 264.968 DL 474.292
228.968 481.492 228.968 DL 474.292 192.968 481.492 192.968 DL 474.292
156.968 481.492 156.968 DL 474.292 120.968 481.492 120.968 DL 229.492
128.168 229.492 120.968 DL 265.492 128.168 265.492 120.968 DL 301.492
128.168 301.492 120.968 DL 337.492 128.168 337.492 120.968 DL 373.492
128.168 373.492 120.968 DL 409.492 128.168 409.492 120.968 DL 445.492
128.168 445.492 120.968 DL 481.492 128.168 481.492 120.968 DL 229.492
333.368 229.492 336.968 DL(1970)215.092 345.608 Q 265.492 333.368
265.492 336.968 DL(1975)251.092 345.608 Q 301.492 333.368 301.492
336.968 DL(1980)287.092 345.608 Q 337.492 333.368 337.492 336.968 DL
(1985)323.092 345.608 Q 373.492 333.368 373.492 336.968 DL(1990)359.092
345.608 Q 409.492 333.368 409.492 336.968 DL(1995)395.092 345.608 Q
445.492 333.368 445.492 336.968 DL(2000)431.092 345.608 Q 481.492
333.368 481.492 336.968 DL(2005)467.092 345.608 Q 214.012 336.248
214.012 336.968 DL 216.172 336.248 214.012 336.248 DL 216.172 336.968
216.172 336.248 DL 221.212 318.248 221.212 336.968 DL 223.372 318.248
221.212 318.248 DL 223.372 336.968 223.372 318.248 DL 228.412 295.928
228.412 336.968 DL 230.572 295.928 228.412 295.928 DL 230.572 336.968
230.572 295.928 DL 235.612 205.928 235.612 336.968 DL 237.772 205.928
235.612 205.928 DL 237.772 336.968 237.772 205.928 DL 242.812 240.488
242.812 336.968 DL 244.972 240.488 242.812 240.488 DL 244.972 336.968
244.972 240.488 DL 250.012 221.048 250.012 336.968 DL 252.172 221.048
250.012 221.048 DL 252.172 336.968 252.172 221.048 DL 257.212 293.768
257.212 336.968 DL 259.372 293.768 257.212 293.768 DL 259.372 336.968
259.372 293.768 DL 264.412 319.688 264.412 336.968 DL 266.572 319.688
264.412 319.688 DL 266.572 336.968 266.572 319.688 DL 271.612 328.328
271.612 336.968 DL 273.772 328.328 271.612 328.328 DL 273.772 336.968
273.772 328.328 DL 278.812 322.568 278.812 336.968 DL 280.972 322.568
278.812 322.568 DL 280.972 336.968 280.972 322.568 DL 286.012 331.208
286.012 336.968 DL 288.172 331.208 286.012 331.208 DL 288.172 336.968
288.172 331.208 DL 293.212 331.928 293.212 336.968 DL 295.372 331.928
293.212 331.928 DL 295.372 336.968 295.372 331.928 DL 300.412 324.728
300.412 336.968 DL 302.572 324.728 300.412 324.728 DL 302.572 336.968
302.572 324.728 DL 307.612 316.088 307.612 336.968 DL 309.772 316.088
307.612 316.088 DL 309.772 336.968 309.772 316.088 DL 314.812 310.328
314.812 336.968 DL 316.972 310.328 314.812 310.328 DL 316.972 336.968
316.972 310.328 DL 322.012 301.688 322.012 336.968 DL 324.172 301.688
322.012 301.688 DL 324.172 336.968 324.172 301.688 DL 329.212 308.888
329.212 336.968 DL 331.372 308.888 329.212 308.888 DL 331.372 336.968
331.372 308.888 DL 336.412 307.448 336.412 336.968 DL 338.572 307.448
336.412 307.448 DL 338.572 336.968 338.572 307.448 DL 343.612 319.688
343.612 336.968 DL 345.772 319.688 343.612 319.688 DL 345.772 336.968
345.772 319.688 DL 350.812 306.728 350.812 336.968 DL 352.972 306.728
350.812 306.728 DL 352.972 336.968 352.972 306.728 DL 358.012 303.848
358.012 336.968 DL 360.172 303.848 358.012 303.848 DL 360.172 336.968
360.172 303.848 DL 365.212 299.528 365.212 336.968 DL 367.372 299.528
365.212 299.528 DL 367.372 336.968 367.372 299.528 DL 372.412 295.928
372.412 336.968 DL 374.572 295.928 372.412 295.928 DL 374.572 336.968
374.572 295.928 DL 379.612 268.568 379.612 336.968 DL 381.772 268.568
379.612 268.568 DL 381.772 336.968 381.772 268.568 DL 386.812 268.568
386.812 336.968 DL 388.972 268.568 386.812 268.568 DL 388.972 336.968
388.972 268.568 DL 394.012 210.968 394.012 336.968 DL 396.172 210.968
394.012 210.968 DL 396.172 336.968 396.172 210.968 DL 401.212 203.768
401.212 336.968 DL 403.372 203.768 401.212 203.768 DL 403.372 336.968
403.372 203.768 DL 408.412 242.648 408.412 336.968 DL 410.572 242.648
408.412 242.648 DL 410.572 336.968 410.572 242.648 DL 415.612 214.568
415.612 336.968 DL 417.772 214.568 415.612 214.568 DL 417.772 336.968
417.772 214.568 DL 422.812 198.728 422.812 336.968 DL 424.972 198.728
422.812 198.728 DL 424.972 336.968 424.972 198.728 DL 430.012 168.488
430.012 336.968 DL 432.172 168.488 430.012 168.488 DL 432.172 336.968
432.172 168.488 DL 437.212 150.488 437.212 336.968 DL 439.372 150.488
437.212 150.488 DL 439.372 336.968 439.372 150.488 DL 444.412 136.088
444.412 336.968 DL 446.572 136.088 444.412 136.088 DL 446.572 336.968
446.572 136.088 DL 451.612 197.288 451.612 336.968 DL 453.772 197.288
451.612 197.288 DL 453.772 336.968 453.772 197.288 DL 458.812 178.568
458.812 336.968 DL 460.972 178.568 458.812 178.568 DL 460.972 336.968
460.972 178.568 DL 466.012 167.768 466.012 336.968 DL 468.172 167.768
466.012 167.768 DL 468.172 336.968 468.172 167.768 DL 473.212 134.648
473.212 336.968 DL 475.372 134.648 473.212 134.648 DL 475.372 336.968
475.372 134.648 DL(was produced by the source lines:)78.292 384.944 Q
126(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 21])
104.4 E 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E(.DS B)20.182 108.944 Q
(.G1)20.182 120.944 Q 7.2(#S)20.182 132.944 S
(ource: http://www.rfc-editor.org/num_rfc_year.html)-7.2 E
(frame ht 3 wid 4 ; coord x 1965,2005 y 0,300)20.182 144.944 Q
(label left "Number" "of RFCs" left 0.6 ; label bot "YEAR" up 0.066667)
20.182 156.944 Q
(label top "Number of RFC documents per YEAR" down 0.233333)20.182
168.944 Q(ticks left in 0.1 from 0 to 300 by 50)20.182 180.944 Q
(ticks right in 0.1 from 0 to 300 by 50 "")20.182 192.944 Q
(ticks top in 0.1 from 1970 to 2005 by 5 "")20.182 204.944 Q
(ticks bot in 0.05 from 1970 to 2005 by 5)20.182 216.944 Q
(copy thru { line from $1-0.15,0 to $1-0.15,$2 ; \\)20.182 228.944 Q
(line from $1-0.15,$2 to $1+0.15,$2 ; \\)27.382 240.944 Q
(line from $1+0.15,$2 to $1+0.15,0 } until "EOF")27.382 252.944 Q
(1968 1)20.182 264.944 Q(1969 26)20.182 276.944 Q(1970 57)20.182 288.944
Q(1971 182)20.182 300.944 Q(1972 134)20.182 312.944 Q(1973 161)20.182
324.944 Q(1974 60)20.182 336.944 Q(1975 24)20.182 348.944 Q(1976 12)
20.182 360.944 Q(1977 20)20.182 372.944 Q(1978 8)20.182 384.944 Q
(1979 7)20.182 396.944 Q(1980 17)20.182 408.944 Q(1981 29)20.182 420.944
Q(1982 37)20.182 432.944 Q(1983 49)20.182 444.944 Q(1984 39)20.182
456.944 Q(1985 41)20.182 468.944 Q(1986 24)20.182 480.944 Q(1987 42)
20.182 492.944 Q(1988 46)20.182 504.944 Q(1989 52)20.182 516.944 Q
(1990 57)20.182 528.944 Q(1991 95)20.182 540.944 Q(1992 95)20.182
552.944 Q(1993 175)20.182 564.944 Q(1994 185)20.182 576.944 Q(1995 131)
20.182 588.944 Q(1996 170)20.182 600.944 Q(1997 192)20.182 612.944 Q
(1998 234)20.182 624.944 Q(1999 259)20.182 636.944 Q(2000 279)20.182
648.944 Q(2001 194)20.182 660.944 Q(2002 220)20.182 672.944 Q(2003 235)
20.182 684.944 Q(2004 281)20.182 696.944 Q(EOF)20.182 708.944 Q(.G2)
20.182 720.944 Q(.DE)20.182 732.944 Q 126(Lilly Expires)20.182 768.944 R
(December 18, 2005)7.2 E([Page 22])104.4 E 0 Cg EP
%%Page: 23 23
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(Grap produces output in pic input format; it is subsequently)78.292
108.944 Q(processed by pic to generate a graphical representation.)
78.292 120.944 Q(There are)14.4 E
(multiple implementations of both grap and pic, and there is also some)
78.292 132.944 Q
(interaction between pic\255produced output and formatters.)78.292
144.944 Q(In)14.4 E
(particular, some implementations of grap produce pic with dimensions)
78.292 156.944 Q
(unsuitable for generating plain text in Internet\255Draft/RFC format.)
78.292 168.944 Q
(Authors who include graphs should be aware of these issues; they can)
78.292 180.944 Q(be safely ignored if no graphs are included.)78.292
192.944 Q
(For consistency, the output produced by grap and pic should be)78.292
216.944 Q
(examined to confirm that the height is specified as a multiple of 1/6)
78.292 228.944 Q
(inch and the width is a multiple of 0.1 inch, not exceeding 7.2)78.292
240.944 Q 7.2(inches. Placement)78.292 252.944 R
(of labels should also be checked between text)7.2 E
(\(nroff\) and PostScript \(troff\) versions, and adjustments to the)
78.292 264.944 Q(source graph specification made as required.)78.292
276.944 Q(A.3.4. Simple Diagrams)56.692 300.944 Q
(Pic [I6.CSTR116] can produce simple diagrams.)78.292 324.944 Q
(Text output)14.4 E
(approximation is limited to rectilinear lines, so one should avoid)
78.292 336.944 Q(ellipses, splines, etc.)78.292 348.944 Q
(Box, line, etc. dimensions should be)14.4 E
(multiples of character width \(0.1 inch\) and text line height \(1/6)
78.292 360.944 Q
(inch\) for consistency between text and troff\255formatted documents.)
78.292 372.944 Q(For example:)78.292 384.944 Q(.DS B)56.692 408.944 Q
(.PS)56.692 420.944 Q(boxwid = 0.8)56.692 432.944 Q 7.2(#a)56.692
444.944 S(rrow approximation that looks acceptable in troff and nroff)
-7.2 E(define myarrow X A: [ move right 0.055;\\)56.692 456.944 Q
("<" ljust;line right \($1 \255 0.1\);">" rjust;\\)63.892 468.944 Q
(move right 0.045 ]\\)63.892 480.944 Q(X)56.692 492.944 Q
(User: box ht 0.333333 "User")56.692 504.944 Q
(FS: box ht 0.666667 "File" "System" with .n at User.s \2550, 0.333333)
56.692 516.944 Q
(Client: box ht 1.333333 wid 1.1 "Client\\\255" "SMTP" \\)56.692 528.944
Q(with .sw at FS.se +0.5, 0)63.892 540.944 Q
("SMTP client" rjust at Client.se \2550, 0.166667)56.692 552.944 Q
(move to User.e ; myarrow\(0.5\))56.692 564.944 Q
(move to FS.e ; myarrow\(0.5\))56.692 576.944 Q
(move to Client.e ; SMTP: myarrow\(1.8\))56.692 588.944 Q
(Server: box ht 1.333333 wid 1.1 "Server\\\255" "SMTP" \\)56.692 600.944
Q(with .sw at Here.x, Client.s.y)63.892 612.944 Q
(box invis ht 0.5 "SMTP" "Commands/Replies" with .s at SMTP.c)56.692
624.944 Q(box invis ht 0.25 "and Mail" with .n at SMTP.c)56.692 636.944
Q("SMTP server" ljust at Server.sw -0, 0.166667)56.692 648.944 Q
(move to Server.e.x, FS.e.y ; myarrow\(0.5\))56.692 660.944 Q
(FS2: box ht 0.666667 "File" "System" \\)56.692 672.944 Q
(with .sw at Server.se.x +0.5, FS.s.y)63.892 684.944 Q(.PE)56.692
696.944 Q(.DE)56.692 708.944 Q 126(Lilly Expires)56.692 768.944 R
(December 18, 2005)7.2 E([Page 23])104.4 E 0 Cg EP
%%Page: 24 24
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(The diagram looks like this:)41.782 108.944 Q .48 LW 99.382 156.92
41.782 156.92 DL 99.382 132.944 99.382 156.92 DL 41.782 132.944 99.382
132.944 DL 41.782 156.92 41.782 132.944 DL(User)56.182 147.608 Q 99.382
228.92 41.782 228.92 DL 99.382 180.896 99.382 228.92 DL 41.782 180.968
99.382 180.968 DL 41.782 228.992 41.782 180.968 DL(File)56.182 201.584 Q
(System)48.982 213.584 Q 214.582 228.92 135.382 228.92 DL 214.582
132.944 214.582 228.92 DL 135.382 132.944 214.582 132.944 DL 135.382
228.92 135.382 132.944 DL(Client\255)149.782 177.608 Q(SMTP)160.582
189.608 Q(SMTP client)135.382 243.584 Q(<)103.342 147.608 Q 132.142
144.968 103.342 144.968 DL(>)124.942 147.608 Q(<)103.342 207.584 Q
132.142 204.944 103.342 204.944 DL(>)124.942 207.584 Q(<)218.542 183.608
Q 340.942 180.968 218.542 180.968 DL(>)333.742 183.608 Q 423.382 228.92
344.182 228.92 DL 423.382 132.944 423.382 228.92 DL 344.182 132.944
423.382 132.944 DL 344.182 228.92 344.182 132.944 DL(Server\255)358.582
177.608 Q(SMTP)369.382 189.608 Q(SMTP)264.982 159.608 Q
(Commands/Replies)221.782 171.608 Q(and Mail)250.582 192.608 Q
(SMTP server)344.182 243.584 Q(<)427.342 207.584 Q 456.142 204.944
427.342 204.944 DL(>)448.942 207.584 Q 516.982 228.92 459.382 228.92 DL
516.982 180.896 516.982 228.92 DL 459.382 180.968 516.982 180.968 DL
459.382 228.992 459.382 180.968 DL(File)473.782 201.584 Q(System)466.582
213.584 Q
(Some versions of pic are able to approximate arrows well; others are)
41.782 264.944 Q 7.2(not. The)41.782 276.944 R
(example above emulates arrows with a mix of lines and text)7.2 E
(characters to work around poor approximations of pic arrows.)41.782
288.944 Q(Some)14.4 E
(implementations of pic generate output for multi\255line text labels)
41.782 300.944 Q
(which does not work well with some implementations of nroff.)41.782
312.944 Q(Authors)14.4 E
(who include graphs and diagrams should be aware of these issues; they)
41.782 324.944 Q
(can be safely ignored if no graphs or diagrams are included.)41.782
336.944 Q(A.3.5. Tables)20.182 360.944 Q
(Tables may be formatted using the tbl program [I4.CSTR49].)41.782
384.944 Q
(Horizontal rules produced in troff\255formatted documents take less)
41.782 396.944 Q
(vertical space than those formatted by nroff, throwing off page)41.782
408.944 Q(breaks unless special precautions are taken.)41.782 420.944 Q
(Consistent vertical)14.4 E
(space may be forced by using the following sequence of lines to)41.782
432.944 Q(produce full\255width horizontal rules:)41.782 444.944 Q
(.mk vP)20.182 468.944 Q(.if t .sp 0.33P)20.182 480.944 Q(_)20.182
492.944 Q(.if t .sp |\\n\(vPu+1P)20.182 504.944 Q
(Those lines perform the following steps to ensure consistency:)41.782
528.944 Q 14.4(1. Mark)41.782 552.944 R
(the current vertical place in register vP.)7.2 E 14.4(2. For)41.782
576.944 R
(troff \(but not nroff\), move down approximately one\255third of)7.2 E
7.2(at)77.782 588.944 S(ext line.)-7.2 E
(This approximately centers the horizontal rule in)14.4 E
(the vertical space in troff.)77.782 600.944 Q 14.4(3. Emit)41.782
624.944 R(the horizontal rule \(see [I4.CSTR49] for details\); an)7.2 E
(equals sign instead of an underscore produces a double rule.)77.782
636.944 Q 14.4(4. In)41.782 660.944 R
(troff, move to 1 text line below the previously\255marked)7.2 E
(vertical position.)77.782 672.944 Q
(This corresponds to the vertical position)14.4 E
(produced by nroff after a horizontal rule.)77.782 684.944 Q
(Different implementations of tbl produce slightly different output.)
41.782 708.944 Q
(For example, horizontal rules in text output are sometimes produced)
41.782 720.944 Q
(with a series of underscore characters; other implementations may use)
41.782 732.944 Q(dash \(hyphen\) characters.)41.782 744.944 Q
(While underscoring looks more attractive)14.4 E 126(Lilly Expires)
20.182 768.944 R(December 18, 2005)7.2 E([Page 24])104.4 E 0 Cg EP
%%Page: 25 25
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(in heading rules than hyphens, it can interact poorly with text when)
78.292 108.944 Q(used within a table.)78.292 120.944 Q
(Some implementations of tbl require extensions specific to a)78.292
144.944 Q(particular implementation of formatters.)78.292 156.944 Q
(A.3.6. ABNF)56.692 180.944 Q
(ABNF as described in [I18.RFC2234] can be difficult to format.)78.292
204.944 Q(ABNF)14.4 E
(could be formatted manually as one or more displays, or tbl could be)
78.292 216.944 Q(used to align related sets of ABNF rules.)78.292
228.944 Q(Both of those options)14.4 E
(require significant manual effort.)78.292 240.944 Q(Another option is \
to use a preprocessor that reads free\255form ABNF and)78.292 264.944 Q
(formats it for presentation.)78.292 276.944 Q 7.2(At)14.4 G
(ool is available to parse and format)-7.2 E(ABNF\255like grammar descr\
iptions \(it requires comments not associated)78.292 288.944 Q
(with any rule to begin without whitespace before the semicolon)78.292
300.944 Q
(\(unlike RFC 2234\) and does not require an old\255fashioned teletype)
78.292 312.944 Q("carriage return" control character before the end\255\
of\255line \(also)78.292 324.944 Q(unlike RFC 2234\)\).)78.292 336.944 Q
(ABNF is provided between macro lines AS and AE)14.4 E
(\(ABNF start and ABNF end\).)78.292 348.944 Q
(Within that ABNF section, another macro,)14.4 E(BC, is recognized.)
78.292 360.944 Q(It causes the current \(or subsequent\) rule to be)14.4
E(formatted with block comments, that is, the comments appear in a)
78.292 372.944 Q
(block to the right of the rule definition with running comment text)
78.292 384.944 Q
(formatted in a block approximately the same height as the ABNF)78.292
396.944 Q(definition.)78.292 408.944 Q(For example, the input:)78.292
432.944 Q(.AS 6 72 cgsntr)56.692 456.944 Q
(FWS = \( [ *WSP CRLF ] 1*WSP \) / obs-FWS)56.692 468.944 Q 7.2(;F)14.4
G(olding white space)-7.2 E(.BC)56.692 504.944 Q 7.2(ctext =)56.692
516.944 R(NO-WS-CTL /)21.6 E 7.2(;N)36 G(on white space controls.)-7.2 E
(%d33-39 /)229.492 528.944 Q 7.2(;T)50.4 G(he rest of the US-ASCII)-7.2
E(%d42-91 /)92.692 540.944 Q 14.4(;c)50.4 G
(haracters not including "\(",)-14.4 E 50.4(%d93-126 ;)229.492 552.944 R
("\)", or ")14.4 E 14.4(ccontent =)56.692 576.944 R
(ctext/quoted-pair/COMMENT)50.4 E 57.6(comment =)56.692 588.944 R
("\(" *\([FWS] ccontent\) [FWS] "\)")14.4 E
(CFWS=*\([FwS] comment\) \(\([fws] comment\) / fWs\))56.692 600.944 Q
(.AE)56.692 612.944 Q(produces formatted ABNF which looks like:)78.292
636.944 Q 28.8(CFWS =)99.892 660.944 R
(*\([FWS] comment\) \(\([FWS] comment\) / FWS\))7.2 E 7.2(comment =)
99.892 684.944 R("\(" *\([FWS] ccontent\) [FWS] "\)")7.2 E
(ccontent = ctext / quoted-pair / comment)99.892 708.944 Q 126
(Lilly Expires)56.692 768.944 R(December 18, 2005)7.2 E([Page 25])104.4
E 0 Cg EP
%%Page: 26 26
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 21.6(ctext =)63.382
108.944 R(NO-WS-CTL /)7.2 E 7.2(;N)57.6 G
(on white space controls. The rest)-7.2 E(%d33-39 / %d42-91)142.582
120.944 Q 7.2(;o)14.4 G 7.2(ft)-7.2 G(he US-ASCII characters not)-7.2 E
7.2(/%)142.582 132.944 S 57.6(d93-126 ;)-7.2 F
(including "\(", "\)", or ")7.2 E 36(FWS =)63.382 156.944 R
(\([*WSP CRLF] 1*WSP\) / obs-FWS ; Folding white space)7.2 E
(Each rule is placed in a separate display by the ABNF preprocessor so)
41.782 180.944 Q(that an ABNF rule won't be split across a page break.)
41.782 192.944 Q(Optional)14.4 E
(arguments to the AS macro are numbers \(not troff register references,)
41.782 204.944 Q 7.2(etc.\) which)41.782 216.944 R
(indicate the indent and line length in characters, and)7.2 E
(one\255character option flags which control processing:)41.782 228.944
Q 183.6(Flag Description)41.782 252.944 R .48 LW 531.382 261.904 41.782
261.904 DL(c)52.582 276.944 Q
(canonicalize case of character literals; type \(letter after '%'\))
70.582 276.944 Q
(is lower\255case, hexadecimal digit letters are upper\255case.)70.582
288.944 Q
(Rulename references use the same case as the defining ABNF line.)70.582
300.944 Q(d)52.582 312.944 Q
(omit display wrappers around output rules, instead separating)70.582
312.944 Q(rules with an empty line.)70.582 324.944 Q
(This may be useful if the entire ABNF)14.4 E
(is placed within a display wrapper.)70.582 336.944 Q(g)52.582 348.944 Q
(group concatenated elements in parentheses if in an alternation)70.582
348.944 Q(expression)70.582 360.944 Q(n)52.582 372.944 Q
(normalize repetition specifications: 0*1foo becomes [foo], M[foo)70.582
372.944 Q(bar] becomes *M\(foo bar\), etc.)70.582 384.944 Q(s)52.582
396.944 Q(Combine adjacent quoted strings into a single quoted string)
70.582 396.944 Q(where possible)70.582 408.944 Q(t)52.582 420.944 Q
(topologically sort rules in a ruleset so that productions are)70.582
420.944 Q(defined before use)70.582 432.944 Q(r)52.582 444.944 Q
(reverse the sense of topological sorting; use precedes)70.582 444.944 Q
(definition \(ineffective if the t flag is not specified\))70.582
456.944 Q(A.3.7. Client-Server Protocol Exchanges)20.182 480.944 Q
(Some documents illustrate client server exchanges such as:)41.782
504.944 Q(S: 220 foo.example.net)41.782 528.944 Q
(C: helo bar.example.com)41.782 552.944 Q(S: 250 blah blah blah)41.782
576.944 Q(C: quit)41.782 600.944 Q(S: 221 Go in peace)41.782 624.944 Q
(Depending on the specific protocol and how it is desired to be)41.782
648.944 Q
(formatted and grouped, displays, paragraphs, a list, or a table might)
41.782 660.944 Q(be used to format such an exchange.)41.782 672.944 Q
(The example above uses a single)14.4 E(indented display, specified as:)
41.782 684.944 Q 126(Lilly Expires)20.182 768.944 R(December 18, 2005)
7.2 E([Page 26])104.4 E 0 Cg EP
%%Page: 27 27
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E(.DS I)56.692 108.944 Q
(S: 220 foo.example.net)56.692 120.944 Q(C: helo bar.example.com)56.692
144.944 Q(S: 250 blah blah blah)56.692 168.944 Q(C: quit)56.692 192.944
Q(S: 221 Go in peace)56.692 216.944 Q(.DE)56.692 228.944 Q
(Here is the same example as a variable list:)78.292 252.944 Q 14.4
(S: 220)78.292 276.944 R(foo.example.net)7.2 E 14.4(C: helo)78.292
300.944 R(bar.example.com)7.2 E 14.4(S: 250)78.292 324.944 R
(blah blah blah)7.2 E 14.4(C: quit)78.292 348.944 R 14.4(S: 221)78.292
372.944 R(Go in peace)7.2 E
(Lists items are implemented as paragraphs, so formatting as)78.292
396.944 Q(paragraphs will look the same.)78.292 408.944 Q
(The list was specified as:)14.4 E(.VL)56.692 432.944 Q(.LI S:)56.692
444.944 Q(220 foo.example.net)56.692 456.944 Q(.LI C:)56.692 468.944 Q
(helo bar.example.com)56.692 480.944 Q(.LI S:)56.692 492.944 Q
(250 blah blah blah)56.692 504.944 Q(.LI C:)56.692 516.944 Q(quit)56.692
528.944 Q(.LI S:)56.692 540.944 Q(221 Go in peace)56.692 552.944 Q(.LE)
56.692 564.944 Q(Below is the same example formatted as a table:)78.292
588.944 Q -1.2(S: 220)78.292 612.944 R(foo.example.net)7.2 E -1.2
(C: helo)78.292 636.944 R(bar.example.com)7.2 E -1.2(S: 250)78.292
660.944 R(blah blah blah)7.2 E -1.2(C: quit)78.292 684.944 R -1.2
(S: 221)78.292 708.944 R(Go in peace)7.2 E(The table was specified by:)
78.292 732.944 Q 126(Lilly Expires)56.692 768.944 R(December 18, 2005)
7.2 E([Page 27])104.4 E 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E(.TS)20.182 108.944 Q
(tab \(~\);)20.182 120.944 Q(l1 l.)20.182 132.944 Q
(S:~220 foo.example.net)20.182 144.944 Q(C:~helo bar.example.com)20.182
168.944 Q(S:~250 blah blah blah)20.182 192.944 Q(C:~quit)20.182 216.944
Q(S:~221 Go in peace)20.182 240.944 Q(.TE)20.182 252.944 Q 20.182
276.944 EBEGIN
[/Title (A.4. Postprocessing) /Dest (SA.4) /OUT pdfmark
EEND 20.182 276.944 EBEGIN
[/Dest (SA.4) /Page 28 /View [ /FitH 552 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.4. Postprocessing)20.182 276.944 Q
(Scripts are available for use with the awk [I19.awk] interpreter for)
41.782 300.944 Q
(postprocessing of text and PostScript formatter output \(primarily to)
41.782 312.944 Q
(reorder pages so that the Table of Contents appears in the correct)
41.782 324.944 Q
(location, although the postprocessor for text also removes)41.782
336.944 Q 7.2(overstriking\). A)41.782 348.944 R
(sed [I20.sed] script is available to assist in)7.2 E
(preparation of HTML formatting.)41.782 360.944 Q 20.182 384.944 EBEGIN
[/Title (A.5. Proofreading and Checking Output) /Dest (SA.5) /OUT pdfmark
EEND 20.182 384.944 EBEGIN
[/Dest (SA.5) /Page 28 /View [ /FitH 444 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.5. Proofreading and Checking Output)20.182
384.944 Q(It is so easy to incorporate references that it is easy to)
41.782 408.944 Q
(unintentionally include a given reference more than once.)41.782
420.944 Q(While)14.4 E
(authors can generally be nonchalant about formatting of references,)
41.782 432.944 Q
(references should be proofread carefully to check for duplicates,)
41.782 444.944 Q
(references categorized as normative which should instead be)41.782
456.944 Q(informative or vice versa, etc.)41.782 468.944 Q
(Henrik Levkowetz' "idnits" program [I14.idnits] is useful for)41.782
492.944 Q
(catching diagrams and tables that exceed the maximum allowed line)
41.782 504.944 Q(length.)41.782 516.944 Q 20.182 540.944 EBEGIN
[/Title (Appendix B. Macros Specifically for the RFC Editor) /Dest (SB) /OUT pdfmark
EEND 20.182 540.944 EBEGIN
[/Dest (SB) /Page 28 /View [ /FitH 288 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix B. Macros Specifically for the RFC Editor)20.182 540.944 Q
(In addition to the NU, FN, UD, OB, IS, and CA macros discussed in the)
41.782 564.944 Q
(body of this memo, there are several macros intended for RFC Editor)
41.782 576.944 Q(\(rather than author\) use.)41.782 588.944 Q
(They are described in this Appendix.)14.4 E 20.182 612.944 EBEGIN
[/Title (B.1. IESG Notes) /Dest (SB.1) /OUT pdfmark
EEND 20.182 612.944 EBEGIN
[/Dest (SB.1) /Page 28 /View [ /FitH 216 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(B.1. IESG Notes)20.182 612.944 Q
(The IN macro takes a single numeric argument indicating the type of)
41.782 636.944 Q
(IESG note to be included; some types take a second argument:)41.782
648.944 Q 8.4(Type 2nd)41.782 672.944 R 165.6(Argument Text)7.2 F .48 LW
525.382 681.904 41.782 681.904 DL 22.8(1n)52.582 696.944 S(one)-22.8 E
(The IESG has not found any conflict between)194.182 696.944 Q
(this document and IETF work.)194.182 708.944 Q 126(Lilly Expires)20.182
768.944 R(December 18, 2005)7.2 E([Page 28])104.4 E 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 8.4(Type 2nd)78.292
108.944 R 165.6(Argument Text)7.2 F .48 LW 561.892 117.904 78.292
117.904 DL 22.8(2W)89.092 132.944 S(orking Group)-22.8 E
(The IESG thinks that this work is related to)230.692 132.944 Q
(IETF work done in WG Working Group, but this)230.692 144.944 Q
(does not prevent publishing.)230.692 156.944 Q 22.8(3W)89.092 168.944 S
(orking Group)-22.8 E(The IESG thinks that publication is harmful to)
230.692 168.944 Q(the IETF work done in WG Working Group and)230.692
180.944 Q(recommends not publishing the document at this)230.692 192.944
Q(time.)230.692 204.944 Q 22.8(4P)89.092 216.944 S(rocedure)-22.8 E
(The IESG thinks that this document violates)230.692 216.944 Q
(IETF procedures for Procedure and should)230.692 228.944 Q
(therefore not be published without IETF review)230.692 240.944 Q
(and IESG approval.)230.692 252.944 Q 22.8(5n)89.092 264.944 S(one)-22.8
E(The IESG thinks that this document extends an)230.692 264.944 Q
(IETF protocol in a way that requires IETF)230.692 276.944 Q
(review and should therefore not be published)230.692 288.944 Q
(without IETF review and IESG approval.)230.692 300.944 Q 22.8(6n)89.092
312.944 S(one)-22.8 E(The content of this RFC was at one time)230.692
312.944 Q(considered by the IETF, and therefore it may)230.692 324.944 Q
(resemble a current IETF work in progress or a)230.692 336.944 Q
(published IETF work.)230.692 348.944 Q(This RFC is not a)14.4 E
(candidate for any level of Internet Standard.)230.692 360.944 Q
(The IETF disclaims any knowledge of the)230.692 372.944 Q
(fitness of this RFC for any purpose and in)230.692 384.944 Q
(particular notes that the decision to publish)230.692 396.944 Q
(is not based on IETF review for such things as)230.692 408.944 Q
(security, congestion control, or inappropriate)230.692 420.944 Q
(interaction with deployed protocols.)230.692 432.944 Q(The RFC)14.4 E
(Editor has chosen to publish this document at)230.692 444.944 Q
(its discretion.)230.692 456.944 Q(Readers of this RFC should)14.4 E
(exercise caution in evaluating its value for)230.692 468.944 Q
(implementation and deployment.)230.692 480.944 Q(See RFC 3932)14.4 E
(for more information.)230.692 492.944 Q 22.8(7n)89.092 504.944 S(one)
-22.8 E(This RFC is not a candidate for any level of)230.692 504.944 Q
(Internet Standard.)230.692 516.944 Q(The IETF disclaims any)14.4 E
(knowledge of the fitness of this RFC for any)230.692 528.944 Q
(purpose and in particular notes that the)230.692 540.944 Q
(decision to publish is not based on IETF)230.692 552.944 Q
(review for such things as security, congestion)230.692 564.944 Q
(control, or inappropriate interaction with)230.692 576.944 Q
(deployed protocols.)230.692 588.944 Q(The RFC Editor has chosen)14.4 E
(to publish this document at its discretion.)230.692 600.944 Q
(Readers of this document should exercise)230.692 612.944 Q
(caution in evaluating its value for)230.692 624.944 Q
(implementation and deployment.)230.692 636.944 Q(See RFC 3932)14.4 E
(for more information.)230.692 648.944 Q 126(Lilly Expires)56.692
768.944 R(December 18, 2005)7.2 E([Page 29])104.4 E 0 Cg EP
%%Page: 30 30
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 8.4(Type 2nd)41.782
108.944 R 165.6(Argument Text)7.2 F .48 LW 525.382 117.904 41.782
117.904 DL 22.8(8n)52.582 132.944 S(one)-22.8 E
(This RFC is not a candidate for any level of)194.182 132.944 Q
(Internet Standard.)194.182 144.944 Q(The IETF disclaims any)14.4 E
(knowledge of the fitness of this RFC for any)194.182 156.944 Q
(purpose and notes that the decision to publish)194.182 168.944 Q
(is not based on IETF review apart from IESG)194.182 180.944 Q
(review for conflict with IETF work.)194.182 192.944 Q(The RFC)14.4 E
(Editor has chosen to publish this document at)194.182 204.944 Q
(its discretion.)194.182 216.944 Q(See RFC 3932 for more)14.4 E
(information.)194.182 228.944 Q
(If a type of 0 \(zero\) is specified, text after the IN macro line is)
41.782 252.944 Q 7.2(collected. The)41.782 264.944 R
(RFC Editor can use this feature to incorporate an)7.2 E
(IESG notice other then the ones prescribed in [N4.BCP78] as listed in)
41.782 276.944 Q(the table above.)41.782 288.944 Q
(The IN macro should be placed in the front matter \(before the first)
41.782 312.944 Q(SH or NH macro\).)41.782 324.944 Q
(The corresponding note will be formatted as an)14.4 E
(unnumbered section appearing before the Abstract.)41.782 336.944 Q
(If no IN macro)14.4 E
(call is placed in the front matter section, no IESG note will be)41.782
348.944 Q(included in the document.)41.782 360.944 Q 20.182 384.944
EBEGIN
[/Title (B.2. Alternate Document Type and Number) /Dest (SB.2) /OUT pdfmark
EEND 20.182 384.944 EBEGIN
[/Dest (SB.2) /Page 30 /View [ /FitH 444 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(B.2. Alternate Document Type and Number)20.182
384.944 Q(Some RFCs are also BCP, STD, or FYI documents.)41.782 408.944
Q(The RFC Editor may)14.4 E
(indicate such a document type and number via the AN macro.)41.782
420.944 Q(It takes)14.4 E
(two arguments; the type \(which must be one of BCP, STD, or FYI\) and)
41.782 432.944 Q(the number corresponding to that type.)41.782 444.944 Q
(The information is placed in)14.4 E
(the first page heading, properly formatted.)41.782 456.944 Q
(The AN macro should also)14.4 E(be placed in the front matter.)41.782
468.944 Q 20.182 492.944 EBEGIN
[/Title (Appendix C. Document Progression Using the rfc Macros) /Dest (SC.1) /OUT pdfmark
EEND 20.182 492.944 EBEGIN
[/Dest (SC.1) /Page 30 /View [ /FitH 336 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix C. Document Progression Using the rfc Macros)20.182 492.944 Q
20.182 516.944 EBEGIN
[/Title (C.1. Initial Internet-Draft) /Dest (SC.1) /OUT pdfmark
EEND 20.182 516.944 EBEGIN
[/Dest (SC.1) /Page 30 /View [ /FitH 312 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.1. Initial Internet-Draft)20.182 516.944 Q
(An initial draft using the rfc macros should specify a draft number)
41.782 540.944 Q
(version of 00 by supplying a \2551 argument to the NU macro or via)
41.782 552.944 Q(command\255line specification of register N.)41.782
564.944 Q(The latter may be)14.4 E
(accomplished by editing a line in the Makefile.)41.782 576.944 Q
(Document category)14.4 E
(\(CA macro\) can be ignored, or can be specified to indicate intended)
41.782 588.944 Q 7.2(status. The)41.782 600.944 R
(draft file name \(see [N3.ID]\) should be specified via)7.2 E
(the FN macro.)41.782 612.944 Q
(Long \(TL\) and short \(ST\) titles need to be specified,)14.4 E(as we\
ll as author\(s\) or editor\(s\) \(AU or ED macro\(s\)\) and Table of)
41.782 624.944 Q
(Contents parameters \(TC macro or command\255line register)41.782
636.944 Q 7.2(specifications\). An)41.782 648.944 R
(Abstract \(AB macro\) is required.)7.2 E(The remainder)14.4 E
(of the document is specified by defining sections, paragraphs, lists,)
41.782 660.944 Q
(and references, plus any diagrams or other non\255textual material.)
41.782 672.944 Q
(The document is then formatted and the text version submitted as an)
41.782 696.944 Q(Internet\255Draft [N3.ID].)41.782 708.944 Q
(During processing, the rfc macro package checks for certain types of)
41.782 732.944 Q(errors and issues warnings and other messages.)41.782
744.944 Q(If such a message)14.4 E 126(Lilly Expires)20.182 768.944 R
(December 18, 2005)7.2 E([Page 30])104.4 E 0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E
(appears, it is advisable to consider a revision to the document or)
78.292 108.944 Q(other appropriate action.)78.292 120.944 Q 56.692
144.944 EBEGIN
[/Title (C.2. Subsequent Draft Revisions) /Dest (SC.2) /OUT pdfmark
EEND 56.692 144.944 EBEGIN
[/Dest (SC.2) /Page 31 /View [ /FitH 684 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.2. Subsequent Draft Revisions)56.692 144.944 Q
(Each revision involves updating the argument to the NU macro or)78.292
168.944 Q(command\255line register N specification \(sequencing to \255\
2, then \2553,)78.292 180.944 Q
(etc.\) and making desired changes to the content.)78.292 192.944 Q
(Note that if the)14.4 E
(file name is changed, the numbering must be restarted at 00.)78.292
204.944 Q(If a)14.4 E
(Makefile is used, it too should be updated to reflect the revised)
78.292 216.944 Q(version numbering.)78.292 228.944 Q
(The document is reformatted and resubmitted as a revised Draft)78.292
252.944 Q([N3.ID].)78.292 264.944 Q 56.692 288.944 EBEGIN
[/Title (C.3. Publication as an RFC) /Dest (SC.3) /OUT pdfmark
EEND 56.692 288.944 EBEGIN
[/Dest (SC.3) /Page 31 /View [ /FitH 540 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.3. Publication as an RFC)56.692 288.944 Q
(The Abstract may be retained \(possibly edited\) or removed.)78.292
312.944 Q(Document)14.4 E
(category should be specified in consultation with the IETF or RFC)
78.292 324.944 Q 7.2(Editor. The)78.292 336.944 R
(document number should be left unspecified \(0 \(zero\))7.2 E(argument\
 to the NU macro or command\255line register N specification\);)78.292
348.944 Q
(the RFC Editor will assign an RFC number at the time of publication.)
78.292 360.944 Q
(The document is reformatted and sent to the RFC Editor.)78.292 372.944
Q(By prior)14.4 E
(arrangement with the RFC Editor, the document source can be sent, as)
78.292 384.944 Q(that may simplify final formatting by the RFC Editor.)
78.292 396.944 Q 56.692 420.944 EBEGIN
[/Title (Appendix D. Obtaining the rfc Macros and Related Tools) /Dest (SD) /OUT pdfmark
EEND 56.692 420.944 EBEGIN
[/Dest (SD) /Page 31 /View [ /FitH 408 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix D. Obtaining the rfc Macros and Related Tools)56.692 420.944 Q
(The rfc macros and related tools are currently available at)78.292
444.944 Q 7.2(http://users.erols.com/blilly/formatting. Individual)
78.292 456.944 R(files are:)7.2 E 289.2(File Description)78.292 480.944
R .48 LW 565.492 489.904 78.292 489.904 DL 177.6(tmac.rfc the)78.292
504.944 R(rfc macros)7.2 E(Makefile)78.292 516.944 Q 7.2(am)320.692
516.944 S(akefile used to automate)-7.2 E
(preprocessing, formatting, and)320.692 528.944 Q 7.2
(postprocessing. It)320.692 540.944 R(can be)7.2 E
(modified as needed for specific)320.692 552.944 Q(documents.)320.692
564.944 Q(repaginate.awk)78.292 576.944 Q(an awk script used for)320.692
576.944 Q(postprocessing text output.)320.692 588.944 Q(It)14.4 E
(reorders pages so that the Table)320.692 600.944 Q
(of Contents appears in the correct)320.692 612.944 Q(location.)320.692
624.944 Q(psrenumber.awk)78.292 636.944 Q
(an awk script for postprocessing)320.692 636.944 Q(PostScript output.)
320.692 648.944 Q(It reorders)14.4 E(pages so that the Table of)320.692
660.944 Q(Contents appears in the correct)320.692 672.944 Q(location.)
320.692 684.944 Q(htmlize.sed)78.292 696.944 Q 7.2(as)320.692 696.944 S
(ed script for HTML markup)-7.2 E(template.rfc)78.292 708.944 Q
(Template suitable as a draft)320.692 708.944 Q(starting point)320.692
720.944 Q(draft-lilly-using-troff\25505.rfc)78.292 732.944 Q
(the source for this document)320.692 732.944 Q 126(Lilly Expires)56.692
768.944 R(December 18, 2005)7.2 E([Page 31])104.4 E 0 Cg EP
%%Page: 32 32
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 289.2
(File Description)41.782 108.944 R .48 LW 528.982 117.904 41.782 117.904
DL(draft-lilly-using-troff\25505.txt)41.782 132.944 Q
(text output for this document)284.182 132.944 Q
(draft-lilly-using-troff\25505.ps)41.782 144.944 Q
(PostScript output for this)284.182 144.944 Q(document)284.182 156.944 Q
(draft-lilly-using-troff\25505.pdf)41.782 168.944 Q
(PDF output for this document)284.182 168.944 Q
(draft-lilly-using-troff\25505.psa4)41.782 180.944 Q
(PostScript output for this)284.182 180.944 Q
(document, formatted for ISO A4)284.182 192.944 Q(paper)284.182 204.944
Q(draft-lilly-using-troff\25505.pdfa4)41.782 216.944 Q
(PDF output for this document,)284.182 216.944 Q
(formatted for ISO A4 paper)284.182 228.944 Q
(draft-lilly-using-troff\25505.html)41.782 240.944 Q
(HTML 4.01 Strict compliant version)284.182 240.944 Q
(of this document preserving page)284.182 252.944 Q
(layout and numbering)284.182 264.944 Q
(There are also subdirectories containing source code and related)41.782
288.944 Q
(files for the ABNF formatter and reference formatter preprocessors.)
41.782 300.944 Q
(If the macros and related tools are deemed useful, it is hoped that)
41.782 324.944 Q(they might be relocated to the RFC Editor site.)41.782
336.944 Q 20.182 360.944 EBEGIN
[/Title (Appendix E. Summary of Directives) /Dest (SE) /OUT pdfmark
EEND 20.182 360.944 EBEGIN
[/Dest (SE) /Page 32 /View [ /FitH 468 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix E. Summary of Directives)20.182 360.944
Q(The following table summarizes rfc macro directives in alphabetical)
41.782 384.944 Q
(order \(macros specific to preprocessors and internal use macros are)
41.782 396.944 Q 7.2(omitted\). The)41.782 408.944 R
(section number containing detailed information about)7.2 E
(each macro is listed.)41.782 420.944 Q 10.8(Name Section)41.782 444.944
R(Description)147.6 E .48 LW 495.382 453.904 41.782 453.904 DL 18
(AB 5.3.1)48.982 468.944 R(Abstract)32.4 E 18(AN B.2)48.982 480.944 R
(Alternate document series number)46.8 E 18(AP 5.3.10 Appendix)48.982
492.944 R 18(AU 5.2.6)48.982 504.944 R(Author)32.4 E 18(BL 5.3.7.2)
48.982 516.944 R(Bullet list)18 E 18(CA 5.2.3)48.982 528.944 R
(Category or Intended status)32.4 E 18(DE 5.3.6)48.982 540.944 R
(Display end)32.4 E 18(DF 5.3.6)48.982 552.944 R(Floating display start)
32.4 E 18(DS 5.3.6)48.982 564.944 R(Display start)32.4 E 18(DT 5.2.7)
48.982 576.944 R(Date)32.4 E 18(ED 5.2.6)48.982 588.944 R(Editor)32.4 E
18(EM 5.4)48.982 600.944 R(End matter)46.8 E 18(FN 5.2.5)48.982 612.944
R(\(Internet-Draft\) file name \(w/o version\))32.4 E 18(IB 5.3.9)48.982
624.944 R(MIB \(or MIB\255like\) boilerplate)32.4 E 18(IE 5.3.8)48.982
636.944 R(Informative reference end)32.4 E 18(IN B.1)48.982 648.944 R
(IESG note)46.8 E 18(IP 5.3.3)48.982 660.944 R(Indented paragraph)32.4 E
18(IR 5.3.8)48.982 672.944 R(Informative reference start)32.4 E 18
(IS 5.2.9)48.982 684.944 R(Independent submission \(to RFC Editor\))32.4
E 18(KE 5.3.6)48.982 696.944 R(Keep end)32.4 E 18(KF 5.3.6)48.982
708.944 R(Floating keep start)32.4 E 18(KS 5.3.6)48.982 720.944 R
(Keep start)32.4 E 18(LE 5.3.7)48.982 732.944 R(List end)32.4 E 126
(Lilly Expires)20.182 768.944 R(December 18, 2005)7.2 E([Page 32])104.4
E 0 Cg EP
%%Page: 33 33
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I-Ds and RFCs using troff)7.2 E(June 2005)75.6 E 10.8(Name Section)
78.292 108.944 R(Description)147.6 E .48 LW 531.892 117.904 78.292
117.904 DL 18(LI 5.3.7)85.492 132.944 R(List item)32.4 E 18(LP 5.3.3)
85.492 144.944 R(Left\255aligned paragraph)32.4 E 18(NE 5.3.8)85.492
156.944 R(Normative reference end)32.4 E 18(NH 5.3.2)85.492 168.944 R
(Numbered section heading)32.4 E 18(NL 5.3.7.1)85.492 180.944 R
(Numbered list)18 E 18(NR 5.3.8)85.492 192.944 R
(Normative reference start)32.4 E 18(NS 5.3.5)85.492 204.944 R
(Needed \(vertical\) space)32.4 E 18(NU 5.2.2)85.492 216.944 R
(RFC number or draft version)32.4 E 18(OB 5.2.4)85.492 228.944 R
(Obsoleted RFCs)32.4 E 18(ON 5.2.10 Optional)85.492 240.944 R(notice)7.2
E 18(RE 5.3.4)85.492 252.944 R(Decrease indent)32.4 E 18(RS 5.3.4)85.492
264.944 R(Increase indent)32.4 E 18(SH 5.3.2)85.492 276.944 R
(\(unnumbered\) Section heading)32.4 E 18(ST 5.2.1)85.492 288.944 R
(Short title for page heading)32.4 E 18(TC 5.2.8)85.492 300.944 R
(Table of contents specification)32.4 E 18(TL 5.2.1)85.492 312.944 R
(\(Long\) document title)32.4 E 18(UP 5.2.4)85.492 324.944 R
(Updated RFCs)32.4 E 18(VL 5.3.7.3)85.492 336.944 R(Variable list)18 E
56.692 360.944 EBEGIN
[/Title (Appendix F. Source File Directive Order) /Dest (SF) /OUT pdfmark
EEND 56.692 360.944 EBEGIN
[/Dest (SF) /Page 33 /View [ /FitH 468 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix F. Source File Directive Order)56.692
360.944 Q
(Some directives appear in certain parts of a source document as)78.292
384.944 Q(summarized in the following diagram.)78.292 396.944 Q
(For content ordering, see)14.4 E([I13.Instruct].)78.292 408.944 Q 50.4
(Part Directives)99.892 432.944 R(Comments)129.6 E .48 LW 557.092
441.904 78.292 441.904 DL 557.092 443.904 78.292 443.904 DL 39.6(NU RFC)
215.092 456.944 R(or draft version number)7.2 E 39.6(TL \(long\))215.092
468.944 R(Title)7.2 E 39.6(ST Short)215.092 480.944 R(title)7.2 E 39.6
(DT Date)215.092 492.944 R(override)7.2 E 39.6(AU Author)215.092 504.944
R 39.6(ED Editor)215.092 516.944 R 39.6(FN Internet\255Draft)215.092
528.944 R(file name)7.2 E 39.6(TC Table)215.092 540.944 R
(of contents parameters)7.2 E 39.6(CA category)215.092 552.944 R
(or Intended status)7.2 E 39.6(IS Independent)215.092 564.944 R
(submission)7.2 E 39.6(IN IESG)215.092 576.944 R(note)7.2 E 39.6
(ON Optional)215.092 588.944 R(notice)7.2 E 39.6(AN Alternate)215.092
600.944 R(series number)7.2 E 39.6(UP Updated)215.092 612.944 R(RFCs)7.2
E 39.6(OB Obsoleted)215.092 624.944 R(RFCs)7.2 E(Front)81.892 504.944 Q
(Matter)81.892 516.944 Q(\(before)81.892 528.944 Q(Abstract)81.892
540.944 Q(and first)81.892 552.944 Q(section)81.892 564.944 Q(heading\))
81.892 576.944 Q 557.092 633.904 78.292 633.904 DL 39.6(AB \(required)
215.092 648.944 R(for Internet\255Draft\))7.2 E 39.6(IP \(additional)
215.092 660.944 R(Abstract paragraphs\))7.2 E(Abs