home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
u
/
usrlst04.zip
/
USERS.DOC
< prev
next >
Wrap
Text File
|
1990-04-12
|
5KB
|
115 lines
- 1 -
User Lister v0.4 - Documentation
--------------------------------
(C)Copyright 1990 - by Joe Farrell
Legal Information
=================
As you may have heard before, this is the legal garbage you should know in
order to run this program. I guarantee absolutely nothing out of this user
lister program except that it will occupy disk space. I cannot be held re-
sponsible if it burns down your house. Please keep in mind this software is
absolutely FREE, no charge, and it's not "Public Domain". If you find it of
value, GOOD! I'm not asking for any registration fees of any sort, but if you
feel your conscience bothering you, you can send a small donation to me at the
address at the end of this documentation.
Introduction
============
User Lister was created due to the fact that most other user listing
utilities written for Telegard were not quite perfect, and they didn't have
most of the options many SysOps wanted. User lister is quite the opposite of
most utilities written today, it's fast, small, and very easy to use. You
have many options towards what you would like listed.
Usage
=====
To execute User Lister, you may simply type "USERS" (without the quotes) and
it will show a listing of options. Here is a detailed description of them:
C:\> Users [Real names, City and State] File1.Asc File2.Ans
Real names, City and State - Here you may specify either a 0, 1, 2 or 3:
- If you specify a 0, neither Real names nor City and State will be
included.
- If you specify a 1, only Real names will be included.
- If you specify a 2, only City and State will be included
- If you specify a 3, both Real Names, City and State will be included.
File1.Asc - Name of ASCII file to be created.
File2.Ans - Name of ANSI file to be created.
Note: Handles will always be included. You must also specify one of the above
number for each parameter; there are no default values.
IMPORTANT: Also, you need not specify a path for the file to be written; it
will automatically place it in your afiles directory according to what was
read from the Status.Dat file.
- 2 -
Examples
========
C:\> Users 3 0 bullet9.msg
Create a bulletin with Real names, Non-ANSI, and write it to the file
"bullet9.msg".
C:\> Users 1 1 bullet11.ans
Create a bulletin with only Real name, ANSI included, and write it to the
file "bullet11.msg".
New Features and Bug-Fixes
==========================
Previously (in v0.1 and v0.2), User Lister only created one file at a time,
first Ascii (the non-Ansi bulletin), then you would have to re-enter another
command line to output an Ansi bulletin also. Well, that is obviously fixed
in this version. Also, a few bugs were fixed, and things were cleaned up a
little. (Read in the "Technical Information" section for details on bug-
fixes.) In this version, you can also re-direct the output of the status of
file creation via Gateway. (If you don't understand this, don't worry! It's
not any big thing.)
Technical Information
=====================
User Lister was written in Turbo C, and I used the TGREC.H header file for
all file structures. It originally started as a program to only write user
names, but I decided to make it support real names, city and state. In pre-
vious versions, there was a "Fix" parameter that you could specify at the end
of the command line that would apparently correct the "null" output of the
Ansi bulletin. Well, that turned out to be a bug where I used the strcpy()
function improperly. I just couldn't understand why it would sometimes put
those STUPID messages saying "Now writing Ansi Bulletin: (null) ..." -- I
hated that!
Credit
======
I'd like to thank Art Solomon of the Mobius Building BBS for allowing me to
test all my software on his BBS. I'd also like to thank the Telegard
Development Team for creating such a perfect BBS software, and for also giving
me a chance to write some utilities that I find worthwhile!
In closing, I found User Lister to be a great program, and I hope you will.
You can look for updates with upcoming versions. If you have any questions,
contact me at The Mobius Building BBS (313) 781-0871, or call me voice (313)
752-5264. You may also write to me: Joe Farrell
11715 31 Mile Rd.
Romeo, Mich
48065
Thanks for trying User Lister!