Dec 192017
 
Keeps track of your libraries, documents your .OBJ files.
File LIBTOOL.ZIP from The Programmer’s Corner in
Category C Source Code
Keeps track of your libraries, documents your .OBJ files.
File Name File Size Zip Size Zip Type
LIBTOOL.DOC 33144 7208 deflated
LIBTOOL.EXE 47284 24887 deflated

Download File LIBTOOL.ZIP Here

Contents of the LIBTOOL.DOC file





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool



TABLE OF CONTENTS

License 1
Program name 1
Copyright 1
Conditions of use 1
Registration 1
Copying 2
Fees and compensation 2
Distribution 3
Renting and leasing 3
Use as a sales aid 3
Program modifications 3
Program changes 4
Revocation of license 4
Disclaimer of Warranty 4
Limitation of liability 4
Governing Law 4
Introduction 5
Documentation Assumptions 5
System Requirements 6
Video Constraints 6
Getting Started 6
Program Defaults 7
Command Line Switches 7
Description of Command Line Switches 7
b 7
l .ext 7
o .ext 8
p size 8
s 8
B 8
L name 9
O name 9
? 9
Command Keys 9
Esc 9
Left and Right Arrow 10
Up and Down Arrow 10
Home 10
End 10
PgUp and PgDn 10
Enter 10
Key corresponding to a menu item's first letter 10
Operation of the Mouse 11
Operation of Mouse Buttons 11
Left Button with Mouse Cursor not Visible 11
Right Button with Mouse Cursor not Visible 11
Both Buttons with Cursor not Visible 11
Left Button with Mouse Cursor Visible 11
Right Button with Mouse Cursor Visible 11
Operation of Libtool 12
Commands 13



i





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Replace an existing module 13
Move an object module to another library 13
List library contents on the SCREEN 13
Print library contents on the PRINTER 13
Add a new object module 13
Delete an object module 13
Extract an object module 13
Select a library 13
Create a new library 14
Delete a library 14
Name change for a library module 14
Quit 14













































ii





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool



SINGLE COPY COMPUTER SOFTWARE LICENSE


THIS DOCUMENT IS A SINGLE COMPUTER SOFTWARE LICENSE
granted by Zaxis with a mailing address of:

Zaxis
202 Pebble Creek Road
Summerville, SC. 29483.


Program name

This license describes the terms and conditions of use
for the computer program called LIBTOOL.


Copyright

LIBTOOL and any associated documentation is copyrighted
material. Violation of the copyright voids the terms of
this license and revokes the privileges granted under this
license. LIBTOOL was developed for Zaxis by the copyright
owner and author, Russell D. Mitterling.


Conditions of use

You are granted a limited license to use LIBTOOL
pursuant to the terms and conditions described below.
LIBTOOL is distributed under the user supported marketing
concept. LIBTOOL is not free software and the author
retains full rights to the software. You may use LIBTOOL on
a trial basis for a period not to exceed thirty (30) days.
After the thirty day trial period, you must register LIBTOOL
OR you must destroy your orginal copy of LIBTOOL, any other
copies of LIBTOOL you may have made and any associated
materials. LIBTOOL may not be used for any governmental,
institutional, or commercial purpose without registration.


Registration

LIBTOOL may be registered by sending thirty dollars
($30.00) in US funds to Zaxis at the address listed above.
Include your name or organization name, address and
telephone number of yourself or your organization's
representative. If you are registering on behalf of an
organization, include the name and title of the
organization's representative who is responsible for
LIBTOOL.





1





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Copying

You are granted a limited license to copy LIBTOOL for
the trial use of others subject to the terms and conditions
of this license and also subject to the following
conditions:

1.LIBTOOL must be copied in unmodified form.
2.The copy must include the following files:

LIBTOOL.EXE
LIBTOOL.DOC

3.The terms of this license do not prohibit the
use of archival programs on the LIBTOOL files.
4.The terms of this license should not be construed in
a manner that violates U.S. copyright laws.

Fees and compensation

No fee, charge or other compensation may be accepted or
requested, either directly or indirectly, unless expressly
permitted by this license or unless express written
permission is obtained from Zaxis.

































2





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Distribution


1.Distributors of public domain and user supported
software, such as disk vending services, may
distribute copies of LIBTOOL subject to the
conditions of this license only after obtaining
a written license from Zaxis.

