From a35f10b668dbc44b22553b480c9a2b0a51e5bd60 Mon Sep 17 00:00:00 2001
From: Murray Stokely <murray@FreeBSD.org>
Date: Wed, 22 Aug 2001 05:07:12 +0000
Subject: [PATCH] Standardize the synopsis.  (List of what the reader will
 learn by reading this chapter, and another list of what the reader is
 expected to already know.)

---
 .../books/handbook/l10n/chapter.sgml          | 40 +++++++++++++------
 1 file changed, 28 insertions(+), 12 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml b/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml
index 56dc7bf10f..5c33bd97f8 100644
--- a/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml,v 1.66 2001/08/10 22:58:14 chern Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml,v 1.67 2001/08/21 23:44:13 murray Exp $
 -->
 
 <chapter id="l10n">
@@ -28,18 +28,34 @@
   <sect1>
     <title>Synopsis</title>
 
-    <para>This section of the handbook discusses the internationalization
-      and localization of FreeBSD to different countries and different
-      settings.  If the users wish to use languages other than the system
-      default English, he/she will have to setup the system accordingly.
-      Please note that language support for each language varies in level.
-      Hence, the user should contact the respective FreeBSD local group
-      that is responsible for each language.</para>
+    <para>FreeBSD is a very distributed project with users and
+      contributors located all over the world.  This chapter discusses
+      the internationalization and localization features of FreeBSD
+      that allow non-English speaking users to get real work done.
+      There are many aspects of the i18n implementation in both the system
+      and application levels, so where applicable we refer the reader
+      to more specific sources of documentation.</para>
 
-    <para>There are many aspects of I18N implementation in
-      both the system and application levels, so where applicable we
-      refer the reader to individual documentation, man pages,
-      READMEs, and so forth.</para>
+    <para>After reading this chapter you will know:</para>
+    <itemizedlist>
+      <listitem><para>How different languages and locales are encoded
+      on modern operating systems.</para></listitem>
+      <listitem><para>How to set the locale for your login
+      shell.</para></listitem>
+      <listitem><para>How to configure your console for non-English
+      languages.</para></listitem>
+      <listitem><para>How to use X Windows effectively with different
+      languages.</para></listitem>
+      <listitem><para>Where to find more information about writing
+      i18n-compliant applications.</para></listitem>
+   </itemizedlist>
+
+    <para>Before reading this chapter you should:</para>
+
+    <itemizedlist>
+      <listitem><para>Know how to install additional third-party
+        applications (<xref linkend="ports">).</para></listitem>
+    </itemizedlist>
   </sect1>
 
   <sect1>