Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml	19 Apr 2003 20:42:15 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml	13 May 2003 12:45:37 -0000	1.1.2.4
@@ -16,7 +16,8 @@
       <computeroutput>index</computeroutput>, so we'll build that
       first, starting with the tcl file:
 </para>
-      <screen>[service0@yourserver samplenote]$<userinput> cd /web/service0/packages/samplenote/www</userinput>
+      <screen>[service0@yourserver samplenote]$<userinput> mkdir /web/service0/packages/samplenote/www</userinput>
+[service0@yourserver samplenote]$<userinput> cd /web/service0/packages/samplenote/www</userinput>
 [service0@yourserver www]$ <userinput>emacs index.tcl</userinput></screen>
       <para>Paste this into the file.</para>      
       <programlisting>ad_page_contract {
@@ -127,7 +128,7 @@
 &lt;p&gt;&lt;a href="note-edit"&gt;Add a note&lt;/a&gt;&lt;/p&gt;</programlisting>
     </sect2>
     <sect2>
-      <title>Add files to APM</title>
+      <title>Making the APM load your files</title>
       <para>Before we can test these files, we have to notify the
       package manager that they exist.  (More precisely, the tcl and
       adp will work fine as-is, but the xql file will not be
@@ -140,22 +141,28 @@
         <listitem><para>Click <computeroutput>Manage file information</computeroutput></para>
         </listitem>
         <listitem>
-          <para>Click <computeroutput>Scan the packages/samplenote directory for additional files in thispackage </computeroutput></para>
+          <para>
+            Check the values in the file type column for your files. A
+            question mark means the APM doesn't recognize the file
+            type and probably means you have mistyped a filename.
+          </para>
         </listitem>
-        <listitem><para>Click <computeroutput>add checked files</computeroutput></para>
+
+        <listitem>
+          <para>
+            At the bottom of the file list page - click on the
+            <computeroutput>watch all files</computeroutput> link.
+            Unlike adp and tcl pages, xql pages get cached.  (And new
+            xql files don't get loaded when they're watched or the
+            server is restarted.)  Watching an xql file causes the APM
+            to load the contents of the XQL into memory so that it can
+            be used, and to reload it whenever the file is changed.
+            The watch will last until the server is restarted.
+          </para>
         </listitem>
-        <listitem><para>On the list of files, on the
-        <computeroutput>index.xql</computeroutput> line, click
-        <computeroutput>watch</computeroutput>.  Unlike adp and tcl
-        pages, xql pages get cached.  (And new xql files don't get
-        loaded when they're added.)  Watching an xql file causes the APM
-        to load the contents of the XQL into memory so that it can be
-        used, and to reload it whenever the file is changed.  The
-        watch will last until the server is restarted.</para>
-        </listitem>
 
       </itemizedlist>
-      <para>Now that the pages are in the APM, check to make sure that the self-documenting code is working.</para>
+      <para>Now that the APM is aware of your files, check to make sure that the self-documenting code is working.</para>
       <itemizedlist>
         <listitem><para>Browse to <computeroutput>http://yourserver.test:8000/api-doc/</computeroutput></para>
         </listitem>