[Date Prev][Date Next][Subject Prev][Subject Next][Date Index][Subject Index]

Revised Documentation



           ***** REVISED *****

              WELCOME TO
               XYWRITE

       AN UNOFFICIAL AND INFORMAL DISCUSSION LIST
    FOR THE XYWRITE WORD PROCESSOR FOR DOS AND WINDOWS

              from
     Nathan Sivin (nsivin@xxxxxxxx)
             1997.7.4

INTRODUCTION
============

Please save this message for future reference, especially if you are not
familiar with the CCAT list server. This might look like a waste of disk
space now, but in 6 months you will be glad you saved this information when
you realize that you cannot remember how to unsubscribe, leave the list to
avoid filling up your mailbox while you are on vacations, or download
utilities and other files.

The XyWrite Discussion Group operates from the list server at the Center
for the Computer Analysis of Texts at the University of Pennsylvania. It
was founded and is administered by Nathan Sivin of the Department of
History and Sociology of Science at the University (with technical help
from CCAT). The Group exists to facilitate the exchange of information,
ideas, XPL programs, solutions to problems, etc. You can post a question
for colleagues to answer, propose a topic for discussion, reply to an
earlier query, trade information, and so on. 

The List is open to you if you are able to send e-mail messages to and
receive them from Internet addresses, regardless of whether you have a
connection to an Internet account. When you subscribe, your e-mail address
is added to the distribution list for all messages. You then receive by
e-mail every message that others address to the list
(XYWRITE@xxxxxxxx). Every message you send, including every
direct reply to a message, is forwarded to every other subscriber. You can
suspend or end your subscription at any time. There is no charge for any
List activity.

In addition to forwarding messages, the List maintains programs and files
contributed by you and other members that subscribers can choose and
download individually, as well as archives of the messages sent to the
list, prepared every month and kept for two years. Such files are
maintained by our list server. Available files are described, and detailed
instructions for downloading binary files via Anonymous FTP, are given in
the text file CATALOG.DOC. For submitting files to be kept and
distributed, see below.

GETTING INVOLVED IN THE GROUP
=============================

There are two different ways to follow and contribute to the List's ongoing
discussions.

It is not essential to subscribe in order to take part in the List. You
can always send individual messages, which, if they are addressed to the
List, will be automatically forwarded to all subscribers. Those who
receive the message can then reply to you privately. If this is what you
prefer, specify in your message that you are not a subscriber and should be
contacted privately.

Most people who want to follow the discussions find it convenient to sign
up with our "list server", a computer which will automatically deliver
copies of all the List's correspondence to your Internet, Bitnet, online
service, or other e-mail address, and redistribute messages from you.

PLEASE NOTE that everything concerned with subscribing is transacted not
with the List itself (xywrite@xxxxxxxx) but with the list server
(LISTPROC@xxxxxxxx). Its sole function is to automatically
maintain mailing lists for various groups, redistribute messages, and
provide basic information about the lists when requested. Because the
process is automatic, your requests must be in a set form. Any
subscription requests sent to the List address cannot be acted upon, just
as messages for the List will be lost if they go to the list server.

Any of the commands summarized below may be abbreviated by their first
three letters, e.g., SUB for subscribe, UNS for unsubscribe. The server
ignores subject lines, so it is best to avoid providing your message with a
subject. If your email program automatically appends anything (e.g., a
"signature" or return address) after the message, please erase it. If you
use EUDORA, just click on "no signature."

These are the forms for requests:

SUBSCRIBING
===========

Start your subscription by mailing to LISTPROC@xxxxxxxx the
following message in a single line:

subscribe xywrite name,

with your name in up to 4 words.

The list server will arrange (without human intervention) for your
subscription to go to the address from which you sent the message. If your
own account does not use a ListProc server, or if you want it to go to a
different address, say jones@xxxxxxxx, your message would specify
the address and the subscriber, as well as your own name in parentheses.
If you aren't sure, keep life simple by sending the command this way:

subscribe xywrite jones@xxxxxxxx (Tom Jones)

As soon as your subscription is processed you will receive an up-to-date
copy of this welcoming message with complete instructions. Whenever you
want to end your subscription, send the following one-line message, with
the additions above if necessary:

