asciidoctor-rfc 0.1.0 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (130) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +5 -0
  3. data/.oss-guides.rubocop.yml +1077 -0
  4. data/.rspec +1 -0
  5. data/.rubocop.yml +19 -1063
  6. data/.travis.yml +3 -2
  7. data/Guardfile +22 -0
  8. data/README.adoc +1151 -0
  9. data/Rakefile +1 -1
  10. data/asciidoctor-rfc.gemspec +20 -3
  11. data/bin/asciidoctor-rfc2 +15 -0
  12. data/bin/asciidoctor-rfc3 +15 -0
  13. data/bin/rspec +0 -1
  14. data/lib/asciidoctor-rfc.rb +4 -0
  15. data/lib/asciidoctor/rfc/common/base.rb +218 -0
  16. data/lib/asciidoctor/rfc/common/front.rb +120 -0
  17. data/lib/asciidoctor/rfc/v2/base.rb +341 -0
  18. data/lib/asciidoctor/rfc/v2/blocks.rb +192 -0
  19. data/lib/asciidoctor/rfc/v2/converter.rb +64 -0
  20. data/lib/asciidoctor/rfc/v2/front.rb +69 -0
  21. data/lib/asciidoctor/rfc/v2/inline_anchor.rb +102 -0
  22. data/lib/asciidoctor/rfc/v2/lists.rb +134 -0
  23. data/lib/asciidoctor/rfc/v2/table.rb +112 -0
  24. data/lib/asciidoctor/rfc/v2/validate.rb +738 -0
  25. data/lib/asciidoctor/rfc/v2/validate2.rng +716 -0
  26. data/lib/asciidoctor/rfc/v3/base.rb +358 -0
  27. data/lib/asciidoctor/rfc/v3/blocks.rb +203 -0
  28. data/lib/asciidoctor/rfc/v3/converter.rb +64 -0
  29. data/lib/asciidoctor/rfc/v3/front.rb +115 -0
  30. data/lib/asciidoctor/rfc/v3/inline_anchor.rb +90 -0
  31. data/lib/asciidoctor/rfc/v3/lists.rb +190 -0
  32. data/lib/asciidoctor/rfc/v3/svg.rng +9081 -0
  33. data/lib/asciidoctor/rfc/v3/table.rb +65 -0
  34. data/lib/asciidoctor/rfc/v3/validate.rb +2168 -0
  35. data/lib/asciidoctor/rfc/v3/validate.rng +2143 -0
  36. data/lib/asciidoctor/rfc/version.rb +2 -2
  37. data/spec/asciidoctor/rfc/v2/appendix_spec.rb +124 -0
  38. data/spec/asciidoctor/rfc/v2/area_spec.rb +60 -0
  39. data/spec/asciidoctor/rfc/v2/author_spec.rb +444 -0
  40. data/spec/asciidoctor/rfc/v2/comments_spec.rb +316 -0
  41. data/spec/asciidoctor/rfc/v2/crossref_spec.rb +205 -0
  42. data/spec/asciidoctor/rfc/v2/date_spec.rb +166 -0
  43. data/spec/asciidoctor/rfc/v2/dlist_spec.rb +108 -0
  44. data/spec/asciidoctor/rfc/v2/document_spec.rb +161 -0
  45. data/spec/asciidoctor/rfc/v2/example_spec.rb +50 -0
  46. data/spec/asciidoctor/rfc/v2/front_spec.rb +75 -0
  47. data/spec/asciidoctor/rfc/v2/image_spec.rb +81 -0
  48. data/spec/asciidoctor/rfc/v2/indexterm_spec.rb +66 -0
  49. data/spec/asciidoctor/rfc/v2/inline_formatting_spec.rb +177 -0
  50. data/spec/asciidoctor/rfc/v2/keyword_spec.rb +63 -0
  51. data/spec/asciidoctor/rfc/v2/listing_spec.rb +59 -0
  52. data/spec/asciidoctor/rfc/v2/literal_spec.rb +53 -0
  53. data/spec/asciidoctor/rfc/v2/olist_spec.rb +147 -0
  54. data/spec/asciidoctor/rfc/v2/paragraph_spec.rb +68 -0
  55. data/spec/asciidoctor/rfc/v2/preamble_spec.rb +140 -0
  56. data/spec/asciidoctor/rfc/v2/quote_spec.rb +24 -0
  57. data/spec/asciidoctor/rfc/v2/references_spec.rb +96 -0
  58. data/spec/asciidoctor/rfc/v2/section_spec.rb +260 -0
  59. data/spec/asciidoctor/rfc/v2/sidebar_spec.rb +32 -0
  60. data/spec/asciidoctor/rfc/v2/table_spec.rb +293 -0
  61. data/spec/asciidoctor/rfc/v2/ulist_spec.rb +96 -0
  62. data/spec/asciidoctor/rfc/v2/workgroup_spec.rb +60 -0
  63. data/spec/asciidoctor/rfc/v3/appendix_spec.rb +130 -0
  64. data/spec/asciidoctor/rfc/v3/area_spec.rb +63 -0
  65. data/spec/asciidoctor/rfc/v3/author_spec.rb +540 -0
  66. data/spec/asciidoctor/rfc/v3/comments_spec.rb +308 -0
  67. data/spec/asciidoctor/rfc/v3/crossref_spec.rb +269 -0
  68. data/spec/asciidoctor/rfc/v3/date_spec.rb +149 -0
  69. data/spec/asciidoctor/rfc/v3/dlist_spec.rb +121 -0
  70. data/spec/asciidoctor/rfc/v3/document_spec.rb +109 -0
  71. data/spec/asciidoctor/rfc/v3/example_spec.rb +34 -0
  72. data/spec/asciidoctor/rfc/v3/front_spec.rb +43 -0
  73. data/spec/asciidoctor/rfc/v3/image_spec.rb +81 -0
  74. data/spec/asciidoctor/rfc/v3/indexterm_spec.rb +69 -0
  75. data/spec/asciidoctor/rfc/v3/inline_formatting_spec.rb +319 -0
  76. data/spec/asciidoctor/rfc/v3/keyword_spec.rb +33 -0
  77. data/spec/asciidoctor/rfc/v3/link_spec.rb +34 -0
  78. data/spec/asciidoctor/rfc/v3/listing_spec.rb +59 -0
  79. data/spec/asciidoctor/rfc/v3/literal_spec.rb +51 -0
  80. data/spec/asciidoctor/rfc/v3/olist_spec.rb +168 -0
  81. data/spec/asciidoctor/rfc/v3/paragraph_spec.rb +73 -0
  82. data/spec/asciidoctor/rfc/v3/preamble_spec.rb +112 -0
  83. data/spec/asciidoctor/rfc/v3/quote_spec.rb +91 -0
  84. data/spec/asciidoctor/rfc/v3/references_spec.rb +147 -0
  85. data/spec/asciidoctor/rfc/v3/section_spec.rb +198 -0
  86. data/spec/asciidoctor/rfc/v3/series_info_spec.rb +151 -0
  87. data/spec/asciidoctor/rfc/v3/sidebar_spec.rb +30 -0
  88. data/spec/asciidoctor/rfc/v3/table_spec.rb +275 -0
  89. data/spec/asciidoctor/rfc/v3/ulist_spec.rb +74 -0
  90. data/spec/asciidoctor/rfc/v3/workgroup_spec.rb +33 -0
  91. data/spec/examples/davies-template-bare-06.adoc +361 -0
  92. data/spec/examples/davies-template-bare-06.xml.orig +426 -0
  93. data/spec/examples/example-v2.adoc +181 -0
  94. data/spec/examples/example-v2.xml +675 -0
  95. data/spec/examples/example-v3.adoc +185 -0
  96. data/spec/examples/example-v3.xml +1009 -0
  97. data/spec/examples/mib-doc-template-xml-06.adoc +596 -0
  98. data/spec/examples/mib-doc-template-xml-06.xml.orig +654 -0
  99. data/spec/examples/rfc1149.md +76 -0
  100. data/spec/examples/rfc1149.md.2.xml +94 -0
  101. data/spec/examples/rfc1149.md.3.xml +93 -0
  102. data/spec/examples/rfc1149.md.adoc +65 -0
  103. data/spec/examples/rfc2100.md +149 -0
  104. data/spec/examples/rfc2100.md.2.xml +169 -0
  105. data/spec/examples/rfc2100.md.3.xml +163 -0
  106. data/spec/examples/rfc2100.md.adoc +136 -0
  107. data/spec/examples/rfc3514.md +203 -0
  108. data/spec/examples/rfc3514.md.2.xml +238 -0
  109. data/spec/examples/rfc3514.md.3.xml +258 -0
  110. data/spec/examples/rfc3514.md.adoc +324 -0
  111. data/spec/examples/rfc5841.md +342 -0
  112. data/spec/examples/rfc5841.md.2.xml +393 -0
  113. data/spec/examples/rfc5841.md.3.xml +449 -0
  114. data/spec/examples/rfc5841.md.adoc +414 -0
  115. data/spec/examples/rfc6350.adoc +3499 -0
  116. data/spec/examples/rfc6350.bib +763 -0
  117. data/spec/examples/rfc748.md +79 -0
  118. data/spec/examples/rfc748.md.2.xml +116 -0
  119. data/spec/examples/rfc748.md.3.xml +109 -0
  120. data/spec/examples/rfc748.md.adoc +80 -0
  121. data/spec/examples/rfc7511.md +257 -0
  122. data/spec/examples/rfc7511.md.2.xml +300 -0
  123. data/spec/examples/rfc7511.md.3.xml +347 -0
  124. data/spec/examples/rfc7511.md.adoc +417 -0
  125. data/spec/spec_helper.rb +115 -5
  126. metadata +274 -9
  127. data/.hound.yml +0 -3
  128. data/README.md +0 -84
  129. data/lib/asciidoctor/rfc.rb +0 -7
  130. data/spec/asciidoctor-rfc/.keep +0 -0