2.Operators of electronic bulletin board systems
may post LIBTOOL for downloading by their users
without a written license if the user is not
charged a fee for downloading LIBTOOL. A fee to
access the bulletin board is not considered a
fee for downloading under the terms of this
license.

3.Clubs may distribute LIBTOOL and may charge a
nominal fee, not to exceed ten dollars ($10.00)
in US funds, for their distribution and
preparation services.

4.Unless expressly permitted by the terms of this
license, LIBTOOL may not be distributed in
conjunction with any other product or service
without obtaining a written license from Zaxis.

5.LIBTOOL may not be sold without obtaining a
written license from Zaxis.


Renting and leasing

LIBTOOL may not be rented or leased to others.


Use as a sales aid

LIBTOOL may not be used as a sales aid without
obtaining a written license from Zaxis.


Program modifications

Modifications to LIBTOOL by persons other than the
author or those authorized in writing by Zaxis is strictly
prohibited. You may NOT modify, patch, hack, disassemble,
or otherwise alter or reverse engineer LIBTOOL.
Distribution of computer programs and/or instructions that
will cause the modification of LIBTOOL is prohibited.
Distribution of LIBTOOL without copyright notices or
complete copies of the documentation included with LIBTOOL
is an unauthorized modification.




3





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Program changes

Zaxis may make improvements and/or changes in LIBTOOL
and/or associated materials at any time and without prior
notice.


Revocation of license

Any violation of the terms of this license or the use
of LIBTOOL for illegal purposes immediately voids and
revokes this license.


Disclaimer of Warranty

LIBTOOL AND ASSOCIATED MATERIALS ARE PROVIDED AS IS AND
WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES.


ANY IMPLIED WARRANTIES, INCLUDING ANY WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE
DISCLAIMED.


IN NO EVENT SHALL ZAXIS BE LIABLE FOR LOSS OF PROFIT OR
ANY OTHER COMMERCIAL DAMAGE; INCLUDING, BUT NOT LIMITED TO,
SPECIAL,INCIDENTAL,CONSEQUENTIAL, INDIRECT OR OTHER SIMILAR
DAMAGES. Some states do not allow the exclusion or
limitation of incidental or consequental damages, so the
above limitation or exclusion may not apply to you.


Limitation of liability

In no case shall Zaxis' liability exceed the license
fee or ten dollars ($10.00) in US funds, whichever is
greater. In no case shall Zaxis be liable for any damages
resulting from the illegal use of LIBTOOL.


Governing Law

This documentation shall be construed, interpreted and
governed by the laws of the state of South Carolina.












4





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool



LIBTOOL


Introduction to Libtool


The design objective of Libtool is to enhance the use
of a librarian. Libtool meets the design objective by
providing the following services:

1.Single command processing of multiple step
procedures.
2.Command line and/or menu interfaces to
the librarian.
3.Substitute for batch file processing.
4.Integration of computer resources to increase
the utility of library processing.
5.Mouse control of menus.


When Libtool first starts, it shows the library file
selection menu, a command selection menu, a directory
information window, and a prompt to select a library if a
library file name was not specified on the command line.
Selections from the various menus are made via the cursor
control keys or the mouse. When Libtool displays more than
one menu, it highlights the frame of the active window.
Movement between windows is controlled by cursor control
keys or by the mouse. Selection of a command then actives
additional menus and information windows as needed by the
specific command. Commands are performed on the last
library file selected unless the command requires more than
one library file or is the "Select a library" command.


Documentation Assumptions


This document assumes that you are familiar with the
operation of your computer and with the operation of DOS.
Therefore, standard procedures such as copying files,
setting environment variables, booting the computer, etc.
are not described in detail. If you are unfamiliar with any
of these procedures, consult one of the many excellent texts
on DOS and computer operations.











5





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


System Requirements

1.IBM compatible computer running DOS 2.0 or higher.
2.256KB of memory.
3.Microsoft's or Borland's librarian program.
4.Mouse and printer are optional.


Video Constraints


Libtool uses direct screen writing routines to
eliminate sluggish response in the window system. Libtool
currently supports CGA and MDA compatible video adapters.


Getting Started


Libtool can operate from any directory; but, it must be
able to find the librarian program and the directories that
contain your library files and your object modules. If the
librarian program is not in the current directory, then the
environment PATH variable must be set to point to the
directory that contains the librarian.


