(last updated for version 1.15)


An ASCII version of this document is included with the self-extracting archive you can download using the above button? For some reason, the option "/an" mentioned in the manual is not supported by the actual software.

1.) Purpose

Displays a "Motto Of The Day", i.e. a quotation read from a so-called quotation file. The program automatically picks a new one at random for every day. On one day, however, the same quotation is displayed all the time (unless you make changes to the files, or something). The program is intended to be installed in your "autoexec.bat" file.

Special abilities: This program ist fast. No matter how big your quotation file may be, it will hardly take a second to select a quotation and display it! It's easy to use, no index files, no data or configuration files! Quotation files may be edited with any ASCII editor! Multiple file support! And more ...

2.) Disclaimer

Any resemblance between the expressed views and those of my employer, my terminal, or the view out my window are purely coincidental. Any resemblance between the above and my own views is non-deterministic. The question of the existence of views in the absence of anyone to hold them is left as an exercise for the reader. The question of the existence of the reader is left as an exercise for the second god coefficient. (A discussion of non-orthogonal, non-integral polytheism is beyond the scope of this documentation.)

Mind that I take no responsibility whatsoever for any trouble you may be having with or because of the use of this program, in the judicial sense, that is. Of course any ideas on improving the program are very welcome.

The program is freeware. That means you are allowed to make as many copies as you want, but you must never change or charge anything, and always make a complete copy including this file. There's no warranty at all.

3.) Quotation Files

Quotation files contain all the quotations that can potentially be displayed. In order to make it possible for QUOTS to deal with the files correctly, you must make sure they are compatible with the following format: Usually, all these requirements are easy to meet. I downloaded a few huge qfiles from Internet, and was able to use them almost immediately, after running a search-and-replace on the quotation terminators.

Multiple files: Some people are real crazy about collecting quotations, so they might have more than 1 MB of quotations (That's more than will fit in a single file, remember?). So I included multiple file support. Just specify more than one file on the command line, and QUOTS will use them all. There are a few things you might want to know about how QUOTS picks quotations from multiple files:

This is done in order to ensure that only one different quotation is displayed on the same day. Of course, when you change the contents of a file, its date and time is changed, and QUOTS may pick a different quotation for the rest of the day. If QUOTS encounters an invalid file specification, it will tell you about it, but continue with the other ones if possible. The number of files is limited to ten.
Called with no parameters, QUOTS will attempt to open 'quots.qts' as quotation file and display a quotation. If this fails, it will display a brief online help screen.

4.) Options

Well, there are a few options. Not very many though. If you don't want to specify any options, you don't have to.
The order in which options are given does not matter. Options may even be mixed with file specifications. They are recognized by their preceding slashes or hyphens. For a better understanding of how the command line options work together, I have provided the following examples for complete program calls:
(a) QUOTS quots.qts -c:3090E07 -t:"" nice.qts 5000 bgsaying.qts 10000 english.qts
This is how QUOTS is called in my autoexec.bat file. The quotation is chosen from one of the four given files. "english.qts" is the biggest one (500 quots, 70,000 bytes), whereas the other three are relatively small. "nice" contains nice quotations that are a little too long, so I don't want to have them displayed too often (probability like a 5000 bytes file).
QUOTS displays the chosen quotation using light gray text and a yellow frame on black background. There is no title.

(b) QUOTS myquots.qts
Displays a quotation from "myquots.qts" with all the default settings, i.e. title, color set, frame, ...

Tries to open "quots.qts". If successful, see (b). If not, QUOTS will display a short help screen with brief instructions on usage etc.
The latter can also be achieved by typing in "QUOTS -?". This comes in handy when there is a file "quots.qts", but you still want to see the help screen.

(d) QUOTS lotsofqu.ots -l:- -a
Displays a quotation from "lotsofqu.ots" just like (b), except that the frame is ommitted, and a new quotation is chosen whenever the program is called, regardless of date.

5.) Contacting the Author

If you feel a strong urge to throw up because you've read this, feel free to do so. For other, more constructive criticism, ideas for bug changes, or praise(?) you may contact me by e-mail. (For e-mail bombs, the stress is on e!) Remember: Don't Panic!
   Documentation is like sex: When it is good, it is very, very good;
   and when it is bad, it is better than nothing.
                                                  -- Dick Brandon
Here's the address: public(at)thomasjensen.com

6.) Downloading quots

The link below gets you the quots self-extracting archive. Under DOS (sure) all you have to do is type quots-x while you're in the directory you want quots to be installed in, and it will upack. You're all set.


   "... A booming voice says, "Wrong, cretin!", and you notice that you
   have turned into a pile of dust."

quots © 1995 by Thomas Jensen <public(at)thomasjensen.com>
Page created February 2, 1995, last modified: 09/23/96. All rights reserved.
Location: https://thomasjensen.com/software/quots/