diff --git a/docs/v3cfgfaq.txt b/docs/v3cfgfaq.txt
index fec3e3119ea29cc1ca70a91ed5eeb8a58dfe7cfc..7ebf8c2d26bbc4ac209a4b184b1284019db8b93a 100644
--- a/docs/v3cfgfaq.txt
+++ b/docs/v3cfgfaq.txt
@@ -1,46 +1,19 @@
Answers to frequently asked questions re: configuring Synchronet Version 3
- by Rob Swindell (digital man), May 2000, last updated October 2001
-
-Q: The SBBSCTRL:BBS->Login menu option isn't working for me.
-A: The default local login command in v3.00 ("start telnet://localhost") does
- not work on NT-based OSes (including Win2K and WinXP). If you're running
- v3.00, run REGEDIT and go into
- HKEY_CURRENT_USER\Software\Swindell\Synchronet Control Panel
- and change "LoginCommand" to "telnet localhost" or "mtel localhost" or
- whatever your favorite telnet client is.
-
- If you're running v3.10e or later, then the "start telnet://localhost"
- command line should work (start up your registered telnet client).
-
-Q: The SBBSCTRL:BBS->Configure menu option isn't working for me.
-A: SCFG and SCFG32 are console-mode programs that only work in an 80x25
- console window. If you're seeing the message "USCRN failed!" that means
- you probably have your default console window set to a dimensions larger
- than 80x25.
-
- You can fix this on Windows NT/2K/XP by adjusting the properties of your
- System32\command.pif file. Make sure "restore settings at startup"
- (under the "Screen" tab) is not checked. Also, make sure the screen buffer
- size is no larger than the screen window size (80x25).
+ by Rob Swindell (digital man), May 2000, last updated January 2003
Q: I want to create custom menus. Is there any detailed documentation or
samples regarding custom menus on Synchronet?
-A: Yes, see http://synchro.net/docs/customization.html and
- http://synchro.net/docs/baja.html for details.
+A: Yes, see http://synchro.net/docs/customization.html,
+ http://synchro.net/docs/baja.html and http://synchro.net/docs/js.html
+ for details.
Q: How do I join DOVE-Net?
-A: If you've installed v3.00, Telnet to vert.synchro.net and create a new
+A: If you've installed v3.10, Telnet to vert.synchro.net and create a new
account for your QWKnet transfers (using your system's QWK-ID for the user
- name), then edit the file VERT.FTP in your EXEC directory, replacing the
- qwk-id and password with the username and password you created on
- Vertrauen.
- If you've upgraded to v3.00e or later, you'll probably want to use the
- new QNET-FTP Baja module instead of the old VERT.BAT/VERT.FTP scripts.
- See exec/qnet-ftp.src for instructions.
- If you're running an older version of Synchronet (or upgraded to v3.0b),
- then you'll need to create the message areas and QWKnet hub information in
- SBBSCTRL:BBS->Configure->Networks->QWK Packet Networks->Network Hubs.
- See DOVE-NET.ZIP for details.
+ name), then edit your "Call-out Command Line" in SCFG->Networks->QWK->Hubs
+ ->VERT: replace "YOURPASS" with the password you used when creating your
+ QWKnet user account. Do NOT change anything else in the command-line!
+ That's it! For more details, see DOCS/DOVE-NET.TXT.
Q: What is my system's QWK-ID?
A: This is normally an abbreviation of your BBS's name that YOU determine
@@ -73,10 +46,12 @@ A: I don't know of any doors, but I do know of several newsgroup<->fido
gateway packages: newsgate, gigo, internet rex, and many others.
A: You can also try MerlinSystem's NetXpress Usenet Gateway for Synchronet
(nx-sync, it's free): http://www.binaryh.com/merlinsys/
-A: Internal NNTP support for Synchronet is planned for the near future.
+A: Synchronet v3.10 comes with NewsLink, an external JavaScript module for
+ importing and exporting messages via NNTP (Network News Transfer Protocol).
+ Just edit your ctrl/newslink.cfg file to get started.
-Q: How do keep external programs (doors) from popping up windows and stealing
- the keyboard/mouse focus?
+Q: How do I keep external programs (doors) from popping up windows and
+ stealing the keyboard/mouse focus?
A: Check SBBSCTRL:Telnet->Configure->Minimize Externals.
Q: How do I set additional nodes for telnet access?
@@ -86,37 +61,6 @@ A: Create the additional nodes in SBBSCTRL:BBS->Configure->Nodes if you
configuration information is ignored). Set SBBSCTRL:Telnet->Config->Last
Node to highest node number you want available for telnet logins.
-Q: How come some of the times diplayed are off by exactly one hour?
-A: There is a time-zone bug in the Microsoft Visual C++ run-time library I'm
- using in Synchronet v3 related to day-light savings time. Those of you
- using v3 in a timezone which has daylight savings, may see a different time
- in the BBS (ctrl-T for example) than you do in SBBSCTRL or your system tray.
-
- You can fix the problem by removing Windows' knowledge of daylight savings
- altogether (which I think is a dumb idea to begin with). You need to run
- TZEDIT which is included on the Win98 CD in the tools\reskit\config
- directory. It's included with Win95 OSR2 in the Admin\Apptools\Tzedit
- directory. Anyway, run tzedit, select your time-zone from the list (it
- should already be selected), click the "Edit" button, and UN-CHECK the
- "Automatically set Daylight Savings Time" check box. Then clck OK, then
- click CLOSE.
-
- Now, you need to RE-SELECT the time-zone by double-clicking the time in your
- system-tray (lower right corner) or by re-selecting the time zone in the
- control panel. Now when you run Synchronet and user logs on (for example),
- the times should all be correct.
-
-Q: I get an error message that contains "file: c:\src\sbbs3\etc" or something
- similar but I do not have Synchronet installed on drive C or that path does
- not exist?
-A: The "Source" or "File" portion of the error message is for the author's
- reference only and has nothing to do with your Synchronet configuration. The
- file path in question was the original source code file where the error
- occured, which you do not need to concern yourself with (unless you are
- modifying the source code). Send the ENTIRE error message (as shown in your
- data/error.log file) to the author if you still have any questions or
- concerns that aren't answered here or in the sysop documentation.
-
Q: How do I add files to the file database?
A: The easiest way is to use the ADDFILES utility which can automatically
detect and import embedded descriptions (e.g. FILE_ID.DIZ). See the
@@ -124,14 +68,23 @@ A: The easiest way is to use the ADDFILES utility which can automatically
chapter for details. No, a files.bbs list is not necessary for adding
files. Use "ADDFILES * /DIZ" to search all directories for a new files.bbs,
import any embedded descriptions (e.g. FILE_ID.DIZ), and delete the file.bbs
- after importing it.
-
-Q: My long filenames aren't appearing correctly on the BBS?
-A: The Synchronet file database currently only supports the DOS 8.3 naming
- format. Longer filenames will be shown in their Micros~1 mangled form.
- The Synchronet FTP server does automatically detect and display long
- filenames, however. Long filenames will be supported in the BBS/Telnet
- server in a future release.
+ after importing it. If you don't have a file list (e.g. files.bbs) to import
+ just use "ADDFILES * /SZN" to search all directories for new files and use
+ embedded (FILE_ID.DIZ) description files, if they exist.
+
+Q: Long filename support doesn't seem to fully functional.
+A: Support for files with long filenames (greater than the MS-DOS 8.3 format)
+ is a work in the progress. There are two main issues:
+ A: The current file database format only supports 8.3 filenames.
+ B: The only X/Y/Zmodem file transfer program that currently works with
+ Synchronet-Win32 is FDSZ, which is a 16-bit DOS programs (which therefore
+ only supports 8.3 format filenames).
+ Synchronet v3.10 will display long filenames, but the files must be added to
+ the database using a means other than X/Y/Zmodem (at this time).
+ The file database format is being replaced in v3.20 and will store long
+ filenames as well as many other improvements.
+ There is work being done to create a good 32-bit Winsock alternative to FDSZ
+ that will support long filenames as well as consume less resources.
Q: How do I enable forced upload/download ratios.
A: By default, Synchronet utilizes a "credit" system, where a user typically
@@ -165,26 +118,6 @@ Q: When I run SBBSCTRL it asks me for the path to MAIN.CNF, but I don't have
A: You've installed the v3 upgrade without installing v2.3 first. Install
Synchronet v2.3 (SBBS230?.ZIP) first, then apply the upgrade.
-Q: File transfers (DSZ) aren't working.
-A: You need to use FDSZ (FOSSIL version of DSZ) in place of DSZ:
- 1. Verify you have FDSZ.EXE in your Synchronet EXEC directory.
- 2. Change the command lines in SBBSCTRL:BBS->Configure->File Options->
- Transfer Protocols from "%!dsz ..." to "%!fdsz ...".
-A: If you're using an NT-based OS (including Win2K and WinXP), you'll need
- to upgrade to v3.10e or later to get the fix for Zmodem transfers.
-
-Q: Why do I get an SBBS.DLL error about missing GetDiskFreeSpaceEx?
-A: You're attempting to run Synchronet v3.0 on pre-OSR2 Windows 95 or Windows
- NT 3.x. Support for pre-OSR2 Windows 95 was added in Synchronet v3.00c.
- See http://www.synchro.net/platforms.html for a matrix of supported
- platforms.
-
-Q: Can I run version 3 under Windows NT4/2000?
-A: The first beta release (v3.00a) did not include a FOSSIL/DOS interrupt
- driver for NT/2000, so only Windows 95/98 was fully supported. Version
- 3.00b includes a FOSSIL/DOS interrupt driver for NT4/2000. If running under
- NT4/2000, see NTREADME.TXT for configuration details.
-
Q: My CPU/kernel-utilization meter reports 100% when a user is online and
entering a string/line of text.
A: Set SBBSCTRL:BBS->Configure->Nodes->Node X->Toggle Options->Low Priority
@@ -214,7 +147,7 @@ A: Make sure you have "Intercept I/O Interrupts" set to "No" for all FOSSIL
doors in SBBSCTRL:BBS->Configure->External Programs->Online Programs
(this includes Synchronet Match Maker v2.x).
Make sure you have the appropriate startup directory, command line, and
- drop file options set in SCFG. See SBBSDOOR.ZIP for specific instructions
+ drop file options set in SCFG. See SBBSDOOR.TXT for specific instructions
on setting up some popular door games (i.e. LORD, BRE, GlobalWar, TW2002).
Make sure you DO NOT have any FOSSIL drivers loaded (including X00, BNU,
ADF, COM/IP, WinFOSSIL, or NetModem) as they will conflict with
@@ -224,15 +157,6 @@ A: Make sure you have "Intercept I/O Interrupts" set to "No" for all FOSSIL
FOSSIL driver is automatically configured and loaded when needed - there
is nothing you need to do to install or load the Synchronet FOSSIL driver.
-Q: How do I get Synchronet to create a DOOR32.SYS drop file?
-Q: How do I tell Synchronet that a program is 32-bit?
-A: Add the program's base filename to SBBSCTRL:BBS->Configure->External
- Programs->OS/2 Program List (this is actually the native 32-bit program
- list). If you specified the executable file extension (e.g. ".exe") on
- the program's command-line, then you'll also need to include the
- filename with the extension in the 32-bit Program List.
- This process will be improved greatly in a future version of Synchronet.
-
Q: SyncEdit isn't working correctly.
A: See the file SYEDTFAQ.TXT for details.
@@ -248,10 +172,114 @@ A: Synchronet version 3 no longer uses Scroll-Lock to indicate sysop
availability. Instead, there is a button on the SBBSCTRL tool bar and on
the BBS menu to toggle the sysop availability for chat (added in v3.00b).
+Q: Is there any updated documentation for Synchronet v3?
+Q: The documentation I have (sysop.doc) appears to be for v2.3 for DOS/OS2?
+Q: Do you have documentation that is easier for me to view/print/etc?
+A: Yes, the documentation included in Synchronet v3.00b was the same old
+ SYSOP.DOC (ASCII text file) created for Synchronet for DOS and OS/2 v2.30.
+ It was reformatted in HTML and updated for version 3.00c (as of
+ December 2000). You can view the progress of the Synchronet Documentation
+ project at: http://synchro.net/docs. Contributors are welcome!
+ The Synchronet HTML docs have been converted to PDF for your
+ viewing/printing pleasure and can be downloaded @ vert.synchro.net.
+
+*** OLD (ver 3.0) ANSWERS TO FREQUENTLY ASKED QUESTIONS ***
+
+Q: The SBBSCTRL:BBS->Login menu option isn't working for me.
+A: The default local login command in v3.00 ("start telnet://localhost") does
+ not work on NT-based OSes (including Win2K and WinXP). If you're running
+ v3.00, run REGEDIT and go into
+ HKEY_CURRENT_USER\Software\Swindell\Synchronet Control Panel
+ and change "LoginCommand" to "telnet localhost" or "mtel localhost" or
+ whatever your favorite telnet client is.
+
+ If you're running v3.10e or later, then the "start telnet://localhost"
+ command line should work (start up your registered telnet client).
+
+Q: The SBBSCTRL:BBS->Configure menu option isn't working for me.
+A: SCFG and SCFG32 are console-mode programs that only work in an 80x25
+ console window. If you're seeing the message "USCRN failed!" that means
+ you probably have your default console window set to a dimensions larger
+ than 80x25.
+
+ You can fix this on Windows NT/2K/XP by adjusting the properties of your
+ System32\command.pif file. Make sure "restore settings at startup"
+ (under the "Screen" tab) is not checked. Also, make sure the screen buffer
+ size is no larger than the screen window size (80x25).
+
+Q: How come some of the times diplayed are off by exactly one hour?
+A: There is a time-zone bug in the Microsoft Visual C++ run-time library I'm
+ using in Synchronet v3 related to day-light savings time. Those of you
+ using v3 in a timezone which has daylight savings, may see a different time
+ in the BBS (ctrl-T for example) than you do in SBBSCTRL or your system tray.
+
+ You can fix the problem by removing Windows' knowledge of daylight savings
+ altogether (which I think is a dumb idea to begin with). You need to run
+ TZEDIT which is included on the Win98 CD in the tools\reskit\config
+ directory. It's included with Win95 OSR2 in the Admin\Apptools\Tzedit
+ directory. Anyway, run tzedit, select your time-zone from the list (it
+ should already be selected), click the "Edit" button, and UN-CHECK the
+ "Automatically set Daylight Savings Time" check box. Then clck OK, then
+ click CLOSE.
+
+ Now, you need to RE-SELECT the time-zone by double-clicking the time in your
+ system-tray (lower right corner) or by re-selecting the time zone in the
+ control panel. Now when you run Synchronet and user logs on (for example),
+ the times should all be correct.
+
+Q: I get an error message that contains "file: c:\src\sbbs3\etc" or something
+ similar but I do not have Synchronet installed on drive C or that path does
+ not exist?
+A: The "Source" or "File" portion of the error message is for the author's
+ reference only and has nothing to do with your Synchronet configuration. The
+ file path in question was the original source code file where the error
+ occured, which you do not need to concern yourself with (unless you are
+ modifying the source code). Send the ENTIRE error message (as shown in your
+ data/error.log file) to the author if you still have any questions or
+ concerns that aren't answered here or in the sysop documentation.
+
+Q: My long filenames aren't appearing correctly on the BBS?
+A: The Synchronet file database currently only supports the DOS 8.3 naming
+ format. Longer filenames will be shown in their Micros~1 mangled form.
+ The Synchronet FTP server does automatically detect and display long
+ filenames, however. Long filenames will be supported in the BBS/Telnet
+ server in a future release (v3.10).
+
+Q: File transfers (DSZ) aren't working.
+A: You need to use FDSZ (FOSSIL version of DSZ) in place of DSZ:
+ 1. Verify you have FDSZ.EXE in your Synchronet EXEC directory.
+ 2. Change the command lines in SBBSCTRL:BBS->Configure->File Options->
+ Transfer Protocols from "%!dsz ..." to "%!fdsz ...".
+A: If you're using an NT-based OS (including Win2K and WinXP), you'll need
+ to upgrade to v3.10e or later to get the fix for Zmodem transfers.
+
+Q: Why do I get an SBBS.DLL error about missing GetDiskFreeSpaceEx?
+A: You're attempting to run Synchronet v3.0 on pre-OSR2 Windows 95 or Windows
+ NT 3.x. Support for pre-OSR2 Windows 95 was added in Synchronet v3.00c.
+ See http://www.synchro.net/platforms.html for a matrix of supported
+ platforms.
+
+Q: Can I run version 3 under Windows NT4/2000?
+A: The first beta release (v3.00a) did not include a FOSSIL/DOS interrupt
+ driver for NT/2000, so only Windows 95/98 was fully supported. Version
+ 3.00b includes a FOSSIL/DOS interrupt driver for NT4/2000. If running under
+ NT4/2000, see NTREADME.TXT for configuration details.
+
+Q: How do I get Synchronet to create a DOOR32.SYS drop file?
+A: In v3.10, you just select "Door32.sys" from the drop file list.
+
+Q: How do I tell Synchronet that a program is 32-bit?
+A: Add the program's base filename to SBBSCTRL:BBS->Configure->External
+ Programs->OS/2 Program List (this is actually the native 32-bit program
+ list). If you specified the executable file extension (e.g. ".exe") on
+ the program's command-line, then you'll also need to include the
+ filename with the extension in the 32-bit Program List.
+ In v3.10, you just set "Native Executable" to "Yes".
+
Q: What is SCFG?
A: The Synchronet Configuration Utility (exec/scfg.exe). This 16-bit
console/text-mode program is left-over from Synchronet v2 and is still used
- (as of v3.10) to configure many of the aspects of Synchronet v3
+ (as of v3.0) to configure many of the aspects of Synchronet v3
(SBBSCTRL:BBS->Configure). See http://synchro.net/docs/system_config.html
for details.
@@ -276,18 +304,8 @@ A: The Synchronet Configuration Utility (exec/scfg.exe). This 16-bit
SCFG will fail with a "USCRN failed!" error message when run in a non-80x25
window.
- A GUI re-write of SCFG (for Win32 and Linux) is planned for the near future.
-
-Q: Is there any updated documentation for Synchronet v3?
-Q: The documentation I have (sysop.doc) appears to be for v2.3 for DOS/OS2?
-Q: Do you have documentation that is easier for me to view/print/etc?
-A: Yes, the documentation included in Synchronet v3.00b was the same old
- SYSOP.DOC (ASCII text file) created for Synchronet for DOS and OS/2 v2.30.
- It was reformatted in HTML and updated for version 3.00c (as of
- December 2000). You can view the progress of the Synchronet Documentation
- project at: http://synchro.net/docs. Contributors are welcome!
- The Synchronet HTML docs have been converted to PDF for your
- viewing/printing pleasure and can be downloaded @ vert.synchro.net.
+ SCFG.EXE v3.10 is 32-bit, there is no more SCFG32.EXE. Also, SCFG.EXE is no
+ longer limited to 80x25 text windows.
As always, see the documentation if you have any questions that aren't
answered here: http://synchro.net/docs