- docbook/xmldocs.css: minimal CSS adjustment

- refs/*: about 20 tags added

- glossary/*: placeholders

docbook/xmldocs.css

@@ -253,7 +253,7 @@ a:hover { text-decoration: underline; }
 .screen {
 	margin-top: 0;
 	padding: 4px 4px 4px 4px;
-	border-left: dashed 1px #ffd1d1;
+	border-left: dashed 1px #ff8300; /*#ffd1d1;*/
 	padding-left: 8px;
 }
 

refs/backup-file.tag

@@ -0,0 +1,68 @@
+__NAME__ purpose
+backup Interchange file
+__END__
+
+__NAME__ synopsis 
+<row>
+
+	<entry>
+	file
+	</entry>
+	<entry>
+	Yes
+	</entry>
+	<entry>
+	Yes
+	</entry>
+	<entry>
+	</entry>
+	<entry>
+	File to back-up
+	</entry>
+
+</row> 
+&ROW_INTERPOLATE_0;
+&ROW_REPARSE_1;
+__END__
+
+
+__NAME__ description
+The tag allows backing up of Interchange files.
+Files are simply copied
+to the <filename class='directory'>backup/</filename> subdirectory of
+the catalog root directory (&glos-CATROOT;).
+</para><para>
+File paths are preserved during copy; a target catalog file of say,
+<filename>pages/index.html</filename> would be saved to 
+<filename>backup/pages/index.html</filename>.
+</para><para>
+You can copy filenames specified with absolute paths, and in fact, you
+can backup any file that the &IC; process can read.
+__END__
+
+
+__NAME__ notes
+The backup directory and the full pathname are automatically created
+if they don't already exist.
+__END__
+
+__NAME__ example: Backing-up catalog index page
+<programlisting>
+[either]
+  [tmp name=backup set="[backup-file pages/index.html]" hide=1]
+[or]
+  [scratch ui_error]
+[/either]
+</programlisting>
+__END__
+
+__NAME__ example: Backing-up system password file
+<programlisting>
+[either]
+  [tmp name=backup set="[backup-file /etc/passwd]" hide=1]
+[or]
+  [scratch ui_error]
+[/either]
+</programlisting>
+__END__
+

refs/cp.tag

@@ -1,27 +1,50 @@
+__NAME__ purpose
+copy a file
+__END__
+
 __NAME__ synopsis 
 <row>
 
 	<entry>
-	umask
+	from
 	</entry>
 	<entry>
-	<!-- POS -->
+	Yes
 	</entry>
 	<entry>
-	<!-- REQ -->
+	Yes
+	</entry>
+	<entry>
+	<!-- DFL -->
+	</entry>
+	<entry>
+	Source file to copy.
+	</entry>
+
+</row> 
+<row>
+
+	<entry>
+	to
+	</entry>
+	<entry>
+	Yes
+	</entry>
+	<entry>
+	Yes
 	</entry>
 	<entry>
 	<!-- DFL -->
 	</entry>
 	<entry>
-	<!-- DSC -->
+	Destination directory or file to copy to.
 	</entry>
 
 </row> 
 <row>
 
 	<entry>
-	hide
+	umask
 	</entry>
 	<entry>
 	<!-- POS -->
@@ -30,13 +53,34 @@ __NAME__ synopsis
 	<!-- REQ -->
 	</entry>
 	<entry>
-	<!-- DFL -->
+	Interchange process default
 	</entry>
 	<entry>
-	<!-- DSC -->
+	File &glos-umask;.
 	</entry>
 
 </row> 
+&ROW_HIDE_0;
 &ROW_INTERPOLATE_0;
 &ROW_REPARSE_1;
-__END__
+__END__
+
+
+__NAME__ description
+The tag simply copies source file to the destination.
+__END__
+
+__NAME__ see also
+backup-file,backup-database
+__END__
+
+__NAME__ example: Basic example
+<programlisting>
+[either]
+  [cp from=pages/index.html to=/tmp/ hide=1]
+[or]
+  Copy failed. See error logs for details.
+[/either]
+</programlisting>
+__END__
+