Date: Sat, 14 Feb 2009 23:50:04 +0100 (CET) From: Fabian Ruch <fabianruch@bsdgroup.de> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/131684: [patch] articles/linux-comparison: replace Addenda by footnote elements Message-ID: <200902142250.n1EMo4Kf002725@beastie.local> Resent-Message-ID: <200902142300.n1EN06Lv039648@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 131684
>Category: docs
>Synopsis: [patch] articles/linux-comparison: replace Addenda by footnote elements
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Sat Feb 14 23:00:05 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator: Fabian Ruch
>Release: FreeBSD 7.1-RELEASE i386
>Organization:
>Environment:
System: FreeBSD beastie.local 7.1-RELEASE FreeBSD 7.1-RELEASE #0: Thu Jan 1 14:37:25 UTC 2009 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386
>Description:
The attached patch replaces the addenda by footnotes in
doc/en_US.ISO8859-1/articles/linux-comparison/article.sgml (r1.10), so
that the extra information is always shown on the same page currently
read and one can jump to it via hyperlinks.
>How-To-Repeat:
Inform yourself about an Open Source alternative to Linux!
>Fix:
--- lc110en.diff begins here ---
Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/linux-comparison/article.sgml,v
retrieving revision 1.10
diff -u -r1.10 article.sgml
--- article.sgml 8 Aug 2006 19:35:13 -0000 1.10
+++ article.sgml 14 Feb 2009 22:34:11 -0000
@@ -99,7 +99,15 @@
<para>&os; is a complete operating system (kernel and
userland) with a well-respected heritage grounded in the
- roots of Unix development.[1] Since both the kernel and the
+ roots of Unix development.
+
+ <footnote>
+ <para>See also <ulink
+ url="http://www.oreilly.com/catalog/opensources/book/kirkmck.html"></ulink>;
+ for a brief history.</para>
+ </footnote>
+
+ Since both the kernel and the
provided utilities are under the control of the same release
engineering team, there is less likelihood of library
incompatibilities. Security vulnerabilities can also be
@@ -145,7 +153,15 @@
restrictions on the distribution of GPLd code. In contrast,
the BSD license places no such restrictions, which gives you
the flexibility of keeping the code Open Source or closing
- the code for a proprietary commercial product.[2] Having
+ the code for a proprietary commercial product.
+
+ <footnote>
+ <para>For a fairly unbiased view of the merits of each
+ license, see <ulink
+ url="http://en.wikipedia.org/wiki/BSD_and_GPL_licensing"></ulink>.</para>;
+ </footnote>
+
+ Having
stable and reliable code under the attractive BSD license
means that many operating systems, such as <ulink url="http://developer.apple.com/darwin/projects/darwin/faq.html">Apple OS X</ulink>
are based on FreeBSD code. It also means that if you choose
@@ -192,7 +208,15 @@
operating system! It supports the X Window System, the same
one used in &linux; distributions to provide a desktop user
interface. It also supports over 13,000 easy to install
- third-party applications,[3] including KDE, Gnome, and
+ third-party applications,
+
+ <footnote>
+ <para>Using <ulink url="&url.base;/ports">FreeBSD's ports
+ collection</ulink>: software installation is as easy as
+ <command>pkg_add -r application_name</command>.</para>
+ </footnote>
+
+ including KDE, Gnome, and
OpenOffice.</para>
<para>Several projects are available to ease the installation of
@@ -483,14 +507,30 @@
and Unix skillsets to FreeBSD administration.</para></listitem>
<listitem><para>In-house developers have full access to all
- FreeBSD code[4] for all releases going back to the original
+ FreeBSD code
+
+ <footnote>
+ <para>In addition, all code is browsable through a
+ web-interface: <ulink
+ url="http://www.FreeBSD.org/cgi/cvsweb.cgi/"></ulink>.</para>;
+ </footnote>
+
+ for all releases going back to the original
&os; release. Included with the code are all of the log
messages which provide context to changes and
bug fixes. Additionally, a developer can easily replicate any
release by simply checking out the code with the desired
label. In contrast, &linux; traditionally didn't follow this
model, but has recently adopted a more mature development
- model. [5]</para></listitem>
+ model.
+
+ <footnote>
+ <para>An interesting overview of the evolving Linux
+ development model can be found at <ulink
+ url="http://linuxdevices.com/articles/AT4155251624.html"></ulink>.</para>;
+ </footnote>
+
+ </para></listitem>
<listitem><para>In-house developers also have full access to
FreeBSD's <ulink
@@ -516,35 +556,6 @@
in their existing infrastructure, &os; is an excellent choice
indeed.</para>
</sect1>
-
- <sect1 id="freebsd-addenda">
- <title>Addenda</title>
-
- <orderedlist>
-
- <listitem><para>See also <ulink
- url="http://www.oreilly.com/catalog/opensources/book/kirkmck.html"></ulink>;
- for a brief history.</para></listitem>
-
- <listitem><para>For a fairly unbiased view of the merits of each
- license, see <ulink
- url="http://en.wikipedia.org/wiki/BSD_and_GPL_licensing"></ulink>.</para></listitem>;
-
- <listitem><para>Using <ulink
- url="&url.base;/ports">FreeBSD's ports
- collection</ulink>: software installation is as easy as
- <command>pkg_add -r application_name</command>.</para></listitem>
-
- <listitem><para>In addition, all code is browsable through a
- web-interface: <ulink
- url="http://www.FreeBSD.org/cgi/cvsweb.cgi/"></ulink>.</para></listitem>;
-
- <listitem><para>An interesting overview of the evolving Linux
- development model can be found at <ulink
- url="http://linuxdevices.com/articles/AT4155251624.html"></ulink>.</para></listitem>;
-
- </orderedlist>
- </sect1>
</article>
--- lc110en.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200902142250.n1EMo4Kf002725>