Support for preprocessing info file via cpp or m4.

[cc65] / doc / ar65.sgml

diff --git a/doc/ar65.sgml b/doc/ar65.sgml
index 18afb9951e43ff136b309d779853bb7ea6a90de3..2e01025cac05d985ea9d16c248bbe0f0137d3be2 100644 (file)
--- a/doc/ar65.sgml
+++ b/doc/ar65.sgml
@@ -3,11 +3,13 @@
 <article>
 
 <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.
+<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
+<date>2017-05-28
+
+<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>
 
 <!-- Table of contents -->
@@ -30,16 +32,17 @@ for the cc65 compiler. ar65 is part of this suite.
 The archiver is called as follows:
 
 <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
+       Usage: ar65 <operation ...> lib file|module ...
+       Operations are some of:
+               r       Add modules
+               d       Delete modules
+               t       List library table
+               v       Increase verbosity (put before other operation)
+               x       Extract modules
+               V       Print the archiver version
 </verb></tscreen>
 
-You may add modules to a library using the `a' command. If the library
+You may add modules to a library using the `r' command (`a' is deprecated). If the library
 does not exist, it is created (and a warning message is printed which you
 may ignore if creation of the library was your intention). You may
 specify any number of modules on the command line following the library.
@@ -51,7 +54,7 @@ has a newer timestamp than the one to add.
 Here's an example:
 
 <tscreen><verb>
-       ar65 a mysubs.lib sub1.o sub2.o
+       ar65 r mysubs.lib sub1.o sub2.o
 </verb></tscreen>
 
 This will add two modules to the library `mysubs.lib' creating the
@@ -61,10 +64,10 @@ 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
+       ar65 v v r mysubs.lib ofiles/sub1.o ofiles/sub2.o
 </verb></tscreen>
 
-will add two modules named `sub1.o' and `sub2.o' to the library.
+will verbose 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.
@@ -79,13 +82,13 @@ This will delete the module named `sub1.o' from the library, printing an
 error if the library does not contain that module.
 
 
-The `l' command prints a list of all modules in the library. Any module
-names on the command line are ignored.
+The `t' command prints a table of all modules in the library (`l' is deprecated).
+Any module names on the command line are ignored.
 
 Example:
 
 <tscreen><verb>
-       ar65 l mysubs.lib
+       ar65 tv mysubs.lib
 </verb></tscreen>
 
 
@@ -115,19 +118,11 @@ 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<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 (<htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">).
-
-
-
 <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:
+ar65 (and all cc65 binutils) are (C) Copyright 1998-2000 Ullrich von
+Bassewitz. For usage of the binaries and/or sources the following conditions
+do apply:
 
 This software is provided 'as-is', without any expressed or implied
 warranty.  In no event will the authors be held liable for any damages