git-scribe 0.0.4 → 0.0.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (151) hide show
  1. data/.gitignore +1 -0
  2. data/Rakefile +31 -0
  3. data/SPEC.asciidoc +126 -0
  4. data/TODO.txt +29 -0
  5. data/bin/git-scribe +2 -1
  6. data/docbook-xsl/.CatalogManager.properties.example +61 -0
  7. data/docbook-xsl/.urilist +1 -0
  8. data/git-scribe.gemspec +32 -0
  9. data/lib/git-scribe.rb +21 -315
  10. data/lib/git-scribe/check.rb +60 -0
  11. data/lib/git-scribe/cli.rb +84 -0
  12. data/lib/git-scribe/generate.rb +222 -0
  13. data/lib/git-scribe/init.rb +16 -0
  14. data/lib/git-scribe/version.rb +3 -0
  15. data/template/.gitignore +1 -0
  16. data/template/.gitscribe +5 -0
  17. data/test/check_test.rb +12 -0
  18. data/test/gen_test.rb +78 -0
  19. data/test/init_test.rb +36 -0
  20. data/test/test_helper.rb +44 -0
  21. metadata +49 -161
  22. data/example/book/big.asc +0 -5604
  23. data/example/book/holmes.asc +0 -12983
  24. data/example/output/META-INF/container.xml +0 -6
  25. data/example/output/OEBPS/ar01s02.html +0 -15
  26. data/example/output/OEBPS/ar01s03.html +0 -3
  27. data/example/output/OEBPS/content.opf +0 -21
  28. data/example/output/OEBPS/index.html +0 -5
  29. data/example/output/OEBPS/toc.ncx +0 -37
  30. data/example/output/a_case_of_identity.html +0 -725
  31. data/example/output/a_example_appendix.html +0 -63
  32. data/example/output/a_migration_notes.html +0 -95
  33. data/example/output/apa.html +0 -20
  34. data/example/output/apb.html +0 -6
  35. data/example/output/apc.html +0 -24
  36. data/example/output/apd.html +0 -30
  37. data/example/output/ape.html +0 -26
  38. data/example/output/apf.html +0 -9
  39. data/example/output/apg.html +0 -42
  40. data/example/output/aph.html +0 -89
  41. data/example/output/ar01s02.html +0 -12
  42. data/example/output/ar01s03.html +0 -34
  43. data/example/output/ar01s04.html +0 -77
  44. data/example/output/ar01s05.html +0 -272
  45. data/example/output/ar01s06.html +0 -35
  46. data/example/output/ar01s07.html +0 -105
  47. data/example/output/ar01s08.html +0 -33
  48. data/example/output/ar01s09.html +0 -12
  49. data/example/output/ar01s10.html +0 -14
  50. data/example/output/ar01s11.html +0 -34
  51. data/example/output/ar01s12.html +0 -63
  52. data/example/output/ar01s13.html +0 -156
  53. data/example/output/ar01s14.html +0 -330
  54. data/example/output/ar01s15.html +0 -22
  55. data/example/output/ar01s16.html +0 -27
  56. data/example/output/ar01s17.html +0 -94
  57. data/example/output/ar01s18.html +0 -359
  58. data/example/output/ar01s19.html +0 -373
  59. data/example/output/ar01s20.html +0 -27
  60. data/example/output/ar01s21.html +0 -33
  61. data/example/output/ar01s22.html +0 -351
  62. data/example/output/ar01s23.html +0 -21
  63. data/example/output/ar01s24.html +0 -69
  64. data/example/output/ar01s25.html +0 -60
  65. data/example/output/ar01s26.html +0 -217
  66. data/example/output/ar01s27.html +0 -88
  67. data/example/output/ar01s28.html +0 -237
  68. data/example/output/ar01s29.html +0 -68
  69. data/example/output/ar01s30.html +0 -154
  70. data/example/output/ar01s31.html +0 -6
  71. data/example/output/ar01s32.html +0 -22
  72. data/example/output/ar01s33.html +0 -209
  73. data/example/output/asciidoc_backends.html +0 -190
  74. data/example/output/asciidoc_document_types.html +0 -131
  75. data/example/output/attribute_entries.html +0 -185
  76. data/example/output/attribute_lists.html +0 -157
  77. data/example/output/attribute_references.html +0 -414
  78. data/example/output/attributelist_element.html +0 -143
  79. data/example/output/b_packager_notes.html +0 -68
  80. data/example/output/bi01.html +0 -18
  81. data/example/output/big.asc +0 -5604
  82. data/example/output/block_element_definitions.html +0 -448
  83. data/example/output/block_titles.html +0 -83
  84. data/example/output/blockid_element.html +0 -80
  85. data/example/output/book.asc +0 -5604
  86. data/example/output/book.epub +0 -0
  87. data/example/output/book.fo +0 -3788
  88. data/example/output/book.html +0 -8793
  89. data/example/output/book.xml +0 -8265
  90. data/example/output/c_asciidoc_safe_mode.html +0 -105
  91. data/example/output/callouts.html +0 -214
  92. data/example/output/catalog +0 -10
  93. data/example/output/colophon.html +0 -397
  94. data/example/output/configuration_files.html +0 -672
  95. data/example/output/converting_docbook_to_other_file_formats.html +0 -324
  96. data/example/output/d_using_asciidoc_with_non-english_languages.html +0 -107
  97. data/example/output/delimited_blocks.html +0 -455
  98. data/example/output/document_attributes.html +0 -95
  99. data/example/output/document_processing.html +0 -116
  100. data/example/output/document_structure.html +0 -493
  101. data/example/output/e_vim_syntax_highlighter.html +0 -111
  102. data/example/output/example_bibliography.html +0 -82
  103. data/example/output/example_colophon.html +0 -58
  104. data/example/output/example_glossary.html +0 -73
  105. data/example/output/example_index.html +0 -108
  106. data/example/output/f_attribute_options.html +0 -129
  107. data/example/output/filters.html +0 -179
  108. data/example/output/footnotes.html +0 -103
  109. data/example/output/g_diagnostics.html +0 -148
  110. data/example/output/generating_plain_text_files.html +0 -68
  111. data/example/output/getting_started.html +0 -87
  112. data/example/output/glossary.html +0 -95
  113. data/example/output/go01.html +0 -24
  114. data/example/output/h_backend_attributes.html +0 -308
  115. data/example/output/help_commands.html +0 -96
  116. data/example/output/holmes.asc +0 -12983
  117. data/example/output/image/octocat_professor.png +0 -0
  118. data/example/output/include/hello.c +0 -10
  119. data/example/output/index.html +0 -656
  120. data/example/output/indexes.html +0 -104
  121. data/example/output/intrinsic_attributes.html +0 -165
  122. data/example/output/ix01.html +0 -3
  123. data/example/output/lists.html +0 -666
  124. data/example/output/macros.html +0 -737
  125. data/example/output/manpage_documents.html +0 -124
  126. data/example/output/master.css +0 -281
  127. data/example/output/mathematical_formulas.html +0 -125
  128. data/example/output/page.html +0 -60
  129. data/example/output/paragraphs.html +0 -192
  130. data/example/output/pr01.html +0 -3
  131. data/example/output/source_code_highlighting.html +0 -59
  132. data/example/output/stylesheets/handbookish-quirks.css +0 -0
  133. data/example/output/stylesheets/handbookish.css +0 -233
  134. data/example/output/tables.html +0 -797
  135. data/example/output/text_formatting.html +0 -273
  136. data/example/output/the_adventure_of_the_beryl_coronet.html +0 -968
  137. data/example/output/the_adventure_of_the_blue_carbuncle.html +0 -825
  138. data/example/output/the_adventure_of_the_copper_beeches.html +0 -998
  139. data/example/output/the_adventure_of_the_engineer_s_thumb.html +0 -851
  140. data/example/output/the_adventure_of_the_noble_bachelor.html +0 -861
  141. data/example/output/the_adventure_of_the_speckled_band.html +0 -1015
  142. data/example/output/the_boscombe_valley_mystery.html +0 -974
  143. data/example/output/the_first_chapter.html +0 -110
  144. data/example/output/the_five_orange_pips.html +0 -776
  145. data/example/output/the_man_with_the_twisted_lip.html +0 -946
  146. data/example/output/the_red-headed_league.html +0 -950
  147. data/example/output/the_second_chapter.html +0 -95
  148. data/example/output/the_third_chapter.html +0 -58
  149. data/example/output/tips_and_tricks.html +0 -452
  150. data/example/output/title.html +0 -120
  151. data/example/output/titles.html +0 -126
