%!PS-Adobe-3.0
%%Creator: groff version 1.19.1
%%CreationDate: Wed May 11 10:34:20 2005
%%DocumentNeededResources: font Courier
%%+ font Times-Italic
%%+ font Symbol
%%DocumentSuppliedResources: procset grops 1.19 1
%%Pages: 39
%%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 352.8(Internet\255Draft May)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: November 6, 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\25504)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 129.6(Lilly Expires)
56.692 768.944 R(November 6, 2005)7.2 E([Page 1])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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(8)14.4 E
(5.4. End Matter................................................ 14)
63.382 276.944 Q
(6. Acknowledgments................................................ 15)
41.782 288.944 Q
(7. Security Considerations........................................ 15)
41.782 300.944 Q
(8. Internationalization Considerations............................ 15)
41.782 312.944 Q
(9. IANA Considerations............................................ 15)
41.782 324.944 Q
(Appendix A. Esoterica............................................. 15)
41.782 336.944 Q
(A.1. Troff vs. Nroff........................................... 15)
63.382 348.944 Q
(A.2. Output Adjustments........................................ 17)
63.382 360.944 Q
(A.3. Tips and Tricks........................................... 18)
63.382 372.944 Q
(A.4. Postprocessing............................................ 27)
63.382 384.944 Q
(A.5. Proofreading and Checking Output.......................... 27)
63.382 396.944 Q
(Appendix B. Macros Specifically for the RFC Editor................ 27)
41.782 408.944 Q
(B.1. IESG Notes................................................ 27)
63.382 420.944 Q
(B.2. Alternate Document Type and Number........................ 29)
63.382 432.944 Q
(Appendix C. Document Progression Using the rfc Macros............. 29)
41.782 444.944 Q
(C.1. Initial Internet-Draft.................................... 29)
63.382 456.944 Q
(C.2. Subsequent Draft Revisions................................ 30)
63.382 468.944 Q
(C.3. Publication as an RFC..................................... 30)
63.382 480.944 Q
(Appendix D. Obtaining the rfc Macros and Related Tools............ 30)
41.782 492.944 Q
(Appendix E. Summary of Directives................................. 31)
41.782 504.944 Q
(Appendix F. Source File Directive Order........................... 32)
41.782 516.944 Q
(Appendix G. Disclaimers........................................... 33)
41.782 528.944 Q
(Appendix H. Change History........................................ 34)
41.782 540.944 Q
(Normative References.............................................. 36)
41.782 552.944 Q
(Informative References............................................ 37)
41.782 564.944 Q
(Author's Address.................................................. 38)
41.782 576.944 Q 129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)
7.2 E([Page 2])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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 129.6
(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 3])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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 129.6(Lilly Expires)20.182 768.944 R
(November 6, 2005)7.2 E([Page 4])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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 Com\
ments 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. Note)78.292 732.944 R
(also that a backslash character appears before the)7.2 E
(hyphen; that causes the hyphen to be interpreted as a normal text)
78.292 744.944 Q 129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)
7.2 E([Page 5])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(hyphen rather than as an indication of a possible hyphenation)41.782
108.944 Q(\(line\255breaking\) point.)41.782 120.944 Q
(The backslash at the end of the first line)14.4 E(escapes the end\255o\
f\255line, allowing the line to effectively continue)41.782 132.944 Q
(with the contents of the second line.)41.782 144.944 Q
(Escape sequences are discussed)14.4 E(in detail in [I1.CSTR54].)41.782
156.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 168.944 Q 7.2(headings. For)41.782 180.944 R
(this document, that was specified as:)7.2 E
(.ST "Writing I\\\255Ds and RFCs using troff)20.182 204.944 Q
(5.2.2. RFC or Draft Version Number)20.182 228.944 Q
(RFCs have an RFC number assigned by the RFC Editor; Internet\255Drafts)
41.782 252.944 Q(have a version number.)41.782 264.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 276.944 Q
(Appendix A: a negative number is interpreted as an incremental)41.782
288.944 Q(version number for a draft; \2551 for draft version \25500, \
\2552 for draft)41.782 300.944 Q(version \25501, etc.)41.782 312.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 324.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
336.944 Q(appear.)41.782 348.944 Q(5.2.3. Document Category \(RFCs\))
20.182 372.944 Q
(RFCs have a category; one of Experimental, Informational, Standards)
41.782 396.944 Q(Track, or Best Current Practice [I11.BCP9].)41.782
408.944 Q(The category is)14.4 E
(specified as the argument to the CA macro; that macro directive need)
41.782 420.944 Q
(only be supplied for RFCs \(if supplied in drafts it shows as Intended)
41.782 432.944 Q(status in the first page heading\) [N3.ID].)41.782
444.944 Q(5.2.4. Updated and Obsoleted RFCs)20.182 468.944 Q
(Some RFCs update or obsolete earlier RFCs.)41.782 492.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 504.944 Q(the argument to an UP macro.)41.782 516.944 Q
(Similarly, an obsoleted RFC is)14.4 E
(indicated by an argument to an OB macro.)41.782 528.944 Q
(Multiple UP and OB macros)14.4 E
(may be used to indicate that multiple RFCs are updated or obsoleted.)
41.782 540.944 Q(5.2.5. Internet-Draft File Name)20.182 564.944 Q
(An Internet\255Draft has a file name used for retrieval; the base file)
41.782 588.944 Q
(name \(without the trailing hyphen and version number suffix\) is)
41.782 600.944 Q
(specified as the argument to the FN macro; the FN macro is not)41.782
612.944 Q(necessary \(is ignored\) for RFCs.)41.782 624.944 Q
(The file name may contain only)14.4 E
(lower\255case letters, digits, and hyphens [N3.ID].)41.782 636.944 Q
(5.2.6. Authors or Editors)20.182 660.944 Q
(An Internet\255Draft or RFC may have up to five authors specified.)
41.782 684.944 Q
(Information for each author may be specified via the AU macro.)41.782
696.944 Q(The)14.4 E(macro takes 9 arguments:)41.782 708.944 Q 129.6
(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 6])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 176.4
(Argument Description)78.292 108.944 R .48 LW 564.292 117.904 78.292
117.904 DL(1)103.492 132.944 Q
(First initial and surname for first page heading)153.892 132.944 Q(2)
103.492 144.944 Q
(First name and/or initials for Author's Address section)153.892 144.944
Q(3)103.492 156.944 Q
(Surname for page footer and Author's Address section)153.892 156.944 Q
(4)103.492 168.944 Q
(Gender; one of m \(male\), f \(female\), or o \(other or)153.892
168.944 Q(indeterminate\))153.892 180.944 Q 43.2(5I)103.492 192.944 S
(nternet mailbox)-43.2 E 43.2(6T)103.492 204.944 S(elephone Number)-43.2
E 43.2(7F)103.492 216.944 S(ax Number)-43.2 E 43.2(8U)103.492 228.944 S
(RL)-43.2 E 43.2(9A)103.492 240.944 S(ffiliation)-43.2 E
(The author's gender is used to customize boilerplate verbiage to)78.292
264.944 Q
(accommodate enforcers of political correctness, at least until)78.292
276.944 Q
(individual male or female authors are prohibited from submitting)78.292
288.944 Q(Internet-Drafts with sensible boilerplate.)78.292 300.944 Q
(Arguments containing)14.4 E
(space characters must be enclosed in double quotes.)78.292 312.944 Q
(Arguments that)14.4 E
(are not used must have an empty double quoted string or other)78.292
324.944 Q(zero\255width argument as a placeholder.)78.292 336.944 Q
(Optional text following the AU)14.4 E
(macro line is collected verbatim \(without flowing into a paragraph\))
78.292 348.944 Q(as the postal address for the author.)78.292 360.944 Q
(Similar information can be)14.4 E
(provided for additional authors by additional AU macro calls.)78.292
372.944 Q
(Some documents, notably those produced by IETF Working Groups, are)
78.292 396.944 Q(prepared by a Document Editor [I12.BCP25].)78.292
408.944 Q(To distinguish an Editor)14.4 E
(from an Author, use the ED macro instead of the AU macro.)78.292
420.944 Q(There may)14.4 E
(be multiple Editors, but one cannot have a mix of Authors and Editors)
78.292 432.944 Q
(\(if one is specified as an Editor, all are treated as Editors\).)
78.292 444.944 Q(5.2.7. Date)56.692 468.944 Q
(The date used for the document heading is normally the current date)
78.292 492.944 Q(when formatted.)78.292 504.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 516.944 Q
(respectively\), or the values may be specified via command\255line)
78.292 528.944 Q(arguments as described in Appendix A.)78.292 540.944 Q
(5.2.8. Section Headings and the Table of Contents)56.692 564.944 Q
(An RFC or Internet\255Draft may contain numbered sections.)78.292
588.944 Q(Sections may)14.4 E
(have subsections, and the section level represents the number of)78.292
600.944 Q(dot\255separated levels.)78.292 612.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 624.944 Q
(As sections are)14.4 E
(specified, the rfc macro package collects information for a Table of)
78.292 636.944 Q 7.2(Contents. The)78.292 648.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)
78.292 660.944 Q
(the table\), and the second argument specifies the maximum section)
78.292 672.944 Q(level to include in the Table of Contents entries.)
78.292 684.944 Q
(These parameters may alternatively be specified via command\255line)
78.292 708.944 Q 7.2(arguments. See)78.292 720.944 R
(Appendix A for details.)7.2 E 129.6(Lilly Expires)56.692 768.944 R
(November 6, 2005)7.2 E([Page 7])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(5.2.9. Independent vs. IETF Submissions)20.182 108.944 Q
(Internet\255Drafts and RFCs may be products of IETF Working Groups or)
41.782 132.944 Q
(other IETF entities, or they may be independent submissions.)41.782
144.944 Q(The)14.4 E
(macro IS is used to identify independent submissions, as there is a)
41.782 156.944 Q
(slight difference in the boilerplate text which accompanies them.)
41.782 168.944 Q(The IS macro takes no arguments.)41.782 180.944 Q
(Unfortunately, the IETF Secretariat rejects independent)41.782 204.944
Q(Internet\255Draft submissions that have the independent submission)
41.782 216.944 Q
(boilerplate required by the RFC Editor [I13.Instruct] \(bottom of page)
41.782 228.944 Q
(33\), probably because it is not recognized by Henrik Levkowetz')41.782
240.944 Q("idnits" program [I14.idnits].)41.782 252.944 Q
(Therefore, until the IETF Secretariat)14.4 E
(and the RFC Editor resolve their differences the IS macro SHOULD NOT)
41.782 264.944 Q(be used except by the RFC Editor.)41.782 276.944 Q
(5.2.10. Optional Notices)20.182 300.944 Q
(Certain optional notices may be placed at the front of)41.782 324.944 Q
7.2(Internet\255Drafts. The)41.782 336.944 R
(ON macro is used to specify one of the)7.2 E
(following notices via a numeric argument:)41.782 348.944 Q 216
(Type Text)41.782 372.944 R .48 LW 527.782 381.904 41.782 381.904 DL(1)
52.582 396.944 Q
(This document may not be modified, and derivative works of it)88.582
396.944 Q(may not be created.)88.582 408.944 Q
(This document may only be posted in an)14.4 E(Internet\255Draft.)88.582
420.944 Q(2)52.582 432.944 Q
(This document may not be modified, and derivative works of it)88.582
432.944 Q(may not be created, except to publish it as an RFC and to)
88.582 444.944 Q(translate it into languages other than English.)88.582
456.944 Q
(If a second argument is given to the ON macro, it is interpreted as)
41.782 480.944 Q(the number of a section that may be extracted.)41.782
492.944 Q(The text is modified)14.4 E(to reflect that.)41.782 504.944 Q
(For example:)14.4 E(.ON 1 1.2.3)20.182 528.944 Q(produces the text:)
41.782 552.944 Q
(This document may not be modified, and derivative works of it may not)
41.782 576.944 Q
(be created other than to extract section 1.2.3 as\255is for separate)
41.782 588.944 Q 7.2(use. This)41.782 600.944 R
(document may only be posted in an Internet\255Draft.)7.2 E 20.182
624.944 EBEGIN
[/Title (5.3. Document Content) /Dest (S5.3.) /OUT pdfmark
EEND 20.182 624.944 EBEGIN
[/Dest (S5.3.) /Page 8 /View [ /FitH 204 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.3. Document Content)20.182 624.944 Q
(Having specified preliminary information as described above, the)41.782
648.944 Q(document content may be specified.)41.782 660.944 Q
(5.3.1. Abstract)20.182 696.944 Q
(The first item that an author might want to provide is the Abstract)
41.782 720.944 Q(for the document.)41.782 732.944 Q
(It is initiated with the AB macro, which takes no)14.4 E 7.2
(arguments. It)41.782 744.944 R
(collects text until the next macro directive into a)7.2 E 129.6
(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 8])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(paragraph for the document abstract.)78.292 108.944 Q
(An abstract is required for an)14.4 E
(Internet\255Draft; it is optional for an RFC.)78.292 120.944 Q
(5.3.2. Numbered and Unnumbered Sections)56.692 144.944 Q
(Additional document content is usually organized into sections.)78.292
168.944 Q(There are two types of sections: numbered and unnumbered.)
78.292 180.944 Q(For the)14.4 E
(purpose of collecting headings for the Table of Contents, unnumbered)
78.292 192.944 Q
(sections have a section "level" even though no number appears.)78.292
204.944 Q(A)14.4 E
(section is initiated with an SH macro for unnumbered sections, or an)
78.292 216.944 Q(NH macro for numbered sections.)78.292 228.944 Q
(Each macro takes two arguments: the)14.4 E
(section level and the section heading text.)78.292 240.944 Q
(Numbering for numbered)14.4 E(sections is computed automatically.)
78.292 252.944 Q(5.3.3. Paragraphs)56.692 276.944 Q
(Within sections, text is organized into paragraphs.)78.292 300.944 Q
(RFCs and)14.4 E(Internet\255Drafts usually use indented block paragrap\
hs like this one;)78.292 312.944 Q
(these are introduced with the IP macro.)78.292 324.944 Q
(That macro can take two)14.4 E
(optional arguments: initial unindented text and an indent distance.)
78.292 336.944 Q
(The defaults are no unindented text and an indent distance of 3)78.292
348.944 Q(character spaces \(0.3 inch\).)78.292 360.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 372.944 Q
(distance, be specified in multiples of 0.1 inch so that nroff\255 and)
78.292 384.944 Q(troff\255formatted versions of documents maintain the \
same line and page)78.292 396.944 Q(breaks.)78.292 408.944 Q
(Unindented paragraphs are possible via the LP macro.)78.292 432.944 Q
(5.3.4. Special Indentation)56.692 456.944 Q
(Indentation may be controlled with RS and RE macros.)78.292 480.944 Q
(The RS macro)14.4 E
(will increase the indent level by the paragraph indentation increment)
78.292 492.944 Q
(of 3 character spaces, while the RE macro will reduce indentation by)
78.292 504.944 Q(that amount.)78.292 516.944 Q
(5.3.5. Reserving Vertical Space)56.692 540.944 Q
(Sometimes it is necessary to ensure that there is sufficient vertical)
78.292 564.944 Q
(space before the bottom of the current page for some complex output)
78.292 576.944 Q
(that cannot easily be handled with a keep or display \(see below\).)
78.292 588.944 Q
(The NS macro takes one argument specifying the number of text lines)
78.292 600.944 Q 7.2(needed. If)78.292 612.944 R
(fewer lines remain on the current page, output will)7.2 E
(continue at the top of the next page.)78.292 624.944 Q
(5.3.6. Keeps and Displays)56.692 648.944 Q
(Sometimes one has lines of text or non\255textual content which one)
78.292 672.944 Q
(would like to appear as a group, uninterrupted by page breaks.)78.292
684.944 Q(Such)14.4 E 7.2(ag)78.292 696.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.)78.292 708.944 Q
(Keeps are)14.4 E
(typically used to fine\255tune formatting; they are rarely required.)
78.292 720.944 Q 129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)
7.2 E([Page 9])115.2 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(Keeps will not work with multiple paragraphs \(or list items\) between)
41.782 108.944 Q(KS and KE directives.)41.782 120.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 132.944 Q(the NS macro directive to reserve space.)41.782 144.944
Q(More complex groupings can be obtained by "displays".)41.782 168.944 Q
(Displays are)14.4 E(started like keeps, using the DS macro.)41.782
180.944 Q(Display content is not)14.4 E
(filled into paragraphs; output appears like the input lines except)
41.782 192.944 Q(for indentation.)41.782 204.944 Q
(The DS macro takes an argument consisting of a)14.4 E
(single letter which identifies the type of display:)41.782 216.944 Q
186(Type Description)41.782 240.944 R .48 LW 530.182 249.904 41.782
249.904 DL(C)52.582 264.944 Q(Each line of text is centered)76.582
264.944 Q(B)52.582 276.944 Q
(The input lines are read as a block, and the block is centered)76.582
276.944 Q(L)52.582 288.944 Q(The display is left\255aligned)76.582
288.944 Q(I)52.582 300.944 Q
(The display is indented by the amount indicated by an optional)76.582
300.944 Q(second argument \(default is 3 character spaces\))76.582
312.944 Q(Displays are typically used for block quoted material and for)
41.782 336.944 Q(preventing page breaks within non\255textual material \
such as tables and)41.782 348.944 Q 7.2(diagrams. For)41.782 360.944 R
(example, the input:)7.2 E(.DS C)20.182 384.944 Q(War is Peace)20.182
396.944 Q(Freedom is Slavery)20.182 408.944 Q(Ignorance is Strength)
20.182 420.944 Q(.\\" Eric Arthur Blair, a.k.a. George Orwell)20.182
432.944 Q(.DE)20.182 444.944 Q
(produces output in which each line is centered:)41.782 468.944 Q
(War is Peace)236.182 492.944 Q(Freedom is Slavery)214.582 504.944 Q
(Ignorance is Strength)203.782 516.944 Q(whereas the input:)41.782
540.944 Q(.DS B)20.182 564.944 Q(War can still settle problems,)20.182
576.944 Q
(but it can only settle them the wrong way. \\" Bertrand Russell)20.182
588.944 Q(.DE)20.182 600.944 Q
(produces the text lines as a centered block:)41.782 624.944 Q
(War can still settle problems,)128.182 648.944 Q
(but it can only settle them the wrong way.)128.182 660.944 Q
(Sometimes placement of a display, such as one containing a diagram,)
41.782 684.944 Q(is not critical.)41.782 696.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)
41.782 708.944 Q(it if it will not fit on the current output page.)
41.782 720.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)41.782
732.944 Q(ending with a DE macro call.)41.782 744.944 Q
(Floating displays are output before the)14.4 E 129.6(Lilly Expires)
20.182 768.944 R(November 6, 2005)7.2 E([Page 10])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(end of the section and subsection in which they are defined in the)
78.292 108.944 Q
(input, so they cannot appear in the wrong section of the formatted)
78.292 120.944 Q(document.)78.292 132.944 Q
(Text following a display or keep should be organized as a paragraph,)
78.292 156.944 Q
(to ensure that the text appears where expected on output and so that)
78.292 168.944 Q
(page breaks can be adjusted to prevent widows and orphans.)78.292
180.944 Q(5.3.7. Lists)56.692 204.944 Q(5.3.7.1. Numbered Lists)56.692
228.944 Q(The NL macro initializes a numbered list.)78.292 252.944 Q
(It takes three optional)14.4 E(arguments:)78.292 264.944 Q 14.4(1. a)
78.292 288.944 R(prefix string.)7.2 E
(The default is an empty string \(no prefix\).)14.4 E 14.4(2. a)78.292
312.944 R(one\255character numbering format; one of)7.2 E 28.8(1n)99.892
336.944 S(umber using Arabic numerals \(the default\))-28.8 E 28.8(In)
99.892 360.944 S
(umber using Roman numbers expressed as upper\255case letters)-28.8 E
28.8(in)99.892 384.944 S
(umber using Roman numbers expressed as lower\255case letters)-28.8 E
28.8(Al)99.892 408.944 S(etter with upper\255case letters)-28.8 E 28.8
(al)99.892 432.944 S(etter with lower\255case letters)-28.8 E 14.4(3. a)
78.292 456.944 R(suffix string.)7.2 E(The default is a period.)14.4 E
(Each list item after the initialization is introduced by the LI \(list)
78.292 480.944 Q(item\) macro.)78.292 492.944 Q
(Text following the LI macro line is processed as an)14.4 E
(indented paragraph with the first line numbered.)78.292 504.944 Q
(The most recently started list is terminated with the LE \(list end\))
78.292 528.944 Q(macro.)78.292 540.944 Q
(Lists may be nested up to 9 levels deep.)78.292 564.944 Q
(Each level of nesting is)14.4 E
(indented by the paragraph indent value \(3 characters\).)78.292 576.944
Q(The list)14.4 E
(above has a variable list \(see description below\) inside a numbered)
78.292 588.944 Q(list.)78.292 600.944 Q(5.3.7.2. Bulleted Lists)56.692
624.944 Q 7.2(Ab)78.292 648.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.)78.292
660.944 Q(The input lines:)78.292 684.944 Q 129.6(Lilly Expires)56.692
768.944 R(November 6, 2005)7.2 E([Page 11])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.BL)20.182 108.944 Q
(.LI)20.182 120.944 Q(first bulleted item)20.182 132.944 Q(.LI)20.182
144.944 Q(second)20.182 156.944 Q(bulleted item)20.182 168.944 Q(.LE)
20.182 180.944 Q(produce the output:)41.782 204.944 Q 16.8<8366>41.782
228.944 S(irst bulleted item)-16.8 E 16.8<8373>41.782 252.944 S
(econd bulleted item)-16.8 E
(The BL macro will accept an optional argument, which is treated as a)
41.782 276.944 Q
(string to use in place of the default bullet character.)41.782 288.944
Q(5.3.7.3. Variable Lists)20.182 312.944 Q
(The VL macro initializes a variable list.)41.782 336.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 348.944 Q(The LE macro terminates a variable list.)41.782 360.944
Q(5.3.8. References)20.182 384.944 Q
(Internet\255Drafts and RFCs contain two types of references: normative)
41.782 408.944 Q(references and informative references.)41.782 420.944 Q
(Citations for the reference)14.4 E
(material appear near the end of the document and are indicated by a)
41.782 432.944 Q
(bracketed tag within the document text like this: [N1.RFC2223].)41.782
444.944 Q
(Macros are provided to automatically number and format normative and)
41.782 456.944 Q
(informative references in the style used in this document.)41.782
468.944 Q(The)14.4 E
(reference tags consist of the letter N \(for normative references\) or)
41.782 480.944 Q 7.2(I\()41.782 492.944 S
(for informative references\), followed by a sequential number)-7.2 E
(within each series, optionally followed by a dot and a string)41.782
504.944 Q
(supplied as an argument to the NR macro for normative references, IR)
41.782 516.944 Q(for informative references.)41.782 528.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)41.782
540.944 Q
(argument must be 2 characters suitable as the name of a string.)41.782
552.944 Q
(Internal string names used by the rfc macro package always begin with)
41.782 564.944 Q(an upper\255case letter; it is generally safe to use a\
 two\255character)41.782 576.944 Q
