[ Top | Up | Prev | Next | Map | Index ]

Readme for analog3.11

Mailing lists

I welcome mail about analog, both praise and bug reports! I and others are also usually happy to help people who have trouble with analog: it helps me to find bugs, and know where the documentation is unclear.

There are three mailing lists for analog.

Announcements about analog. I post to this when there are new versions, for example. Usually only gets a few messages a year.
Getting help with analog from experienced users. This is the place to go if you have trouble setting up or configuring the program.
This just goes to me. Use for private comments.

To subscribe to the analog-announce mailing list, send a message to analog-announce-request@lists.isite.net with the word subscribe in the main body of the message. Note that the word has to be in the body of the message, not the subject. Also note the -request part of the address.

If you want to get help with analog, please check the following simple things first.

  1. Read the FAQ. Maybe I've answered your question already. If I have, I'll just direct you to the FAQ, not answer it again.
  2. Read the list of known bugs at my site, to see if your bug is already known about.
  3. Read the other relevant pages of the Readme, particularly the section on Starting to use analog, and the section on Errors and warnings if your question is about one of those. If your question is already answered on one of those pages, I'll just direct you to it, not answer the question again.
  4. If your question is "How do I do ... with analog" then don't ask it until you've read the whole of the section on Customising analog yourself, and still don't know how to do it. I don't appreciate people who are too lazy to read the documentation. (If the documentation is unclear, or the relevant paragraph is too well hidden, then that's a different matter. Of course I want to know about that.)
  5. If analog isn't doing what you thought you asked it to, then run it with the PRINTVARS ON configuration command, and see what options it thinks it's meant to be using.
  6. Describe exactly what you did, what you expected, and what the computer did. Include the exact text of any error messages, not a précis.
  7. Do not send long files or attachments unless you're asked to. I do not want to see your configuration file, your header file, your output file, or any logfile over 20 lines long. They are almost always useless to me.
I'm sorry to be so fussy, but a lot of the mail on the list really needn't have been sent at all, and just wastes the time of everybody on the list. As I say, I really do welcome genuine mail.

If you still need help, first subscribe to the analog-help mailing list by sending a message to analog-help-request@lists.isite.net with the word subscribe in the main body of the message. Note that the word has to be in the body of the message, not the subject. You can then send mail to analog-help@lists.isite.net. Don't try and use this address for subscribing though. It won't work!

If you want to send a private message to me, you can send it to me at analog-author@lists.isite.net.

These mailing lists are new. If there's any problem with them, you can still get me at my personal address, sret1@cam.ac.uk.

Many thanks to ISite for providing these mailing lists free of charge.

Stephen Turner
E-mail: analog-author@lists.isite.net

[ Top | Up | Prev | Next | Map | Index ]