bslathi19/cc65
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Replaced the text files by SGML files

Browse Source 
git-svn-id: svn://svn.cc65.org/cc65/trunk@206 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
cuz
2000-07-27 18:57:12 +00:00
parent f97869b106
commit 51a09ddf37
2 changed files with 820 additions and 634 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
doc/ar65.txt → doc/ar65.sgml
View File

@@ -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 <!-- Begin the document -->
(uz@musoftware.de)
<sect>Overview
<p>
Contents
--------
1. Overview
2. Usage
3. Bugs/Feedback
4. Copyright
1. Overview
-----------
ar65 is a replacement for the libr65 archiver that was part of the cc65 C 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 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, 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 so I decided to write a completely new assembler/linker/archiver suite
for the cc65 compiler. ar65 is part of this suite. for the cc65 compiler. ar65 is part of this suite.
<sect>Usage
<p>
2. Usage
--------
The archiver is called as follows: The archiver is called as follows:
Usage: ar65 <operation> lib file|module ... <tscreen><verb>
Operation is one of: Usage: ar65 <operation> lib file|module ...
a Add modules Operation is one of:
d Delete modules a Add modules
l List library contents d Delete modules
x Extract modules l List library contents
X Print the archiver version x Extract modules
X 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 `a' command. If the library
does not exist, it is created (and a warning message is printed which you 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: Here's an example:
<tscreen><verb>
ar65 a mysubs.lib sub1.o sub2.o ar65 a mysubs.lib sub1.o sub2.o
</verb></tscreen>
This will add two modules to the library `mysubs.lib' creating the This will add two modules to the library `mysubs.lib' creating the
library if necessary. If the library contains modules named sub1.o or 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 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 a mysubs.lib ofiles/sub1.o ofiles/sub2.o
</verb></tscreen>
will add two modules named `sub1.o' and `sub2.o' to the library. 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 Deleting modules from a library is done with the `d' command. You may not
give a path when naming the modules. give a path when naming the modules.
Example: Example:
<tscreen><verb>
ar65 d mysubs.lib sub1.o ar65 d mysubs.lib sub1.o
</verb></tscreen>
This will delete the module named `sub1.o' from the library, printing an This will delete the module named `sub1.o' from the library, printing an
error if the library does not contain that module. error if the library does not contain that module.
@@ -87,7 +84,9 @@ names on the command line are ignored.
Example: Example:
<tscreen><verb>
ar65 l mysubs.lib ar65 l mysubs.lib
</verb></tscreen>
Using the `x' command, you may extract modules from the library. The 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: Example for extracting a module from the library:
<tscreen><verb>
ar65 x mysubs.lib sub1.o ar65 x mysubs.lib sub1.o
</verb></tscreen>
The `V' command prints the version number of the assembler. If you send 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). 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 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're doing something interesting with it, I would be glad to hear from
you. Feel free to contact me by email (uz@musoftware.de). 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. ar65 (and all cc65 binutils) are (C) Copyright 1998 Ullrich von Bassewitz.
For usage of the binaries and/or sources the following conditions do For usage of the binaries and/or sources the following conditions do
apply: 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 including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions: freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not <enum>
claim that you wrote the original software. If you use this software <item> The origin of this software must not be misrepresented; you must not
in a product, an acknowledgment in the product documentation would be claim that you wrote the original software. If you use this software
appreciated but is not required. in a product, an acknowledgment in the product documentation would be
2. Altered source versions must be plainly marked as such, and must not appreciated but is not required.
be misrepresented as being the original software. <item> Altered source versions must be plainly marked as such, and must not
3. This notice may not be removed or altered from any source be misrepresented as being the original software.
distribution. <item> This notice may not be removed or altered from any source
distribution.
</enum>
</article>

1356
doc/ca65.txt → doc/ca65.sgml
View File

File diff suppressed because it is too large Load Diff