Libtool searches for library files and object modules
based on the following precedence:

1.Directories specified by command line switches.
2.Directories specified by the LIB and OBJ environment
variables.
3.Current directory.

The directories specified by the LIB and OBJ
environment variables must end with a \. For example, if
your object modules are in the C:\C\OBJ directory then the
OBJ environment variable should look like:

OBJ=C:\C\OBJ\


The first step in getting started is to copy
Libtool.exe to any desired drive and directory. Then copy a
librarian program to the same directory OR set the PATH
environment variable to point to the directory that contains
the librarian. Then, as an option, set the LIB and OBJ
environment variables to the appropriate directories.
Libtool is now ready to run; but, you should look over the
command line switch set first.






6





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Program Defaults


Libtool contains several internal defaults which can be
modified by command line switches. These defaults are:

1.Librarian :Microsoft's lib.exe
2.Library file default extension :.lib
3.Object module default extension :.obj
4.Video snow checks :Off
5.Page size variable :16 bytes
6.Auto deletion of backup library :On


Command Line Switches


The operation of Libtool can be modified by several
command line switches which are described below. All of the
command line switches are optional. A command line switch
is a single alphanumeric character preceded by either a - or
a / and optionally followed by a parameter. If a switch
requires a parameter, the parameter can be separated from
the switch by tabs or spaces. The switch character is case
sensitive. Each line in the following examples demonstrates
alternate methods of specifying switches:

-b /b
-Lc:\c\ -L c:\c\ /L c:\c\



Description of Command Line Switches


b

This switch suppress the automatic deletion of the
backup library file. It only affects the operation of the
Microsoft librarian since the Borland librarian does not
generate backup files.


l .ext

This switch sets the default library extension to .ext.
Libtool uses the default library extension to identify
library files that it uses to generate the library file
menu. The internal program default is set to .lib. If your
library files have a different extension, use this switch to
change the default library extension to the extension on
your library files. Example:

-l .lbr



7





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


o .ext

This switch sets the default extension for object
modules to .ext. You can override this extension for any
Libtool command requiring a user supplied file name by
specifying the name and extension.


p size

This switch is specific to the Microsoft librarian and
has no effect for the Borland librarian. The switch is used
to set the page size the librarian uses. The range of
values is 16 to 32768 bytes. Any size parameter that is not
a multiple of 16 bytes is converted to the highest multiple
of 16 bytes that does not exceed the size parameter. The
internal setting for the page size variable is 16 bytes.
Consult Microsoft's librarian documentation for more
information on the page size variable.


s

This switch turns on the video snow checks in case your
video adapter produces snow on the video screen.


B

This switch forces Libtool to use the Borland
librarian.


























8





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


L name

This switch is used to specify a library file name
AND/OR the name of the directory that contains the library
files. Libtool parses the name parameter and splits it into
file name and directory name parts. If Libtool finds a file
name in the name parameter, Libtool uses that file name as
the library file for command processing and the opening
screen bypasses the library selection menu. If name is a
directory name or a file name that contains a directory
name, Libtool uses the specified directory name to search
for library files. Some examples follow:

-L \c\ Libtool searches the \c\ directory for
library files.
-L \c\test.lib Libtool searches the \c\ directory for
library files and bypasses the library
selection menu. Test.lib is the library
file Libtool would use for command
processing.
-L test.lib Libtool searches the directory specified
in the LIB environment variable or the
current directory if LIB is not
specified. Test.lib is the library file
for command processing.


O name

This switch performs similar actions as the the L
switch except the results apply to object module names.


?

This switch shows a screen briefly describing Libtool
and the functions of the switches.


Command Keys


Esc

The Esc key will abort the current operation. The Esc
key will return you to DOS if it is pressed while you are in
the library selection menu or the command selection menu.










9





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Left and Right Arrow

These two keys will change the active menu selection
window. The cursor bar in the current window will move as
necessary to indicate the action of these keys. For
instance, if you press one of these keys while the command
selection menu is the active menu and the library selection
menu is also shown on the screen, the library selection menu
becomes the active menu and the command selection cursor bar
moves to the "Select a library" menu item.


Up and Down Arrow

These key move the menu selection bar up or down. If
the selection bar is at the top or bottom of the window,
these keys cause the information displayed in the window to
scroll by one item or cause the selection bar to jump to the
bottom or top of the window.


