Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 16 Dec 2012 19:59:47 -0500
From:      Eitan Adler <lists@eitanadler.com>
To:        Alex Weber <alexwebr@gmail.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: patch for ThwackAFAQ differences-to-other-bsds
Message-ID:  <CAF6rxgmhfWOUkVaHRNKcht8JbapgP3ouEM6Wcnq3Z2%2Bqwrj8Ew@mail.gmail.com>
In-Reply-To: <50CE6891.2080303@gmail.com>

index | next in thread | previous in thread | raw e-mail

[-- Attachment #1 --]
On 16 December 2012 19:34, Alex Weber <alexwebr@gmail.com> wrote:
> Hello list,
>
> This is my first patch to the FreeBSD docs, so please let me know if
> I've done something wrong! :)

This is a really good start!

A few comments.  Almost all of them are formatting, rather than
content nits. This is good. :)

- Try not to change whitespace and content in the same diff.  This
makes it harder for our translators to see what changed.
- The maximum line length is 70 (with some exceptions, e.g., for links)
- "FreeBSD" is spelled "&os;"
- http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/openssh.html
is spelled &url.books.handbook;/openssh.html
- ssh(1)  can also be spelled &man.ssh.1;
- items at the same indentation level should have an extra newline
- sentences have double spaces

I've attached a modified diff so you could see how it may look.




>
> This patch seeks to update the FAQ question "What are the differences
> between FreeBSD and NetBSD, OpenBSD, and other open source BSD operating
> systems?" listed in the ThwackAFAQ wiki.
>
> I've attached the patch as 'differences-to-other-bsds.patch'.
>
> -Alex Weber
>
> _______________________________________________
> freebsd-doc@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
>



-- 
Eitan Adler

[-- Attachment #2 --]
commit 9c9beee3e224c3c0a416d841b2285aec59274f1f
Author: Eitan Adler <lists@eitanadler.com>
Date:   Sun Dec 16 19:57:37 2012 -0500

    Update and expand on the differences to other bsds question.
    
    Submitted by:	Alex Weber <alexwebr@gmail.com>
    Approved by:	??? (mentor)

diff --git a/en_US.ISO8859-1/books/faq/book.xml b/en_US.ISO8859-1/books/faq/book.xml
index 44cc4c0..3b297a6 100644
--- a/en_US.ISO8859-1/books/faq/book.xml
+++ b/en_US.ISO8859-1/books/faq/book.xml
@@ -305,7 +305,40 @@
 	    differences between the various projects,
 	    called <ulink
 	      url="http://www.freebsdworld.gr/freebsd/bsd-family-tree.html">The BSD Family Tree</ulink>
-	    which goes a fair way to answering this question.</para>
+	    which goes a fair way to answering this question.
+	    Some of the information is out of date, but the history
+	    portion in particular remains accurate.</para>
+
+	  <para>Most of the BSDs share patches and code, even today.
+	    All of the BSDs have common ancestry.</para>
+
+	  <para>The design goals of &os; are described in
+	    <xref linkend="FreeBSD-goals"/>, above.  The design goals
+	    of the other most popular BSDs may be summarized as
+	    follows:</para>
+
+	  <itemizedlist>
+	    <listitem>
+	      <para>OpenBSD aims for operating system security above
+		all else. The OpenBSD team wrote
+		<ulink
+		  url="&url.books.handbook;/openssh.html">OpenSSH</ulink>
+		and &man.pf.4;,
+	        which have both been ported to &os;.</para>
+	    </listitem>
+
+	    <listitem>
+	      <para>NetBSD aims to be easily ported to other hardware
+		platforms.</para>
+	    </listitem>
+
+	    <listitem>
+	      <para>DragonFlyBSD is a fork of &os;&nbsp;4.8 that has
+		since developed many interesting features of its own,
+		including the HAMMER file system and support for
+		user-mode <quote>vkernels</quote>.</para>
+	    </listitem>
+	  </itemizedlist>
 	</answer>
       </qandaentry>
 
help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAF6rxgmhfWOUkVaHRNKcht8JbapgP3ouEM6Wcnq3Z2%2Bqwrj8Ew>