os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Expand contractions in the fdp-primer.

Browse source 
Also replace a few erroneous "it's" with the possessive "its".
This commit is contained in:
Giorgos Keramidas 2001-12-08 12:12:47 +00:00
parent 0efd38263b
commit 96e9fe2ad3
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=11373
5 changed files with 31 additions and 31 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.sgml
View file

@ -309,7 +309,7 @@ PRI_LANG?= en_US.ISO8859-1
<note>
<para><makevar>PRI_LANG</makevar> in no way affects what documents
can, or even will, be built. It's main use is creating links to
can, or even will, be built. Its main use is creating links to
commonly referenced documents into the FreeBSD documentation
install root.</para>
</note>
@ -378,7 +378,7 @@ PRI_LANG?= en_US.ISO8859-1
<para>After that descriptive tuple, instructions on how to build
the target may be given, if the conversion process between the
target and it's dependencies are not previously defined, or if
target and its dependencies are not previously defined, or if
this particular conversion is not the same as the default
conversion method.</para>
@ -399,7 +399,7 @@ PRI_LANG?= en_US.ISO8859-1
<para>What sets this macro apart from other targets? Basically,
it is executed <emphasis>after</emphasis> the instructions
given in the build procedure it is listed as a dependency to,
and it doesn't adjust <makevar>.TARGET</makevar>, which is the
and it does not adjust <makevar>.TARGET</makevar>, which is the
variable which contains the name of the target currently
being built.</para>

14
en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
View file

