STYLELST.EXE

A Style Description Listing Utility

Version 2.0, November 15, 1988

STYLELST is a program that creates a WP5 document containing style file names and their descriptions. You can then print that file in WordPerfect. (There is an option to create a text file; see below.) The file is stored in the same drive/directory as the styles. The names of the styles are sorted alphabetically.

STYLELST normally creates a WP5 document file, with a DOS text printer defined in the document. When you retrieve the document from List Files (or Retrieve), WP5 will convert it to your default printer. There are a few simple formatting codes in the document to help make the columns line up. There's a [Tab Set] code at the beginning to help set up the tabs properly. And one [Indent Left] is used to format the description.

HOW TO RUN THE PROGRAM

STYLELST is run at the DOS prompt by typing in

STYLELST

(We assume that you have STYLELST.EXE available in the current directory, or in a directory specified by the DOS PATH command.)

COMMAND LINE OPTIONS

There are two for STYLELST: TEXT, and HELP.

TEXT	Allows you to create a text file, rather than a WP5 document. If you wish to edit the text file, you'll need to use the Text In/Out command (Ctrl/F5). The default is to create a WP5 document.

HELP	Shows a quick help screen, which describes the program and details the command line options. You are returned to the DOS prompt; the program will not run.

These options can be specified in any order.

HOW IT WORKS

The program was written and compiled in MicroSoft QuickBasic 4.0. It seems to need about 55K. It should catch most errors (files not found, etc.); if you looked at the source code, you'd probably find an example of "IAB-BIW" (it ain't beautiful - but it works).

STYLELST first asks you for the name of the style you wish to analyze. If the file does not exist, you can try again, or quit the program

STYLELST normally creates a WP5 document file, unless you use the TEXT option on the DOS command line. In either case, this is what it looks like:

STYLE FILE DESCRIPTIONS

as of 11-12-1988, 20:13

Style file : MANUAL.STY

STYLE NAME DESCRIPTION

Bibliogrphy Bibliography

Bullet Bullet, with indented block

Chaphead Chapter Heading

Condense Condense on/off pair

Contents Table of Contents

...etc.

There is a limit of 256 styles that STYLELST will analyze in one style file. The SLS file is normally a WP5 document file, use the Retrieve command in WordPerfect to edit it. (If you specified the TEXT command line option, a DOS text file is created. You'll need to use the Text In/Out to retrieve it in a WP5 document.)

VERSION CHANGES:

1.1 (8/12/88): Minor changes to put the version number shows on screen, a bit more error checking, cleaner screens.

1.2 (8/15/88): Due to the way that styles are stored in a file, the program would sometimes miss style names. The program should get all of them now.

Versions 1.x made it into distribution, but was pulled from CIS since the problem in 1.2 was significant.

2.0 (11/12/88): Due to popular request, I changed the program so that it would normally create a WP5 document, rather than a text file. But there is an option to create a text file, just add the word TEXT at the DOS command line:

STYLELST TEXT

(For more information about these options, please see COMMAND LINE OPTIONS, above.)

I also sorted the style names in the list.

I also added a HELP option, just in case. If you specify HELP, a help screen will appear, but the program will return you to the DOS prompt.

STYLEDOC -- TO DOCUMENT STYLE FILE COMMANDS

We're in the process of creating a companion program called STYLEDOC, which will be sent to the WPSG forum on CompuServe when it's ready. It will actually translates the commands in a style file into English, creating a text file for each style file it finds. It's a great way to "hard-copy" your styles.

It will be a shareware program (registration will be $15). We're aiming for the first of December (but you know how product release date promises go!).

MACROLST and MACRODOC

We've also got similar programs for macros. MACROLST creates a file containing a list of all the macro files (and their descriptions) that are in a subdirectory.

MACRODOC creates a documentation file for each macro found in a subdirectory. This file contains the macro codes, similar to how you'll see it in the WP5 Macro Edit command.

MACROLST is a public domain program, free for the asking. MACRODOC is shareware, and costs $15 to register. Both are great to document your macros, and are available on Compuserve's WPSG forum, as MACROL.ARC and MACROD.ARC.

A SPECIAL DEAL

If you want to get registered copies all four programs, (STYLELST, MACROLST, MACRODOC, and STYLEDOC when available), send along a $25 registration fee (that saves $5) and a disk in a mailer. We'll send back the latest versions of those programs, and our thanks.

IF YOU HAVE PROBLEMS

While I tested this program quite a bit, it's possible that you might have problems. Some things to check are that you specify a drive/directory that actually exists, that there's enough room on the disk for the file, and that you don't have too many files in a directory.

This version of STYLELST (2.0) is placed in the Public Domain. There's no charge for it's use, but please give me credit if you pass it around (we programmers are a humble people). Please send the ARC file so that they will get this file, too. Although we've tested STYLELST, and there's no "damaging" code, we can't be responsible for any damage to your system caused by this program or variations of the code. (With all the brain-damaged programmers out there that are writing virus programs, we trust that you'll perform the necessary precautions when dealing with all programs you download.)

HOW TO FIND ME

I'm interested in comments to improve the program, and if you have problems. The easiest way to contact me is electronically. You can leave a message on CompuServe (71331,514) or on the Time Traveller BBS system (916) 739-8386 (2400-N-8-1). I'll try to respond quickly (I'm on Compuserve daily, and on Time Traveller weekly).

I'll be posting information about this and the other programs on CIS when they are ready.

To send your comments (and the registration fee):

PLACER COMPUTER SYSTEMS

3488 Corwin Court, Loomis, CA 95650

Rick Hellewell (CIS: 71331,514)

---30---