Replaced the text files by SGML files

git-svn-id: svn://svn.cc65.org/cc65/trunk@206 b7a2c559-68d2-44c3-8de9-860c34a00d81

doc/ar65.sgml

@@ -1,51 +1,43 @@
+<!doctype linuxdoc system>
 
+<article>
 
-				   ar65
+<title>ar65 Users Guide
+<author>Ullrich von Bassewitz, <tt/uz@musoftware.de/
+<date>
+<abstract>ar65 is an archiver for object files generated by ca65. It allows
+to create archives, add or remove modules from archives, and to extract modules
+from existing archives.
+</abstract>
 
-       	      An Archiver for Object Files Generated by ca65
+<!-- Table of contents -->
+<toc>
 
-	       (C) Copyright 1998-1999 Ullrich von Bassewitz
-			    (uz@musoftware.de)
+<!-- Begin the document -->
 
+<sect>Overview
 
-
-Contents
---------
-
-  1. Overview
-
-  2. Usage
-
-  3. Bugs/Feedback
-
-  4. Copyright
-
-
-
-1. Overview
------------
-
+<p>
 ar65 is a replacement for the libr65 archiver that was part of the cc65 C
 compiler suite developed by John R. Dunning. libr65 had some problems and
 the copyright does not permit some things which I wanted to be possible,
 so I decided to write a completely new assembler/linker/archiver suite
 for the cc65 compiler. ar65 is part of this suite.
 
+<sect>Usage
 
-
-2. Usage
---------
-
+<p>
 The archiver is called as follows:
 
-	Usage: ar65 <operation> lib file|module ...
-	Operation is one of:
-		a	Add modules
-		d	Delete modules
-		l	List library contents
-		x	Extract modules
-		X	Print the archiver version
-
+<tscreen><verb>
+   	Usage: ar65 <operation> lib file|module ...
+   	Operation is one of:
+   	       	a	Add modules
+   	       	d	Delete modules
+   	       	l	List library contents
+   	       	x	Extract modules
+   	       	X	Print the archiver version
+</verb></tscreen>
 
 You may add modules to a library using the `a' command. If the library
 does not exist, it is created (and a warning message is printed which you
@@ -58,7 +50,9 @@ has a newer timestamp than the one to add.
 
 Here's an example:
 
+<tscreen><verb>
 	ar65 a mysubs.lib sub1.o sub2.o
+</verb></tscreen>
 
 This will add two modules to the library `mysubs.lib' creating the
 library if necessary. If the library contains modules named sub1.o or
@@ -66,17 +60,20 @@ sub2.o, they are replaced by the new ones.
 
 Modules names in the library are stored without the path, so, using
 
+<tscreen><verb>
 	ar65 a mysubs.lib ofiles/sub1.o ofiles/sub2.o
+</verb></tscreen>
 
 will add two modules named `sub1.o' and `sub2.o' to the library.
 
-
 Deleting modules from a library is done with the `d' command. You may not
 give a path when naming the modules.
 
 Example:
 
+<tscreen><verb>
 	ar65 d mysubs.lib sub1.o
+</verb></tscreen>
 
 This will delete the module named `sub1.o' from the library, printing an
 error if the library does not contain that module.
@@ -87,7 +84,9 @@ names on the command line are ignored.
 
 Example:
 
+<tscreen><verb>
 	ar65 l mysubs.lib
+</verb></tscreen>
 
 
 Using the `x' command, you may extract modules from the library. The
@@ -102,7 +101,9 @@ this is not a problem.
 
 Example for extracting a module from the library:
 
+<tscreen><verb>
 	ar65 x mysubs.lib sub1.o
+</verb></tscreen>
 
 
 The `V' command prints the version number of the assembler. If you send
@@ -114,19 +115,18 @@ operation does update the library. This is only a warning, the linker
 will ignore one of the duplicate symbols (which one is unspecified).
 
 
+<sect>Bugs/Feedback
 
-3. Bugs/Feedback
-----------------
-
+<p>
 If you have problems using the archiver, if you find any bugs, or if
 you're doing something interesting with it, I would be glad to hear from
 you. Feel free to contact me by email (uz@musoftware.de).
 
 
 
-4. Copyright
-------------
+<sect>Copyright
 
+<p>
 ar65 (and all cc65 binutils) are (C) Copyright 1998 Ullrich von Bassewitz.
 For usage of the binaries and/or sources the following conditions do
 apply:
@@ -139,14 +139,18 @@ Permission is granted to anyone to use this software for any purpose,
 including commercial applications, and to alter it and redistribute it
 freely, subject to the following restrictions:
 
-1. The origin of this software must not be misrepresented; you must not
-   claim that you wrote the original software. If you use this software
-   in a product, an acknowledgment in the product documentation would be
-   appreciated but is not required.
-2. Altered source versions must be plainly marked as such, and must not
-   be misrepresented as being the original software.
-3. This notice may not be removed or altered from any source
-   distribution.
+<enum>
+<item>	The origin of this software must not be misrepresented; you must not
+	claim that you wrote the original software. If you use this software
+	in a product, an acknowledgment in the product documentation would be
+	appreciated but is not required.
+<item>	Altered source versions must be plainly marked as such, and must not
+	be misrepresented as being the original software.
+<item>	This notice may not be removed or altered from any source
+	distribution.
+</enum>
+
+</article>