unsubscribe xywrite

OTHER BUSINESS WITH THE LIST SERVER
===================================

The list server can respond automatically and quickly (by separate e-mail
replies) to a few other useful commands, all of which should be sent as
single-line messages to LISTPROC:

To have an index of the files stored in the EAAN directory of
CCAT.SAS.UPENN.EDU sent to your e-mail address:

index xywrite

To have a file stored in xywrite@xxxxxxxx sent to your e-mail
address, send the full file specification as determined from the index:

get xywrite FILESPEC

for instance get xywrite CATALOG.DOC which will get you a list describing
all downloadable files.

To find out who is on the xywrite list:

who xywrite

To have general introductory information for xywrite (that is, the current
version of this file) sent to you:

review xywrite

If you want a list of subscribers, the "review" command will include it as
well as the descriptive information. If you want only the list:

review xywrite sub

For information about all the lists served by the list server:

lists

These are just a few of the commands available to you. You can also set
various options, search for keywords and other patterns, etc. For detailed
information visit the Corporation for Research and Educational Networking's
(CREN) web site, http://www.cren.net. You can also order the User Manual
by anonymous ftp from info.cren.net, /listproc/userman. That brings you
the plain text version unless you append ".rtf" for Microsoft Rich Text or
".ps" for PostScript.

TAKING PART IN THE LIST
========================

When you want to send a message to all subscribers, just send it as
ordinary e-mail to the Internet address xywrite@xxxxxxxx. A copy
will automatically be forwarded to all of the List's subscribers. By the
same logic, if you use the e-mail "Reply" function to respond to incoming
mail from a member of the List, it will automatically be addressed back *to
the entire group* (i.e. to xywrite@xxxxxxxx, and thence to all
subscribers!). If what you have to say is not of general interest, then
please take the trouble to send it only to the sender, whose private
address you can find in the header of his or her message.

Everyone, decidedly including myself, occasionally fires off a private
reply to a new message to every one of the hundreds of subscribers of the
list from which it was forwarded. To avoid the resulting embarrassment,
make a habit of checking the "from" line of the message you want to answer,
and of checking the "to" line of your own reply.

We also ask that, when you are replying and your e-mail program asks you
whether you want to quote the message to which you are replying, that you
limit your quotation. Use it only if the point will not be clear, or if
you are replying to an old message that other subscribers will have
forgotten about. If you do quote it, edit the quotation so that you just
keep the essential part, or better yet summarize. Taking this trouble will
keep your message from being needlessly large, which inconveniences everyone.

You are welcome to contact the List about any topic connected with xywrite
and its uses. All messages are automatically accepted and forwarded. The
List provides a place to post messages, try out ideas, ask questions, etc.
Please keep in mind, however, that

1. E-mail is never a private or secure facility. If you are concerned
about who reads your messages, think twice about sending them via e-mail.
In addition, anyone may subscribe to this list. Any message sent to the
list goes to all subscribers.

2. Most people do not read their e-mail every day, and not many post a
message when they are away from their universities, even for an extended
period. It is a good idea not to trust e-mail for urgent matters.

3. Please be kind to other subscribers by not sending irrelevant
materials, or materials meant only for one subscriber (unless you are
confident that they will interest a number of subscribers). Remember that
you can get the private e-mail addresses of subscribers from the list
server (and from many other directories, using the WHOIS and FINGER
commands in UNIX) and send individual messages.

Junk Internet messages are an occasional, unavoidable annoyance. We can
usually stop transmissions from a given source after the first, but not the
first. You will minimize the distraction by not broadcasting complaints.
We are alert to the problem, and deal with it to the extent we can. If it
get worse, we may block the list so only subscribers can send messages.

ACKNOWLEDGEMENTS, VACATIONS, ETC.
=================================

Normally, when you send a message to the list, as a subscriber you will
also get a copy. If you don't want this to happen, send:

set xywrite mail noack

and, if you change your mind:

set xywrite mail ack

If you are away for long enough to let your mailbox fill up, further
messages are automatically bounced or queued, generating a very large
number of error messages, which an informally run list like this cannot
cope with. For that reason, it is virtually certain that your subscription
will be terminated. There is an easy way to avoid this by setting mail
options:

