Support for "virtual operands" of subroutines like this:

[cc65] / doc / ar65.sgml

diff --git a/doc/ar65.sgml b/doc/ar65.sgml
index d35bc9987c1c272fbf4f33e3fda84079f87f91e9..2e01025cac05d985ea9d16c248bbe0f0137d3be2 100644 (file)
--- a/doc/ar65.sgml
+++ b/doc/ar65.sgml
@@ -3,8 +3,8 @@
 <article>
 
 <title>ar65 Users Guide
-<author>Ullrich von Bassewitz, <htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">
-<date>19.07.2000
+<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
@@ -32,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
-                       V       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.
@@ -53,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
@@ -63,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.
@@ -81,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>