compilers.conf.5: Some more cleanup.

* Remove a reference to an old patch I did for building world with clang.
  The changes which are currently needed remain to be determined.

* Make the examples more generic and indicate that buildworld/kernel
  do not necessarily survive with the compilers listed. Also, stuff them
  into an EXAMPLES section.

* Add a comma.

Reported-by: Carsten Mattner <carstenmattner@gmail.com>

diff --git a/share/man/man5/compilers.conf.5 b/share/man/man5/compilers.conf.5
index ccb78da..05001f1 100644 (file)
--- a/share/man/man5/compilers.conf.5
+++ b/share/man/man5/compilers.conf.5
@@ -29,7 +29,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 12, 2012
+.Dd October 14, 2012
 .Dt COMPILERS.CONF 5
 .Os
 .Sh NAME
@@ -78,20 +78,6 @@ Any additional flags to pass to
 .Va <version>_CXX .
 .El
 .Pp
-Once configured the compiler can then be used like this:
-.Bd -literal -offset indent
-env CCVER=clang make
-.Ed
-.Pp
-To build world and kernel, use the following instructions:
-.Bd -literal -offset indent
-cd /usr/src
-fetch http://leaf.dragonflybsd.org/~swildner/world_clang.diff
-patch -p1 <world_clang.diff
-env WORLD_CCVER=clang make -DNO_GCC47 buildworld
-env WORLD_CCVER=clang make buildkernel KERNCONF=MYCONF
-.Ed
-.Pp
 Currently, defaults are provided for
 .Nm clang
 (installed from
@@ -117,7 +103,7 @@ compilers are selected by setting the
 variable.
 The
 .Pa cpp ,
-.Pa cc
+.Pa cc ,
 etc\&. programs in
 .Pa /usr/bin
 are actually links to the
@@ -155,6 +141,18 @@ script.
 .It Pa /etc/compilers.conf
 external compiler configuration file
 .El
+.Sh EXAMPLES
+Once configured the compiler can be used like this:
+.Bd -literal -offset indent
+env CCVER=clang make
+.Ed
+.Pp
+To try building world and kernel, use:
+.Bd -literal -offset indent
+cd /usr/src
+env WORLD_CCVER=<version> make -DNO_GCC47 buildworld
+env WORLD_CCVER=<version> make buildkernel KERNCONF=MYCONF
+.Ed
 .Sh SEE ALSO
 .Xr objformat 1 ,
 .Xr build 7