set xywrite mail postpone

When you are ready to receive messages again, send:

set xywrite mail noack OR ack, as the case may be.

If you change or drop an email address, or know that your account will be
closed, PLEASE unsubscribe. Then you can subscribe again from the new
address. I am often inundated in error messages from university servers
that refuse messages after they close down accounts of graduating students,
etc.

PREPARING MESSAGES AND OTHER FILES
==================================

All messages must be in ASCII text form. If you are using a DOS
communications program, it is usually easier to create them in your word
processor, edit and proofread them, and upload them than to use the
primitive editor in your e-mail package. Some programs (PC-WRITE, XYWRITE,
NOTA BENE, the EDIT program included in DOS 6+) normally produce ASCII
files; all others provide a way of saving files in ASCII form. Messages
are transmitted via many different computers. Some do not use the full IBM
ASCII set; others use an entirely different standard. It is a good idea to
avoid ASCII characters below no. 32 and above no. 128, such as letters with
diacritics.  If your computer uses tab characters to indent paragraphs (as
WordPerfect 5.1 does), please avoid them, or delete them before saving the
ASCII file.

The best layout to use is plain block form, in which *paragraphs are not
indented and a blank line separates paragraphs.* This document is an
example. This form can be read on virtually every computer. If your
computer uses tab characters to indent paragraphs (as WordPerfect 5.1
does), please avoid them, or delete them before saving the ASCII file.

If you use a Windows comm program, you can always paste text (SHIFT-INS)
into the message composition window by copying it (CTRL-INS) from an open
Windows word processor and shifting windows (ALT-TAB or CTRL-ESC).

If you compose your message with XyWrite, please remove all deltas and
insert hard returns at the end of each line before sending. AVOID LINES
MORE THAN 65 CHARACTERS LONG, AND GET RID OF THE ^Z (EOF) at the end of the
file (which must be done from outside XyWrite). There are various XPL
programs for this cleaning up, one of was posted for anonymous ftp download
in XYLNS.ZIP. If you want to keep it simple, you can load STRIP.PRN
(command: ldprn strip.prn), then print to a file (command: printf
,filename), and finally, if necessary, call the output file and clean it up.

Please check the file before sending it. The simplest way to check a file
is to use the DOS "TYPE" command, followed by a vertical bar and the "MORE"
filter command (i.e., at the DOS prompt:

type filespec | more

but the vertical bar before "more" above may not be intact by the time this
message reaches you). That command will show you a screenful of text at a
time. Any non-standard characters will be readily visible.

UPLOADING FILES
===============

When you send e-mail messages to the list, they are simply redistributed.
If you have a program or other file that you would like to have stored so
that people can download and use it, special arrangements must be made to
upload and store it. Programs must be sent in binary form, zipped if they
are long. If you are unable to send binary files, the alternative is to
use XX-encoding, preferably with the utility shareware program UUXFER. It
is less likely to be corrupted by cross-platform transmission than
UU-encoding. MIME often works, but not always. Contact me for information.

Before deciding whether and what to upload, I suggest you try ordering one
or more of the few files already posted on the list. Note their form
before deciding how to format your own files.


IDENTIFYING AND ORDERING FILES
==============================

You can use an "index" message, as explained above, to get a list of
available files, and a "get" message to order them.

For instance, "index" will let you know that among the files available
(beginning in mid-April 1994) are

CATALOG.DOC (a description of each available file)

The first file to order is CATALOG.DOC, to help you choose others. To
order any file, note that you must use a period between filename and
filetype. Thus to order that one you use the command:

get xywrite catalog.doc

You can also use anonymous ftp or a web browser to examine the directory
interactively and individual files and download them yourself. CATALOG.DOC
has the details.

The monthly archives of discussions, which will let you catch up with
earlier activities, are compiled automatically into text files. They may
be ordered or downloaded in the same way as other text files.

Good luck, and have fun. If you wish to contact me directly, do so at my
private Internet address,

NSIVIN@xxxxxxxx

My postal address is appended at the end of every message from me. Please
note that it is not possible for me to answer or even read messages every
day.

END
-------
N. Sivin
History and Sociology of Science
University of Pennsylvania
nsivin@xxxxxxxx