|
Lines 46-52
Link Here
|
| 46 |
“Don't use contractions” would be wrong.</para> |
46 |
“Don't use contractions” would be wrong.</para> |
| 47 |
|
47 |
|
| 48 |
<para>Avoiding contractions makes for a more formal tone, is more |
48 |
<para>Avoiding contractions makes for a more formal tone, is more |
| 49 |
precise, and slightly easier for translators.</para> |
49 |
precise, and is slightly easier for translators.</para> |
| 50 |
</listitem> |
50 |
</listitem> |
| 51 |
</varlistentry> |
51 |
</varlistentry> |
| 52 |
|
52 |
|
|
Lines 54-64
Link Here
|
| 54 |
<term>Use the serial comma</term> |
54 |
<term>Use the serial comma</term> |
| 55 |
|
55 |
|
| 56 |
<listitem> |
56 |
<listitem> |
| 57 |
<para>In a list of items within a paragraph, seperate each item from |
57 |
<para>In a list of items within a paragraph, separate each item from |
| 58 |
the others with a comma. Seperate the last item from the others with |
58 |
the others with a comma. Seperate the last item from the others with |
| 59 |
a comma and the word “and”.</para> |
59 |
a comma and the word “and”.</para> |
| 60 |
|
60 |
|
| 61 |
<para>For example, look at the following quote;</para> |
61 |
<para>For example, look at the following:</para> |
| 62 |
|
62 |
|
| 63 |
<blockquote> |
63 |
<blockquote> |
| 64 |
<para>This is a list of one, two and three items.</para> |
64 |
<para>This is a list of one, two and three items.</para> |
|
Lines 68-74
Link Here
|
| 68 |
“two”, and “three”, or a list of two items, |
68 |
“two”, and “three”, or a list of two items, |
| 69 |
“one” and “two and three”?</para> |
69 |
“one” and “two and three”?</para> |
| 70 |
|
70 |
|
| 71 |
<para>It is better to be explicit and include a serial comma;</para> |
71 |
<para>It is better to be explicit and include a serial comma:</para> |
| 72 |
|
72 |
|
| 73 |
<blockquote> |
73 |
<blockquote> |
| 74 |
<para>This is a list of one, two, and three items.</para> |
74 |
<para>This is a list of one, two, and three items.</para> |
|
Lines 132-138
Link Here
|
| 132 |
<application>emacs</application>.</para> |
132 |
<application>emacs</application>.</para> |
| 133 |
|
133 |
|
| 134 |
<para>While it may be argued that a capital letter following |
134 |
<para>While it may be argued that a capital letter following |
| 135 |
the end of sentence period, this is not the case, especially |
135 |
a period denotes a new sentence, this is not the case, especially |
| 136 |
in name usage. <quote>Jordan K. Hubbard</quote> is a good |
136 |
in name usage. <quote>Jordan K. Hubbard</quote> is a good |
| 137 |
example; it has a capital <literal>H</literal> following a |
137 |
example; it has a capital <literal>H</literal> following a |
| 138 |
period and a space, and there certainly isn't a new sentence |
138 |
period and a space, and there certainly isn't a new sentence |
|
Lines 142-148
Link Here
|
| 142 |
</variablelist> |
142 |
</variablelist> |
| 143 |
|
143 |
|
| 144 |
<para>For more information about writing style, see <ulink |
144 |
<para>For more information about writing style, see <ulink |
| 145 |
url="http://www.columbia.edu/acis/bartleby/strunk/">Elements of |
145 |
url="http://www.bartleby.com/141/index.html">Elements of |
| 146 |
Style</ulink>, by William Strunk.</para> |
146 |
Style</ulink>, by William Strunk.</para> |
| 147 |
|
147 |
|
| 148 |
<sect1> |
148 |
<sect1> |