data/example/output/c_asciidoc_safe_mode.html DELETED
@@ -1,105 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5
- <link rel="stylesheet" href="master.css" type="text/css" />
6
- <title>C. AsciiDoc Safe Mode</title>
7
- </head>
8
-
9
- <body>
10
- <div class="nav" id="navheader">
11
- <table width="100%">
12
- <tr><td width="33%" align="left">
13
-
14
- <a href="b_packager_notes.html">Prev</a><br/>
15
- B. Packager Notes
16
-
17
- </td><td width="33%" align="center">
18
-
19
- <a href="index.html">Home</a><br/>
20
- <strong>AsciiDoc User Guide</strong>
21
-
22
- </td><td width="33%" align="right">
23
-
24
- <a href="d_using_asciidoc_with_non-english_languages.html">Next</a><br/>
25
- D. Using AsciiDoc with non-English Languages
26
-
27
- </td></tr>
28
- </table>
29
- </div>
30
-
31
- <hr/>
32
-
33
- <div class="content">
34
- <div class="appendix" lang="en" xml:lang="en">
35
- <div class="titlepage"><div><div><h2 class="title">
36
- <a id="X39"></a>C. AsciiDoc Safe Mode</h2></div></div></div>
37
- <p>AsciiDoc <span class="emphasis"><em>safe mode</em></span> skips potentially dangerous scripted sections in
38
- AsciiDoc source files by inhibiting the execution of arbitrary code or
39
- the inclusion of arbitrary files.</p>
40
- <p>The safe mode is disabled by default, it can be enabled with the
41
- asciidoc(1) <code class="literal">--safe</code> command-line option.</p>
42
- <div class="itemizedlist">
43
- <p class="title"><b>Safe mode constraints</b></p>
44
- <ul type="disc">
45
- <li>
46
- <code class="literal">eval</code>, <code class="literal">sys</code> and <code class="literal">sys2</code> executable attributes and block macros are
47
- not executed.
48
- </li>
49
- <li>
50
- <code class="literal">include::&lt;filename&gt;[]</code> and <code class="literal">include1::&lt;filename&gt;[]</code> block macro
51
- files must reside inside the parent file’s directory.
52
- </li>
53
- <li>
54
- <code class="literal">{include:&lt;filename&gt;}</code> executable attribute files must reside
55
- inside the source document directory.
56
- </li>
57
- <li>
58
- Passthrough Blocks are dropped.
59
- </li>
60
- </ul>
61
- </div>
62
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
63
- <h3 class="title">Warning</h3>
64
- <p>The safe mode is not designed to protect against unsafe AsciiDoc
65
- configuration files. Be especially careful when:</p>
66
- <div class="orderedlist"><ol type="1">
67
- <li>
68
- Implementing filters.
69
- </li>
70
- <li>
71
- Implementing elements that don’t escape special characters.
72
- </li>
73
- <li>
74
- Accepting configuration files from untrusted sources.
75
- </li>
76
- </ol></div>
77
- </div>
78
- </div>
79
-
80
- </div>
81
-
82
- <hr/>
83
-
84
- <div class="nav" id="navfooter">
85
- <table width="100%">
86
- <tr><td width="33%" align="left">
87
-
88
- <a href="b_packager_notes.html">Prev</a><br/>
89
- B. Packager Notes
90
-
91
- </td><td width="33%" align="center">
92
-
93
- <a href="index.html">Home</a><br/>
94
- AsciiDoc User Guide
95
-
96
- </td><td width="33%" align="right">
97
-
98
- <a href="d_using_asciidoc_with_non-english_languages.html">Next</a><br/>
99
- D. Using AsciiDoc with non-English Languages
100
-
101
- </td></tr>
102
- </table>
103
- </div>
104
- </body>
105
- </html>
data/example/output/callouts.html DELETED
@@ -1,214 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5
- <link rel="stylesheet" href="master.css" type="text/css" />
6
- <title>Callouts</title>
7
- </head>
8
-
9
- <body>
10
- <div class="nav" id="navheader">
11
- <table width="100%">
12
- <tr><td width="33%" align="left">
13
-
14
- <a href="indexes.html">Prev</a><br/>
15
- Indexes
16
-
17
- </td><td width="33%" align="center">
18
-
19
- <a href="index.html">Home</a><br/>
20
- <strong>AsciiDoc User Guide</strong>
21
-
22
- </td><td width="33%" align="right">
23
-
24
- <a href="macros.html">Next</a><br/>
25
- Macros
26
-
27
- </td></tr>
28
- </table>
29
- </div>
30
-
31
- <hr/>
32
-
33
- <div class="content">
34
- <div class="section" lang="en" xml:lang="en">
35
- <div class="titlepage"><div><div><h2 class="title" style="clear: both">
36
- <a id="_callouts"></a>Callouts</h2></div></div></div>
37
- <p>Callouts are a mechanism for annotating verbatim text (for example:
38
- source code, computer output and user input). Callout markers are
39
- placed inside the annotated text while the actual annotations are
40
- presented in a callout list after the annotated text. Here’s an
41
- example:</p>
42
- <pre class="screen"> .MS-DOS directory listing
43
- -----------------------------------------------------
44
- 10/17/97 9:04 &lt;DIR&gt; bin
45
- 10/16/97 14:11 &lt;DIR&gt; DOS &lt;1&gt;
46
- 10/16/97 14:40 &lt;DIR&gt; Program Files
47
- 10/16/97 14:46 &lt;DIR&gt; TEMP
48
- 10/17/97 9:04 &lt;DIR&gt; tmp
49
- 10/16/97 14:37 &lt;DIR&gt; WINNT
50
- 10/16/97 14:25 119 AUTOEXEC.BAT &lt;2&gt;
51
- 2/13/94 6:21 54,619 COMMAND.COM &lt;2&gt;
52
- 10/16/97 14:25 115 CONFIG.SYS &lt;2&gt;
53
- 11/16/97 17:17 61,865,984 pagefile.sys
54
- 2/13/94 6:21 9,349 WINA20.386 &lt;3&gt;
55
- -----------------------------------------------------
56
-
57
- &lt;1&gt; This directory holds MS-DOS.
58
- &lt;2&gt; System startup code for DOS.
59
- &lt;3&gt; Some sort of Windows 3.1 hack.</pre>
60
- <p>Which renders:</p>
61
- <p><b>MS-DOS directory listing. </b>
62
- </p>
63
- <pre class="screen">10/17/97 9:04 &lt;DIR&gt; bin
64
- 10/16/97 14:11 &lt;DIR&gt; DOS <a id="CO1-1"></a><img src="images/callouts/1.png" alt="1" border="0">
65
- 10/16/97 14:40 &lt;DIR&gt; Program Files
66
- 10/16/97 14:46 &lt;DIR&gt; TEMP
67
- 10/17/97 9:04 &lt;DIR&gt; tmp
68
- 10/16/97 14:37 &lt;DIR&gt; WINNT
69
- 10/16/97 14:25 119 AUTOEXEC.BAT <a id="CO1-2"></a><img src="images/callouts/2.png" alt="2" border="0">
70
- 2/13/94 6:21 54,619 COMMAND.COM <a id="CO1-3"></a><img src="images/callouts/3.png" alt="3" border="0">
71
- 10/16/97 14:25 115 CONFIG.SYS <a id="CO1-4"></a><img src="images/callouts/4.png" alt="4" border="0">
72
- 11/16/97 17:17 61,865,984 pagefile.sys
73
- 2/13/94 6:21 9,349 WINA20.386 <a id="CO1-5"></a><img src="images/callouts/5.png" alt="5" border="0"></pre>
74
- <p>
75
- </p>
76
- <div class="calloutlist"><table border="0" summary="Callout list">
77
- <tr>
78
- <td width="5%" valign="top" align="left"><p><a href="#CO1-1"><img src="images/callouts/1.png" alt="1" border="0"></a> </p></td>
79
- <td valign="top" align="left">
80
- This directory holds MS-DOS.
81
- </td>
82
- </tr>
83
- <tr>
84
- <td width="5%" valign="top" align="left"><p><a href="#CO1-2"><img src="images/callouts/2.png" alt="2" border="0"></a> <a href="#CO1-3"><img src="images/callouts/3.png" alt="3" border="0"></a> <a href="#CO1-4"><img src="images/callouts/4.png" alt="4" border="0"></a> </p></td>
85
- <td valign="top" align="left">
86
- System startup code for DOS.
87
- </td>
88
- </tr>
89
- <tr>
90
- <td width="5%" valign="top" align="left"><p><a href="#CO1-5"><img src="images/callouts/5.png" alt="5" border="0"></a> </p></td>
91
- <td valign="top" align="left">
92
- Some sort of Windows 3.1 hack.
93
- </td>
94
- </tr>
95
- </table></div>
96
- <div class="itemizedlist">
97
- <p class="title"><b>Explanation</b></p>
98
- <ul type="disc">
99
- <li>
100
- The callout marks are whole numbers enclosed in angle brackets —  they refer to the correspondingly numbered item in the following
101
- callout list.
102
- </li>
103
- <li>
104
- By default callout marks are confined to <span class="emphasis"><em>LiteralParagraphs</em></span>,
105
- <span class="emphasis"><em>LiteralBlocks</em></span> and <span class="emphasis"><em>ListingBlocks</em></span> (although this is a
106
- configuration file option and can be changed).
107
- </li>
108
- <li>
109
- Callout list item numbering is fairly relaxed — list items can
110
- start with <code class="literal">&lt;n&gt;</code>, <code class="literal">n&gt;</code> or <code class="literal">&gt;</code> where <code class="literal">n</code> is the optional list item
111
- number (in the latter case list items starting with a single <code class="literal">&gt;</code>
112
- character are implicitly numbered starting at one).
113
- </li>
114
- <li>
115
- Callout lists should not be nested.
116
- </li>
117
- <li>
118
- Callout lists start list items hard against the left margin.
119
- </li>
120
- <li>
121
- If you want to present a number inside angle brackets you’ll need to
122
- escape it with a backslash to prevent it being interpreted as a
123
- callout mark.
124
- </li>
125
- </ul>
126
- </div>
127
- <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
128
- <h3 class="title">Note</h3>
129
- <p>Define the AsciiDoc <span class="emphasis"><em>icons</em></span> attribute (for example using the <code class="literal">-a
130
- icons</code> command-line option) to display callout icons.</p>
131
- </div>
132
- <div class="section" lang="en" xml:lang="en">
133
- <div class="titlepage"><div><div><h3 class="title">
134
- <a id="_implementation_notes"></a>Implementation Notes</h3></div></div></div>
135
- <p>Callout marks are generated by the <span class="emphasis"><em>callout</em></span> inline macro while
136
- callout lists are generated using the <span class="emphasis"><em>callout</em></span> list definition. The
137
- <span class="emphasis"><em>callout</em></span> macro and <span class="emphasis"><em>callout</em></span> list are special in that they work
138
- together. The <span class="emphasis"><em>callout</em></span> inline macro is not enabled by the normal
139
- <span class="emphasis"><em>macros</em></span> substitutions option, instead it has its own <span class="emphasis"><em>callouts</em></span>
140
- substitution option.</p>
141
- <p>The following attributes are available during inline callout macro
142
- substitution:</p>
143
- <div class="variablelist"><dl>
144
- <dt><span class="term">
145
- <code class="literal">{index}</code>
146
- </span></dt>
147
- <dd>
148
- The callout list item index inside the angle brackets.
149
- </dd>
150
- <dt><span class="term">
151
- <code class="literal">{coid}</code>
152
- </span></dt>
153
- <dd>
154
- An identifier formatted like <code class="literal">CO&lt;listnumber&gt;-&lt;index&gt;</code> that
155
- uniquely identifies the callout mark. For example <code class="literal">CO2-4</code>
156
- identifies the fourth callout mark in the second set of callout
157
- marks.
158
- </dd>
159
- </dl></div>
160
- <p>The <code class="literal">{coids}</code> attribute can be used during callout list item
161
- substitution — it is a space delimited list of callout IDs that refer
162
- to the explanatory list item.</p>
163
- </div>
164
- <div class="section" lang="en" xml:lang="en">
165
- <div class="titlepage"><div><div><h3 class="title">
166
- <a id="_including_callouts_in_included_code"></a>Including callouts in included code</h3></div></div></div>
167
- <p>You can annotate working code examples with callouts — just remember
168
- to put the callouts inside source code comments. This example displays
169
- the <code class="literal">test.py</code> source file (containing a single callout) using the
170
- <a class="link" href="filters.html#X57" title="Source Code Highlighter Filter">Source Code Highlighter Filter</a>:</p>
171
- <p><b>AsciiDoc source. </b>
172
- </p>
173
- <pre class="screen"> [source,python]
174
- -------------------------------------------
175
- \include::test.py[]
176
- -------------------------------------------
177
-
178
- &lt;1&gt; Print statement.</pre>
179
- <p>
180
- </p>
181
- <p><b>Included <code class="literal">test.py</code> source. </b>
182
- </p>
183
- <pre class="screen">print 'Hello World!' # &lt;1&gt;</pre>
184
- <p>
185
- </p>
186
- </div>
187
- </div>
188
-
189
- </div>
190
-
191
- <hr/>
192
-
193
- <div class="nav" id="navfooter">
194
- <table width="100%">
195
- <tr><td width="33%" align="left">
196
-
197
- <a href="indexes.html">Prev</a><br/>
198
- Indexes
199
-
200
- </td><td width="33%" align="center">
201
-
202
- <a href="index.html">Home</a><br/>
203
- AsciiDoc User Guide
204
-
205
- </td><td width="33%" align="right">
206
-
207
- <a href="macros.html">Next</a><br/>
208
- Macros
209
-
210
- </td></tr>
211
- </table>
212
- </div>
213
- </body>
214
- </html>
data/example/output/catalog DELETED
@@ -1,10 +0,0 @@
1
- <?xml version="1.0"?>
2
- <!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
3
- <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
4
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.2/catalog.xml"/>
5
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.3/catalog.xml"/>
6
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.4/catalog.xml"/>
7
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.5/catalog.xml"/>
8
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/5.0/catalog.xml"/>
9
- <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xsl/1.75.2/catalog.xml"/>
10
- </catalog>
data/example/output/colophon.html DELETED
@@ -1,397 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5
- <link rel="stylesheet" href="master.css" type="text/css" />
6
- <title>Colophon</title>
7
- </head>
8
-
9
- <body>
10
- <div class="nav" id="navheader">
11
- <table width="100%">
12
- <tr><td width="33%" align="left">
13
-
14
- <a href="the_adventure_of_the_copper_beeches.html">Prev</a><br/>
15
- The Adventure of the Copper Beeches
16
-
17
- </td><td width="33%" align="center">
18
-
19
- <a href="index.html">Home</a><br/>
20
- <strong>The Adventures of Sherlock Holmes</strong>
21
-
22
- </td><td width="33%" align="right">
23
-
24
- </td></tr>
25
- </table>
26
- </div>
27
-
28
- <hr/>
29
-
30
- <div class="content">
31
- <div class="section" lang="en" xml:lang="en">
32
- <div class="titlepage"><div><div><h2 class="title" style="clear: both">
33
- <a id="_colophon"></a>Colophon</h2></div></div></div>
34
- <div class="itemizedlist">
35
- <p class="title"><b>Acknowledgements</b></p>
36
- <ul type="disc">
37
- <li>
38
- Text imported from <a class="ulink" href="http://www.gutenberg.org" target="_top">Project Gutenburg</a>
39
- <a class="ulink" href="http://www.gutenberg.org/etext/1661" target="_top">http://www.gutenberg.org/etext/1661</a>.
40
- </li>
41
- <li>
42
- CSS page design is based on the <a class="ulink" href="http://epubzengarden.com" target="_top">ePub Zen
43
- Garden</a> <span class="emphasis"><em>Gbs</em></span> style.
44
- </li>
45
- <li>
46
- Cover illustration by Sidney Paget for the Strand Magazine: Sherlock
47
- Holmes and doctor Watson, published in The Adventure of Silver Blaze
48
- (1892) with the caption "Holmes gave me a sketch of the events"
49
- (<a class="ulink" href="http://commons.wikimedia.org/wiki/File:Strand_paget.jpg" target="_top">http://commons.wikimedia.org/wiki/File:Strand_paget.jpg</a>).
50
- </li>
51
- </ul>
52
- </div>
53
- <p><b>Project Gutenberg backmatter. </b>
54
- </p>
55
- <pre class="literallayout">*** END OF THE PROJECT GUTENBERG EBOOK, THE ADVENTURES OF SHERLOCK HOLMES ***
56
-
57
- This file should be named advsh12.txt or advsh12.zip
58
- Corrected EDITIONS of our eBooks get a new NUMBER, advsh13.txt
59
- VERSIONS based on separate sources get new LETTER, advsh12a.txt
60
-
61
- Project Gutenberg eBooks are often created from several printed
62
- editions, all of which are confirmed as Public Domain in the US
63
- unless a copyright notice is included. Thus, we usually do not
64
- keep eBooks in compliance with any particular paper edition.
65
-
66
- We are now trying to release all our eBooks one year in advance
67
- of the official release dates, leaving time for better editing.
68
- Please be encouraged to tell us about any error or corrections,
69
- even years after the official publication date.
70
-
71
- Please note neither this listing nor its contents are final til
72
- midnight of the last day of the month of any such announcement.
73
- The official release date of all Project Gutenberg eBooks is at
74
- Midnight, Central Time, of the last day of the stated month. A
75
- preliminary version may often be posted for suggestion, comment
76
- and editing by those who wish to do so.
77
-
78
- Most people start at our Web sites at:
79
- http://gutenberg.net or
80
- http://promo.net/pg
81
-
82
- These Web sites include award-winning information about Project
83
- Gutenberg, including how to donate, how to help produce our new
84
- eBooks, and how to subscribe to our email newsletter (free!).
85
-
86
-
87
- Those of you who want to download any eBook before announcement
88
- can get to them as follows, and just download by date. This is
89
- also a good way to get them instantly upon announcement, as the
90
- indexes our cataloguers produce obviously take a while after an
91
- announcement goes out in the Project Gutenberg Newsletter.
92
-
93
- http://www.ibiblio.org/gutenberg/etext04 or
94
- ftp://ftp.ibiblio.org/pub/docs/books/gutenberg/etext04
95
-
96
- Or /etext03, 02, 01, 00, 99, 98, 97, 96, 95, 94, 93, 92, 92, 91 or 90
97
-
98
- Just search by the first five letters of the filename you want,
99
- as it appears in our Newsletters.
100
-
101
-
102
- Information about Project Gutenberg (one page)
103
-
104
- We produce about two million dollars for each hour we work. The
105
- time it takes us, a rather conservative estimate, is fifty hours
106
- to get any eBook selected, entered, proofread, edited, copyright
107
- searched and analyzed, the copyright letters written, etc. Our
108
- projected audience is one hundred million readers. If the value
109
- per text is nominally estimated at one dollar then we produce $2
110
- million dollars per hour in 2002 as we release over 100 new text
111
- files per month: 1240 more eBooks in 2001 for a total of 4000+
112
- We are already on our way to trying for 2000 more eBooks in 2002
113
- If they reach just 1-2% of the world's population then the total
114
- will reach over half a trillion eBooks given away by year's end.
115
-
116
- The Goal of Project Gutenberg is to Give Away 1 Trillion eBooks!
117
- This is ten thousand titles each to one hundred million readers,
118
- which is only about 4% of the present number of computer users.
119
-
120
- Here is the briefest record of our progress (* means estimated):
121
-
122
- eBooks Year Month
123
-
124
- 1 1971 July
125
- 10 1991 January
126
- 100 1994 January
127
- 1000 1997 August
128
- 1500 1998 October
129
- 2000 1999 December
130
- 2500 2000 December
131
- 3000 2001 November
132
- 4000 2001 October/November
133
- 6000 2002 December*
134
- 9000 2003 November*
135
- 10000 2004 January*
136
-
137
-
138
- The Project Gutenberg Literary Archive Foundation has been created
139
- to secure a future for Project Gutenberg into the next millennium.
140
-
141
- We need your donations more than ever!
142
-
143
- As of February, 2002, contributions are being solicited from people
144
- and organizations in: Alabama, Alaska, Arkansas, Connecticut,
145
- Delaware, District of Columbia, Florida, Georgia, Hawaii, Illinois,
146
- Indiana, Iowa, Kansas, Kentucky, Louisiana, Maine, Massachusetts,
147
- Michigan, Mississippi, Missouri, Montana, Nebraska, Nevada, New
148
- Hampshire, New Jersey, New Mexico, New York, North Carolina, Ohio,
149
- Oklahoma, Oregon, Pennsylvania, Rhode Island, South Carolina, South
150
- Dakota, Tennessee, Texas, Utah, Vermont, Virginia, Washington, West
151
- Virginia, Wisconsin, and Wyoming.
152
-
153
- We have filed in all 50 states now, but these are the only ones
154
- that have responded.
155
-
156
- As the requirements for other states are met, additions to this list
157
- will be made and fund raising will begin in the additional states.
158
- Please feel free to ask to check the status of your state.
159
-
160
- In answer to various questions we have received on this:
161
-
162
- We are constantly working on finishing the paperwork to legally
163
- request donations in all 50 states. If your state is not listed and
164
- you would like to know if we have added it since the list you have,
165
- just ask.
166
-
167
- While we cannot solicit donations from people in states where we are
168
- not yet registered, we know of no prohibition against accepting
169
- donations from donors in these states who approach us with an offer to
170
- donate.
171
-
172
- International donations are accepted, but we don't know ANYTHING about
173
- how to make them tax-deductible, or even if they CAN be made
174
- deductible, and don't have the staff to handle it even if there are
175
- ways.
176
-
177
- Donations by check or money order may be sent to:
178
-
179
- Project Gutenberg Literary Archive Foundation
180
- PMB 113
181
- 1739 University Ave.
182
- Oxford, MS 38655-4109
183
-
184
- Contact us if you want to arrange for a wire transfer or payment
185
- method other than by check or money order.
186
-
187
- The Project Gutenberg Literary Archive Foundation has been approved by
188
- the US Internal Revenue Service as a 501(c)(3) organization with EIN
189
- [Employee Identification Number] 64-622154. Donations are
190
- tax-deductible to the maximum extent permitted by law. As fund-raising
191
- requirements for other states are met, additions to this list will be
192
- made and fund-raising will begin in the additional states.
193
-
194
- We need your donations more than ever!
195
-
196
- You can get up to date donation information online at:
197
-
198
- http://www.gutenberg.net/donation.html
199
-
200
-
201
- ***
202
-
203
- If you can't reach Project Gutenberg,
204
- you can always email directly to:
205
-
206
- Michael S. Hart &lt;hart@pobox.com&gt;
207
-
208
- Prof. Hart will answer or forward your message.
209
-
210
- We would prefer to send you information by email.
211
-
212
-
213
- **The Legal Small Print**
214
-
215
-
216
- (Three Pages)
217
-
218
- ***START**THE SMALL PRINT!**FOR PUBLIC DOMAIN EBOOKS**START***
219
- Why is this "Small Print!" statement here? You know: lawyers.
220
- They tell us you might sue us if there is something wrong with
221
- your copy of this eBook, even if you got it for free from
222
- someone other than us, and even if what's wrong is not our
223
- fault. So, among other things, this "Small Print!" statement
224
- disclaims most of our liability to you. It also tells you how
225
- you may distribute copies of this eBook if you want to.
226
-
227
- *BEFORE!* YOU USE OR READ THIS EBOOK
228
- By using or reading any part of this PROJECT GUTENBERG-tm
229
- eBook, you indicate that you understand, agree to and accept
230
- this "Small Print!" statement. If you do not, you can receive
231
- a refund of the money (if any) you paid for this eBook by
232
- sending a request within 30 days of receiving it to the person
233
- you got it from. If you received this eBook on a physical
234
- medium (such as a disk), you must return it with your request.
235
-
236
- ABOUT PROJECT GUTENBERG-TM EBOOKS
237
- This PROJECT GUTENBERG-tm eBook, like most PROJECT GUTENBERG-tm eBooks,
238
- is a "public domain" work distributed by Professor Michael S. Hart
239
- through the Project Gutenberg Association (the "Project").
240
- Among other things, this means that no one owns a United States copyright
241
- on or for this work, so the Project (and you!) can copy and
242
- distribute it in the United States without permission and
243
- without paying copyright royalties. Special rules, set forth
244
- below, apply if you wish to copy and distribute this eBook
245
- under the "PROJECT GUTENBERG" trademark.
246
-
247
- Please do not use the "PROJECT GUTENBERG" trademark to market
248
- any commercial products without permission.
249
-
250
- To create these eBooks, the Project expends considerable
251
- efforts to identify, transcribe and proofread public domain
252
- works. Despite these efforts, the Project's eBooks and any
253
- medium they may be on may contain "Defects". Among other
254
- things, Defects may take the form of incomplete, inaccurate or
255
- corrupt data, transcription errors, a copyright or other
256
- intellectual property infringement, a defective or damaged
257
- disk or other eBook medium, a computer virus, or computer
258
- codes that damage or cannot be read by your equipment.
259
-
260
- LIMITED WARRANTY; DISCLAIMER OF DAMAGES
261
- But for the "Right of Replacement or Refund" described below,
262
- [1] Michael Hart and the Foundation (and any other party you may
263
- receive this eBook from as a PROJECT GUTENBERG-tm eBook) disclaims
264
- all liability to you for damages, costs and expenses, including
265
- legal fees, and [2] YOU HAVE NO REMEDIES FOR NEGLIGENCE OR
266
- UNDER STRICT LIABILITY, OR FOR BREACH OF WARRANTY OR CONTRACT,
267
- INCLUDING BUT NOT LIMITED TO INDIRECT, CONSEQUENTIAL, PUNITIVE
268
- OR INCIDENTAL DAMAGES, EVEN IF YOU GIVE NOTICE OF THE
269
- POSSIBILITY OF SUCH DAMAGES.
270
-
271
- If you discover a Defect in this eBook within 90 days of
272
- receiving it, you can receive a refund of the money (if any)
273
- you paid for it by sending an explanatory note within that
274
- time to the person you received it from. If you received it
275
- on a physical medium, you must return it with your note, and
276
- such person may choose to alternatively give you a replacement
277
- copy. If you received it electronically, such person may
278
- choose to alternatively give you a second opportunity to
279
- receive it electronically.
280
-
281
- THIS EBOOK IS OTHERWISE PROVIDED TO YOU "AS-IS". NO OTHER
282
- WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, ARE MADE TO YOU AS
283
- TO THE EBOOK OR ANY MEDIUM IT MAY BE ON, INCLUDING BUT NOT
284
- LIMITED TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
285
- PARTICULAR PURPOSE.
286
-
287
- Some states do not allow disclaimers of implied warranties or
288
- the exclusion or limitation of consequential damages, so the
289
- above disclaimers and exclusions may not apply to you, and you
290
- may have other legal rights.
291
-
292
- INDEMNITY
293
- You will indemnify and hold Michael Hart, the Foundation,
294
- and its trustees and agents, and any volunteers associated
295
- with the production and distribution of Project Gutenberg-tm
296
- texts harmless, from all liability, cost and expense, including
297
- legal fees, that arise directly or indirectly from any of the
298
- following that you do or cause: [1] distribution of this eBook,
299
- [2] alteration, modification, or addition to the eBook,
300
- or [3] any Defect.
301
-
302
- DISTRIBUTION UNDER "PROJECT GUTENBERG-tm"
303
- You may distribute copies of this eBook electronically, or by
304
- disk, book or any other medium if you either delete this
305
- "Small Print!" and all other references to Project Gutenberg,
306
- or:
307
-
308
- [1] Only give exact copies of it. Among other things, this
309
- requires that you do not remove, alter or modify the
310
- eBook or this "small print!" statement. You may however,
311
- if you wish, distribute this eBook in machine readable
312
- binary, compressed, mark-up, or proprietary form,
313
- including any form resulting from conversion by word
314
- processing or hypertext software, but only so long as
315
- *EITHER*:
316
-
317
- [*] The eBook, when displayed, is clearly readable, and
318
- does *not* contain characters other than those
319
- intended by the author of the work, although tilde
320
- (~), asterisk (*) and underline (_) characters may
321
- be used to convey punctuation intended by the
322
- author, and additional characters may be used to
323
- indicate hypertext links; OR
324
-
325
- [*] The eBook may be readily converted by the reader at
326
- no expense into plain ASCII, EBCDIC or equivalent
327
- form by the program that displays the eBook (as is
328
- the case, for instance, with most word processors);
329
- OR
330
-
331
- [*] You provide, or agree to also provide on request at
332
- no additional cost, fee or expense, a copy of the
333
- eBook in its original plain ASCII form (or in EBCDIC
334
- or other equivalent proprietary form).
335
-
336
- [2] Honor the eBook refund and replacement provisions of this
337
- "Small Print!" statement.
338
-
339
- [3] Pay a trademark license fee to the Foundation of 20% of the
340
- gross profits you derive calculated using the method you
341
- already use to calculate your applicable taxes. If you
342
- don't derive profits, no royalty is due. Royalties are
343
- payable to "Project Gutenberg Literary Archive Foundation"
344
- the 60 days following each date you prepare (or were
345
- legally required to prepare) your annual (or equivalent
346
- periodic) tax return. Please contact us beforehand to
347
- let us know your plans and to work out the details.
348
-
349
- WHAT IF YOU *WANT* TO SEND MONEY EVEN IF YOU DON'T HAVE TO?
350
- Project Gutenberg is dedicated to increasing the number of
351
- public domain and licensed works that can be freely distributed
352
- in machine readable form.
353
-
354
- The Project gratefully accepts contributions of money, time,
355
- public domain materials, or royalty free copyright licenses.
356
- Money should be paid to the:
357
- "Project Gutenberg Literary Archive Foundation."
358
-
359
- If you are interested in contributing scanning equipment or
360
- software or other items, please contact Michael Hart at:
361
- hart@pobox.com
362
-
363
- [Portions of this eBook's header and trailer may be reprinted only
364
- when distributed free of all fees. Copyright (C) 2001, 2002 by
365
- Michael S. Hart. Project Gutenberg is a TradeMark and may not be
366
- used in any sales of Project Gutenberg eBooks or other materials be
367
- they hardware or software or any other related product without
368
- express permission.]
369
-
370
- *END THE SMALL PRINT! FOR PUBLIC DOMAIN EBOOKS*Ver.02/11/02*END*</pre>
371
- <p>
372
- </p>
373
- </div>
374
-
375
- </div>
376
-
377
- <hr/>
378
-
379
- <div class="nav" id="navfooter">
380
- <table width="100%">
381
- <tr><td width="33%" align="left">
382
-
383
- <a href="the_adventure_of_the_copper_beeches.html">Prev</a><br/>
384
- The Adventure of the Copper Beeches
385
-
386
- </td><td width="33%" align="center">
387
-
388
- <a href="index.html">Home</a><br/>
389
- The Adventures of Sherlock Holmes
390
-
391
- </td><td width="33%" align="right">
392
-
393
- </td></tr>
394
- </table>
395
- </div>
396
- </body>
397
- </html>