From owner-p4-projects@FreeBSD.ORG  Sun Nov 15 14:53:53 2009
Return-Path: <owner-p4-projects@FreeBSD.ORG>
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 219A0106568F; Sun, 15 Nov 2009 14:53:53 +0000 (UTC)
Delivered-To: perforce@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CE362106568B
	for <perforce@FreeBSD.org>; Sun, 15 Nov 2009 14:53:52 +0000 (UTC)
	(envelope-from rene@FreeBSD.org)
Received: from repoman.freebsd.org (repoman.freebsd.org
	[IPv6:2001:4f8:fff6::29])
	by mx1.freebsd.org (Postfix) with ESMTP id A2C088FC15
	for <perforce@FreeBSD.org>; Sun, 15 Nov 2009 14:53:52 +0000 (UTC)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFErqFA041566
	for <perforce@FreeBSD.org>; Sun, 15 Nov 2009 14:53:52 GMT
	(envelope-from rene@FreeBSD.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.14.3/8.14.3/Submit) id nAFErq9X041564
	for perforce@freebsd.org; Sun, 15 Nov 2009 14:53:52 GMT
	(envelope-from rene@FreeBSD.org)
Date: Sun, 15 Nov 2009 14:53:52 GMT
Message-Id: <200911151453.nAFErq9X041564@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	rene@FreeBSD.org using -f
From: Rene Ladan <rene@FreeBSD.org>
To: Perforce Change Reviews <perforce@FreeBSD.org>
Precedence: bulk
Cc: 
Subject: PERFORCE change 170641 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 15 Nov 2009 14:53:53 -0000

http://p4web.freebsd.org/chv.cgi?CH=170641

Change 170641 by rene@rene_self on 2009/11/15 14:53:01

	[porters handbook/clang]:
	* Add missing text [1] [2]
	* Elaborate a bit on CC and CXX variables [1]
	* Mention that "int main(void)" is also valid for Clang [2]
	* Mention the default C standards used
	Submitted by: remko [1], Oliver Fromme [2]	

Affected files ...

.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/porters-handbook/book.sgml#51 edit

Differences ...

==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/porters-handbook/book.sgml#51 (text+ko) ====

@@ -13613,15 +13613,16 @@
 
 	<itemizedlist>
 	  <listitem>
-	    <para>Respect <makevar>CC</makevar> and <makevar>CXX</makevar>. Do
-	      not any of <filename>cc</filename>, <filename>c99</filename>,
-	      <filename>gcc</filename>, <filename>c++</filename>, or
-	      <filename>g++</filename> directly.</para>
+	    <para>Respect the <makevar>CC</makevar> and <makevar>CXX</makevar>
+	      variables. Do not use any of the programs <filename>cc</filename>,
+	      <filename>c99</filename>, <filename>gcc</filename>,
+	      <filename>c++</filename>, or <filename>g++</filename> in a port
+	      directly.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Respect <makevar>LD</makevar>, do not use
-	      <filename>ld</filename> directly.</para>
+	      <filename>ld</filename> in a port directly.</para>
 	  </listitem>
 
 	  <listitem>
@@ -13632,10 +13633,11 @@
 	  </listitem>
 
 	  <listitem>
-	    <para>If there are link errors related to missing or already
-	      defined functions, try to add <makevar>CSTD=gnu89</makevar> to
-	      <filename>Makefile</filename>.  The function vsnprintf() is
-	      already built in.</para>
+	    <para>Clang uses the C99 standard by default, while GCC uses the C89
+	      standard by default.  Therefore, if there are any errors related
+	      to missing or already defined functions, try to add
+	      <makevar>CSTD=gnu89</makevar> to
+	      <filename>Makefile</filename>.</para>
 	  </listitem>
 
 	  <listitem>
@@ -13652,9 +13654,13 @@
 	  </listitem>
 
 	  <listitem>
-	    <para>The main function must be properly declared as</para>
+	    <para>The main function must be properly declared as:</para>
 
 	    <programlisting>int main(int argc, char **argv)</programlisting>
+
+	    <para>or, if there are no parameters, as:</para>
+
+	    <programlisting>int main(void)</programlisting>
 	  </listitem>
 
 	  <listitem>