@@ -0,0 +1,169 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <!DOCTYPE rfc SYSTEM 'rfc2629.dtd' []>
3
+ <rfc ipr="trust200902" category="info" docName="rfc-2100">
4
+ <?rfc toc="no"?>
5
+ <?rfc symrefs="no"?>
6
+ <?rfc sortrefs="yes"?>
7
+ <?rfc compact="yes"?>
8
+ <?rfc subcompact="no"?>
9
+ <?rfc private=""?>
10
+ <?rfc topblock="yes"?>
11
+ <?rfc comments="no"?>
12
+ <front>
13
+ <title abbrev="The Naming of Hosts">The Naming of Hosts</title>
14
+
15
+ <author initials="J. R." surname="Ashworth" fullname="Jay R. Ashworth">
16
+ <organization abbrev="Ashworth &amp; Associates">Advanced Technology Consulting</organization>
17
+ <address>
18
+ <postal>
19
+ <street></street>
20
+ <city>St. Petersburg</city>
21
+ <code>FL 33709-4819</code>
22
+ <country></country>
23
+ <region></region>
24
+ </postal>
25
+ <phone>+1 813 790 7592</phone>
26
+ <email>jra@scfn.thpl.lib.fl.us</email>
27
+ <uri></uri>
28
+ </address>
29
+ </author>
30
+ <date year="1997" month="April" day="1"/>
31
+
32
+ <area>Internet</area>
33
+ <workgroup>Network Working Group</workgroup>
34
+ <keyword></keyword>
35
+
36
+
37
+ </front>
38
+
39
+ <middle>
40
+
41
+ <section anchor="introduction" title="Introduction">
42
+ <t>This RFC is a commentary on the difficulty of deciding upon an
43
+ acceptably distinctive hostname for one's computer, a problem which
44
+ grows in direct proportion to the logarithmically increasing size of
45
+ the Internet.
46
+ </t>
47
+ <t>Distribution of this memo is unlimited.
48
+ </t>
49
+ <t>Except to TS Eliot.
50
+ </t>
51
+ <t>And, for that matter, to David Addison, who hates iambic pentameter.
52
+ </t>
53
+ </section>
54
+
55
+ <section anchor="poetry" title="Poetry">
56
+
57
+ <figure align="left"><artwork align="left">
58
+ The Naming of Hosts is a difficult matter,
59
+ It isn't just one of your holiday games;
60
+ You may think at first I'm as mad as a hatter
61
+ When I tell you, a host must have THREE DIFFERENT NAMES.
62
+ </artwork></figure>
63
+
64
+ <figure align="left"><artwork align="left">
65
+ First of all, there's the name that the users use daily,
66
+ Such as venus, athena, and cisco, and ames,
67
+ Such as titan or sirius, hobbes or europa--
68
+ All of them sensible everyday names.
69
+ </artwork></figure>
70
+
71
+ <figure align="left"><artwork align="left">
72
+ There are fancier names if you think they sound sweeter,
73
+ Some for the web pages, some for the flames:
74
+ Such as mercury, phoenix, orion, and charon--
75
+ But all of them sensible everyday names.
76
+ </artwork></figure>
77
+
78
+ <figure align="left"><artwork align="left">
79
+ But I tell you, a host needs a name that's particular,
80
+ A name that's peculiar, and more dignified,
81
+ Else how can it keep its home page perpendicular,
82
+ And spread out its data, send pages world wide?
83
+ </artwork></figure>
84
+
85
+ <figure align="left"><artwork align="left">
86
+ Of names of this kind, I can give you a quorum,
87
+ Like lothlorien, pothole, or kobyashi-maru,
88
+ Such as pearly-gates.vatican, or else diplomatic-
89
+ Names that never belong to more than one host.
90
+ </artwork></figure>
91
+
92
+ <figure align="left"><artwork align="left">
93
+ But above and beyond there's still one name left over,
94
+ And that is the name that you never will guess;
95
+ The name that no human research can discover--
96
+ But THE NAMESERVER KNOWS, and will us'ually confess.
97
+ </artwork></figure>
98
+
99
+ <figure align="left"><artwork align="left">
100
+ When you notice a client in rapt meditation,
101
+ The reason, I tell you, is always the same:
102
+ The code is engaged in a deep consultation
103
+ On the address, the address, the address of its name:
104
+ </artwork></figure>
105
+
106
+ <figure align="left"><artwork align="left">
107
+ It's ineffable,
108
+ effable,
109
+ Effanineffable,
110
+ Deep and inscrutable,
111
+ singular
112
+ Name.
113
+ </artwork></figure>
114
+ </section>
115
+
116
+ <section anchor="credits" title="Credits">
117
+ <t>Thanks to Don Libes, Mark Lottor, and a host of twisted
118
+ individuals^W^Wcreative sysadmins for providing source material for
119
+ this memo, to Andrew Lloyd-Webber, Cameron Mackintosh, and a cast of
120
+ thousands (particularly including Terrance Mann) who drew my
121
+ attention to the necessity, and of course, to Thomas Stearns Eliot,
122
+ for making this all necessary.
123
+
124
+ </t>
125
+ </section>
126
+
127
+ <section anchor="security-considerations" title="Security Considerations">
128
+ <t>Security issues are not discussed in this memo.
129
+ </t>
130
+ <t>Particularly the cardiac security of certain famous poets.
131
+ </t>
132
+ </section>
133
+
134
+ </middle>
135
+ <back>
136
+ <references title="Informative References">
137
+ <reference anchor='libes' target=''>
138
+ <front>
139
+ <title>Choosing a Name for Your Computer</title>
140
+ <author initials='D.' surname='Libes' fullname='D. Libes'></author>
141
+ <date year='1989' month='November'/>
142
+ </front>
143
+ <seriesInfo name="Communications of the ACM" value='Vol. 32, No. 11, Pg. 1289' />
144
+ </reference>
145
+ <reference anchor='lottor' target='namedroppers@internic.net'>
146
+ <front>
147
+ <title>Domain Name Survey</title>
148
+ <author initials='M.' surname='Lottor' fullname='M. Lottor'></author>
149
+ <date year='1997' month='January'/>
150
+ </front>
151
+ </reference>
152
+ <reference anchor='ts' target=''>
153
+ <front>
154
+ <title>Old Possum's Book of Practical Cats</title>
155
+ <author initials='TS' surname='Stearns' fullname='TS. Stearns'></author>
156
+ <date/>
157
+ </front>
158
+ </reference>
159
+ <reference anchor='wong' target='http://www.seas.upenn.edu/~mengwong/coolhosts.html'>
160
+ <front>
161
+ <title>Cool Hostnames</title>
162
+ <author initials='M.' surname='Wong' fullname='M. Wong'></author>
163
+ <date/>
164
+ </front>
165
+ </reference>
166
+ </references>
167
+
168
+ </back>
169
+ </rfc>
@@ -0,0 +1,163 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" category="info" docName="rfc-2100">
3
+ <front>
4
+ <title abbrev="The Naming of Hosts">The Naming of Hosts</title>
5
+
6
+ <author initials="J. R." surname="Ashworth" fullname="Jay R. Ashworth">
7
+ <organization abbrev="Ashworth &amp; Associates">Advanced Technology Consulting</organization>
8
+ <address>
9
+ <postal>
10
+ <street></street>
11
+ <city>St. Petersburg</city>
12
+ <code>FL 33709-4819</code>
13
+ <country></country>
14
+ <region></region>
15
+ </postal>
16
+ <phone>+1 813 790 7592</phone>
17
+ <email>jra@scfn.thpl.lib.fl.us</email>
18
+ <uri></uri>
19
+ </address>
20
+ </author>
21
+ <date year="1997" month="April" day="1"/>
22
+
23
+ <area>Internet</area>
24
+ <workgroup>Network Working Group</workgroup>
25
+ <keyword></keyword>
26
+
27
+ </front>
28
+
29
+ <middle>
30
+
31
+ <section anchor="introduction">
32
+ <name>Introduction</name>
33
+ <t>
34
+ This RFC is a commentary on the difficulty of deciding upon an
35
+ acceptably distinctive hostname for one's computer, a problem which
36
+ grows in direct proportion to the logarithmically increasing size of
37
+ the Internet.
38
+ </t>
39
+ <t>
40
+ Distribution of this memo is unlimited.
41
+ </t>
42
+ <t>
43
+ Except to TS Eliot.
44
+ </t>
45
+ <t>
46
+ And, for that matter, to David Addison, who hates iambic pentameter.
47
+ </t>
48
+ </section>
49
+
50
+ <section anchor="poetry">
51
+ <name>Poetry</name>
52
+ <artwork align="left">
53
+ The Naming of Hosts is a difficult matter,
54
+ It isn't just one of your holiday games;
55
+ You may think at first I'm as mad as a hatter
56
+ When I tell you, a host must have THREE DIFFERENT NAMES.
57
+ </artwork>
58
+ <artwork align="left">
59
+ First of all, there's the name that the users use daily,
60
+ Such as venus, athena, and cisco, and ames,
61
+ Such as titan or sirius, hobbes or europa--
62
+ All of them sensible everyday names.
63
+ </artwork>
64
+ <artwork align="left">
65
+ There are fancier names if you think they sound sweeter,
66
+ Some for the web pages, some for the flames:
67
+ Such as mercury, phoenix, orion, and charon--
68
+ But all of them sensible everyday names.
69
+ </artwork>
70
+ <artwork align="left">
71
+ But I tell you, a host needs a name that's particular,
72
+ A name that's peculiar, and more dignified,
73
+ Else how can it keep its home page perpendicular,
74
+ And spread out its data, send pages world wide?
75
+ </artwork>
76
+ <artwork align="left">
77
+ Of names of this kind, I can give you a quorum,
78
+ Like lothlorien, pothole, or kobyashi-maru,
79
+ Such as pearly-gates.vatican, or else diplomatic-
80
+ Names that never belong to more than one host.
81
+ </artwork>
82
+ <artwork align="left">
83
+ But above and beyond there's still one name left over,
84
+ And that is the name that you never will guess;
85
+ The name that no human research can discover--
86
+ But THE NAMESERVER KNOWS, and will us'ually confess.
87
+ </artwork>
88
+ <artwork align="left">
89
+ When you notice a client in rapt meditation,
90
+ The reason, I tell you, is always the same:
91
+ The code is engaged in a deep consultation
92
+ On the address, the address, the address of its name:
93
+ </artwork>
94
+ <artwork align="left">
95
+ It's ineffable,
96
+ effable,
97
+ Effanineffable,
98
+ Deep and inscrutable,
99
+ singular
100
+ Name.
101
+ </artwork>
102
+ </section>
103
+
104
+ <section anchor="credits">
105
+ <name>Credits</name>
106
+ <t>
107
+ Thanks to Don Libes, Mark Lottor, and a host of twisted
108
+ individuals<sup>W</sup>Wcreative sysadmins for providing source material for
109
+ this memo, to Andrew Lloyd-Webber, Cameron Mackintosh, and a cast of
110
+ thousands (particularly including Terrance Mann) who drew my
111
+ attention to the necessity, and of course, to Thomas Stearns Eliot,
112
+ for making this all necessary.
113
+
114
+ </t>
115
+ </section>
116
+
117
+ <section anchor="security-considerations">
118
+ <name>Security Considerations</name>
119
+ <t>
120
+ Security issues are not discussed in this memo.
121
+ </t>
122
+ <t>
123
+ Particularly the cardiac security of certain famous poets.
124
+ </t>
125
+ </section>
126
+
127
+ </middle>
128
+ <back>
129
+ <references>
130
+ <name>Informative References</name>
131
+ <reference anchor='libes' target=''>
132
+ <front>
133
+ <title>Choosing a Name for Your Computer</title>
134
+ <author initials='D.' surname='Libes' fullname='D. Libes'></author>
135
+ <date year='1989' month='November'/>
136
+ </front>
137
+ <seriesInfo name="Communications of the ACM" value='Vol. 32, No. 11, Pg. 1289' />
138
+ </reference>
139
+ <reference anchor='lottor' target='namedroppers@internic.net'>
140
+ <front>
141
+ <title>Domain Name Survey</title>
142
+ <author initials='M.' surname='Lottor' fullname='M. Lottor'></author>
143
+ <date year='1997' month='January'/>
144
+ </front>
145
+ </reference>
146
+ <reference anchor='ts' target=''>
147
+ <front>
148
+ <title>Old Possum's Book of Practical Cats</title>
149
+ <author initials='TS' surname='Stearns' fullname='TS. Stearns'></author>
150
+ <date/>
151
+ </front>
152
+ </reference>
153
+ <reference anchor='wong' target='http://www.seas.upenn.edu/~mengwong/coolhosts.html'>
154
+ <front>
155
+ <title>Cool Hostnames</title>
156
+ <author initials='M.' surname='Wong' fullname='M. Wong'></author>
157
+ <date/>
158
+ </front>
159
+ </reference>
160
+ </references>
161
+
162
+ </back>
163
+ </rfc>
@@ -0,0 +1,136 @@
1
+ = The Naming of Hosts
2
+ Jay R. Ashworth <jra@scfn.thpl.lib.fl.us>
3
+ :doctype: rfc
4
+ :abbrev: The Naming of Hosts
5
+ :status: info
6
+ :name: rfc-2100
7
+ :ipr: trust200902
8
+ :area: Internet
9
+ :workgroup: Network Working Group
10
+ :revdate: 1997-04-01T00:00:00Z
11
+ :forename_initials: J. R.
12
+ :organization_abbrev: Ashworth & Associates
13
+ :organization: Advanced Technology Consulting
14
+ :phone: +1 813 790 7592
15
+ :city: St. Petersburg
16
+ :code: FL 33709-4819
17
+ :sym-refs: false
18
+ :toc-include: false
19
+ :smart-quotes: false
20
+
21
+ [[introduction]]
22
+ == Introduction
23
+
24
+ This RFC is a commentary on the difficulty of deciding upon an
25
+ acceptably distinctive hostname for one's computer, a problem which
26
+ grows in direct proportion to the logarithmically increasing size of
27
+ the Internet.
28
+
29
+ Distribution of this memo is unlimited.
30
+
31
+ Except to TS Eliot.
32
+
33
+ And, for that matter, to David Addison, who hates iambic pentameter.
34
+
35
+ [[poetry]]
36
+ == Poetry
37
+
38
+ [verse]
39
+ ____
40
+ The Naming of Hosts is a difficult matter,
41
+ It isn't just one of your holiday games;
42
+ You may think at first I'm as mad as a hatter
43
+ When I tell you, a host must have THREE DIFFERENT NAMES.
44
+
45
+ First of all, there's the name that the users use daily,
46
+ Such as venus, athena, and cisco, and ames,
47
+ Such as titan or sirius, hobbes or europa--
48
+ All of them sensible everyday names.
49
+
50
+ There are fancier names if you think they sound sweeter,
51
+ Some for the web pages, some for the flames:
52
+ Such as mercury, phoenix, orion, and charon--
53
+ But all of them sensible everyday names.
54
+
55
+ But I tell you, a host needs a name that's particular,
56
+ A name that's peculiar, and more dignified,
57
+ Else how can it keep its home page perpendicular,
58
+ And spread out its data, send pages world wide?
59
+
60
+ Of names of this kind, I can give you a quorum,
61
+ Like lothlorien, pothole, or kobyashi-maru,
62
+ Such as pearly-gates.vatican, or else diplomatic-
63
+ Names that never belong to more than one host.
64
+
65
+ But above and beyond there's still one name left over,
66
+ And that is the name that you never will guess;
67
+ The name that no human research can discover--
68
+ But THE NAMESERVER KNOWS, and will us'ually confess.
69
+
70
+ When you notice a client in rapt meditation,
71
+ The reason, I tell you, is always the same:
72
+ The code is engaged in a deep consultation
73
+ On the address, the address, the address of its name:
74
+
75
+ It's ineffable,
76
+ effable,
77
+ Effanineffable,
78
+ Deep and inscrutable,
79
+ singular
80
+ Name.
81
+ ____
82
+
83
+ [[credits]]
84
+ == Credits
85
+
86
+ Thanks to Don Libes, Mark Lottor, and a host of twisted
87
+ individuals^W^Wcreative sysadmins for providing source material for
88
+ this memo, to Andrew Lloyd-Webber, Cameron Mackintosh, and a cast of
89
+ thousands (particularly including Terrance Mann) who drew my
90
+ attention to the necessity, and of course, to Thomas Stearns Eliot,
91
+ for making this all necessary.
92
+ <<libes,>> <<lottor,>> <<wong,>> <<ts,>>
93
+
94
+ [[security-considerations]]
95
+ == Security Considerations
96
+
97
+ Security issues are not discussed in this memo.
98
+
99
+ Particularly the cardiac security of certain famous poets.
100
+
101
+ [bibliography]
102
+ == References
103
+ ++++
104
+ <reference anchor='libes' target=''>
105
+ <front>
106
+ <title>Choosing a Name for Your Computer</title>
107
+ <author initials='D.' surname='Libes' fullname='D. Libes'></author>
108
+ <date year='1989' month='November'/>
109
+ </front>
110
+ <seriesInfo name="Communications of the ACM" value='Vol. 32, No. 11, Pg. 1289' />
111
+ </reference>
112
+
113
+ <reference anchor='lottor' target='namedroppers@internic.net'>
114
+ <front>
115
+ <title>Domain Name Survey</title>
116
+ <author initials='M.' surname='Lottor' fullname='M. Lottor'></author>
117
+ <date year='1997' month='January'/>
118
+ </front>
119
+ </reference>
120
+
121
+ <reference anchor='ts' target=''>
122
+ <front>
123
+ <title>Old Possum's Book of Practical Cats</title>
124
+ <author initials='TS' surname='Stearns' fullname='TS. Stearns'></author>
125
+ <date/>
126
+ </front>
127
+ </reference>
128
+
129
+ <reference anchor='wong' target='http://www.seas.upenn.edu/~mengwong/coolhosts.html'>
130
+ <front>
131
+ <title>Cool Hostnames</title>
132
+ <author initials='M.' surname='Wong' fullname='M. Wong'></author>
133
+ <date/>
134
+ </front>
135
+ </reference>
136
+ ++++