--- nsdl/README	2002/07/14 07:58:53	1.2
+++ nsdl/README	2002/10/13 06:22:12	1.6
@@ -8,6 +8,14 @@ and vice versa.
 
 More information is in the doc/ directory.
 
+Quick installation instructions
+===============================
+If you are using a tarball, then, as root, execute the UPDATE command:
+./UPDATE.
+
+If you are working directly from the CVS repository, then, as root:
+cd build; make build; make install.
+
 What's new
 ==========
 For a history of this software, you should work through
@@ -26,8 +34,17 @@ make install
 
 Important files
 ===============
-The stylesheets for carrying out the metadata conversion are
-nsdl/lib/stylesheets/*.xsl  .
+To get a good overview on the metadata conversion, I recommend
+you look at the nsdl/prototypes/metadata_convert.pl script
+(perldoc ./metadata_convert.pl).  Among other things, this
+provides a list regarding the crosswalk possibilities of
+LON-CAPA to&from IEEE-LOM and LON-CAPA to&from Dublin Core.
+
+Currenty, the four stylesheets for carrying out the metadata conversion are:
+* nsdl/lib/stylesheets/dcnsdl_to_loncapa.xsl
+* nsdl/lib/stylesheets/lomnsdl_to_loncapa.xsl
+* nsdl/lib/stylesheets/loncapa_to_dcnsdl.xsl
+* nsdl/lib/stylesheets/loncapa_to_lomnsdl.xsl
 
 The Apache web handler modules are defined in the directory:
 nsdl/lib/perl/Apache/  .
@@ -35,8 +52,9 @@ nsdl/lib/perl/Apache/  .
 The Apache configuration file (see below also) is
 nsdl/conf/nsdl.conf  .
 
-The source-to-target is defined by nsdl/build/gatewayfiles.lpml
-(an XML file defines how the software is "rendered" onto the system.
+The source-to-target information is defined by nsdl/build/gatewayfiles.lpml
+(an XML file defines how the software is "rendered" onto the system).
+gatewayfiles.lpml is used in many locations inside nsdl/build/Makefile.
 
 And, there are other files.
 
@@ -73,8 +91,8 @@ Here are some of the remaining issues
                        place more importance on the exhaustive IEEE LOM
                        standard rather than the weaker Dublin Core standard.
                        In the future, to get to Dublin Core, it might make
-                       sense to convert LON-CAPA to IEEE LOM and *then*
-                       go to IEEE LOM metadata standard.
+                       sense to first convert LON-CAPA to IEEE LOM and *then*
+                       go to the Dublin Core metadata standard.
 * ISSUE: Set hierarchies
   PROBLEM: Asking for ListIdentifiers from LON-CAPA will return a really long
            list that represents a "jumbled" repository.  Currently,