home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / bbs / waffle / 6318 < prev    next >
Encoding:
Internet Message Format  |  1993-01-21  |  33.2 KB

  1. Xref: sparky comp.bbs.waffle:6318 news.answers:5355
  2. Newsgroups: comp.bbs.waffle,news.answers
  3. Path: sparky!uunet!spool.mu.edu!uwm.edu!psuvax1!snobol.cs.psu.edu!fenner
  4. From: fenner@cs.psu.edu (Bill Fenner)
  5. Subject: Waffle Frequently Asked Questions (FAQ)
  6. Message-ID: <C172xs.357@cs.psu.edu>
  7. Followup-To: comp.bbs.waffle
  8. Originator: fenner@snobol.cs.psu.edu
  9. Sender: news@cs.psu.edu (Usenet)
  10. Supersedes: <waffle-faq_c0FaX4@cs.psu.edu>
  11. Nntp-Posting-Host: snobol.cs.psu.edu
  12. Reply-To: fenner@cs.psu.edu (Bill Fenner)
  13. Date: Thu, 21 Jan 1993 08:15:27 GMT
  14. Approved: news-answers-request@MIT.edu
  15. Expires: Fri, 19 Feb 1993 08:15:05 GMT
  16. Lines: 901
  17.  
  18. Archive-name: waffle-faq
  19. Original-Author: vds7789@aw2.fsl.ca.boeing.com (Vince Skahan)
  20. Last-modified: $Date: 1993/01/20 16:31:56 $
  21.  
  22.  
  23.                     Waffle Frequently Asked Questions (FAQs)
  24.                     ========================================
  25.  
  26. INTRODUCTION
  27.  
  28.   The intent of this document is to assemble, in one place, a general list
  29.   of Waffle-related Frequently Asked Questions.  It is not intended to be
  30.   all-inclusive, since no one document can replace the 400KB or so of
  31.   documents that come with Waffle.
  32.  
  33.   Rather than repeat material maintained in other newsgroups, other periodic
  34.   postings, or the \waffle\docs directory, this document will attempt to
  35.   point the reader to the right place for information that is either too
  36.   complicated to describe here, or is kept up to date elsewhere.
  37.  
  38.   This document includes information for the current official release of 
  39.   Waffle (v1.65, released 8/1/92).
  40.  
  41.   In many cases, the answer to a FAQ might be something along the lines of 
  42.   "you can't at v1.64 or before".  Version-specific answers are indicated 
  43.   whenever possible.
  44.  
  45.   At this time, this document primarily addresses the DOS version of Waffle, 
  46.   but feel free to submit unix-Waffle FAQs to the address above for inclusion 
  47.   in the next posting.
  48.  
  49.   Comments, additions, and corrections are welcomed (via e-mail please).
  50.  
  51.  
  52. GENERAL INFORMATION
  53.  
  54. 1. What is Waffle ?
  55.  
  56.     Waffle is a USENET-compatible BBS system which supports UUCP
  57.     mail, UUCP, and USENET news.  In addition, there is a built-in
  58.     editor, file upload/download, and the ability to hook in
  59.     external programs and gateway to (or from) other packages.
  60.  
  61.     DOS Waffle supports (but does not require) external Fossil
  62.     drivers to allow use of high speed modems and allows an MSDOS
  63.     PC to be a fully RFC compliant USENET node.  It also provides
  64.     the UUCP-based transport mechanism that generally comes with
  65.     unix systems.
  66.  
  67.         Unix Waffle provides just the BBS functionality and requires the 
  68.     'traditional' unix communications, mail, and USENET-news software 
  69.         for those functions.
  70.  
  71.         See \waffle\docs\readme, unix.doc, and dos.doc for more details.
  72.  
  73. 2. What operating systems does it run on ?
  74.  
  75.         IBM-PCs and compatibles running MSDOS (which includes Microsoft
  76.                 Windows, DR-DOS, and OS/2 if you have enough memory).
  77.  
  78.     Many variants of unix.  In particular, configuration options are
  79.     already in place for: NeXT, BSD 4.2/4.3, A/UX, SUN, LINUX, IRIS,
  80.     Ultrix, XENIX, Interactive 386/ix, HP/UX, Altos 2000.  If you
  81.     have one of these environments, Waffle should just drop in with
  82.     no problems.
  83.  
  84.  
  85. LICENSING
  86.  
  87. 1. Is Waffle free ?
  88.  
  89.         In a word, no.
  90.  
  91.         The DOS version is shareware that is made available in
  92.         binary form at many locations so you can 'try before you buy'.
  93.  
  94.     The UNIX version is available as source code only, and there
  95.     is no provision to 'try before you buy'.  However, the look
  96.     and feel of the two versions are almost identical, so the DOS
  97.     version serves as a 'try' version.
  98.  
  99. 2. OK, so what's it cost ?
  100.  
  101.     For non-commercial sites, DOS Waffle costs $30.00 (US) for 
  102.     binaries and $120.00 (US) for sources. The unix sources are 
  103.     $120.00 (US) for non-commercial sites.
  104.  
  105.     Contact the author, Tom Dell <dell@vox.darkside.com> for info
  106.     about purchasing Waffle, or see \waffle\docs\register.doc from
  107.     the DOS distribution for more details.
  108.  
  109. 3. What if I bought DOS binaries and I now want sources ?
  110.  
  111.         You pay the difference between the binary fee you've paid
  112.         already and the cost of the source code.
  113.  
  114. 4. Once I'm registered, can I upgrade to new versions for free ?
  115.  
  116.     Yes, although you might have to download a copy rather than
  117.     expecting a floppy to come in the mail.
  118.  
  119.  
  120. AVAILABILITY
  121.  
  122. 1. How can I get Waffle by ftp ?
  123.  
  124.         Anonymous ftp:
  125.         -------------
  126.  
  127.         Waffle (DOS version) is available via anonymous ftp from
  128.         SIMTEL20 and its various mirror sites as follows:
  129.  
  130.         wsmr-simtel20.army.mil                  26.2.0.74
  131.                 pd1:<msdos.waffle>waf165.zip
  132.  
  133.         wuarchive.wustl.edu                     128.252.135.4
  134.                 /pub/mirrors/msdos/waffle/waf165.zip
  135.  
  136.         There are other SIMTEL20 mirror sites.  See the periodic postings
  137.         in comp.binaries.ibm.pc.d and news.answers for more details.
  138.  
  139. 2. What if I'm not on the Internet ?
  140.  
  141.         From the author's BBS:
  142.         ---------------------
  143.         The Dark Side of the Moon BBS      1.408.245.SPAM (7726) (Tom Dell)
  144.  
  145.         From SIMTEL20 and mirrors via mail-based-archive-servers:
  146.         ---------------------------------------------------------
  147.         A number of sites run archive-servers to give non-Internet folks
  148.         the ability to do the equivalent of ftp-by-mail.
  149.  
  150.         If you do not have FTP access to SIMTEL20, files may be ordered by
  151.         mail from:
  152.  
  153.            Internet-style:      listserv@vm1.nodak.edu
  154.                                 listserv@vm.ecs.rpi.edu
  155.  
  156.            UUCP-style:          uunet!vm1.nodak.edu!listserv
  157.                                 uunet!vm.ecs.rpi.edu!listserv
  158.  
  159.         Send this command to the server to get its help file:
  160.                 GET PDGET HELP
  161.  
  162.         NOTE: remember that if you request items from an archive-server
  163.         via mail, that your traffic goes through every system between the
  164.         server and you, and adds such load on each system.  Be courteous.
  165.  
  166.         There are a number of periodic postings in news.answers that tell
  167.         how to get software via mail in far more detail than what is
  168.         provided here.
  169.  
  170.         From other BBS sites:
  171.         ---------------------
  172.     Via mail:
  173.         questor.wimsey.bc.ca (Steve Pershing):
  174.             mail with text 'help' to username 'MailServer'
  175.  
  176.     Available for downloading:
  177.         The Heart of Gold BBS
  178.         +1 814 238-9633
  179.         300-2400/v.32/v.32bis/ZyXEL 16.8k, free download on first call
  180.         look in /file/ibm/bbs/waf*.zip
  181.  
  182.  
  183. SUPPORT MECHANISM
  184.  
  185. 1. How can I get questions answered ?
  186.  
  187.         First, read everything in \waffle\docs.
  188.         Then read them about 3 more times.
  189.         Then read them again.
  190.  
  191.     Running a USENET site is not difficult, but it's also not
  192.     trivial.  Running Waffle is not always immediately self-evident
  193.     either.
  194.  
  195.     The docs will help... a lot.  Yes, there is a lot to read, and
  196.     yes, it seems ponderous, but most of your questions are
  197.     answered either in the docs or in this FAQ.
  198.  
  199.         Use of a version of 'grep' to scan all the documents for
  200.         keywords is highly recommended, or looking in 1.65's new
  201.     \waffle\docs\index.
  202.  
  203. 2. Is there a USENET newsgroup for Waffle ?
  204.  
  205.         Yes, comp.bbs.waffle (also known as 'c.b.w.')
  206.  
  207.     Don't be shy, there's a lot of expertise in c.b.w.  That's what
  208.     it's there for.  However, be sure that you have looked through
  209.     all the documentation before posting your question; you will
  210.     likely get flamed if you ask a question that is clearly
  211.     answered in the documentation (or in the FAQ, for that matter.)
  212.  
  213. 3. Can I get in touch with the author of Waffle ?
  214.  
  215.         Yes.
  216.  
  217.         Tom Dell reads comp.bbs.waffle, though he doesn't generally
  218.         post too often since he's busy 'doing good' for us all :-)
  219.  
  220.         He's also reachable via e-mail at dell@vox.darkside.com.
  221.         Be aware that Tom gets *LOTS* of mail, so replies might
  222.         take a while.
  223.  
  224.     In general, normal questions to comp.bbs.waffle will get quite
  225.     a few responses in a very timely manner.  There probably aren't
  226.     too many questions you can't get answered in c.b.w.
  227.  
  228. 4. How many Waffle sites are there currently?
  229.  
  230.     It's hard to say since there are sites that are unregistered,
  231.     not in the UUCP maps, and/or are mail-only and do not exchange
  232.     news.
  233.  
  234.     I periodically count how many Waffle sites have posted to USENET
  235.     in the past 2 weeks.  The last survey was done on Jan 16, 1993,
  236.     and the results were:
  237.         10/29/92 1/16/93
  238.     1.61:         2         1
  239.     1.63:         9         8
  240.     1.64:        81        44
  241.     1.65:       266       266
  242.     1.66:             1    [this is misleading; 1.66 is not out yet.]
  243.                 ---       ---
  244.                  358       320
  245.  
  246.  
  247.  
  248. MAIL
  249.  
  250. 1. How can I route domainized mail for my uucp neighbor directly to them ?
  251.  
  252.         Domain-based mail goes to your smarthost (as defined in static)
  253.         unless you override that route with an entry in paths.
  254.  
  255.         If you mail to 'friend@hostname.domain' and you're directly
  256.         connected to them via UUCP, you can force a direct delivery
  257.         with a paths entry of :
  258.  
  259.                 hostname.domain         hostname
  260.  
  261. 2. What should I do with my headers?
  262.  
  263.         Nothing unless you know what you're doing.
  264.  
  265.         In general, you want your 'netmail' and 'netnews' parameters in
  266.         static to result in valid headers, so that people can reply to you.
  267.  
  268.         If you can do so, get into a domain and domainize all your headers.
  269.         It'll make your life easier and will do the same for people who
  270.         exchange mail with you.
  271.  
  272.         The important thing to remember is that if you put a domain-style
  273.         address out without being domainized, people will probably not be
  274.         able to reply to your mail.  Just because an address looks good
  275.         doesn't make it valid...
  276.  
  277. 3. I'm not in a domain.  What should my headers look like ?
  278.  
  279.         In general, you want to have an address that is a known-good route
  280.         from a known site.
  281.  
  282.         Some possibilities are:
  283.                 All bang-path ===> some_known_host!your_site!you
  284.             (i.e. mailfrom: psuvax1!%u!%A
  285.                or mailfrom: psuvax1!%n!%A)
  286.                 mixed format  ===> you%your_site.uucp@some_internet_site
  287.             (i.e. mailfrom: %A%%%n@psuvax1.cs.psu.edu)
  288.                                    your_site!you@some_internet_site
  289.             (i.e. mailfrom: %u!%A@psuvax1.cs.psu.edu
  290.                or mailfrom: %n!%A@psuvax1.cs.psu.edu)
  291.  
  292.     (All of the examples above assume something like:
  293.         node: hogbbs.UUCP
  294.         uucpname: hogbbs
  295.      in your static file)
  296.  
  297.         The actual format that works best for you depends on who you're
  298.         connected to and what their mailer can handle.
  299.  
  300.     Note that the all bang-path format is not reccomended for news;
  301.     sites running B News will mangle your article in such a way that
  302.     downstream sites running newer software will drop it on the floor.
  303.  
  304. 4. I'm a single site. Should I register in the UUCP maps?
  305.  
  306.     Yes, or get a domain name.
  307.  
  308.         The bottom line is that if people try to mail to you, you want
  309.         your address to be reachable.  From Internet, you want to get
  310.         domainized and get a MX record if you can.
  311.  
  312.     From UUCP-only sites that don't touch Internet, you need a map
  313.     entry (or a header that routes you through somebody with a map
  314.     entry you can trust).
  315.  
  316. 5. Can I display something other than the sender when listing mail ?
  317.  
  318.     Yes, as of 1.65 you can specify the header you want to see when
  319.     you do a list of messages via the 'listmail' item in static.
  320.     Unfortunately, this is not configurable per-user, only
  321.     per-site.
  322.  
  323. 6. Does Waffle support mail folders ?
  324.  
  325.         Yes, as of 1.65.
  326.  
  327.     If you have no new mail in your mailbox, you can say 'mail *' to
  328.     get a list of mailboxes to read.
  329.  
  330. 7. Can I use (my favorite mail program) ?
  331.  
  332.         Some people have had luck with 'readmail' for reading only,
  333.         and at 1.65 either mush or pc-elm should work for read/write.
  334.  
  335.         Version 1.65 has MMDF-style mailboxes with messages separated
  336.         by four control-A's, so mush and pc-elm should be able to
  337.         read/write these messages, though you'll have to reindex your
  338.         mailbox with 'makebox' or the like if you write to it.
  339.  
  340. 8. Can I keep a record of all mail that comes into the system ?
  341.  
  342.         Yes, create a file called 'inbox' in \waffle\admin and all
  343.         incoming mail will be copied there. You can stash this file
  344.     elsewhere via the rr.inbox variable in the static file.
  345.     See rmail.doc for more information...
  346.  
  347.  
  348. FILES SECTION
  349.  
  350. 1. How can I set the prompt in the files section ?
  351.  
  352.         Use the undocumented (before 1.65) 'fileprom' static file 
  353.     parameter.  Try 'fileprom : [$f] :' as an example.
  354.  
  355. 2. I use a Fossil driver and a 16550 UART with FIFOs enabled. After
  356.      someone transfers a file, why does it seem as if characters are not being
  357.      transmitted?
  358.  
  359.         If you use DSZ, it directly accesses the UART, and uses the FIFOs. 
  360.     By default, it turns them OFF when it finishes. Since Waffle (at least 
  361.     1.64) doesn't appear to reset the Fossil driver, it tries stuffing 
  362.     characters into a buffer that's turned off.
  363.  
  364.         The fix is to use the 'F' flag on DSZ's command line in
  365.         \waffle\extern\_send and _receive:
  366.  
  367.         Z /command="C:\waffle\bin\dsz F port %d est 0 %b sz -m %i",
  368.  
  369.     or to use the new (as of 1.65) /reset flag on the extern to 
  370.     make Waffle reset the FOSSIL:
  371.  
  372.     Z /command="C:\waffle\bin\dsz port %d est 0 %b sz -m %i" /reset
  373.  
  374.         This can also affect file transfers using the built-in
  375.         editor.
  376.  
  377. 3. People with priv 9 can access the file section fine, but people with
  378.     normal access get "Validation is required to use the FILES section."
  379.  
  380.     Check your /waffle/system/dirs file.  This error occurs if
  381.     the user does not have access to the root file directory
  382.     ("files:" in the static file).  A sample from hogbbs's (working)
  383.     configuration:
  384.  
  385.     /waffle/system/static:
  386.  
  387.         files: f:/file
  388.  
  389.     /waffle/system/dirs:
  390.  
  391.         1 /dir="f:/file" /access=1
  392.  
  393.  
  394. EXTERNALS
  395.  
  396. 1. How do they all work ?
  397.  
  398.     Simple.  There's \waffle\extern\_system for the normal
  399.     commands, and you can add any command you want with any access
  400.     you want by adding a corresponding file to the \waffle\extern
  401.     directory.  The file that you create corresponds to the name of
  402.     the new command.  Be very careful regarding security, though,
  403.     as externs can be the least secure part of Waffle.
  404.  
  405. 2. I use 4DOS, yet Waffle shells out to DOS, not 4DOS...
  406.  
  407.         You need to change the command interpreter in \waffle\extern\_system
  408.         to use 4DOS rather than command.com
  409.  
  410. 3. If I implement Waffle as a door from another BBS, how can users exit
  411.     from Waffle without dropping carrier?
  412.  
  413.     First, disable the 'exit' command in Waffle by adding the
  414.     following line to your static file.
  415.  
  416.     disable: exit
  417.  
  418.     Then provide an external implementation of the exit command by
  419.     creating extern\exit with the following contents.
  420.  
  421.     /access=0 /logout=exit /log /exit=81
  422.  
  423.     This causes Waffle to exit, without dropping the modem connection,
  424.     with errorlevel 81 (or whatever level you want to specify).  The
  425.     /access=0 ensures that all Waffle users can get back out once they
  426.     get in.  Then you just trap errorlevel 81 in the batch file that
  427.     started Waffle to go back to the other BBS.
  428.  
  429.  
  430. EDITORS
  431.  
  432. 1. What editors can I use ?
  433.  
  434.         Locally, any editor your little 'ol heart desires that works
  435.         in pure ASCII (ie, you could use WordPerfectOffice, but not
  436.         WordPerfect itself since that saves in a non-ASCII format normally).
  437.  
  438.         Remotely, you have to be careful to use an editor that is ANSI
  439.         oriented and that doesn't do direct DOS screen I/O. Some editors
  440.         that are frequently used (and are available on SIMTEL20 and other
  441.         fine archive sites) include:
  442.  
  443.                 MEANSI     - MicroEmacs compiled to use ANSI mode.
  444.                 BBStevie   - vi clone
  445.                 FSED       - a very configurable editor that can be made to
  446.                                 look like just about any editor you want
  447.         WWIVEDIT   - the editor for WWIV
  448.  
  449.         Be aware that if you set up external editors for your remote users,
  450.         you might have a security risk on your hands.  Be sure that you
  451.         know whether your editor will let a remote user shell out to the
  452.         operating system or not, and that you're giving exactly the
  453.         privileges you mean to give out.
  454.  
  455.         BBStevie in particular is designed to be configurable so that you
  456.         can prevent folks from getting to the shell (if you want) and you
  457.         can use the same binary to ALLOW some other folks shell access if
  458.         you want to do that, based on their Waffle access level.  
  459.  
  460. 2. How can I use different local and remote editors ?
  461.  
  462.         At 1.65, you can define different local and remote editors from
  463.         within Waffle, so it's simple.  The STATUS command does not let
  464.     you edit your local editor, however; you have to ADMIN T <you>.
  465.  
  466.     Prior to 1.65, you should modify /waffle/extern/_editors to run
  467.     a batch file which gets passed the baud rate, and decides based
  468.     on that whether to run a local or remote editor.
  469.  
  470. 3. Why does (insert editor here) work locally, but not remotely?
  471.  
  472.     If you try BBStevie locally and it's fine, yet you get a blank
  473.     screen when you use it remotely, make sure that you do not have
  474.     an ansi driver loaded.  Some people have luck using PC Magazine's
  475.     ansi.com, which can be loaded and unloaded as part of a batch file
  476.     around your 'waffle local username' command, so that there's no
  477.     ansi driver loaded by default for remote users.
  478.  
  479.         Version 3.0 of BBStevie can use a FOSSIL driver to do its own 
  480.         modem i/o, so that you can use a local ANSI driver to handle 
  481.         local use and remote use will take care of itself.
  482.  
  483. 4. How come STATUS / EDITOR still says there are no editors on the system,
  484.     when I just added stuff to /waffle/extern/_edit?
  485.  
  486.     You need to manually edit /waffle/menus/editors to reflect the
  487.     editors that are available on your system.  Make sure to include
  488.     that the user can select "none" to get back to the internal editor.
  489.  
  490.  
  491. NEWS
  492.  
  493. 1. Can I keep a copy of all posts ?
  494.  
  495.         Yes, look in static.doc and the USENET file distributed with
  496.     Waffle for /spy=monitor.
  497.  
  498. 2. Can I gateway mail to news ?
  499.  
  500.         Absolutely.  You need to set up an alias in 'aliases' that
  501.         looks something like the following:
  502.  
  503.         newsgroup-name  | post newsgroup.name
  504.  
  505.     To go the other way, add
  506.  
  507.     newsgroup.name /mod="submission-address-of-mailing-list".
  508.  
  509.     For example, I have the Pink Floyd mailing list gatewayed on
  510.     hogbbs to mail.echoes .  I got the list maintainer to send
  511.     the mailint list to echoes-list@hogbbs.scol.pa.us, and have
  512.     the following entry in 'aliases':
  513.  
  514.     echoes-list    | post mail.echoes
  515.  
  516.     My definition for mail.echoes in my USENET file looks like:
  517.  
  518.     mail.echoes /name="The Pink Floyd Mailing List"
  519.             /mod=echoes@fawnya.tcs.com
  520.  
  521.     (That should all be on one line; it was split for inclusion
  522.     in the FAQ.)
  523.  
  524. 3. Does Waffle provided threaded newsreading ?
  525.  
  526.         Not at this time.  See the section on AFTERMARKET ADD-ONS
  527.     for info on external newsreaders which do provide threaded
  528.     newsreading.
  529.  
  530. 4. Does Waffle support kill files ?
  531.  
  532.     Not at this time.  This is planned for v1.66 if Tom responds to
  533.     all the pleading.  Meanwhile, check the section on AFTERMARKET
  534.     ADD-ONS, as above.
  535.  
  536. 5. Why do I see multiple copies of the same article ?
  537.  
  538.         Because Waffle has no 'real-news'-like history mechanism
  539.         at this time.  Waffle considers an article to be a duplicate
  540.         only if the local site is already in the path.
  541.  
  542.         If you get a newsfeed of the same newsgroup from several Waffle
  543.         sites into your DOS Waffle, expect to see lots of duplicates :-(
  544.  
  545.         History mechanism is currently planned (rumored) for v1.66
  546.  
  547. 6. Why do my local postings not make it to USENET ?
  548.  
  549.     Check your /waffle/system/feeds file.  Is there an entry for
  550.     your feed there, saying to send all newsgroups there?  If you
  551.     have a /batch= flag in that feeds entry, did you forget to run
  552.     the 'batch' command to take the list of articles to go out,
  553.     assemble them, compress them, and queue them up for
  554.     transmission.
  555.  
  556.         You should call 'batch' from your poll.bat or from cron via the
  557.         schedule file.
  558.  
  559. 7. Can I edit the newsgroups line when making a post ?
  560.  
  561.         Not directly, but you can 'followup groupA groupB' and get
  562.         the same functionality.  Same goes for mailing a reply to
  563.     somebody and also kicking your reply to somebody else.
  564.  
  565. 8. Can I effectively read and followup to saved news messages ?
  566.  
  567.         Not really at this time.  If you're at the console, you could use
  568.         'readmail' to read them reasonably efficiently, though you
  569.         couldn't respond via mail or followup.
  570.  
  571.     There are also a myriad of relatively ugly workarounds available
  572.     in 1.65 making creative use of makebox.exe, perl, etc. to make the 
  573.     saved messages into a mail folder.
  574.  
  575.         Being able to have saved news articles as a mail 'folder' and
  576.         use the mail program to read/follow/reply to saved news has
  577.         been suggested to Tom for a future release.
  578.  
  579. 9. In 'rn', how can I mail an article to somebody other than the author?
  580.  
  581.     Hit ":m username"
  582.  
  583.     Same idea for saving a message to a specified filename. In that
  584.         case you want to hit ":s filename".
  585.  
  586.         Think of it like hitting ':' to get to command mode in vi.  
  587.  
  588.     Be careful, though, if you're at a "More" prompt - at the "More"
  589.     prompt, a ':' just gets you to the "What next?" prompt, so you
  590.     have to hit two colons.
  591.  
  592. 10. I get a message "D:\NEWS/monitor/1 access denied" when posting a
  593.     message.  [someone wanna give me the exact text of the error?]
  594.  
  595.     You must create the monitor newsgroup manually.  monitor and
  596.     local newsgroups are the only ones that must be created manually;
  597.     rnews will create directories for groups in your FORUMS file
  598.     as needed.
  599.  
  600. 11. My users want to use their QWK offline reader to read their netnews.
  601.     Does Waffle support this?
  602.  
  603.     There is a .QWK door for Waffle, called WafLineMail, which was
  604.     written for 1.64 .  It will sort-of work with 1.65 if you use
  605.     the 'explode' utility to unpack your 1.65 mailbox; it works OK
  606.     with news in 1.65 still.  Unfortunately, WafLineMail 1.0 is the
  607.     sort of program that works perfectly on some machines and
  608.     doesn't work at all on others and nobody can ever figure out
  609.     why.
  610.  
  611.     There is a beta of WafLineMail 2.0 floating around, which knows
  612.     about 1.65's mailbox format, and may or may not be more reliable.
  613.  
  614.     WafLineMail 1.0r is available as "wafm10.zip", and the beta that
  615.     I saw was on halcyon.com:/pub/waffle/wlmb5.zip .
  616.  
  617.     As far as I know, development work on WafLineMail has been dropped.
  618.  
  619.     Rhys Weatherly, author of Helldiver, is working on an offline
  620.     reader / Waffle door combo that will allow native handling of
  621.     USENET messages (the .QWK handling was always pretty hack-ish).
  622.     He will presumably announce to comp.bbs.waffle when it is
  623.     available, and this FAQ will be updated when his announcement
  624.     occurs.
  625.  
  626.  
  627. ADMINISTERING A USENET SITE
  628.  
  629. 1. What books should I buy ?
  630.  
  631.         There are several that no USENET admin should be without.
  632.  
  633.         From O-Reilly+Associates:
  634.  
  635.                 Administering UUCP and USENET
  636.                 A Directory of Electronic Mail Addressing and Networks
  637.  
  638.         From 'The Waite Group'
  639.                 Unix Communications
  640.  
  641. 2. What other stuff should I read ?
  642.  
  643.         Read USENET news, particularly some or all of the following
  644.         groups:
  645.                 comp.bbs.waffle
  646.                 comp.mail.uucp
  647.                 news.admin.misc
  648.                 news.answers
  649.                 news.newusers.questions
  650.  
  651.  
  652. COMMUNICATIONS
  653.  
  654. 1. What settings do I use for my Telebit modem ?
  655.  
  656.         That's far too complicated a question to answer here.
  657.         In general, turn compression off, and turn uucp 'spoofing' on.
  658.  
  659.         This can all be done on the fly by sending register settings as
  660.         part of your send-expect sequence when you call out, or you can
  661.         do so as part of your modem initialization string in static.
  662.  
  663.         Some Telebit modems don't save the register settings.  You might
  664.         have to set the registers in both the init string and in the
  665.         calling sequence.
  666.  
  667.         Also, grab a FOSSIL driver to control the port if you are running
  668.         a 9600 baud modem or above.  BNU and X00 seem to be the most
  669.         popularly used fossils according to the folks in c.b.w.  Don't
  670.     forget to set the driver to 'fossil' in the static file.
  671.  
  672. 2. What's the best throughput I can expect ?
  673.  
  674.         Throughput is a function of a variety of things, including
  675.         (but not limited to):
  676.                 - the speed and load of both systems
  677.                 - the speed of both modems
  678.                 - line noise on the phone line
  679.                 - the size of the batches being transferred
  680.                 - whether or not you are using a FOSSIL driver
  681.  
  682.         With a 2400 baud modem, you should get anywhere between 200 and
  683.         220 cps unless you're transferring very small batches.
  684.  
  685.     V.32 (9600 bps) should get anywhere between 700 and 1020 cps.  
  686.  
  687.         With a Telebit Trailblazer Plus, you should expect something on
  688.         the order of 800 to 1400+ characters/second to a similar modem.
  689.  
  690.         Watch your \waffle\admin\net file for details regarding your
  691.         average characters per second.  A drop off from what's "normal"
  692.         could indicate hardware problems or line problems.
  693.  
  694.         [ shameless plug mode on ]
  695.  
  696.         To summarize your DOS net file easily, grab a copy of 'netsum' from
  697.         the Waffle directory on one of the archive sites..
  698.  
  699.         It can generate a variety of reports that can answer things like
  700.         "based on 11 cents/minute, how much DID I spend to uunet so far ?"
  701.  
  702. 3. What are the special characters recognized by the chat script ?
  703.  
  704.         See \waffle\docs\network.doc or 'Managing UUCP and USENET'
  705.         for details.
  706.  
  707. 4. How can I stop my connection from timing out while switching speeds ?
  708.  
  709.         Use uu.delay in static to set a default delay or use the -t
  710.         parameter in your uucico command to override the default.
  711.         See network.doc for more details.
  712.  
  713.     Also, make sure your modem will wait for a carrier at least as long
  714.     as the uu.delay you specify.  If your modem uses the AT command set
  715.     this is probably the S7 register setting.
  716.  
  717.         Lastly, if you talk to a Telebit modem and you have a non-Telebit
  718.         modem (that talks just file to anything else), you might want to
  719.         ask your feed to put PEP tones last.  Initial PEP tones can confuse
  720.         non-Telebit modems quite a bit.
  721.  
  722. 5. What does this error mean?
  723.  
  724.     See \waffle\docs\network.doc, 'Managing UUCP and USENET', or
  725.     Ian Taylor's UUCP Internals FAQ, posted to comp.mail.uucp, for
  726.     details.
  727.  
  728.  
  729. AFTERMARKET ADD-ONS
  730.  
  731. 1. What add-on products are available for Waffle ?
  732.  
  733.         Lots...and I mean lots.
  734.  
  735.         When in doubt poke around the Waffle directory on SIMTEL20 or a
  736.         mirror site for the list of stuff that's purely Waffle related.
  737.  
  738.         Also, keep your eyes open in the Waffle newsgroup for information
  739.         related to utilities that might not have been uploaded to Simtel.
  740.  
  741.     halcyon.com, on the Internet, has a huge anonymous ftp section,
  742.     in /pub/waffle, which is mirrored by remote.halcyon.com for
  743.     anonymous UUCP.
  744.  
  745.         Lastly, look in \waffle\docs\third.doc in 1.65
  746.  
  747. 2. I don't like Waffle's user interface.  Is there another program that
  748.     I can use to access the news?
  749.  
  750.     There are three products that I know of.  NWREADER, by
  751.     sreck@rebox.in-berlin.de (Stefan Reck), and RusNews, by
  752.     russell@alpha3.ersys.edmonton.ab.ca (Russell Schulz), are both
  753.     normal MS-DOS applications.  HellDiver, written by Rhys
  754.     Weatherly, is a Windows application.
  755.  
  756.     Both NWREADER and RusNews should be easy to hook into Waffle's
  757.     Chrome hook - in RUN.BAT, instead of running CHROME, run the
  758.     reader that you like.
  759.  
  760.     I have never used NWREADER, so I know nothing about it, but it
  761.     was described by the author in his original posting of the
  762.     program as an "offline full screen mail and newsreader".  Look
  763.     for nnXXX.zoo or nn386XXX.zoo to run on 386 machines.  A
  764.     companion mailer, RWMAIL, is available as rwmXXX.zoo.  The
  765.     latest versions I know of are NWREADER 3.00 and RWMAIL 2.19 .
  766.  
  767.     RusNews is written in pascal, and offers an "nn-like"
  768.     interface, where you select which articles or threads to read
  769.     in one screen and then go read all that you selected.  RusNews
  770.     also works online, if you want to offer it for your users as
  771.     well.  Look for rusn-*.zip .  The latest version I know of
  772.     is 0.97 .
  773.  
  774.     I have never used HellDiver, but from what I have seen about it
  775.     on comp.bbs.waffle, if you're using Windows anyway, you
  776.     definitely want to give it a try.  Look for helld*.zip .  The
  777.     latest version I know of is 1.07 .
  778.  
  779.  
  780. MISCELLANEOUS
  781.  
  782. 1. How can I set my mail and news signatures to be different ?
  783.  
  784.         It's built-in already.
  785.         The mailsig file is for mail, the sig file is for news.
  786.  
  787.         The \waffle\system\sig file gets inserted if it's there and you
  788.         don't have a personal sig or mailsig file.
  789.  
  790.     If you want to be able to pick which sig goes on which message,
  791.     try Roy Silvernail's APPSIG.ZIP .
  792.  
  793. 2. Why doesn't /waffle/system/mailsig work?
  794.  
  795.     The different names are only for the user's personal signature.
  796.     If you have a system default signature, /waffle/system/sig, it
  797.     is applied to *all* messages.
  798.  
  799. 3. Can I use 16-bit compression ?
  800.  
  801.         Sure, if you have enough memory and can find a 16-bit compression
  802.     program.
  803.  
  804.         One is provided with 1.65 and there are a variety of add-in
  805.         16-bit compress programs for 1.64 and earlier available on SIMTEL.
  806.  
  807.         If you use 16-bit compress, be sure you have the 'compress' flag
  808.         in the static file set correctly for the compress you're using.
  809.     See \waffle\docs\comp16.doc .
  810.  
  811. 4. What are all those files in \waffle\* anyway ?
  812.  
  813.     See \waffle\docs\roadmap.doc for descriptions of almost every
  814.     file that comes with the software.
  815.  
  816. 5. What document in \waffle\docs contains what ?
  817.  
  818.     \waffle\docs\index.doc has the table of contents of each of
  819.     the other documents.  Use a text editor or something similar
  820.     to look for keywords in index.doc, then it will point you to
  821.     which file to look in.
  822.  
  823.     If you have a version of the UNIX utility "grep", it's best
  824.     to do something like "grep keyword \waffle\docs\*", to find
  825.     even obscure references to things.
  826.  
  827.     You'll find a lot of neat but obscure references in HISTORY.DOC.
  828.  
  829. 6. Can I alter my headers after composing a message ?
  830.  
  831.         Some of them are editable in 1.65 via the 'alter' static parameter.
  832.     Don't put "To:", "CC:" or "Newsgroups:" in 'alter'; it won't work.
  833.  
  834. 7. Does DOS Waffle support control messages ?
  835.  
  836.         Other than cancelling a message you posted that hasn't been
  837.         batched up yet, no.  You might want to look at the contents of
  838.     the control newsgroup once in a while to see what control
  839.     messages you received that Waffle didn't process.
  840.  
  841.     There's a program called procc, "PROCess Control" which will
  842.     handle control messages for you.  Look for procc-NN.zip where
  843.     NN is the version number.
  844.  
  845.  
  846. WAFFLE BUGS
  847.  
  848. As with any large system, Waffle has bugs.  Since the source is available,
  849. some users have fixed some of the bugs that have cropped up.  In this
  850. section, the notation "Patch: <user>" means that the mentioned user has
  851. a patch to the source code available that will fix the problem.  You need
  852. to already have the source code for this to be useful to you.  "BPatch: <user>"
  853. means that the mentioned user has a binary patch available, which anyone
  854. should be able to use.  "Fixed: 1.xx" means that the bug is fixed as of
  855. the mentioned version.  "Workaround:" means that there is a way to avoid
  856. the bug in normal operation.
  857.  
  858. 1. When I mail to a | post alias from within Waffle, it only posts the headers.
  859.  
  860.     This is a bug having to do with external editors.
  861.     Workaround: use the internal editor when mailing to such an alias.
  862.     Patch: fenner@cs.psu.edu
  863.     Fixed: 1.66
  864.  
  865. 2. When I mail to a | post alias from within Waffle, it only works the first
  866.     time, the second time it doesn't do *anything*.
  867.  
  868.     Workaround: none known.
  869.     Patch: fenner@cs.psu.edu
  870.     Fixed: 1.66
  871.  
  872. 3. I configured my modem to work with FAX, but Waffle keeps saying
  873.     [Hayes code -2] and hangs up.
  874.  
  875.     This occurs if you have Auto-ATA: in your static file.
  876.     Workaround: make your modem answer the phone (no Auto-ATA: in the
  877.         static file and ATS0=1 in the initialize string).
  878.     Patch: fenner@cs.psu.edu
  879.     Fixed: 1.66
  880.  
  881. 4. I have personal aliases for "mom" and "dad", and when I type "mail mom dad"
  882.     Waffle complains "No such user", even though I can type "mail mom" or
  883.     "mail dad" and it works fine.
  884.  
  885.     Waffle's implementation of personal aliases isn't complete.
  886.     Workaround: put the aliases in /waffle/system/aliases
  887.     WARNING: This makes your aliases available to all users, so
  888.      *be* *careful* with what you put there.
  889.  
  890.  
  891. TRANSITION TO 1.65
  892.  
  893. 1. I updated my config files, but they didn't work.
  894.  
  895.         Some of the config files, notably 'paths', moved in 1.65 to the
  896.         new \waffle\uucp directory.  Make sure you aren't editing the file
  897.         in the old 1.64 location.
  898.  
  899. 2. I'm going to run makebox.  Anything I should know ?
  900.  
  901.         Yes.  Makebox deletes the old mail files after it assembles the 
  902.     new mailbox.  If you're paranoid, you might want to zip up your 
  903.     1.64 mail messages before running makebox if you're not sure you'll 
  904.     stay at 1.65.
  905.  
  906.     If you screw up, try to find a copy of "explode.zip" (it's on
  907.     halcyon.com in /pub/waffle/mail); it will take a 1.65 mailbox
  908.     back to 1.64 format.
  909.  
  910. 3. 1.65 sure seems scary, why should I bother?
  911.  
  912.         Lots of reasons.  See history.doc and release.165 for details.
  913.  
  914.     Of course, if you're happy with the version you run, there's
  915.     not a lot of rush to get updated, though most of the c.b.w.
  916.     readers keep at the current version and you'll get better help
  917.     from c.b.w.  by staying current.  There are still some Waffle
  918.     sites at v1.61 (!!!).
  919.