Home

This key places the selection bar on the first item in
a list of items.


End

This key places the selection bar on the last item in a
list of items.


PgUp and PgDn

These keys scroll information in the windows if the
list of items is longer than the window. Otherwise, they
have no effect.


Enter

This key selects a menu item under the selection bar.


Key corresponding to a menu item's first letter

The corresponding key selects the associated menu item.









10





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Operation of the Mouse


Libtool menus can also be controlled by the mouse.
Libtool currently supports a two button mouse. Movement of
the mouse up or down moves the selection bar.


The mouse button actions that are described below are
position dependant. The buttons perform different actions
depending on whether the mouse cursor is on the left or
right window frame or in the middle of the window.


The mouse cursor is not shown unless the mouse is moved
in the left or right direction so that the cursor is placed
on the left or right window frame. The mouse cursor then
becomes visible to indicate that the mouse buttons have
changed function.


Operation of Mouse Buttons


Left Button with Mouse Cursor not Visible

Changes active window


Right Button with Mouse Cursor not Visible

Selects item highlighted by selection bar


Both Buttons with Cursor not Visible

Libtool performs the Esc key function.


Left Button with Mouse Cursor Visible

If the mouse cursor is on the left frame, Libtool
executes the Home key function. If the mouse cursor is on
the right frame, Libtool executes the PgUp key function.


Right Button with Mouse Cursor Visible

Libtool executes the End key function if the cursor is
on the left frame and the PgDn key function if the cursor is
on the right frame.






11





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Operation of Libtool


After Libtool initializes variables and sorts the
directory lists, it shows a screen consisting of a library
selection menu, a command selection menu, and a directory
information window. If a library file name has not been
supplied on the command line, Libtool also shows a prompt to
select a library name.


Libtool windows are surrounded by a double line border.
When Libtool shows more than one menu window, Libtool
highlights the border of the active menu window. The
selection bar indicates the position of the menu cursor in
the list of menu items. A selection from the menu is made
by pressing Enter or clicking the appropriate mouse button
after moving the selection bar to the desired item.
Pressing the key corresponding to the first letter of the
menu item is equivalent to moving the selection bar to that
item and pressing Enter.


The library selection menu and the object module
selection menu both have a Commands menu item which is not
associated with a file. Selection of the Commands item
returns you to the command selection menu. The object
module selection menu has an additional special item
labelled Manual. Selection of this item causes Libtool to
prompt you for a object module name you enter from the
keyboard.


Libtool makes the library selection menu active at
startup unless a library file name was specified on the
command line. The directory information window does not
display information until a library name has been specified.


The library selection menu and object module selection
menu windows are designed to display a reasonable amount of
information. If the number of files exceeds the window
display capacity, the file list is scrolled in the window by
the command keys or by the mouse.













12





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Commands


Replace an existing module

This command is used to update a module in a library.
Wildcards are allowed in object module names specified on
the command line or by the Manual item in the object module
selection menu.


Move an object module to another library

This command requires several steps to execute.
Libtool prompts for two library names and an object module
name. Libtool must call the librarian twice to complete
this command. This command has an option to reuse the
previously selected library files.


List library contents on the SCREEN

Print library contents on the PRINTER

These two commands show the contents of a library file.


Add a new object module

This command adds an object module to a library file.
Wildcards are allowed in object module names specified on
the command line or by the Manual item in the object module
selection menu.


Delete an object module

This command deletes an object module from a library
file but does NOT delete an object module from the object
module directory.


Extract an object module

This command removes an object module from a library
file and places it in the object module directory. If an
object module with the same name exists in the object module
directory, you are given the opportunity to abort this
command.


Select a library

This command activates the library selection menu.



13





Copyright Russell D. Mitterling 1988 All Rights Reserved Libtool


Create a new library

This command creates a new library file and expects
that the new library file will contain at least one object
module.


Delete a library

This command deletes a library file.


Name change for a library module

This command renames a module in a library file. If an
object module with the original name exists in the object
module directory, you are given the opportunity to rename
the external object module.


Quit

This command causes Libtool to quit.







Microsoft is a registered trademark of Microsoft
Corporation.
IBM is a registered trademark of International
Business Machines Corporation.




Zaxis
202 Pebble Creek Road
Summerville, SC 29483
















14




 December 19, 2017  Add comments

Leave a Reply