@ -331,7 +331,7 @@
To: freebsd-doc@FreeBSD.org
Subject: New documentation available
There's a new copy of my primer for contributers to the FreeBSD
There is a new copy of my primer for contributors to the FreeBSD
Documentation Project available at
<URL:http://people.FreeBSD.org/~nik/primer/index.html>
@ -1128,7 +1128,7 @@
<para>In order to do this, use <sgmltag>itemizedlist</sgmltag>,
<sgmltag>orderedlist</sgmltag>, or
<sgmltag>procedure</sgmltag><footnote><para>There are other types of
list element in DocBook, but we're not concerned with those at
list element in DocBook, but we are not concerned with those at
the moment.</para>
</footnote>
</para>
@ -1430,7 +1430,7 @@ main(void)
</informaltable>
</example>
<para>If you don't want a border around the table the
<para>If you do not want a border around the table the
<literal>frame</literal> attribute can be added to the
<sgmltag>informaltable</sgmltag> element with a value of
<literal>none</literal> (i.e., <literal>&lt;informaltable
@ -2228,12 +2228,12 @@ This is the file called 'foo2'</screen>
<important>
<para>Image support in the documentation is currently extremely
experimental. I think the mechanisms described here are unlikely to
change, but that's not guaranteed.</para>
change, but that is not guaranteed.</para>
<para>You will also need to install the
<filename>graphics/ImageMagick</filename> port, which is used to
convert between the different image formats. This is a big port,
and most of it is not required. However, while we're working on the
and most of it is not required. However, while we are working on the
<filename>Makefile</filename>s and other infrastructure it makes
things easier. This port is <emphasis>not</emphasis> in the
<filename>textproc/docproj</filename> meta port, you must install it
@ -2241,7 +2241,7 @@ This is the file called 'foo2'</screen>
<para>The best example of what follows in practice is the
<filename>doc/en_US.ISO8859-1/articles/vm-design/</filename> document.
If you're unsure of the description that follows, take a look at the
If you are unsure of the description that follows, take a look at the
files in that directory to see how everything hangs together.
Experiment with creating different formatted versions of the
document to see how the image markup appears in the formatted
@ -2512,7 +2512,7 @@ IMAGES= chapter1/fig1.png
<title><sgmltag>anchor</sgmltag></title>
<programlisting><![ CDATA [<para>This paragraph has an embedded
<anchor id="para1">link target in it. It won't show up in
<anchor id="para1">link target in it. It will not show up in
the document.</para>]]></programlisting>
</example>

20
en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
View file

@ -315,7 +315,7 @@
<example>
<title>Single quotes around attributes</title>
<programlisting><![ CDATA [<p align='right'>I'm on the right!</p>]]></programlisting>
<programlisting><![ CDATA [<p align='right'>I am on the right!</p>]]></programlisting>
</example>
<para>Sometimes you do not need to use quotes around attribute values at
@ -592,8 +592,8 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</title>
<note>
<para>You don't need to know this, but it's useful background, and
might help you debug problems when your SGML processor can't locate
<para>You do not need to know this, but it is useful background, and
might help you debug problems when your SGML processor can not locate
the DTD you are using.</para>
</note>
@ -633,7 +633,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
to assign registered names. The ISO council delegated this to
the American National Standards Institute (ANSI).</para>
<para>Because the FreeBSD Project hasn't been registered the
<para>Because the FreeBSD Project has not been registered the
owner string is <literal>-//FreeBSD</literal>. And as you can
see, the W3C are not a registered owner either.</para>
</listitem>
@ -756,7 +756,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
typically (but not always) means the DTD will be provided as a
filename.</para>
<para>Using FPIs is preferred for reasons of portability. You don't
<para>Using FPIs is preferred for reasons of portability. You do not
want to have to ship a copy of the DTD around with your document, and
if you used the <literal>SYSTEM</literal> identifier then everyone
would need to keep their DTDs in the same place.</para>
@ -1038,7 +1038,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
(you may need to copy it to <filename>example.html</filename>
before your browser recognises it as an HTML document).</para>
<para>Unless your browser is very advanced, you won't see the entity
<para>Unless your browser is very advanced, you will not see the entity
reference <literal>&amp;version;</literal> replaced with the
version number. Most web browsers have very simplistic parsers
which do not handle proper SGML<footnote>
@ -1394,7 +1394,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
&lt;programlisting>
&lt![ CDATA [ <![ CDATA [
<p>This is a sample that shows you some of the elements within
HTML. Since the angle brackets are used so many times, it's
HTML. Since the angle brackets are used so many times, it is
simpler to say the whole example is a CDATA marked section
than to use the entity names for the left and right angle
brackets throughout.</p>
@ -1436,7 +1436,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
]]&gt;</programlisting>
</example>
<para>By itself, this isn't too useful. If you wanted to remove text
<para>By itself, this is not too useful. If you wanted to remove text
from your document you could cut it out, or wrap it in
comments.</para>
@ -1448,10 +1448,10 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<para>For example, suppose that you produced a hard-copy version of
some documentation and an electronic version. In the electronic
version you wanted to include some extra content that wasn't to
version you wanted to include some extra content that was not to
appear in the hard-copy.</para>
<para>Create a parameter entity, and set it's value to
<para>Create a parameter entity, and set its value to
<literal>INCLUDE</literal>. Write your document, using marked
sections to delimit content that should only appear in the
electronic version. In these marked sections use the parameter

16
en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml
View file

@ -158,7 +158,7 @@
versions of the files that make up the documentation.</para>
<para>[XXX To Do -- write a tutorial that shows how to use CVSup to
get just the documentation, check it out, and see what's changed
get just the documentation, check it out, and see what has changed
between two arbitrary revisions]</para>
</answer>
</qandaentry>
@ -174,14 +174,14 @@
url="../../../../docproj/translations.html">Documentation
Project translations page</ulink> lists the translation efforts
that are currently known about. If others are already working
on translating documentation to your language, please don't
on translating documentation to your language, please do not
duplicate their efforts. Instead, contact them to see how you can
help.</para>
<para>If no one is listed on that page as translating for your
language, then send a message to
<email>freebsd-doc@FreeBSD.org</email> in case someone else is
thinking of doing a translation, but hasn't announced it yet.</para>
thinking of doing a translation, but has not announced it yet.</para>
</answer>
</qandaentry>
@ -195,7 +195,7 @@
<replaceable>your-language-here</replaceable> Documentation
Translation Project</quote>. Welcome aboard.</para>
<para>First, decide whether or not you've got the time to spare. Since
<para>First, decide whether or not you have got the time to spare. Since
you are the only person working on your language at the moment it is
going to be your responsibility to publicise your work and
coordinate any volunteers that might want to help you.</para>
@ -221,7 +221,7 @@
<qandaentry>
<question>
<para>I've translated some documentation, where do I send it?</para>
<para>I have translated some documentation, where do I send it?</para>
</question>
<answer>
@ -239,12 +239,12 @@
<qandaentry>
<question>
<para>I'm the only person working on translating to this language, how
<para>I am the only person working on translating to this language, how
do I submit my translation?</para>
<para>or</para>
<para>We're a translation team, and want to submit documentation that
<para>We are a translation team, and want to submit documentation that
our members have translated for us?</para>
</question>
@ -342,7 +342,7 @@
Korean, and want to include a section about retailers in Korea in
your Handbook.</para>
<para>There's no real reason why that information should not be in the
<para>There is no real reason why that information should not be in the
English (or German, or Spanish, or Japanese, or &hellip;) versions
as well. It is feasible that an English speaker in Korea might try
and pick up a copy of FreeBSD whilst over there. It also helps

6
en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml
View file

@ -147,7 +147,7 @@
a period denotes a new sentence, this is not the case, especially
in name usage. <quote>Jordan K. Hubbard</quote> is a good
example; it has a capital <literal>H</literal> following a
period and a space, and there certainly isn't a new sentence
period and a space, and there certainly is not a new sentence
there.</para>
</listitem>
</varlistentry>
@ -269,12 +269,12 @@ V
<title>Separating tags</title>
<para>Tags like <sgmltag>itemizedlist</sgmltag> which will
always have further tags inside them, and in fact don't take
always have further tags inside them, and in fact do not take
character data themselves, are always on a line by
themselves.</para>
<para>Tags like <sgmltag>para</sgmltag> and
<sgmltag>term</sgmltag> don't need other tags to contain
<sgmltag>term</sgmltag> do not need other tags to contain
normal character data, and their contents begin immediately
after the tag, <emphasis>on the same line</emphasis>.</para>