(name that begins with a lower\255case letter which is followed by an)
41.782 588.944 Q(upper\255case letter or a digit \(troff internally has\
 some strings which)41.782 600.944 Q
(are named with two lower\255case letters\).)41.782 612.944 Q
(The first normative)14.4 E
(reference in this document could have been specified by the lines:)
41.782 624.944 Q(.NR RFC2223 r1)20.182 648.944 Q
(Postel, J. and J. Reynolds, "Instructions to RFC Authors", RFC\\ 2223,)
20.182 660.944 Q(October 1997.)20.182 672.944 Q(.NE)20.182 684.944 Q
(For references to RFCs, one can simply copy and paste the text made)
41.782 708.944 Q(available by the RFC Editor in the file rfc\255ref.txt\
, as has been done)41.782 720.944 Q
(in this example \(the actual reference text was on a single input)
41.782 732.944 Q
(line, though that is not required, and the backslash preceding the)
41.782 744.944 Q 129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)
7.2 E([Page 12])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(space after "RFC" prevents lines being broken at that space, i.e.)
78.292 108.944 Q(within the RFC document number\).)78.292 120.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 132.944 Q
(Normative References or Informative References section of the)78.292
144.944 Q(generated document.)78.292 156.944 Q
(The reference text is ended with an NE or IE)14.4 E(macro.)78.292
168.944 Q
(The bracketed reference string appears in the text at the place where)
78.292 192.944 Q
(the NR/NE or IR/IE macros are placed, while the actual reference)78.292
204.944 Q
(citation text is saved for output in unnumbered Normative References)
78.292 216.944 Q(and Informative References sections.)78.292 228.944 Q
(No space appears after the)14.4 E
(bracketed reference, so a list of such references may appear with)
78.292 240.944 Q
(comma separators by simply placing a line containing a comma between)
78.292 252.944 Q(reference macro groups.)78.292 264.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 276.944 Q(provided in the input after the NE or IE macro line.)
78.292 288.944 Q(However, a line)14.4 E
(beginning with a dot is normally interpreted as a directive; to)78.292
300.944 Q
(prevent that, the line should begin with the two character sequence)
78.292 312.944 Q(\\& preceding the period.)78.292 324.944 Q
(That sequence represents a zero\255width)14.4 E
(non\255printing space which prevents interpretation of the line as a)
78.292 336.944 Q
(directive without affecting the appearance of the output.)78.292
348.944 Q
(The reference tag \(including the brackets\) generated by the example)
78.292 372.944 Q
(above is saved in the troff string named r1, which can be used to)
78.292 384.944 Q(refer to the same reference.)78.292 396.944 Q
(That reference tag can be made to)14.4 E
(subsequently appear in the document text via a reference to the saved)
78.292 408.944 Q(troff string, viz. the character sequence \\*\(r1.)
78.292 420.944 Q
(References to RFCs by number or via numeric reference to the)78.292
444.944 Q
(corresponding BCP, STD, or FYI series number can be generated by)78.292
456.944 Q(using the rfcref preprocessor.)78.292 468.944 Q
(That preprocessor takes input like:)14.4 E(.RR N 2223 r1)56.692 492.944
Q(and generates the corresponding reference text and NR/NE or IR/IE)
78.292 516.944 Q(macro directives.)78.292 528.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)
78.292 540.944 Q(is no end\255of\255reference directive.)78.292 552.944
Q(Four preprocessor directives are recognized:)78.292 576.944 Q 10.8
(Directive Document)78.292 600.944 R(Series)7.2 E .48 LW 269.092 609.904
78.292 609.904 DL 79.2(BR BCP)103.492 624.944 R 79.2(FR FYI)103.492
636.944 R 79.2(SR STD)103.492 648.944 R 79.2(RR RFC)103.492 660.944 R
(Each directive takes two or three arguments:)78.292 684.944 Q 14.4
(1. a)78.292 708.944 R
(single letter, I or N, to indicate an informative or normative)7.2 E
(reference, respectively)114.292 720.944 Q 14.4(2. the)78.292 744.944 R
(document series number)7.2 E 129.6(Lilly Expires)56.692 768.944 R
(November 6, 2005)7.2 E([Page 13])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 14.4
(3. \(optional\))41.782 108.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 132.944 Q
(some STD document series numbers are either reserved for future use)
41.782 144.944 Q(or are no longer in use.)41.782 156.944 Q
(The rfcref preprocessor also checks whether documents have been)41.782
180.944 Q(updated or obsoleted, and issues suitable warnings.)41.782
192.944 Q(5.3.9. MIB modules, etc.)20.182 216.944 Q
(When a MIB module or similar entity is defined and there is a)41.782
240.944 Q(limitation notice \(via the ON macro\), there may need to be \
a separate)41.782 252.944 Q
(copyright notice placed in the part to be extracted per [N4.BCP78].)
41.782 264.944 Q
(The IB macro may be called at the appropriate section to generate the)
41.782 276.944 Q(properly\255formatted boilerplate text.)41.782 288.944
Q(The mandatory first argument to)14.4 E
(the IB macro selects the type of statement from the ones permitted by)
41.782 300.944 Q
([N4.BCP78], and the optional second argument permits specifying)41.782
312.944 Q(something other than "MIB module".)41.782 324.944 Q
(An optional third argument may be)14.4 E
(used to specify a prefix to the statement, an optional fourth)41.782
336.944 Q
(argument may be used to specify an indent other than paragraph)41.782
348.944 Q
(indent, and an optional fifth argument may be used for a suffix.)41.782
360.944 Q(Unused arguments may be specified as empty strings or other)
41.782 372.944 Q(zero\255width items.)41.782 384.944 Q(The types are:)
14.4 E 216(Type Text)41.782 408.944 R .48 LW 527.782 417.904 41.782
417.904 DL(1)52.582 432.944 Q 7.2(Copyright \251 The)88.582 432.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)88.582
444.944 Q(full legal notices.)88.582 456.944 Q(2)52.582 468.944 Q 7.2
(Copyright \251 The)88.582 468.944 R(Internet Society \(2005\).)7.2 E
(The initial)14.4 E
(version of this MIB module was published in RFC XXXX; for)88.582
480.944 Q(full legal notices see the RFC itself.)88.582 492.944 Q
(Supplementary)14.4 E(information may be available on)88.582 504.944 Q
(http://www.ietf.org/copyrights/ianamib.html.)88.582 516.944 Q
(The correct year is used, and when an RFC number is assigned by the)
41.782 540.944 Q
(RFC Editor, the RFC number will appear in place of XXXX.)41.782 552.944
Q(As noted)14.4 E
(above, alternate text may be substituted for "MIB module".)41.782
564.944 Q(5.3.10. Document Appendices)20.182 588.944 Q(Appendices appea\
r like numbered sections, except that the first\255level)41.782 612.944
Q(consists of upper\255case letters rather than numbers.)41.782 624.944
Q(Each appendix to)14.4 E
(appear in the document should be introduced with the AP macro, which)
41.782 636.944 Q(causes such numbering to take place.)41.782 648.944 Q
(The AP macro takes a single)14.4 E
(argument, the appendix heading text.)41.782 660.944 Q
(Subdivided sections within an)14.4 E(appendix can be introduced with s\
econd\255, third\255level, etc. numbering)41.782 672.944 Q
(via NH macros as with document body sections.)41.782 684.944 Q 20.182
708.944 EBEGIN
[/Title (5.4. End Matter) /Dest (S5.4.) /OUT pdfmark
EEND 20.182 708.944 EBEGIN
[/Dest (S5.4.) /Page 14 /View [ /FitH 120 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(5.4. End Matter)20.182 708.944 Q
(At the very end of the input file describing the document, the author)
41.782 732.944 Q(should place an EM macro directive.)41.782 744.944 Q
(That causes output of)14.4 E 129.6(Lilly Expires)20.182 768.944 R
(November 6, 2005)7.2 E([Page 14])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(references, author's address \(or authors' addresses\), and IPR)78.292
108.944 Q(boilerplate sections.)78.292 120.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 132.944
Q(is more than 15 pages in length, a Table of Contents is also)78.292
144.944 Q(produced.)78.292 156.944 Q 56.692 180.944 EBEGIN
[/Title (6. Acknowledgments) /Dest (S6.) /OUT pdfmark
EEND 56.692 180.944 EBEGIN
[/Dest (S6.) /Page 15 /View [ /FitH 648 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(6. Acknowledgments)56.692 180.944 Q
(The author gratefully acknowledges the discussions of RFC formatting)
78.292 204.944 Q(on the rfc\255interest mailing list.)78.292 216.944 Q
(The format for references was inspired by Keith Moore's draft)78.292
240.944 Q(subsequently published as [I15.RFC3834].)78.292 252.944 Q
56.692 276.944 EBEGIN
[/Title (7. Security Considerations) /Dest (S7.) /OUT pdfmark
EEND 56.692 276.944 EBEGIN
[/Dest (S7.) /Page 15 /View [ /FitH 552 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(7. Security Considerations)56.692 276.944 Q
(No security considerations are addressed by this memo.)78.292 300.944 Q
56.692 324.944 EBEGIN
[/Title (8. Internationalization Considerations) /Dest (S8.) /OUT pdfmark
EEND 56.692 324.944 EBEGIN
[/Dest (S8.) /Page 15 /View [ /FitH 504 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(8. Internationalization Considerations)56.692
324.944 Q(This memo raises no new internationalization considerations.)
78.292 348.944 Q 56.692 372.944 EBEGIN
[/Title (9. IANA Considerations) /Dest (S9.) /OUT pdfmark
EEND 56.692 372.944 EBEGIN
[/Dest (S9.) /Page 15 /View [ /FitH 456 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(9. IANA Considerations)56.692 372.944 Q
(This memo adds no new IANA considerations.)78.292 396.944 Q 56.692
420.944 EBEGIN
[/Title (Appendix A. Esoterica) /Dest (SA.1.) /OUT pdfmark
EEND 56.692 420.944 EBEGIN
[/Dest (SA.1.) /Page 15 /View [ /FitH 408 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix A. Esoterica)56.692 420.944 Q 56.692
444.944 EBEGIN
[/Title (A.1. Troff vs. Nroff) /Dest (SA.1.) /OUT pdfmark
EEND 56.692 444.944 EBEGIN
[/Dest (SA.1.) /Page 15 /View [ /FitH 384 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.1. Troff vs. Nroff)56.692 444.944 Q
(RFCs and Internet\255Drafts are produced as text documents.)78.292
468.944 Q(It is)14.4 E
(sometimes desirable to produce a formatted version for improved)78.292
480.944 Q(rendition of diagrams, etc.)78.292 492.944 Q
(The rfc macro package has been designed)14.4 E
(so that troff formatted output resembles the text version as closely)
78.292 504.944 Q
(as possible; it utilizes a monospaced font for text, does not)78.292
516.944 Q
(embolden section headings \(unlike the ms macro package\), and centers)
78.292 528.944 Q(each page within 8.5 by 11 inch page boundaries.)78.292
540.944 Q(Other than improved)14.4 E
(appearance of non\255textual matter, troff and nroff versions of)78.292
552.944 Q
(documents produced with the rfc macro package should appear nearly)
78.292 564.944 Q
(identical after postprocessing, including page and line breaks.)78.292
576.944 Q(One)14.4 E
(subtlety is that centered text with an odd number of characters is)
78.292 588.944 Q
(offset left or right in nroff output, whereas it is truly centered in)
78.292 600.944 Q(troff output.)78.292 612.944 Q
(Output processed with nroff for text production)14.4 E
(includes a form feed character after each page \(the "fix.pl" script)
78.292 624.944 Q(specified in [N1.RFC2223] is not necessary\).)78.292
636.944 Q
(Separate processing can be performed by troff and nroff by using)78.292
660.944 Q(nroff/troff conditionals, e.g.:)78.292 672.944 Q 129.6
(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 15])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.ie t \\{ \\)20.182
108.944 Q(<troff input goes here>)20.182 120.944 Q(.\\})20.182 132.944 Q
(.el \\{ \\)20.182 144.944 Q(<nroff input goes here>)20.182 156.944 Q
(.\\})20.182 168.944 Q(For a more complete example, consider:)41.782
192.944 Q .56 LW 190.894 252.944 136.894 252.944 DL 190.894 216.944
190.894 252.944 DL 136.894 216.944 190.894 216.944 DL 136.894 252.944
136.894 216.944 DL/F1 14/Courier@0 SF(a)159.19 238.384 Q 154.894 324.944
100.894 324.944 DL 154.894 288.944 154.894 324.944 DL 100.894 288.944
154.894 288.944 DL 100.894 324.944 100.894 288.944 DL(c)123.19 310.384 Q
153.67 255.392 154.894 252.944 DL 152.374 257.984 153.67 255.392 DL
151.078 260.648 152.374 257.984 DL 149.71 263.312 151.078 260.576 DL
148.27 266.048 149.71 263.312 DL 146.83 268.856 148.27 266.048 DL 145.39
271.664 146.83 268.856 DL 143.878 274.472 145.39 271.664 DL 142.366
277.208 143.878 274.472 DL 140.854 279.944 142.366 277.208 DL 136.894
288.944 143.878 280.952 DL 137.902 277.928 136.894 288.944 DL 143.878
280.952 137.902 277.928 DL 226.894 324.944 172.894 324.944 DL 226.894
288.944 226.894 324.944 DL 172.894 288.944 226.894 288.944 DL 172.894
324.944 172.894 288.944 DL(d)195.694 310.384 Q 174.118 255.392 172.894
252.944 DL 175.414 257.984 174.118 255.392 DL 176.71 260.648 175.414
257.984 DL 178.078 263.312 176.71 260.576 DL 179.518 266.048 178.078
263.312 DL 180.958 268.856 179.518 266.048 DL 182.398 271.664 180.958
268.856 DL 183.91 274.472 182.398 271.664 DL 185.422 277.208 183.91
274.472 DL 186.934 279.944 185.422 277.208 DL 190.894 288.944 189.886
277.928 DL 183.91 280.952 190.894 288.944 DL 189.886 277.928 183.91
280.952 DL 372.91 252.944 318.91 252.944 DL 372.91 216.944 372.91
252.944 DL 318.91 216.944 372.91 216.944 DL 318.91 252.944 318.91
216.944 DL(q)341.71 238.384 Q 336.91 324.944 282.91 324.944 DL 336.91
288.944 336.91 324.944 DL 282.91 288.944 336.91 288.944 DL 282.91
324.944 282.91 288.944 DL(r)305.71 310.384 Q 335.686 255.392 336.91
252.944 DL 334.39 257.984 335.686 255.392 DL 333.094 260.648 334.39
257.984 DL 331.654 263.312 333.022 260.576 DL 330.214 266.048 331.654
263.312 DL 328.846 268.856 330.286 266.048 DL 327.406 271.664 328.846
268.856 DL 325.822 274.472 327.334 271.664 DL 324.382 277.208 325.894
274.472 DL 322.87 279.944 324.382 277.208 DL 318.91 288.944 325.894
280.952 DL 319.918 277.928 318.91 288.944 DL 325.894 280.952 319.918
277.928 DL 408.91 324.944 354.91 324.944 DL 408.91 288.944 408.91
324.944 DL 354.91 288.944 408.91 288.944 DL 354.91 324.944 354.91
288.944 DL(s)377.71 310.384 Q 356.134 255.392 354.91 252.944 DL 357.43
257.984 356.134 255.392 DL 358.726 260.648 357.43 257.984 DL 360.094
263.312 358.726 260.576 DL 361.534 266.048 360.094 263.312 DL 362.974
268.856 361.534 266.048 DL 364.414 271.664 362.974 268.856 DL 365.926
274.472 364.414 271.664 DL 367.438 277.208 365.926 274.472 DL 368.878
279.944 367.366 277.208 DL 372.91 288.944 371.902 277.928 DL 365.926
280.952 372.91 288.944 DL 371.902 277.928 365.926 280.952 DL 154.894
396.944 100.894 396.944 DL 154.894 360.944 154.894 396.944 DL 100.894
360.944 154.894 360.944 DL 100.894 396.944 100.894 360.944 DL(h)123.19
382.384 Q 127.894 327.392 127.894 324.944 DL 127.894 329.84 127.894
327.392 DL 127.894 332.36 127.894 329.84 DL 127.894 334.952 127.894
332.36 DL 127.894 337.544 127.894 334.952 DL 127.894 340.208 127.894
337.544 DL 127.894 342.872 127.894 340.208 DL 127.894 345.536 127.894
342.872 DL 127.894 348.2 127.894 345.536 DL 127.894 350.936 127.894
348.272 DL 127.894 360.944 131.926 350.936 DL 124.87 350.936 127.894
360.944 DL 131.854 350.936 124.87 350.936 DL 336.91 396.944 282.91
396.944 DL 336.91 360.944 336.91 396.944 DL 282.91 360.944 336.91
360.944 DL 282.91 396.944 282.91 360.944 DL(t)305.206 382.384 Q 309.91
327.392 309.91 324.944 DL 309.91 329.84 309.91 327.392 DL 309.91 332.36
309.91 329.84 DL 309.91 334.952 309.91 332.36 DL 309.91 337.544 309.91
334.952 DL 309.91 340.208 309.91 337.544 DL 309.91 342.872 309.91
340.208 DL 309.91 345.536 309.91 342.872 DL 309.91 348.2 309.91 345.536
DL 309.91 350.936 309.91 348.272 DL 309.838 360.944 313.87 350.936 DL
306.886 350.936 309.91 360.944 DL 313.87 350.936 306.886 350.936 DL
226.894 396.944 172.894 396.944 DL 226.894 360.944 226.894 396.944 DL
172.894 360.944 226.894 360.944 DL 172.894 396.944 172.894 360.944 DL(i)
195.694 382.384 Q 199.894 327.392 199.894 324.944 DL 199.894 329.84
199.894 327.392 DL 199.894 332.36 199.894 329.84 DL 199.894 334.952
199.894 332.36 DL 199.894 337.544 199.894 334.952 DL 199.894 340.208
199.894 337.544 DL 199.894 342.872 199.894 340.208 DL 199.894 345.536
199.894 342.872 DL 199.894 348.2 199.894 345.536 DL 199.894 350.936
199.894 348.272 DL 199.894 360.944 203.926 350.936 DL 196.87 350.936
199.894 360.944 DL 203.854 350.936 196.87 350.936 DL 289.894 468.944
235.894 468.944 DL 289.894 432.944 289.894 468.944 DL 235.894 432.944
289.894 432.944 DL 235.894 468.944 235.894 432.944 DL(j)258.694 454.384
Q 216.022 328.04 213.862 324.944 DL 218.254 331.28 216.022 328.04 DL
220.63 334.664 218.326 331.28 DL 222.934 338.192 220.63 334.664 DL
225.238 341.792 222.934 338.192 DL 227.542 345.536 225.238 341.792 DL
229.774 349.352 227.542 345.536 DL 232.006 353.168 229.846 349.352 DL
234.022 357.056 232.006 353.168 DL 235.894 360.944 234.022 357.056 DL
238.558 367.064 235.894 360.944 DL 241.078 373.328 238.558 367.064 DL
243.454 379.736 241.078 373.328 DL 245.758 386.216 243.454 379.736 DL
247.918 392.696 245.758 386.216 DL 249.934 399.104 247.918 392.696 DL
251.878 405.368 249.934 399.104 DL 253.678 411.488 251.878 405.368 DL
255.334 417.392 253.678 411.488 DL 256.918 422.936 255.334 417.392 DL
258.862 432.944 259.87 422.936 DL 253.894 423.944 258.862 432.944 DL
259.87 422.936 253.894 423.944 DL 408.91 396.944 354.91 396.944 DL
408.91 360.944 408.91 396.944 DL 354.91 360.944 408.91 360.944 DL 354.91
396.944 354.91 360.944 DL(u)377.206 382.384 Q 381.91 327.392 381.91
324.944 DL 381.91 329.84 381.91 327.392 DL 381.91 332.36 381.91 329.84
DL 381.91 334.952 381.91 332.36 DL 381.91 337.544 381.91 334.952 DL
381.91 340.208 381.91 337.544 DL 381.91 342.872 381.91 340.208 DL 381.91
345.536 381.91 342.872 DL 381.91 348.2 381.91 345.536 DL 381.91 350.936
381.91 348.272 DL 381.838 360.944 385.87 350.936 DL 378.886 350.936
381.91 360.944 DL 385.87 350.936 378.886 350.936 DL 457.87 468.944
403.87 468.944 DL 457.87 432.944 457.87 468.944 DL 403.87 432.944 457.87
432.944 DL 403.87 468.944 403.87 432.944 DL(w)426.166 454.384 Q 399.046
328.04 396.886 324.944 DL 401.278 331.28 399.046 328.04 DL 403.582
334.664 401.278 331.28 DL 405.886 338.192 403.582 334.664 DL 408.19
341.792 405.886 338.192 DL 410.35 345.536 408.118 341.792 DL 412.438
349.352 410.35 345.536 DL 414.526 353.168 412.51 349.352 DL 416.254
357.056 414.454 353.168 DL 417.838 360.944 416.254 357.056 DL 420.142
367.064 417.91 360.944 DL 422.086 373.328 420.142 367.064 DL 423.814
379.736 422.086 373.328 DL 425.254 386.216 423.814 379.736 DL 426.478
392.696 425.254 386.216 DL 427.558 399.104 426.55 392.696 DL 428.422
405.368 427.558 399.104 DL 428.998 411.488 428.35 405.368 DL 429.502
417.392 428.998 411.488 DL 429.862 422.936 429.502 417.392 DL 430.87
432.944 432.886 422.936 DL 426.838 422.936 430.87 432.944 DL 432.886
422.936 426.91 422.936 DL 217.894 468.944 163.894 468.944 DL 217.894
432.944 217.894 468.944 DL 163.894 432.944 217.894 432.944 DL 163.894
468.944 163.894 432.944 DL(k)186.19 454.384 Q 146.326 399.68 143.878
396.944 DL 148.774 402.488 146.326 399.68 DL 151.294 405.224 148.774
402.416 DL 153.814 408.032 151.294 405.224 DL 156.334 410.984 153.814
408.104 DL 158.71 413.792 156.262 410.912 DL 161.086 416.6 158.71
413.792 DL 163.534 419.408 161.158 416.6 DL 165.694 422.216 163.462
419.408 DL 167.926 424.952 165.766 422.216 DL 174.91 432.944 170.878
422.936 DL 165.91 427.976 174.91 432.944 DL 170.878 423.008 165.91
427.976 DL 366.862 468.944 312.862 468.944 DL 366.862 432.944 366.862
468.944 DL 312.862 432.944 366.862 432.944 DL 312.862 468.944 312.862
432.944 DL(v)335.662 454.384 Q 318.838 399.392 317.902 396.944 DL
319.846 401.912 318.838 399.392 DL 320.782 404.576 319.774 401.984 DL
321.79 407.24 320.782 404.576 DL 322.942 409.904 321.862 407.24 DL
323.95 412.64 322.87 409.976 DL 324.958 415.304 323.95 412.64 DL 325.966
417.896 324.958 415.304 DL 326.974 420.488 325.966 417.968 DL 327.91
422.936 326.974 420.488 DL 331.87 432.944 331.87 421.928 DL 324.886
424.952 331.87 432.944 DL 331.87 421.928 324.886 424.952 DL 197.59
399.392 197.878 396.944 DL 197.302 401.84 197.59 399.392 DL 197.014
404.36 197.302 401.84 DL 196.726 406.952 197.014 404.36 DL 196.438
409.544 196.726 406.952 DL 196.078 412.208 196.366 409.544 DL 195.79
414.872 196.078 412.208 DL 195.502 417.536 195.79 414.872 DL 195.214
420.2 195.502 417.536 DL 194.926 422.936 195.214 420.272 DL 192.91
432.944 197.878 423.944 DL 191.902 422.936 192.91 432.944 DL 197.878
423.944 191.902 422.936 DL 369.67 399.392 370.894 396.944 DL 368.302
401.984 369.67 399.392 DL 366.862 404.648 368.302 401.984 DL 365.278
407.312 366.79 404.576 DL 363.694 410.048 365.278 407.312 DL 361.966
412.856 363.622 410.048 DL 360.238 415.664 361.966 412.856 DL 358.51
418.472 360.238 415.664 DL 356.71 421.208 358.51 418.472 DL 354.91
423.944 356.71 421.208 DL 349.87 432.944 357.862 425.96 DL 351.886
422.936 349.87 432.944 DL 357.862 425.96 351.886 422.936 DL 289.894
540.944 235.894 540.944 DL 289.894 504.944 289.894 540.944 DL 235.894
504.944 289.894 504.944 DL 235.894 540.944 235.894 504.944 DL(l)258.694
526.384 Q 211.63 471.68 208.894 468.944 DL 214.438 474.488 211.63 471.68
DL 217.246 477.296 214.438 474.488 DL 220.126 480.176 217.246 477.296 DL
223.006 483.056 220.126 480.176 DL 225.958 486.008 223.006 483.056 DL
228.91 488.96 225.958 486.008 DL 231.862 491.912 228.91 488.96 DL
234.958 495.008 231.934 491.984 DL 237.91 497.96 234.886 494.936 DL
244.894 504.944 239.926 494.936 DL 234.886 499.976 244.894 504.944 DL
239.854 495.008 234.886 499.976 DL 262.894 471.392 262.894 468.944 DL
262.894 473.84 262.894 471.392 DL 262.894 476.36 262.894 473.84 DL
262.894 478.952 262.894 476.36 DL 262.894 481.544 262.894 478.952 DL
262.894 484.208 262.894 481.544 DL 262.894 486.872 262.894 484.208 DL
262.894 489.536 262.894 486.872 DL 262.894 492.2 262.894 489.536 DL
262.894 494.936 262.894 492.272 DL 262.894 504.944 266.926 494.936 DL
259.87 494.936 262.894 504.944 DL 266.854 494.936 259.87 494.936 DL
366.862 540.944 312.862 540.944 DL 366.862 504.944 366.862 540.944 DL
312.862 504.944 366.862 504.944 DL 312.862 540.944 312.862 504.944 DL(x)
335.158 526.384 Q 404.518 471.68 407.902 468.944 DL 400.99 474.56
404.518 471.68 DL 397.318 477.512 400.99 474.56 DL 393.574 480.536
397.318 477.512 DL 389.758 483.56 393.574 480.536 DL 385.942 486.656
389.758 483.56 DL 382.126 489.752 385.942 486.656 DL 378.31 492.848
382.126 489.752 DL 374.566 495.944 378.31 492.848 DL 370.894 498.968
374.566 495.944 DL 362.902 504.944 372.91 501.92 DL 368.878 495.944
362.902 504.944 DL 372.91 501.92 368.878 495.944 DL 339.862 471.392
339.862 468.944 DL 339.862 473.84 339.862 471.392 DL 339.862 476.36
339.862 473.84 DL 339.862 478.952 339.862 476.36 DL 339.862 481.544
339.862 478.952 DL 339.862 484.208 339.862 481.544 DL 339.862 486.872
339.862 484.208 DL 339.862 489.536 339.862 486.872 DL 339.862 492.2
339.862 489.536 DL 339.862 494.936 339.862 492.272 DL 339.862 504.944
343.894 494.936 DL 336.838 494.936 339.862 504.944 DL 343.894 494.936
336.91 494.936 DL 327.91 612.944 273.91 612.944 DL 327.91 576.944 327.91
612.944 DL 273.91 576.944 327.91 576.944 DL 273.91 612.944 273.91
576.944 DL(z)296.206 598.384 Q 274.126 543.392 272.902 540.944 DL
275.422 545.984 274.126 543.392 DL 276.718 548.648 275.422 545.984 DL
278.086 551.312 276.718 548.576 DL 279.526 554.048 278.086 551.312 DL
280.966 556.856 279.526 554.048 DL 282.406 559.664 280.966 556.856 DL
283.918 562.472 282.406 559.664 DL 285.43 565.208 283.918 562.472 DL
286.942 567.944 285.43 565.208 DL 291.91 576.944 289.894 566.936 DL
283.918 569.96 291.91 576.944 DL 289.894 566.936 283.918 569.96 DL
328.702 543.392 329.926 540.944 DL 327.334 545.984 328.63 543.392 DL
326.11 548.648 327.406 545.984 DL 324.67 551.312 326.038 548.576 DL
323.23 554.048 324.67 551.312 DL 321.862 556.856 323.302 554.048 DL
320.422 559.664 321.862 556.856 DL 318.838 562.472 320.35 559.664 DL
317.398 565.208 318.91 562.472 DL 315.886 567.944 317.398 565.208 DL
310.918 576.944 318.91 569.96 DL 312.934 566.936 310.918 576.944 DL
318.838 569.96 312.862 566.936 DL F0
(Diagrams imported from some sources which generate pic may require a)
41.782 636.944 Q
(reset, and in some cases setting of pic variables such as maxpsht and)
41.782 648.944 Q(maxpswid.)41.782 660.944 Q(To conform page breaks betw\
een troff\255 and nroff\255generated documents,)41.782 684.944 Q(the he\
ight of troff\255 and nroff\255produced output should be the same.)
41.782 696.944 Q
(In the example above, that is implemented with an invisible pic box)
41.782 708.944 Q
(in the nroff\255processed version which contains the text referring to)
41.782 720.944 Q(the troff\255formatted versions.)41.782 732.944 Q 129.6
(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 16])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(Some implementations fake text formatting with "troff \255a" or)78.292
108.944 Q("troff \255N" rather than a true nroff.)78.292 120.944 Q
(That generally works poorly,)14.4 E
(particularly if tables, diagrams, etc. are included in the document.)
78.292 132.944 Q
(Some troff implementations can produce PostScript directly; others)
78.292 156.944 Q(require a separate postprocessor.)78.292 168.944 Q
(PostScript produced by some troff)14.4 E
(implementations is not amenable to postprocessing to repaginate)78.292
180.944 Q(\(relocate the table of contents\).)78.292 192.944 Q 56.692
216.944 EBEGIN
[/Title (A.2. Output Adjustments) /Dest (SA.2.) /OUT pdfmark
EEND 56.692 216.944 EBEGIN
[/Dest (SA.2.) /Page 17 /View [ /FitH 612 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.2. Output Adjustments)56.692 216.944 Q
(Formatting may be adjusted by setting registers using command\255line)
78.292 240.944 Q(arguments [I1.CSTR54].)78.292 252.944 Q
(Register names and default values are:)14.4 E 10.8(Name Default)78.292
276.944 R 10.8(Value Function)7.2 F .48 LW 553.492 285.904 78.292
285.904 DL 28.8(C0)89.092 300.944 S(\(zero\))-21.6 E
(Table of Contents length \(pages\))236.692 300.944 Q(D)89.092 312.944 Q
(Current day)125.092 312.944 Q(of month)125.092 324.944 Q
(Day of month used as publication date.)236.692 312.944 Q
(Overridden by DT macro.)236.692 324.944 Q 28.8(H2)89.092 336.944 S
(Highest section heading level to include in)236.692 336.944 Q
(Table of Contents)236.692 348.944 Q 28.8(I0)89.092 360.944 S(.3i)-28.8
E(Paragraph indent increment.)236.692 360.944 Q(Each character)14.4 E
(is 0.1i wide.)236.692 372.944 Q 28.8(L7)89.092 384.944 S(.2i)-28.8 E
(Text line length.)236.692 384.944 Q(Each character is 0.1i)14.4 E 7.2
(wide. The)236.692 396.944 R(default value provides 72)7.2 E
(characters per line and may not be exceeded.)236.692 408.944 Q(M)89.092
420.944 Q(Current month)125.092 420.944 Q
(Month number \(January = 1\) used as)236.692 420.944 Q
(publication date.)236.692 432.944 Q(Overridden by DT macro.)14.4 E 28.8
(N0)89.092 444.944 S(\(zero\))-21.6 E
(RFC or Draft version number \(negative for)236.692 444.944 Q 7.2
(drafts\). Overrides)236.692 456.944 R(NU macro if non\255zero.)7.2 E
28.8(O2)89.092 468.944 S(Minimum number of continued running text)
236.692 468.944 Q(lines at bottom of page \(anything less is)236.692
480.944 Q(considered an orphan\).)236.692 492.944 Q 28.8(P1)89.092
504.944 S(2)-28.8 E(Text point size \(troff\).)236.692 504.944 Q 28.8
(Q5)89.092 516.944 S(8)-28.8 E(Printed lines per page.)236.692 516.944 Q
(The default value)14.4 E(is the maximum permitted.)236.692 528.944 Q(R)
89.092 540.944 Q(for centered)125.092 540.944 Q(text \(troff\))125.092
552.944 Q(Page offset for odd\255numbered \(recto\) pages.)236.692
540.944 Q(Always zero for nroff \(text output\).)236.692 552.944 Q 28.8
(S1)89.092 564.944 S(P)-28.8 E(Interparagraph vertical space.)236.692
564.944 Q(The default)14.4 E(is equivalent to one text line.)236.692
576.944 Q(For)14.4 E(nroff/troff consistency, the value should be)
236.692 588.944 Q(an integral multiple of 1P.)236.692 600.944 Q(T)89.092
612.944 Q(for centered)125.092 612.944 Q(text \(troff\))125.092 624.944
Q(Top margin.)236.692 612.944 Q(Always zero for nroff \(text)14.4 E
(output\).)236.692 624.944 Q(V)89.092 636.944 Q(for centered)125.092
636.944 Q(text \(troff\))125.092 648.944 Q
(Page offset for even\255numbered \(verso\) pages.)236.692 636.944 Q
(Always zero for nroff \(text output\).)236.692 648.944 Q 28.8(W2)89.092
660.944 S(Minimum number of continued running text)236.692 660.944 Q
(lines at top of page \(anything less is)236.692 672.944 Q
(considered a widow\).)236.692 684.944 Q 28.8(X8)89.092 696.944 S(.5i)
-28.8 E(Physical page width \(troff\).)236.692 696.944 Q(Y)89.092
708.944 Q(Current year)125.092 708.944 Q
(4\255digit year number used as publication)236.692 708.944 Q 7.2
(date. Overridden)236.692 720.944 R(by DT macro.)7.2 E 28.8(Z1)89.092
732.944 S(1i)-28.8 E(Physical page height \(troff\).)236.692 732.944 Q
129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 17])
108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(A.2.1. Formatting for Specific Paper Sizes)20.182 108.944 Q
(By default, output processed by troff \(as distinct from text output)
41.782 132.944 Q
(produced by nroff\) is formatted for economical ANSI standard A)41.782
144.944 Q
(\(8.5 x 11 inches\) [I16.ANSI151] paper, with the printed content)
41.782 156.944 Q(centered on each page.)41.782 168.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 180.944 Q(have one\255letter names, they can be set by command\
\255line arguments;)41.782 192.944 Q
(they SHOULD NOT be set in the source file as that would adversely)
41.782 204.944 Q
(affect output produced from that source file, e.g. by the RFC)41.782
216.944 Q 7.2(Editor\). For)41.782 228.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)
41.782 240.944 Q
(binder filing, registers X, Z, R, and V would be set with)41.782
252.944 Q
(command\255line arguments \255rX21c \255rZ29.7c \255rR2c \255rV0.712c.)
41.782 264.944 Q 20.182 288.944 EBEGIN
[/Title (A.3. Tips and Tricks) /Dest (SA.3.) /OUT pdfmark
EEND 20.182 288.944 EBEGIN
[/Dest (SA.3.) /Page 18 /View [ /FitH 540 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.3. Tips and Tricks)20.182 288.944 Q
(Handling non\255textual material is simplified by using preprocessors.)
41.782 312.944 Q
(However, there are some subtleties that can cause frustration for)
41.782 324.944 Q 7.2(authors. Some)41.782 336.944 R
(tips regarding preprocessors and a few tricks to)7.2 E
(ensure satisfactory formatting follow.)41.782 348.944 Q
(A.3.1. Mathematics and Chemistry)20.182 372.944 Q
(While eqn [I8.eqn] is capable of setting complex equations, many)41.782
396.944 Q(symbols cannot be adequately represented in plain text.)41.782
408.944 Q(so, while)14.4 E/F1 12/Times-Italic@0 SF(x)225.016 432.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)
41.782 456.944 Q(in plain text.)41.782 468.944 Q
(Subscripts and superscripts pose problems, and for)14.4 E
(that reason chemical formulae cannot be represented well except for)
41.782 480.944 Q(trivial cases.)41.782 492.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)41.782
504.944 Q
(screw up subsequent diagrams unless at least the first diagram after)
41.782 516.944 Q 7.2(ac)41.782 528.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.)41.782 540.944
Q(A.3.2. Data Formats)20.182 564.944 Q
(The DFORMAT program [I9.CSTR142] produces output suitable for)41.782
588.944 Q
(processing by pic [I6.CSTR116] to generate data format layouts.)41.782
600.944 Q(For)14.4 E(example:)41.782 612.944 Q 129.6(Lilly Expires)
20.182 768.944 R(November 6, 2005)7.2 E([Page 18])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.DS B)56.692 108.944
Q(.begin dformat)56.692 120.944 Q(style fill off)56.692 132.944 Q
(style bitwid 0.20)56.692 144.944 Q(style recspread 0)56.692 156.944 Q
(style recht 0.33333)56.692 168.944 Q(noname)56.692 180.944 Q
(0\2553 \\0Version)63.892 192.944 Q(4\2557 IHL)63.892 204.944 Q
(8\25515 \\0Type of Service)63.892 216.944 Q(16\25531 Total Length)
63.892 228.944 Q(noname)56.692 240.944 Q(0\25515 Identification)63.892
252.944 Q(16\25518 \\0Flags)63.892 264.944 Q(19\25531 Fragment Offset)
63.892 276.944 Q(noname)56.692 288.944 Q(0\2557 Time to Live)63.892
300.944 Q(8\25515 Protocol)63.892 312.944 Q(16\25531 Header Checksum)
63.892 324.944 Q(noname)56.692 336.944 Q(0\25531 Source Address)63.892
348.944 Q(noname)56.692 360.944 Q(0\25531 Destination Address)63.892
372.944 Q(noname)56.692 384.944 Q(0\25523 Options)63.892 396.944 Q
(24\25531 Padding)63.892 408.944 Q(.end)56.692 420.944 Q(.DE)56.692
432.944 Q(Output looks like:)85.492 456.944 Q .48 LW 143.092 504.92
85.492 504.92 DL 143.092 480.944 143.092 504.92 DL 85.492 480.944
143.092 480.944 DL 85.492 504.92 85.492 480.944 DL(Version)92.692
495.608 Q/F1 8/Courier@0 SF(0)88.692 503.6 Q(3)135.092 503.6 Q 200.692
504.92 143.092 504.92 DL 200.692 480.944 200.692 504.92 DL 143.092
480.944 200.692 480.944 DL 143.092 504.92 143.092 480.944 DL F0(IHL)
161.092 495.608 Q F1(4)146.292 503.6 Q(7)192.692 503.6 Q 315.892 504.92
200.692 504.92 DL 315.892 480.944 315.892 504.92 DL 200.692 480.944
315.892 480.944 DL 200.692 504.92 200.692 480.944 DL F0(Type of Service)
207.892 495.608 Q F1(8)203.892 503.6 Q 2.4(15)300.692 503.6 S 546.292
504.92 315.892 504.92 DL 546.292 480.944 546.292 504.92 DL 315.892
480.944 546.292 480.944 DL 315.892 504.92 315.892 480.944 DL F0
(Total Length)387.892 495.608 Q F1 2.4(16)319.092 503.6 S 2.4(31)531.092
503.6 S 315.892 528.968 85.492 528.968 DL 315.892 504.992 315.892
528.968 DL 85.492 504.92 315.892 504.92 DL 85.492 528.896 85.492 504.92
DL F0(Identification)150.292 519.584 Q F1(0)88.692 527.648 Q 2.4(15)
300.692 527.648 S 359.092 528.968 315.892 528.968 DL 359.092 504.992
359.092 528.968 DL 315.892 504.92 359.092 504.92 DL 315.892 528.896
315.892 504.92 DL F0(Flags)323.092 519.584 Q F1 2.4(16)319.092 527.648 S
2.4(18)343.892 527.648 S 546.292 528.968 359.092 528.968 DL 546.292
504.992 546.292 528.968 DL 359.092 504.92 546.292 504.92 DL 359.092
528.896 359.092 504.92 DL F0(Fragment Offset)398.692 519.584 Q F1 2.4
(19)362.292 527.648 S 2.4(31)531.092 527.648 S 200.692 552.944 85.492
552.944 DL 200.692 528.968 200.692 552.944 DL 85.492 528.968 200.692
528.968 DL 85.492 552.944 85.492 528.968 DL F0(Time to Live)99.892
543.56 Q F1(0)88.692 551.624 Q(7)192.692 551.624 Q 315.892 552.944
200.692 552.944 DL 315.892 528.968 315.892 552.944 DL 200.692 528.968
315.892 528.968 DL 200.692 552.944 200.692 528.968 DL F0(Protocol)
229.492 543.56 Q F1(8)203.892 551.624 Q 2.4(15)300.692 551.624 S 546.292
552.944 315.892 552.944 DL 546.292 528.968 546.292 552.944 DL 315.892
528.968 546.292 528.968 DL 315.892 552.944 315.892 528.968 DL F0
(Header Checksum)377.092 543.56 Q F1 2.4(16)319.092 551.624 S 2.4(31)
531.092 551.624 S 546.292 576.92 85.492 576.92 DL 546.292 552.944
546.292 576.92 DL 85.492 552.944 546.292 552.944 DL 85.492 576.92 85.492
552.944 DL F0(Source Address)265.492 567.608 Q F1(0)88.692 575.6 Q 2.4
(31)531.092 575.6 S 546.292 600.968 85.492 600.968 DL 546.292 576.992
546.292 600.968 DL 85.492 576.92 546.292 576.92 DL 85.492 600.896 85.492
576.92 DL F0(Destination Address)247.492 591.584 Q F1(0)88.692 599.648 Q
2.4(31)531.092 599.648 S 431.092 624.944 85.492 624.944 DL 431.092
600.968 431.092 624.944 DL 85.492 600.968 431.092 600.968 DL 85.492
624.944 85.492 600.968 DL F0(Options)233.092 615.56 Q F1(0)88.692
623.624 Q 2.4(23)415.892 623.624 S 546.292 624.944 431.092 624.944 DL
546.292 600.968 546.292 624.944 DL 431.092 600.968 546.292 600.968 DL
431.092 624.944 431.092 600.968 DL F0(Padding)463.492 615.56 Q F1 2.4
(24)434.292 623.624 S 2.4(31)531.092 623.624 S F0
(Note that dimensions are specified to dformat in inches, and in the)
78.292 648.944 Q
(example suitable dimensions were chosen to match text format)78.292
660.944 Q(character width \(multiples of 0.1 inch\) and line height \(1\
/6 inch\) so)78.292 672.944 Q
(that text and troff\255formatted versions are reasonably consistent.)
78.292 684.944 Q(The \\0 sequences are invisible character\255width spa\
ces which improve)78.292 696.944 Q(the text \(nroff\) output.)78.292
708.944 Q 129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E
([Page 19])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(A.3.3. Graphs and charts)20.182 108.944 Q
(Graphs and charts may be generated from data using the grap)41.782
132.944 Q(preprocessor [I5.CSTR114].)41.782 144.944 Q
(For example, the following graph:)14.4 E .48 LW 156.982 180.968 156.982
396.968 DL 444.982 180.968 156.982 180.968 DL 444.982 396.968 444.982
180.968 DL 156.982 396.968 444.982 396.968 DL
(Number of RFC documents per YEAR)185.782 171.584 Q(YEAR)286.582 423.584
Q(Number)63.382 285.608 Q(of RFCs)59.782 297.608 Q 164.182 396.968
156.982 396.968 DL(0)149.782 399.608 Q 164.182 360.968 156.982 360.968
DL(50)142.582 363.608 Q 164.182 324.968 156.982 324.968 DL(100)135.382
327.608 Q 164.182 288.968 156.982 288.968 DL(150)135.382 291.608 Q
164.182 252.968 156.982 252.968 DL(200)135.382 255.608 Q 164.182 216.968
156.982 216.968 DL(250)135.382 219.608 Q 164.182 180.968 156.982 180.968
DL(300)135.382 183.608 Q 437.782 396.968 444.982 396.968 DL 437.782
360.968 444.982 360.968 DL 437.782 324.968 444.982 324.968 DL 437.782
288.968 444.982 288.968 DL 437.782 252.968 444.982 252.968 DL 437.782
216.968 444.982 216.968 DL 437.782 180.968 444.982 180.968 DL 192.982
188.168 192.982 180.968 DL 228.982 188.168 228.982 180.968 DL 264.982
188.168 264.982 180.968 DL 300.982 188.168 300.982 180.968 DL 336.982
188.168 336.982 180.968 DL 372.982 188.168 372.982 180.968 DL 408.982
188.168 408.982 180.968 DL 444.982 188.168 444.982 180.968 DL 192.982
393.368 192.982 396.968 DL(1970)178.582 405.608 Q 228.982 393.368
228.982 396.968 DL(1975)214.582 405.608 Q 264.982 393.368 264.982
396.968 DL(1980)250.582 405.608 Q 300.982 393.368 300.982 396.968 DL
(1985)286.582 405.608 Q 336.982 393.368 336.982 396.968 DL(1990)322.582
405.608 Q 372.982 393.368 372.982 396.968 DL(1995)358.582 405.608 Q
408.982 393.368 408.982 396.968 DL(2000)394.582 405.608 Q 444.982
393.368 444.982 396.968 DL(2005)430.582 405.608 Q 177.502 396.248
177.502 396.968 DL 179.662 396.248 177.502 396.248 DL 179.662 396.968
179.662 396.248 DL 184.702 378.248 184.702 396.968 DL 186.862 378.248
184.702 378.248 DL 186.862 396.968 186.862 378.248 DL 191.902 355.928
191.902 396.968 DL 194.062 355.928 191.902 355.928 DL 194.062 396.968
194.062 355.928 DL 199.102 265.928 199.102 396.968 DL 201.262 265.928
199.102 265.928 DL 201.262 396.968 201.262 265.928 DL 206.302 300.488
206.302 396.968 DL 208.462 300.488 206.302 300.488 DL 208.462 396.968
208.462 300.488 DL 213.502 281.048 213.502 396.968 DL 215.662 281.048
213.502 281.048 DL 215.662 396.968 215.662 281.048 DL 220.702 353.768
220.702 396.968 DL 222.862 353.768 220.702 353.768 DL 222.862 396.968
222.862 353.768 DL 227.902 379.688 227.902 396.968 DL 230.062 379.688
227.902 379.688 DL 230.062 396.968 230.062 379.688 DL 235.102 388.328
235.102 396.968 DL 237.262 388.328 235.102 388.328 DL 237.262 396.968
237.262 388.328 DL 242.302 382.568 242.302 396.968 DL 244.462 382.568
242.302 382.568 DL 244.462 396.968 244.462 382.568 DL 249.502 391.208
249.502 396.968 DL 251.662 391.208 249.502 391.208 DL 251.662 396.968
251.662 391.208 DL 256.702 391.928 256.702 396.968 DL 258.862 391.928
256.702 391.928 DL 258.862 396.968 258.862 391.928 DL 263.902 384.728
263.902 396.968 DL 266.062 384.728 263.902 384.728 DL 266.062 396.968
266.062 384.728 DL 271.102 376.088 271.102 396.968 DL 273.262 376.088
271.102 376.088 DL 273.262 396.968 273.262 376.088 DL 278.302 370.328
278.302 396.968 DL 280.462 370.328 278.302 370.328 DL 280.462 396.968
280.462 370.328 DL 285.502 361.688 285.502 396.968 DL 287.662 361.688
285.502 361.688 DL 287.662 396.968 287.662 361.688 DL 292.702 368.888
292.702 396.968 DL 294.862 368.888 292.702 368.888 DL 294.862 396.968
294.862 368.888 DL 299.902 367.448 299.902 396.968 DL 302.062 367.448
299.902 367.448 DL 302.062 396.968 302.062 367.448 DL 307.102 379.688
307.102 396.968 DL 309.262 379.688 307.102 379.688 DL 309.262 396.968
309.262 379.688 DL 314.302 366.728 314.302 396.968 DL 316.462 366.728
314.302 366.728 DL 316.462 396.968 316.462 366.728 DL 321.502 363.848
321.502 396.968 DL 323.662 363.848 321.502 363.848 DL 323.662 396.968
323.662 363.848 DL 328.702 359.528 328.702 396.968 DL 330.862 359.528
328.702 359.528 DL 330.862 396.968 330.862 359.528 DL 335.902 355.928
335.902 396.968 DL 338.062 355.928 335.902 355.928 DL 338.062 396.968
338.062 355.928 DL 343.102 328.568 343.102 396.968 DL 345.262 328.568
343.102 328.568 DL 345.262 396.968 345.262 328.568 DL 350.302 328.568
350.302 396.968 DL 352.462 328.568 350.302 328.568 DL 352.462 396.968
352.462 328.568 DL 357.502 270.968 357.502 396.968 DL 359.662 270.968
357.502 270.968 DL 359.662 396.968 359.662 270.968 DL 364.702 263.768
364.702 396.968 DL 366.862 263.768 364.702 263.768 DL 366.862 396.968
366.862 263.768 DL 371.902 302.648 371.902 396.968 DL 374.062 302.648
371.902 302.648 DL 374.062 396.968 374.062 302.648 DL 379.102 274.568
379.102 396.968 DL 381.262 274.568 379.102 274.568 DL 381.262 396.968
381.262 274.568 DL 386.302 258.728 386.302 396.968 DL 388.462 258.728
386.302 258.728 DL 388.462 396.968 388.462 258.728 DL 393.502 228.488
393.502 396.968 DL 395.662 228.488 393.502 228.488 DL 395.662 396.968
395.662 228.488 DL 400.702 210.488 400.702 396.968 DL 402.862 210.488
400.702 210.488 DL 402.862 396.968 402.862 210.488 DL 407.902 196.088
407.902 396.968 DL 410.062 196.088 407.902 196.088 DL 410.062 396.968
410.062 196.088 DL 415.102 257.288 415.102 396.968 DL 417.262 257.288
415.102 257.288 DL 417.262 396.968 417.262 257.288 DL 422.302 238.568
422.302 396.968 DL 424.462 238.568 422.302 238.568 DL 424.462 396.968
424.462 238.568 DL 429.502 227.768 429.502 396.968 DL 431.662 227.768
429.502 227.768 DL 431.662 396.968 431.662 227.768 DL 436.702 194.648
436.702 396.968 DL 438.862 194.648 436.702 194.648 DL 438.862 396.968
438.862 194.648 DL(was produced by the source lines:)41.782 444.944 Q
129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 20])
108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.DS B)56.692 108.944
Q(.G1)56.692 120.944 Q 7.2(#S)56.692 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)56.692 144.944 Q
(label left "Number" "of RFCs" left 0.6 ; label bot "YEAR" up 0.066667)
56.692 156.944 Q
(label top "Number of RFC documents per YEAR" down 0.233333)56.692
168.944 Q(ticks left in 0.1 from 0 to 300 by 50)56.692 180.944 Q
(ticks right in 0.1 from 0 to 300 by 50 "")56.692 192.944 Q
(ticks top in 0.1 from 1970 to 2005 by 5 "")56.692 204.944 Q
(ticks bot in 0.05 from 1970 to 2005 by 5)56.692 216.944 Q
(copy thru { line from $1-0.15,0 to $1-0.15,$2 ; \\)56.692 228.944 Q
(line from $1-0.15,$2 to $1+0.15,$2 ; \\)63.892 240.944 Q
(line from $1+0.15,$2 to $1+0.15,0 } until "EOF")63.892 252.944 Q
(1968 1)56.692 264.944 Q(1969 26)56.692 276.944 Q(1970 57)56.692 288.944
Q(1971 182)56.692 300.944 Q(1972 134)56.692 312.944 Q(1973 161)56.692
324.944 Q(1974 60)56.692 336.944 Q(1975 24)56.692 348.944 Q(1976 12)
56.692 360.944 Q(1977 20)56.692 372.944 Q(1978 8)56.692 384.944 Q
(1979 7)56.692 396.944 Q(1980 17)56.692 408.944 Q(1981 29)56.692 420.944
Q(1982 37)56.692 432.944 Q(1983 49)56.692 444.944 Q(1984 39)56.692
456.944 Q(1985 41)56.692 468.944 Q(1986 24)56.692 480.944 Q(1987 42)
56.692 492.944 Q(1988 46)56.692 504.944 Q(1989 52)56.692 516.944 Q
(1990 57)56.692 528.944 Q(1991 95)56.692 540.944 Q(1992 95)56.692
552.944 Q(1993 175)56.692 564.944 Q(1994 185)56.692 576.944 Q(1995 131)
56.692 588.944 Q(1996 170)56.692 600.944 Q(1997 192)56.692 612.944 Q
(1998 234)56.692 624.944 Q(1999 259)56.692 636.944 Q(2000 279)56.692
648.944 Q(2001 194)56.692 660.944 Q(2002 220)56.692 672.944 Q(2003 235)
56.692 684.944 Q(2004 281)56.692 696.944 Q(EOF)56.692 708.944 Q(.G2)
56.692 720.944 Q(.DE)56.692 732.944 Q 129.6(Lilly Expires)56.692 768.944
R(November 6, 2005)7.2 E([Page 21])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(Grap produces output in pic input format; it is subsequently)41.782
108.944 Q(processed by pic to generate a graphical representation.)
41.782 120.944 Q(There are)14.4 E
(multiple implementations of both grap and pic, and there is also some)
41.782 132.944 Q
(interaction between pic\255produced output and formatters.)41.782
144.944 Q(In)14.4 E
(particular, some implementations of grap produce pic with dimensions)
41.782 156.944 Q
(unsuitable for generating plain text in Internet\255Draft/RFC format.)
41.782 168.944 Q
(Authors who include graphs should be aware of these issues; they can)
41.782 180.944 Q(be safely ignored if no graphs are included.)41.782
192.944 Q
(For consistency, the output produced by grap and pic should be)41.782
216.944 Q
(examined to confirm that the height is specified as a multiple of 1/6)
41.782 228.944 Q
(inch and the width is a multiple of 0.1 inch, not exceeding 7.2)41.782
240.944 Q 7.2(inches. Placement)41.782 252.944 R
(of labels should also be checked between text)7.2 E
(\(nroff\) and PostScript \(troff\) versions, and adjustments to the)
41.782 264.944 Q(source graph specification made as required.)41.782
276.944 Q(A.3.4. Simple Diagrams)20.182 300.944 Q
(Pic [I6.CSTR116] can produce simple diagrams.)41.782 324.944 Q
(Text output)14.4 E
(approximation is limited to rectilinear lines, so one should avoid)
41.782 336.944 Q(ellipses, splines, etc.)41.782 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)
41.782 360.944 Q
(inch\) for consistency between text and troff\255formatted documents.)
41.782 372.944 Q(For example:)41.782 384.944 Q(.DS B)20.182 408.944 Q
(.PS)20.182 420.944 Q(boxwid = 0.8)20.182 432.944 Q 7.2(#a)20.182
444.944 S(rrow approximation that looks acceptable in troff and nroff)
-7.2 E(define myarrow X A: [ move right 0.055;\\)20.182 456.944 Q
("<" ljust;line right \($1 \255 0.1\);">" rjust;\\)27.382 468.944 Q
(move right 0.045 ]\\)27.382 480.944 Q(X)20.182 492.944 Q
(User: box ht 0.333333 "User")20.182 504.944 Q
(FS: box ht 0.666667 "File" "System" with .n at User.s \2550, 0.333333)
20.182 516.944 Q
(Client: box ht 1.333333 wid 1.1 "Client\\\255" "SMTP" \\)20.182 528.944
Q(with .sw at FS.se +0.5, 0)27.382 540.944 Q
("SMTP client" rjust at Client.se \2550, 0.166667)20.182 552.944 Q
(move to User.e ; myarrow\(0.5\))20.182 564.944 Q
(move to FS.e ; myarrow\(0.5\))20.182 576.944 Q
(move to Client.e ; SMTP: myarrow\(1.8\))20.182 588.944 Q
(Server: box ht 1.333333 wid 1.1 "Server\\\255" "SMTP" \\)20.182 600.944
Q(with .sw at Here.x, Client.s.y)27.382 612.944 Q
(box invis ht 0.5 "SMTP" "Commands/Replies" with .s at SMTP.c)20.182
624.944 Q(box invis ht 0.25 "and Mail" with .n at SMTP.c)20.182 636.944
Q("SMTP server" ljust at Server.sw -0, 0.166667)20.182 648.944 Q
(move to Server.e.x, FS.e.y ; myarrow\(0.5\))20.182 660.944 Q
(FS2: box ht 0.666667 "File" "System" \\)20.182 672.944 Q
(with .sw at Server.se.x +0.5, FS.s.y)27.382 684.944 Q(.PE)20.182
696.944 Q(.DE)20.182 708.944 Q 129.6(Lilly Expires)20.182 768.944 R
(November 6, 2005)7.2 E([Page 22])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(The diagram looks like this:)78.292 108.944 Q .48 LW 135.892 156.92
78.292 156.92 DL 135.892 132.944 135.892 156.92 DL 78.292 132.944
135.892 132.944 DL 78.292 156.92 78.292 132.944 DL(User)92.692 147.608 Q
135.892 228.92 78.292 228.92 DL 135.892 180.896 135.892 228.92 DL 78.292
180.968 135.892 180.968 DL 78.292 228.992 78.292 180.968 DL(File)92.692
201.584 Q(System)85.492 213.584 Q 251.092 228.92 171.892 228.92 DL
251.092 132.944 251.092 228.92 DL 171.892 132.944 251.092 132.944 DL
171.892 228.92 171.892 132.944 DL(Client\255)186.292 177.608 Q(SMTP)
197.092 189.608 Q(SMTP client)171.892 243.584 Q(<)139.852 147.608 Q
168.652 144.968 139.852 144.968 DL(>)161.452 147.608 Q(<)139.852 207.584
Q 168.652 204.944 139.852 204.944 DL(>)161.452 207.584 Q(<)255.052
183.608 Q 377.452 180.968 255.052 180.968 DL(>)370.252 183.608 Q 459.892
228.92 380.692 228.92 DL 459.892 132.944 459.892 228.92 DL 380.692
132.944 459.892 132.944 DL 380.692 228.92 380.692 132.944 DL(Server\255)
395.092 177.608 Q(SMTP)405.892 189.608 Q(SMTP)301.492 159.608 Q
(Commands/Replies)258.292 171.608 Q(and Mail)287.092 192.608 Q
(SMTP server)380.692 243.584 Q(<)463.852 207.584 Q 492.652 204.944
463.852 204.944 DL(>)485.452 207.584 Q 553.492 228.92 495.892 228.92 DL
553.492 180.896 553.492 228.92 DL 495.892 180.968 553.492 180.968 DL
495.892 228.992 495.892 180.968 DL(File)510.292 201.584 Q(System)503.092
213.584 Q
(Some versions of pic are able to approximate arrows well; others are)
78.292 264.944 Q 7.2(not. The)78.292 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.)78.292
288.944 Q(Some)14.4 E
(implementations of pic generate output for multi\255line text labels)
78.292 300.944 Q
(which does not work well with some implementations of nroff.)78.292
312.944 Q(Authors)14.4 E
(who include graphs and diagrams should be aware of these issues; they)
78.292 324.944 Q
(can be safely ignored if no graphs or diagrams are included.)78.292
336.944 Q(A.3.5. Tables)56.692 360.944 Q
(Tables may be formatted using the tbl program [I4.CSTR49].)78.292
384.944 Q
(Horizontal rules produced in troff\255formatted documents take less)
78.292 396.944 Q
(vertical space than those formatted by nroff, throwing off page)78.292
408.944 Q(breaks unless special precautions are taken.)78.292 420.944 Q
(Consistent vertical)14.4 E
(space may be forced by using the following sequence of lines to)78.292
432.944 Q(produce full\255width horizontal rules:)78.292 444.944 Q
(.mk vP)56.692 468.944 Q(.if t .sp 0.33P)56.692 480.944 Q(_)56.692
492.944 Q(.if t .sp |\\n\(vPu+1P)56.692 504.944 Q
(Those lines perform the following steps to ensure consistency:)78.292
528.944 Q 14.4(1. Mark)78.292 552.944 R
(the current vertical place in register vP.)7.2 E 14.4(2. For)78.292
576.944 R
(troff \(but not nroff\), move down approximately one\255third of)7.2 E
7.2(at)114.292 588.944 S(ext line.)-7.2 E
(This approximately centers the horizontal rule in)14.4 E
(the vertical space in troff.)114.292 600.944 Q 14.4(3. Emit)78.292
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.)114.292
636.944 Q 14.4(4. In)78.292 660.944 R
(troff, move to 1 text line below the previously\255marked)7.2 E
(vertical position.)114.292 672.944 Q
(This corresponds to the vertical position)14.4 E
(produced by nroff after a horizontal rule.)114.292 684.944 Q
(Different implementations of tbl produce slightly different output.)
78.292 708.944 Q
(For example, horizontal rules in text output are sometimes produced)
78.292 720.944 Q
(with a series of underscore characters; other implementations may use)
78.292 732.944 Q(dash \(hyphen\) characters.)78.292 744.944 Q
(While underscoring looks more attractive)14.4 E 129.6(Lilly Expires)
56.692 768.944 R(November 6, 2005)7.2 E([Page 23])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(in heading rules than hyphens, it can interact poorly with text when)
41.782 108.944 Q(used within a table.)41.782 120.944 Q
(Some implementations of tbl require extensions specific to a)41.782
144.944 Q(particular implementation of formatters.)41.782 156.944 Q
(A.3.6. ABNF)20.182 180.944 Q
(ABNF as described in [I18.RFC2234] can be difficult to format.)41.782
204.944 Q(ABNF)14.4 E
(could be formatted manually as one or more displays, or tbl could be)
41.782 216.944 Q(used to align related sets of ABNF rules.)41.782
228.944 Q(Both of those options)14.4 E
(require significant manual effort.)41.782 240.944 Q(Another option is \
to use a preprocessor that reads free\255form ABNF and)41.782 264.944 Q
(formats it for presentation.)41.782 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)41.782 288.944 Q
(with any rule to begin without whitespace before the semicolon)41.782
300.944 Q
(\(unlike RFC 2234\) and does not require an old\255fashioned teletype)
41.782 312.944 Q("carriage return" control character before the end\255\
of\255line \(also)41.782 324.944 Q(unlike RFC 2234\)\).)41.782 336.944 Q
(ABNF is provided between macro lines AS and AE)14.4 E
(\(ABNF start and ABNF end\).)41.782 348.944 Q
(Within that ABNF section, another macro,)14.4 E(BC, is recognized.)
41.782 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)
41.782 372.944 Q
(block to the right of the rule definition with running comment text)
41.782 384.944 Q
(formatted in a block approximately the same height as the ABNF)41.782
396.944 Q(definition.)41.782 408.944 Q(For example, the input:)41.782
432.944 Q(.AS 6 72 cgsntr)20.182 456.944 Q
(FWS = \( [ *WSP CRLF ] 1*WSP \) / obs-FWS)20.182 468.944 Q 7.2(;F)14.4
G(olding white space)-7.2 E(.BC)20.182 504.944 Q 7.2(ctext =)20.182
516.944 R(NO-WS-CTL /)21.6 E 7.2(;N)36 G(on white space controls.)-7.2 E
(%d33-39 /)192.982 528.944 Q 7.2(;T)50.4 G(he rest of the US-ASCII)-7.2
E(%d42-91 /)56.182 540.944 Q 14.4(;c)50.4 G
(haracters not including "\(",)-14.4 E 50.4(%d93-126 ;)192.982 552.944 R
("\)", or ")14.4 E 14.4(ccontent =)20.182 576.944 R
(ctext/quoted-pair/COMMENT)50.4 E 57.6(comment =)20.182 588.944 R
("\(" *\([FWS] ccontent\) [FWS] "\)")14.4 E
(CFWS=*\([FwS] comment\) \(\([fws] comment\) / fWs\))20.182 600.944 Q
(.AE)20.182 612.944 Q(produces formatted ABNF which looks like:)41.782
636.944 Q 28.8(CFWS =)63.382 660.944 R
(*\([FWS] comment\) \(\([FWS] comment\) / FWS\))7.2 E 7.2(comment =)
63.382 684.944 R("\(" *\([FWS] ccontent\) [FWS] "\)")7.2 E
(ccontent = ctext / quoted-pair / comment)63.382 708.944 Q 129.6
(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 24])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 21.6(ctext =)99.892
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)179.092
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(/%)179.092 132.944 S 57.6(d93-126 ;)-7.2 F
(including "\(", "\)", or ")7.2 E 36(FWS =)99.892 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)
78.292 180.944 Q(that an ABNF rule won't be split across a page break.)
78.292 192.944 Q(Optional)14.4 E
(arguments to the AS macro are numbers \(not troff register references,)
78.292 204.944 Q 7.2(etc.\) which)78.292 216.944 R
(indicate the indent and line length in characters, and)7.2 E
(one\255character option flags which control processing:)78.292 228.944
Q 183.6(Flag Description)78.292 252.944 R .48 LW 567.892 261.904 78.292
261.904 DL(c)89.092 276.944 Q
(canonicalize case of character literals; type \(letter after '%'\))
107.092 276.944 Q
(is lower\255case, hexadecimal digit letters are upper\255case.)107.092
288.944 Q
(Rulename references use the same case as the defining ABNF line.)
107.092 300.944 Q(d)89.092 312.944 Q
(omit display wrappers around output rules, instead separating)107.092
312.944 Q(rules with an empty line.)107.092 324.944 Q
(This may be useful if the entire ABNF)14.4 E
(is placed within a display wrapper.)107.092 336.944 Q(g)89.092 348.944
Q(group concatenated elements in parentheses if in an alternation)
107.092 348.944 Q(expression)107.092 360.944 Q(n)89.092 372.944 Q
(normalize repetition specifications: 0*1foo becomes [foo], M[foo)
107.092 372.944 Q(bar] becomes *M\(foo bar\), etc.)107.092 384.944 Q(s)
89.092 396.944 Q
(Combine adjacent quoted strings into a single quoted string)107.092
396.944 Q(where possible)107.092 408.944 Q(t)89.092 420.944 Q
(topologically sort rules in a ruleset so that productions are)107.092
420.944 Q(defined before use)107.092 432.944 Q(r)89.092 444.944 Q
(reverse the sense of topological sorting; use precedes)107.092 444.944
Q(definition \(ineffective if the t flag is not specified\))107.092
456.944 Q(A.3.7. Client-Server Protocol Exchanges)56.692 480.944 Q
(Some documents illustrate client server exchanges such as:)78.292
504.944 Q(S: 220 foo.example.net)78.292 528.944 Q
(C: helo bar.example.com)78.292 552.944 Q(S: 250 blah blah blah)78.292
576.944 Q(C: quit)78.292 600.944 Q(S: 221 Go in peace)78.292 624.944 Q
(Depending on the specific protocol and how it is desired to be)78.292
648.944 Q
(formatted and grouped, displays, paragraphs, a list, or a table might)
78.292 660.944 Q(be used to format such an exchange.)78.292 672.944 Q
(The example above uses a single)14.4 E(indented display, specified as:)
78.292 684.944 Q 129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)
7.2 E([Page 25])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.DS I)20.182 108.944
Q(S: 220 foo.example.net)20.182 120.944 Q(C: helo bar.example.com)20.182
144.944 Q(S: 250 blah blah blah)20.182 168.944 Q(C: quit)20.182 192.944
Q(S: 221 Go in peace)20.182 216.944 Q(.DE)20.182 228.944 Q
(Here is the same example as a variable list:)41.782 252.944 Q 14.4
(S: 220)41.782 276.944 R(foo.example.net)7.2 E 14.4(C: helo)41.782
300.944 R(bar.example.com)7.2 E 14.4(S: 250)41.782 324.944 R
(blah blah blah)7.2 E 14.4(C: quit)41.782 348.944 R 14.4(S: 221)41.782
372.944 R(Go in peace)7.2 E
(Lists items are implemented as paragraphs, so formatting as)41.782
396.944 Q(paragraphs will look the same.)41.782 408.944 Q
(The list was specified as:)14.4 E(.VL)20.182 432.944 Q(.LI S:)20.182
444.944 Q(220 foo.example.net)20.182 456.944 Q(.LI C:)20.182 468.944 Q
(helo bar.example.com)20.182 480.944 Q(.LI S:)20.182 492.944 Q
(250 blah blah blah)20.182 504.944 Q(.LI C:)20.182 516.944 Q(quit)20.182
528.944 Q(.LI S:)20.182 540.944 Q(221 Go in peace)20.182 552.944 Q(.LE)
20.182 564.944 Q(Below is the same example formatted as a table:)41.782
588.944 Q -1.2(S: 220)41.782 612.944 R(foo.example.net)7.2 E -1.2
(C: helo)41.782 636.944 R(bar.example.com)7.2 E -1.2(S: 250)41.782
660.944 R(blah blah blah)7.2 E -1.2(C: quit)41.782 684.944 R -1.2
(S: 221)41.782 708.944 R(Go in peace)7.2 E(The table was specified by:)
41.782 732.944 Q 129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)
7.2 E([Page 26])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E(.TS)56.692 108.944 Q
(tab \(~\);)56.692 120.944 Q(l1 l.)56.692 132.944 Q
(S:~220 foo.example.net)56.692 144.944 Q(C:~helo bar.example.com)56.692
168.944 Q(S:~250 blah blah blah)56.692 192.944 Q(C:~quit)56.692 216.944
Q(S:~221 Go in peace)56.692 240.944 Q(.TE)56.692 252.944 Q 56.692
276.944 EBEGIN
[/Title (A.4. Postprocessing) /Dest (SA.4.) /OUT pdfmark
EEND 56.692 276.944 EBEGIN
[/Dest (SA.4.) /Page 27 /View [ /FitH 552 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.4. Postprocessing)56.692 276.944 Q
(Scripts are available for use with the awk [I19.awk] interpreter for)
78.292 300.944 Q
(postprocessing of text and PostScript formatter output \(primarily to)
78.292 312.944 Q
(reorder pages so that the Table of Contents appears in the correct)
78.292 324.944 Q
(location, although the postprocessor for text also removes)78.292
336.944 Q 7.2(overstriking\). A)78.292 348.944 R
(sed [I20.sed] script is available to assist in)7.2 E
(preparation of HTML formatting.)78.292 360.944 Q 56.692 384.944 EBEGIN
[/Title (A.5. Proofreading and Checking Output) /Dest (SA.5.) /OUT pdfmark
EEND 56.692 384.944 EBEGIN
[/Dest (SA.5.) /Page 27 /View [ /FitH 444 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(A.5. Proofreading and Checking Output)56.692
384.944 Q(It is so easy to incorporate references that it is easy to)
78.292 408.944 Q
(unintentionally include a given reference more than once.)78.292
420.944 Q(While)14.4 E
(authors can generally be nonchalant about formatting of references,)
78.292 432.944 Q
(references should be proofread carefully to check for duplicates,)
78.292 444.944 Q
(references categorized as normative which should instead be)78.292
456.944 Q(informative or vice versa, etc.)78.292 468.944 Q
(Henrik Levkowetz' "idnits" program [I14.idnits] is useful for)78.292
492.944 Q
(catching diagrams and tables that exceed the maximum allowed line)
78.292 504.944 Q(length.)78.292 516.944 Q 56.692 540.944 EBEGIN
[/Title (Appendix B. Macros Specifically for the RFC Editor) /Dest (SB.) /OUT pdfmark
EEND 56.692 540.944 EBEGIN
[/Dest (SB.) /Page 27 /View [ /FitH 288 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix B. Macros Specifically for the RFC Editor)56.692 540.944 Q
(In addition to the NU, FN, UD, OB, IS, and CA macros discussed in the)
78.292 564.944 Q
(body of this memo, there are several macros intended for RFC Editor)
78.292 576.944 Q(\(rather than author\) use.)78.292 588.944 Q
(They are described in this Appendix.)14.4 E 56.692 612.944 EBEGIN
[/Title (B.1. IESG Notes) /Dest (SB.1.) /OUT pdfmark
EEND 56.692 612.944 EBEGIN
[/Dest (SB.1.) /Page 27 /View [ /FitH 216 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(B.1. IESG Notes)56.692 612.944 Q
(The IN macro takes a single numeric argument indicating the type of)
78.292 636.944 Q
(IESG note to be included; some types take a second argument:)78.292
648.944 Q 8.4(Type 2nd)78.292 672.944 R 165.6(Argument Text)7.2 F .48 LW
561.892 681.904 78.292 681.904 DL 22.8(1n)89.092 696.944 S(one)-22.8 E
(The IESG has not found any conflict between)230.692 696.944 Q
(this document and IETF work.)230.692 708.944 Q 129.6(Lilly Expires)
56.692 768.944 R(November 6, 2005)7.2 E([Page 27])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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(2W)52.582 132.944 S(orking Group)-22.8 E
(The IESG thinks that this work is related to)194.182 132.944 Q
(IETF work done in WG Working Group, but this)194.182 144.944 Q
(does not prevent publishing.)194.182 156.944 Q 22.8(3W)52.582 168.944 S
(orking Group)-22.8 E(The IESG thinks that publication is harmful to)
194.182 168.944 Q(the IETF work done in WG Working Group and)194.182
180.944 Q(recommends not publishing the document at this)194.182 192.944
Q(time.)194.182 204.944 Q 22.8(4P)52.582 216.944 S(rocedure)-22.8 E
(The IESG thinks that this document violates)194.182 216.944 Q
(IETF procedures for Procedure and should)194.182 228.944 Q
(therefore not be published without IETF review)194.182 240.944 Q
(and IESG approval.)194.182 252.944 Q 22.8(5n)52.582 264.944 S(one)-22.8
E(The IESG thinks that this document extends an)194.182 264.944 Q
(IETF protocol in a way that requires IETF)194.182 276.944 Q
(review and should therefore not be published)194.182 288.944 Q
(without IETF review and IESG approval.)194.182 300.944 Q 22.8(6n)52.582
312.944 S(one)-22.8 E(The content of this RFC was at one time)194.182
312.944 Q(considered by the IETF, and therefore it may)194.182 324.944 Q
(resemble a current IETF work in progress or a)194.182 336.944 Q
(published IETF work.)194.182 348.944 Q(This RFC is not a)14.4 E
(candidate for any level of Internet Standard.)194.182 360.944 Q
(The IETF disclaims any knowledge of the)194.182 372.944 Q
(fitness of this RFC for any purpose and in)194.182 384.944 Q
(particular notes that the decision to publish)194.182 396.944 Q
(is not based on IETF review for such things as)194.182 408.944 Q
(security, congestion control, or inappropriate)194.182 420.944 Q
(interaction with deployed protocols.)194.182 432.944 Q(The RFC)14.4 E
(Editor has chosen to publish this document at)194.182 444.944 Q
(its discretion.)194.182 456.944 Q(Readers of this RFC should)14.4 E
(exercise caution in evaluating its value for)194.182 468.944 Q
(implementation and deployment.)194.182 480.944 Q(See RFC 3932)14.4 E
(for more information.)194.182 492.944 Q 22.8(7n)52.582 504.944 S(one)
-22.8 E(This RFC is not a candidate for any level of)194.182 504.944 Q
(Internet Standard.)194.182 516.944 Q(The IETF disclaims any)14.4 E
(knowledge of the fitness of this RFC for any)194.182 528.944 Q
(purpose and in particular notes that the)194.182 540.944 Q
(decision to publish is not based on IETF)194.182 552.944 Q
(review for such things as security, congestion)194.182 564.944 Q
(control, or inappropriate interaction with)194.182 576.944 Q
(deployed protocols.)194.182 588.944 Q(The RFC Editor has chosen)14.4 E
(to publish this document at its discretion.)194.182 600.944 Q
(Readers of this document should exercise)194.182 612.944 Q
(caution in evaluating its value for)194.182 624.944 Q
(implementation and deployment.)194.182 636.944 Q(See RFC 3932)14.4 E
(for more information.)194.182 648.944 Q 129.6(Lilly Expires)20.182
768.944 R(November 6, 2005)7.2 E([Page 28])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 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(8n)89.092 132.944 S(one)-22.8 E
(This RFC is not a candidate for any level of)230.692 132.944 Q
(Internet Standard.)230.692 144.944 Q(The IETF disclaims any)14.4 E
(knowledge of the fitness of this RFC for any)230.692 156.944 Q
(purpose and notes that the decision to publish)230.692 168.944 Q
(is not based on IETF review apart from IESG)230.692 180.944 Q
(review for conflict with IETF work.)230.692 192.944 Q(The RFC)14.4 E
(Editor has chosen to publish this document at)230.692 204.944 Q
(its discretion.)230.692 216.944 Q(See RFC 3932 for more)14.4 E
(information.)230.692 228.944 Q
(If a type of 0 \(zero\) is specified, text after the IN macro line is)
78.292 252.944 Q 7.2(collected. The)78.292 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)
78.292 276.944 Q(the table above.)78.292 288.944 Q
(The IN macro should be placed in the front matter \(before the first)
78.292 312.944 Q(SH or NH macro\).)78.292 324.944 Q
(The corresponding note will be formatted as an)14.4 E
(unnumbered section appearing before the Abstract.)78.292 336.944 Q
(If no IN macro)14.4 E
(call is placed in the front matter section, no IESG note will be)78.292
348.944 Q(included in the document.)78.292 360.944 Q 56.692 384.944
EBEGIN
[/Title (B.2. Alternate Document Type and Number) /Dest (SB.2.) /OUT pdfmark
EEND 56.692 384.944 EBEGIN
[/Dest (SB.2.) /Page 29 /View [ /FitH 444 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(B.2. Alternate Document Type and Number)56.692
384.944 Q(Some RFCs are also BCP, STD, or FYI documents.)78.292 408.944
Q(The RFC Editor may)14.4 E
(indicate such a document type and number via the AN macro.)78.292
420.944 Q(It takes)14.4 E
(two arguments; the type \(which must be one of BCP, STD, or FYI\) and)
78.292 432.944 Q(the number corresponding to that type.)78.292 444.944 Q
(The information is placed in)14.4 E
(the first page heading, properly formatted.)78.292 456.944 Q
(The AN macro should also)14.4 E(be placed in the front matter.)78.292
468.944 Q 56.692 492.944 EBEGIN
[/Title (Appendix C. Document Progression Using the rfc Macros) /Dest (SC.1.) /OUT pdfmark
EEND 56.692 492.944 EBEGIN
[/Dest (SC.1.) /Page 29 /View [ /FitH 336 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix C. Document Progression Using the rfc Macros)56.692 492.944 Q
56.692 516.944 EBEGIN
[/Title (C.1. Initial Internet-Draft) /Dest (SC.1.) /OUT pdfmark
EEND 56.692 516.944 EBEGIN
[/Dest (SC.1.) /Page 29 /View [ /FitH 312 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.1. Initial Internet-Draft)56.692 516.944 Q
(An initial draft using the rfc macros should specify a draft number)
78.292 540.944 Q
(version of 00 by supplying a \2551 argument to the NU macro or via)
78.292 552.944 Q(command\255line specification of register N.)78.292
564.944 Q(The latter may be)14.4 E
(accomplished by editing a line in the Makefile.)78.292 576.944 Q
(Document category)14.4 E
(\(CA macro\) can be ignored, or can be specified to indicate intended)
78.292 588.944 Q 7.2(status. The)78.292 600.944 R
(draft file name \(see [N3.ID]\) should be specified via)7.2 E
(the FN macro.)78.292 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)
78.292 624.944 Q
(Contents parameters \(TC macro or command\255line register)78.292
636.944 Q 7.2(specifications\). An)78.292 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,)
78.292 660.944 Q
(and references, plus any diagrams or other non\255textual material.)
78.292 672.944 Q
(The document is then formatted and the text version submitted as an)
78.292 696.944 Q(Internet\255Draft [N3.ID].)78.292 708.944 Q
(During processing, the rfc macro package checks for certain types of)
78.292 732.944 Q(errors and issues warnings and other messages.)78.292
744.944 Q(If such a message)14.4 E 129.6(Lilly Expires)56.692 768.944 R
(November 6, 2005)7.2 E([Page 29])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(appears, it is advisable to consider a revision to the document or)
41.782 108.944 Q(other appropriate action.)41.782 120.944 Q 20.182
144.944 EBEGIN
[/Title (C.2. Subsequent Draft Revisions) /Dest (SC.2.) /OUT pdfmark
EEND 20.182 144.944 EBEGIN
[/Dest (SC.2.) /Page 30 /View [ /FitH 684 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.2. Subsequent Draft Revisions)20.182 144.944 Q
(Each revision involves updating the argument to the NU macro or)41.782
168.944 Q(command\255line register N specification \(sequencing to \255\
2, then \2553,)41.782 180.944 Q
(etc.\) and making desired changes to the content.)41.782 192.944 Q
(Note that if the)14.4 E
(file name is changed, the numbering must be restarted at 00.)41.782
204.944 Q(If a)14.4 E
(Makefile is used, it too should be updated to reflect the revised)
41.782 216.944 Q(version numbering.)41.782 228.944 Q
(The document is reformatted and resubmitted as a revised Draft)41.782
252.944 Q([N3.ID].)41.782 264.944 Q 20.182 288.944 EBEGIN
[/Title (C.3. Publication as an RFC) /Dest (SC.3.) /OUT pdfmark
EEND 20.182 288.944 EBEGIN
[/Dest (SC.3.) /Page 30 /View [ /FitH 540 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(C.3. Publication as an RFC)20.182 288.944 Q
(The Abstract may be retained \(possibly edited\) or removed.)41.782
312.944 Q(Document)14.4 E
(category should be specified in consultation with the IETF or RFC)
41.782 324.944 Q 7.2(Editor. The)41.782 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\);)41.782
348.944 Q
(the RFC Editor will assign an RFC number at the time of publication.)
41.782 360.944 Q
(The document is reformatted and sent to the RFC Editor.)41.782 372.944
Q(By prior)14.4 E
(arrangement with the RFC Editor, the document source can be sent, as)
41.782 384.944 Q(that may simplify final formatting by the RFC Editor.)
41.782 396.944 Q 20.182 420.944 EBEGIN
[/Title (Appendix D. Obtaining the rfc Macros and Related Tools) /Dest (SD.) /OUT pdfmark
EEND 20.182 420.944 EBEGIN
[/Dest (SD.) /Page 30 /View [ /FitH 408 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Appendix D. Obtaining the rfc Macros and Related Tools)20.182 420.944 Q
(The rfc macros and related tools are currently available at)41.782
444.944 Q 7.2(http://users.erols.com/blilly/formatting. Individual)
41.782 456.944 R(files are:)7.2 E 289.2(File Description)41.782 480.944
R .48 LW 528.982 489.904 41.782 489.904 DL 177.6(tmac.rfc the)41.782
504.944 R(rfc macros)7.2 E(Makefile)41.782 516.944 Q 7.2(am)284.182
516.944 S(akefile used to automate)-7.2 E
(preprocessing, formatting, and)284.182 528.944 Q 7.2
(postprocessing. It)284.182 540.944 R(can be)7.2 E
(modified as needed for specific)284.182 552.944 Q(documents.)284.182
564.944 Q(repaginate.awk)41.782 576.944 Q(an awk script used for)284.182
576.944 Q(postprocessing text output.)284.182 588.944 Q(It)14.4 E
(reorders pages so that the Table)284.182 600.944 Q
(of Contents appears in the correct)284.182 612.944 Q(location.)284.182
624.944 Q(psrenumber.awk)41.782 636.944 Q
(an awk script for postprocessing)284.182 636.944 Q(PostScript output.)
284.182 648.944 Q(It reorders)14.4 E(pages so that the Table of)284.182
660.944 Q(Contents appears in the correct)284.182 672.944 Q(location.)
284.182 684.944 Q(htmlize.sed)41.782 696.944 Q 7.2(as)284.182 696.944 S
(ed script for HTML markup)-7.2 E(template.rfc)41.782 708.944 Q
(Template suitable as a draft)284.182 708.944 Q(starting point)284.182
720.944 Q(draft-lilly-using-troff\25504.rfc)41.782 732.944 Q
(the source for this document)284.182 732.944 Q 129.6(Lilly Expires)
20.182 768.944 R(November 6, 2005)7.2 E([Page 30])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 289.2
(File Description)78.292 108.944 R .48 LW 565.492 117.904 78.292 117.904
DL(draft-lilly-using-troff\25504.txt)78.292 132.944 Q
(text output for this document)320.692 132.944 Q
(draft-lilly-using-troff\25504.ps)78.292 144.944 Q
(PostScript output for this)320.692 144.944 Q(document)320.692 156.944 Q
(draft-lilly-using-troff\25504.pdf)78.292 168.944 Q
(PDF output for this document)320.692 168.944 Q
(draft-lilly-using-troff\25504.psa4)78.292 180.944 Q
(PostScript output for this)320.692 180.944 Q
(document, formatted for ISO A4)320.692 192.944 Q(paper)320.692 204.944
Q(draft-lilly-using-troff\25504.pdfa4)78.292 216.944 Q
(PDF output for this document,)320.692 216.944 Q
(formatted for ISO A4 paper)320.692 228.944 Q
(draft-lilly-using-troff\25504.html)78.292 240.944 Q
(HTML 4.01 Strict compliant version)320.692 240.944 Q
(of this document preserving page)320.692 252.944 Q
(layout and numbering)320.692 264.944 Q
(There are also subdirectories containing source code and related)78.292
288.944 Q
(files for the ABNF formatter and reference formatter preprocessors.)
78.292 300.944 Q
(If the macros and related tools are deemed useful, it is hoped that)
78.292 324.944 Q(they might be relocated to the RFC Editor site.)78.292
336.944 Q 56.692 360.944 EBEGIN
[/Title (Appendix E. Summary of Directives) /Dest (SE.) /OUT pdfmark
EEND 56.692 360.944 EBEGIN
[/Dest (SE.) /Page 31 /View [ /FitH 468 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix E. Summary of Directives)56.692 360.944
Q(The following table summarizes rfc macro directives in alphabetical)
78.292 384.944 Q
(order \(macros specific to preprocessors and internal use macros are)
78.292 396.944 Q 7.2(omitted\). The)78.292 408.944 R
(section number containing detailed information about)7.2 E
(each macro is listed.)78.292 420.944 Q 10.8(Name Section)78.292 444.944
R(Description)147.6 E .48 LW 531.892 453.904 78.292 453.904 DL 18
(AB 5.3.1)85.492 468.944 R(Abstract)32.4 E 18(AN B.2)85.492 480.944 R
(Alternate document series number)46.8 E 18(AP 5.3.10 Appendix)85.492
492.944 R 18(AU 5.2.6)85.492 504.944 R(Author)32.4 E 18(BL 5.3.7.2)
85.492 516.944 R(Bullet list)18 E 18(CA 5.2.3)85.492 528.944 R
(Category or Intended status)32.4 E 18(DE 5.3.6)85.492 540.944 R
(Display end)32.4 E 18(DF 5.3.6)85.492 552.944 R(Floating display start)
32.4 E 18(DS 5.3.6)85.492 564.944 R(Display start)32.4 E 18(DT 5.2.7)
85.492 576.944 R(Date)32.4 E 18(ED 5.2.6)85.492 588.944 R(Editor)32.4 E
18(EM 5.4)85.492 600.944 R(End matter)46.8 E 18(FN 5.2.5)85.492 612.944
R(\(Internet-Draft\) file name \(w/o version\))32.4 E 18(IB 5.3.9)85.492
624.944 R(MIB \(or MIB\255like\) boilerplate)32.4 E 18(IE 5.3.8)85.492
636.944 R(Informative reference end)32.4 E 18(IN B.1)85.492 648.944 R
(IESG note)46.8 E 18(IP 5.3.3)85.492 660.944 R(Indented paragraph)32.4 E
18(IR 5.3.8)85.492 672.944 R(Informative reference start)32.4 E 18
(IS 5.2.9)85.492 684.944 R(Independent submission \(to RFC Editor\))32.4
E 18(KE 5.3.6)85.492 696.944 R(Keep end)32.4 E 18(KF 5.3.6)85.492
708.944 R(Floating keep start)32.4 E 18(KS 5.3.6)85.492 720.944 R
(Keep start)32.4 E 18(LE 5.3.7)85.492 732.944 R(List end)32.4 E 129.6
(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 31])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 10.8(Name Section)
41.782 108.944 R(Description)147.6 E .48 LW 495.382 117.904 41.782
117.904 DL 18(LI 5.3.7)48.982 132.944 R(List item)32.4 E 18(LP 5.3.3)
48.982 144.944 R(Left\255aligned paragraph)32.4 E 18(NE 5.3.8)48.982
156.944 R(Normative reference end)32.4 E 18(NH 5.3.2)48.982 168.944 R
(Numbered section heading)32.4 E 18(NL 5.3.7.1)48.982 180.944 R
(Numbered list)18 E 18(NR 5.3.8)48.982 192.944 R
(Normative reference start)32.4 E 18(NS 5.3.5)48.982 204.944 R
(Needed \(vertical\) space)32.4 E 18(NU 5.2.2)48.982 216.944 R
(RFC number or draft version)32.4 E 18(OB 5.2.4)48.982 228.944 R
(Obsoleted RFCs)32.4 E 18(ON 5.2.10 Optional)48.982 240.944 R(notice)7.2
E 18(RE 5.3.4)48.982 252.944 R(Decrease indent)32.4 E 18(RS 5.3.4)48.982
264.944 R(Increase indent)32.4 E 18(SH 5.3.2)48.982 276.944 R
(\(unnumbered\) Section heading)32.4 E 18(ST 5.2.1)48.982 288.944 R
(Short title for page heading)32.4 E 18(TC 5.2.8)48.982 300.944 R
(Table of contents specification)32.4 E 18(TL 5.2.1)48.982 312.944 R
(\(Long\) document title)32.4 E 18(UP 5.2.4)48.982 324.944 R
(Updated RFCs)32.4 E 18(VL 5.3.7.3)48.982 336.944 R(Variable list)18 E
20.182 360.944 EBEGIN
[/Title (Appendix F. Source File Directive Order) /Dest (SF.) /OUT pdfmark
EEND 20.182 360.944 EBEGIN
[/Dest (SF.) /Page 32 /View [ /FitH 468 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix F. Source File Directive Order)20.182
360.944 Q
(Some directives appear in certain parts of a source document as)41.782
384.944 Q(summarized in the following diagram.)41.782 396.944 Q
(For content ordering, see)14.4 E([I13.Instruct].)41.782 408.944 Q 50.4
(Part Directives)63.382 432.944 R(Comments)129.6 E .48 LW 520.582
441.904 41.782 441.904 DL 520.582 443.904 41.782 443.904 DL 39.6(NU RFC)
178.582 456.944 R(or draft version number)7.2 E 39.6(TL \(long\))178.582
468.944 R(Title)7.2 E 39.6(ST Short)178.582 480.944 R(title)7.2 E 39.6
(DT Date)178.582 492.944 R(override)7.2 E 39.6(AU Author)178.582 504.944
R 39.6(ED Editor)178.582 516.944 R 39.6(FN Internet\255Draft)178.582
528.944 R(file name)7.2 E 39.6(TC Table)178.582 540.944 R
(of contents parameters)7.2 E 39.6(CA category)178.582 552.944 R
(or Intended status)7.2 E 39.6(IS Independent)178.582 564.944 R
(submission)7.2 E 39.6(IN IESG)178.582 576.944 R(note)7.2 E 39.6
(ON Optional)178.582 588.944 R(notice)7.2 E 39.6(AN Alternate)178.582
600.944 R(series number)7.2 E 39.6(UP Updated)178.582 612.944 R(RFCs)7.2
E 39.6(OB Obsoleted)178.582 624.944 R(RFCs)7.2 E(Front)45.382 504.944 Q
(Matter)45.382 516.944 Q(\(before)45.382 528.944 Q(Abstract)45.382
540.944 Q(and first)45.382 552.944 Q(section)45.382 564.944 Q(heading\))
45.382 576.944 Q 520.582 633.904 41.782 633.904 DL 39.6(AB \(required)
178.582 648.944 R(for Internet\255Draft\))7.2 E 39.6(IP \(additional)
178.582 660.944 R(Abstract paragraphs\))7.2 E(Abstract)48.982 654.944 Q
520.582 669.904 41.782 669.904 DL 129.6(Lilly Expires)20.182 768.944 R
(November 6, 2005)7.2 E([Page 32])108 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\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 50.4
(Part Directives)99.892 108.944 R(Comments)129.6 E .48 LW 557.092
117.904 78.292 117.904 DL 557.092 119.904 78.292 119.904 DL 39.6
(NH Numbered)215.092 132.944 R(section)7.2 E 39.6(SH Unnumbered)215.092
144.944 R(section)7.2 E 39.6(NS Need)215.092 156.944 R
(\(vertical\) space)7.2 E
(......................................................)168.292 168.944
Q(IP, LP)200.692 180.944 Q(paragraphs)32.4 E
(......................................................)168.292 192.944
Q(RS, RE)200.692 204.944 Q(Indentation adjustment)32.4 E
(......................................................)168.292 216.944
Q(IR, IE)200.692 228.944 Q(BR, FR, RR, SR)171.892 240.944 Q
(Informative references)276.292 234.944 Q
(......................................................)168.292 252.944
Q(NR, NE)200.692 264.944 Q(BR, FR, RR, SR)171.892 276.944 Q
(Normative references)276.292 270.944 Q
(......................................................)168.292 288.944
Q(DS, DF, DE)186.292 300.944 Q(displays)18 E
(......................................................)168.292 312.944
Q(KS, KF, KE)186.292 324.944 Q(keeps)18 E
(......................................................)168.292 336.944
Q(BL, NL, VL)186.292 348.944 Q(LI, LE)200.692 360.944 Q(Lists)276.292
354.944 Q(......................................................)168.292
372.944 Q 39.6(IB MIB)215.092 384.944 R
(\(or MIB\255like\) copyright notice)7.2 E
(......................................................)168.292 396.944
Q(EQ, EN)200.692 408.944 Q(Mathematical equations)32.4 E
(......................................................)168.292 420.944
Q(TS, TH, T&, TE)171.892 432.944 Q(Tables)3.6 E
(......................................................)168.292 444.944
Q(AS, BC, AE)186.292 456.944 Q(ABNF)18 E
(......................................................)168.292 468.944
Q(PS, PE)200.692 480.944 Q(Diagrams)32.4 E
(......................................................)168.292 492.944
Q(G1, G2)200.692 504.944 Q(Graphs)32.4 E
(......................................................)168.292 516.944
Q(.begin, .end)179.092 528.944 Q(Data formats)10.8 E
(......................................................)168.292 540.944
Q(.cstart, .cend)171.892 552.944 Q(Chemical formulae)3.6 E
(......................................................)168.292 564.944
Q 39.6(AP Appendices)215.092 576.944 R(\(after bulk of body\))7.2 E
(Body and)78.292 348.944 Q(Appendices)78.292 360.944 Q 557.092 585.904
78.292 585.904 DL 39.6(EM last)215.092 600.944 R
(macro directive in source document)7.2 E(End Matter)78.292 600.944 Q
56.692 624.944 EBEGIN
[/Title (Appendix G. Disclaimers) /Dest (SG.) /OUT pdfmark
EEND 56.692 624.944 EBEGIN
[/Dest (SG.) /Page 33 /View [ /FitH 204 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix G. Disclaimers)56.692 624.944 Q
(This document has exactly one \(1\) author.)78.292 648.944 Q
(In spite of the fact that the author's given name may also be the)
78.292 672.944 Q
(surname of other individuals, and the fact that the author's surname)
78.292 684.944 Q
(may also be a given name for some females, the author is, and has)
78.292 696.944 Q(always been, male.)78.292 708.944 Q
(The presence of "or she", "/SHE", "each", "their", and "authors")78.292
732.944 Q
(\(plural\) in the boilerplate sections of this document is irrelevant.)
78.292 744.944 Q 129.6(Lilly Expires)56.692 768.944 R(November 6, 2005)
7.2 E([Page 33])108 E 0 Cg EP
%%Page: 34 34
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(The author of this document is not responsible for the boilerplate)
41.782 108.944 Q(text.)41.782 120.944 Q
(Comments regarding the silliness, lack of accuracy, and lack of)41.782
144.944 Q
(precision of the boilerplate text should be directed to the IESG, not)
41.782 156.944 Q(to the author.)41.782 168.944 Q 20.182 204.944 EBEGIN
[/Title (Appendix H. Change History) /Dest (SH.) /OUT pdfmark
EEND 20.182 204.944 EBEGIN
[/Dest (SH.) /Page 34 /View [ /FitH 624 ] /DEST pdfmark
EEND/F0 12/Courier@0 SF(Appendix H. Change History)20.182 204.944 Q
([[This change history will not be part of a published RFC]])41.782
228.944 Q(-03 to -04)41.782 252.944 Q 16.8<8341>63.382 276.944 S
(dded information about implementation \(preprocessor,)-16.8 E
(formatter, etc.\) issues)87.382 288.944 Q 16.8<835b>63.382 312.944 S
(updated Makefile, macros, scripts to improve compatibility])-16.8 E
16.8<835b>63.382 336.944 S
(updated htmlize.sed to guess at section number references,)-16.8 E
(URIs, and mailboxes])87.382 348.944 Q 16.8<8343>63.382 372.944 S
(orrected typos and errors in text)-16.8 E(-02 to -03)41.782 396.944 Q
16.8<8341>63.382 420.944 S
(dded ED macro directive description for document Editor \(vs.)-16.8 E
(Author\))87.382 432.944 Q 16.8<8366>63.382 456.944 S
(ixed file list to include draft version suffix)-16.8 E 16.8<8361>63.382
480.944 S(dded tip regarding duplicate references)-16.8 E 16.8<8361>
63.382 504.944 S(dded mention and reference to idnits)-16.8 E 16.8<835b>
63.382 528.944 S(added HTML generation to Makefile])-16.8 E 16.8<8361>
63.382 552.944 S(dded client\255server exchange examples)-16.8 E 16.8
<835b>63.382 576.944 S
(revised macros to enforce strict IETF Secretariat boilerplate)-16.8 E
(rules which appear to require authors to be hermaphroditic,)87.382
588.944 Q
(transsexual, \(individuals\) or multi\255gender teams effective 6)
87.382 600.944 Q(May 2005])87.382 612.944 Q 16.8<836c>63.382 636.944 S
(owered page count limit for TOC in accordance with)-16.8 E
(ID\255Checklist Revision 1.2)87.382 648.944 Q 16.8<8373>63.382 672.944
S(eparate paragraphs in RFC 3978 boilerplate \(idnits bug fixed\))-16.8
E 16.8<8375>63.382 696.944 S
(pdated reference to March 2005 version of 1id-guidelines)-16.8 E
(\(also reported typo, so there'll be yet another version\))87.382
708.944 Q 16.8<8363>63.382 732.944 S
(larified 0 as zero in default value column of register table)-16.8 E
(in Appendix A)87.382 744.944 Q 129.6(Lilly Expires)20.182 768.944 R
(November 6, 2005)7.2 E([Page 34])108 E 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 16.8<8361>99.892
108.944 S(dded summary of directives)-16.8 E 16.8<8361>99.892 132.944 S
(dded guide to directives in source document sections)-16.8 E 16.8<8372>
99.892 156.944 S(evised some wording)-16.8 E 16.8<8361>99.892 180.944 S
(dded grap example)-16.8 E 16.8<8372>99.892 204.944 S
(earranged directives in front matter to correspond to table)-16.8 E
(in appendix)123.892 216.944 Q 16.8<8361>99.892 240.944 S
(dded template document to files)-16.8 E 16.8<835b>99.892 264.944 S
(revised Makefile to better handle preprocessors])-16.8 E 16.8<835b>
99.892 288.944 S(revised Makefile to incorporate rfcref preprocessor])
-16.8 E 16.8<8361>99.892 312.944 S
(dded discussion of rfcref preprocessor)-16.8 E 16.8<835b>99.892 336.944
S(revised HTML generation to improve rendition of copyright)-16.8 E
(symbols and bullets])123.892 348.944 Q 16.8<835b>99.892 372.944 S
(revised HTML generation to provide reference anchors and)-16.8 E
(links])123.892 384.944 Q 16.8<835b>99.892 408.944 S
(revised HTML generation to provide table of contents anchors)-16.8 E
(and links])123.892 420.944 Q 16.8<835b>99.892 444.944 S
(split out much of HTML manipulation to htmlize.sed to)-16.8 E
(facilitate maintenance])123.892 456.944 Q 16.8<8361>99.892 480.944 S
(dded additional optional arguments to IB macro directive to)-16.8 E
(accommodate use within MIB syntax)123.892 492.944 Q 16.8<8361>99.892
516.944 S(dded disclaimers of boilerplate silliness, inaccuracy, and)
-16.8 E(imprecision)123.892 528.944 Q(-01 to -02)78.292 552.944 Q 16.8
<8361>99.892 576.944 S(dded this change history)-16.8 E 16.8<8361>99.892
600.944 S(dded acknowledgment re. reference style)-16.8 E 16.8<8372>
99.892 624.944 S
(emoved extraneous commas from preprocessor reference list)-16.8 E 16.8
<8363>99.892 648.944 S(orrected typos)-16.8 E 16.8<8372>99.892 672.944 S
(evised pic for SMTP diagram)-16.8 E 16.8<8361>99.892 696.944 S
(dded section regarding ABNF formatting)-16.8 E 16.8<8361>99.892 720.944
S(dded caveat regarding multiple paragraphs in a keep)-16.8 E 16.8<8361>
99.892 744.944 S(dded .NS macro to reserve vertical space)-16.8 E 129.6
(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 35])108 E 0
Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E 16.8<8375>63.382
108.944 S(pdated boilerplate for revised BCP 78 and BCP 79)-16.8 E
(-00 to -01)41.782 132.944 Q 16.8<8363>63.382 156.944 S
(larified issue w.r.t. low\255level directives \(as distinguished)-16.8
E(from macro call directives\))87.382 168.944 Q 16.8<8375>63.382 192.944
S(pdated Requirement levels to correspond to changed text)-16.8 E 16.8
<8373>63.382 216.944 S
(ome extraneous commas unintentionally crept into the list of)-16.8 E
(preprocessor references)87.382 228.944 Q 16.8<8361>63.382 252.944 S
(dded description of alternative methods for loading macros)-16.8 E 16.8
<8375>63.382 276.944 S
(pdated descriptions to incorporate setting registers from the)-16.8 E
(command line)87.382 288.944 Q 16.8<8361>63.382 312.944 S
(dded text regarding draft file name lower-case letters)-16.8 E
(requirement)87.382 324.944 Q 16.8<8369>63.382 348.944 S(mproved usage)
-16.8 E 16.8<8372>63.382 372.944 S
(earranged some text under Document Content heading)-16.8 E 16.8<8361>
63.382 396.944 S(dded recommendations regarding troff units)-16.8 E 16.8
<8369>63.382 420.944 S
(mproved differentiation between keeps and displays)-16.8 E 16.8<8369>
63.382 444.944 S(mproved table formatting)-16.8 E 16.8<8361>63.382
468.944 S(dded floating keeps and displays)-16.8 E 16.8<8361>63.382
492.944 S(dded pointer regarding text following a display)-16.8 E 16.8
<8361>63.382 516.944 S(dded optional argument to bulleted list macro)
-16.8 E 16.8<8361>63.382 540.944 S
(dded table of single\255character registers)-16.8 E 16.8<8361>63.382
564.944 S(dded description of formatting for paper sizes other than)
-16.8 E(ANSI A)87.382 576.944 Q 16.8<8361>63.382 600.944 S
(dded tips and tricks for eqn, chem, dformat, pic, and tbl)-16.8 E 16.8
<8361>63.382 624.944 S(dded description of document progression)-16.8 E
16.8<8361>63.382 648.944 S(dded ISO A4 versions of formatted documents)
-16.8 E(Normative References)20.182 672.944 Q([N1.RFC2223])41.782
696.944 Q 135.382 696.944 EBEGIN
[/Dest (N1) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Postel, J. and J. Reynolds, "Instructions to RFC)135.382 696.944 Q
(Authors", RFC 2223, October 1997.)135.382 708.944 Q([N2.BCP14])41.782
732.944 Q 135.382 732.944 EBEGIN
[/Dest (N2) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bradner, S., "Key words for use in RFCs to Indicate)135.382 732.944 Q
(Requirement Levels", BCP 14, RFC 2119, March 1997.)135.382 744.944 Q
129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)7.2 E([Page 36])
108 E 0 Cg EP
%%Page: 37 37
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E([N3.ID])78.292
108.944 Q 171.892 108.944 EBEGIN
[/Dest (N3) /DEST pdfmark
EEND/F0 12/Courier@0 SF
("Guidelines to Authors of Internet\255Drafts", March 2005,)171.892
108.944 Q(ftp://ftp.ietf.org/ietf/1id\255guidelines.txt)171.892 120.944
Q([N4.BCP78])78.292 144.944 Q 171.892 144.944 EBEGIN
[/Dest (N4) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bradner, S., "IETF Rights in Contributions", BCP 78,)171.892 144.944 Q
(RFC 3978, March 2005.)171.892 156.944 Q(Informative References)56.692
180.944 Q([I1.CSTR54])78.292 204.944 Q 186.292 204.944 EBEGIN
[/Dest (I1) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Ossanna, Joseph F., "NROFF/TROFF User's Manual",)186.292 204.944 Q
(Computing Science Technical Report No.54, Bell)186.292 216.944 Q
(Laboratories, Murray Hill, New Jersey, 1976.)186.292 228.944 Q([I2.ms])
78.292 252.944 Q 186.292 252.944 EBEGIN
[/Dest (I2) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Lesk, M. E., "Typing Documents on the UNIX System:)186.292 252.944 Q
(Using the \255ms Macros with Troff and Nroff", 1978, in)186.292 264.944
Q("UNIX TIME\255SHARING SYSTEM \(VOLUME 2\): UNIX)186.292 276.944 Q
(Programmer's Manual", Holt, Rinehart, & Winston, 1979)186.292 288.944 Q
([I3.RFC1543])78.292 312.944 Q 186.292 312.944 EBEGIN
[/Dest (I3) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Postel, J., "Instructions to RFC Authors", RFC 1543,)186.292 312.944 Q
(October 1993.)186.292 324.944 Q([I4.CSTR49])78.292 348.944 Q 186.292
348.944 EBEGIN
[/Dest (I4) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Lesk, M. E., "TBL \255 A Program for Setting Tables",)186.292 348.944 Q
(Bell Laboratories Computing Science Technical Report)186.292 360.944 Q
(#49, Murray Hill, New Jersey, 1976.)186.292 372.944 Q([I5.CSTR114])
78.292 396.944 Q 186.292 396.944 EBEGIN
[/Dest (I5) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bentley, Jon L. and Kernighan, Brian W., "Grap \255 A)186.292 396.944 Q
(Language for Typesetting Graphs Tutorial and User)186.292 408.944 Q
(Manual", Computing Science Technical Report No.114,)186.292 420.944 Q
(AT&T Bell Laboratories, Murray Hill, New Jersey, 1991.)186.292 432.944
Q([I6.CSTR116])78.292 456.944 Q 186.292 456.944 EBEGIN
[/Dest (I6) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Kernighan, Brian W., "Pic \255 A Graphics Language for)186.292 456.944
Q(Typesetting User Manual", Computing Science Technical)186.292 468.944
Q(Report No.116, AT&T Bell Laboratories, Murray Hill,)186.292 480.944 Q
(New Jersey, 1991.)186.292 492.944 Q([I7.CSTR122])78.292 516.944 Q
186.292 516.944 EBEGIN
[/Dest (I7) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bentley, Jon L., Jelinski, Lynn W., and Kernighan,)186.292 516.944 Q
(Brian W., "Chem \255 A Program for Typesetting Chemical)186.292 528.944
Q(Diagrams: User Manual", Computing Science Technical)186.292 540.944 Q
(Report No.122, AT&T Bell Laboratories, Murray Hill,)186.292 552.944 Q
(New Jersey, 1992.)186.292 564.944 Q([I8.eqn])78.292 588.944 Q 186.292
588.944 EBEGIN
[/Dest (I8) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Kernighan, Brian W, and Cherry, Lorinda L., "A System)186.292 588.944 Q
(for Typesetting Mathematics", Communications of the)186.292 600.944 Q
(ACM 18, 182\255193, 1975.)186.292 612.944 Q([I9.CSTR142])78.292 636.944
Q 186.292 636.944 EBEGIN
[/Dest (I9) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bentley, Jon L. "DFORMAT \255 A Program for Typesetting)186.292 636.944
Q(Data Formats", Computing Science Technical Report)186.292 648.944 Q
(No.142, AT&T Bell Laboratories, Murray Hill, New)186.292 660.944 Q
(Jersey, 1988.)186.292 672.944 Q([I10.make])78.292 696.944 Q 186.292
696.944 EBEGIN
[/Dest (I10) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Feldman, S. I., "Make \212 A Program for Maintaining)186.292 696.944 Q
(Computer Programs", 1978, in "UNIX TIME\255SHARING SYSTEM)186.292
708.944 Q(\(VOLUME 2\) : UNIX Programmer's Manual", Holt,)186.292
720.944 Q(Rinehart, & Winston, 1979)186.292 732.944 Q 129.6
(Lilly Expires)56.692 768.944 R(November 6, 2005)7.2 E([Page 37])108 E 0
Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)20.182 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E([I11.BCP9])41.782
108.944 Q 149.782 108.944 EBEGIN
[/Dest (I11) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Bradner, S., "The Internet Standards Process \255\255)149.782 108.944 Q
(Revision 3", BCP 9, RFC 2026, October 1996.)149.782 120.944 Q
([I12.BCP25])41.782 144.944 Q 149.782 144.944 EBEGIN
[/Dest (I12) /DEST pdfmark
EEND/F0 12/Courier@0 SF(Bradner, S., "IETF Working Group Guidelines and)
149.782 144.944 Q(Procedures", BCP 25, RFC 2418, September 1998.)149.782
156.944 Q([I13.Instruct])41.782 180.944 Q 149.782 180.944 EBEGIN
[/Dest (I13) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Reynolds, J., and R. Braden, "Instructions to Request)149.782 180.944 Q
(for Comments \(RFC\) Authors", Work in progress \(August)149.782
192.944 Q(2004\).)149.782 204.944 Q([I14.idnits])41.782 228.944 Q
149.782 228.944 EBEGIN
[/Dest (I14) /DEST pdfmark
EEND/F0 12/Courier@0 SF(http://ietf.levkowetz.com/tools/idnits/)149.782
228.944 Q([I15.RFC3834])41.782 252.944 Q 149.782 252.944 EBEGIN
[/Dest (I15) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Moore, K., "Recommendations for Automatic Responses to)149.782 252.944
Q(Electronic Mail", RFC 3834, August 2004.)149.782 264.944 Q
([I16.ANSI151])41.782 288.944 Q 149.782 288.944 EBEGIN
[/Dest (I16) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(American National Standards Institute \(ANSI\), "Bond)149.782 288.944 Q
(Papers and Index Bristols \255 Common Sheet Sizes", ANSI)149.782
300.944 Q(INCITS 151\2551987 \(R2002\))149.782 312.944 Q([I17.ISO216])
41.782 336.944 Q 149.782 336.944 EBEGIN
[/Dest (I17) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(International Organization for Standardization \(ISO\),)149.782 336.944
Q("Writing paper and certain classes of printed)149.782 348.944 Q
(matter \255\255 Trimmed sizes \255\255 A and B series",)149.782 360.944
Q(ISO 216:1975)149.782 372.944 Q([I18.RFC2234])41.782 396.944 Q 149.782
396.944 EBEGIN
[/Dest (I18) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Crocker, D. and P. Overell, "Augmented BNF for Syntax)149.782 396.944 Q
(Specifications: ABNF", RFC 2234, November 1997.)149.782 408.944 Q
([I19.awk])41.782 432.944 Q 149.782 432.944 EBEGIN
[/Dest (I19) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(Aho, Alfred V., Wienberger, Peter J., and Kernighan,)149.782 432.944 Q
(Brian W., "Awk \212 A Pattern Scanning and Processing)149.782 444.944 Q
(Language", 1978, in "UNIX TIME\255SHARING SYSTEM)149.782 456.944 Q
(\(VOLUME 2\): UNIX Programmer's Manual", Holt, Rinehart,)149.782
468.944 Q 7.2(&W)149.782 480.944 S(inston, 1979)-7.2 E([I20.sed])41.782
504.944 Q 149.782 504.944 EBEGIN
[/Dest (I20) /DEST pdfmark
EEND/F0 12/Courier@0 SF
(McMahon, Lee E., "SED \212 A Non\255interactive Text)149.782 504.944 Q
(Editor", 1978, "UNIX TIME\255SHARING SYSTEM \(VOLUME 2\):)149.782
516.944 Q(UNIX Programmer's Manual", Holt, Rinehart, & Winston,)149.782
528.944 Q(1979)149.782 540.944 Q(Author's Address)20.182 564.944 Q
(Bruce Lilly)41.782 588.944 Q(Email: blilly@erols.com)41.782 612.944 Q
(Full Copyright Statement)20.182 636.944 Q 7.2(Copyright \251 The)41.782
660.944 R(Internet Society \(2005\).)7.2 E
(This document is subject to the rights, licenses and restrictions)
41.782 684.944 Q
(contained in BCP 78, and except as set forth therein, the authors)
41.782 696.944 Q(retain all their rights.)41.782 708.944 Q
(This document and the information contained herein are provided on an)
41.782 732.944 Q
("AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS)
41.782 744.944 Q 129.6(Lilly Expires)20.182 768.944 R(November 6, 2005)
7.2 E([Page 38])108 E 0 Cg EP
%%Page: 39 39
%%BeginPageSetup
BP
%%EndPageSetup
/F0 12/Courier@0 SF 32.4(Internet\255Draft Writing)56.692 84.944 R
(I\255Ds and RFCs using troff)7.2 E(May 2005)82.8 E
(OR IS SPONSORED BY \(IF ANY\), THE INTERNET SOCIETY AND THE INTERNET)
78.292 108.944 Q
(ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,)
78.292 120.944 Q
(INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE)78.292
132.944 Q
(INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED)78.292
144.944 Q
(WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.)
78.292 156.944 Q(Intellectual Property Statement)56.692 180.944 Q
(The IETF takes no position regarding the validity or scope of any)
78.292 204.944 Q
(Intellectual Property Rights or other rights that might be claimed to)
78.292 216.944 Q
(pertain to the implementation or use of the technology described in)
78.292 228.944 Q
(this document or the extent to which any license under such rights)
78.292 240.944 Q
(might or might not be available; nor does it represent that it has)
78.292 252.944 Q
(made any independent effort to identify any such rights.)78.292 264.944
Q(Information)14.4 E
(on the procedures with respect to rights in RFC documents can be)78.292
276.944 Q(found in BCP 78 and BCP 79.)78.292 288.944 Q
(Copies of IPR disclosures made to the IETF Secretariat and any)78.292
312.944 Q
(assurances of licenses to be made available, or the result of an)78.292
324.944 Q
(attempt made to obtain a general license or permission for the use of)
78.292 336.944 Q
(such proprietary rights by implementers or users of this)78.292 348.944
Q(specification can be obtained from the IETF on\255line IPR repository\
 at)78.292 360.944 Q(http://www.ietf.org/ipr.)78.292 372.944 Q
(The IETF invites any interested party to bring to its attention any)
78.292 396.944 Q
(copyrights, patents or patent applications, or other proprietary)78.292
408.944 Q
(rights that may cover technology that may be required to implement)
78.292 420.944 Q(this standard.)78.292 432.944 Q
(Please address the information to the IETF at)14.4 E
(ietf\255ipr@ietf.org.)78.292 444.944 Q(Acknowledgment)56.692 468.944 Q
(Funding for the RFC Editor function is currently provided by the)78.292
492.944 Q(Internet Society.)78.292 504.944 Q 129.6(Lilly Expires)56.692
768.944 R(November 6, 2005)7.2 E([Page 39])108 E 0 Cg EP

%%Trailer
end
%!Description: PostScript ISO A4 version of draft-lilly-using-troff-05
%%EOF