Cleanup.

Author: wb2osz

conf/generic.conf

@@ -29,16 +29,21 @@
 %C%# Extensive documentation can be found here:
 %C%# Stable release -       https://github.com/wb2osz/direwolf/tree/master/doc
 %C%# Latest development -   https://github.com/wb2osz/direwolf/tree/dev/doc
+%C%# Additional topics -    https://github.com/wb2osz/direwolf-doc
 %C%#
-%W%# The complete documentation set can also be found in the doc folder.
-%L%# The complete documentation set can also be found in
+%W%# The basic documentation set can also be found in the doc folder.
+%L%# The basic documentation set can also be found in
 %L%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
 %L%# Concise "man" pages are also available for Linux.
 %M%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
 %M%# Concise "man" pages are also available for Mac OSX.
 %C%#
+%C%# Questions???  Join the discussion forum:  https://groups.io/g/direwolf
+%C%#
+%C%#
 %C%# This sample file does not have examples for all of the possibilities.
-%C%# Consult the User Guide for more details on configuration options.%C%#
+%C%# Consult the User Guide for more details on configuration options
+%C%# and other documents for more details for different uses.
 %C%#
 %C%# These are the most likely settings you might change:
 %C%#
@@ -231,14 +236,14 @@
 %C%# It can be up to 6 letters and digits with an optional ssid.
 %C%# The APRS specification requires that it be upper case.
 %C%#
-%C%# Example (don't use this unless you are me):  MYCALL	WB2OSZ-5
+%C%# Example (don't use this unless you are me):  MYCALL WB2OSZ-5
 %C%#
 %C%
 %C%MYCALL N0CALL
 %C%
 %C%#
 %C%# Pick a suitable modem speed based on your situation.
-%C%#	1200 	Most common for VHF/UHF.  Default if not specified.
+%C%#	1200 	Most common for VHF/UHF.  This is the default if not specified.
 %C%#	2400	QPSK compatible with MFJ-2400, and probably PK232-2400 & KPC-2400.
 %C%#	300	Low speed for HF SSB.  Default tones 1600 & 1800.
 %C%#	EAS	Emergency Alert System (EAS) Specific Area Message Encoding (SAME).
@@ -263,6 +268,10 @@
 %C%
 %C%#DTMF
 %C%
+%C%# Push to Talk (PTT) can be confusing because there are so many different cases.
+%C%# Radio-Interface-Guide.pdf  in  https://github.com/wb2osz/direwolf-doc
+%C%# goes into detail about the various options.
+%C%
 %L%# If using a C-Media CM108/CM119 or similar USB Audio Adapter,
 %L%# you can use a GPIO pin for PTT control. This is very convenient
 %L%# because a single USB connection is used for both audio and PTT.
@@ -290,6 +299,7 @@
 %C%#PTT COM1 RTS
 %C%#PTT COM1 RTS -DTR
 %L%#PTT /dev/ttyUSB0 RTS
+%L%#PTT /dev/ttyUSB0 RTS -DTR
 %C%
 %L%#
 %L%# On Linux, you can also use general purpose I/O pins if
@@ -301,7 +311,7 @@
 %L%
 %L%#PTT GPIO 25
 %L%
-%C%# The Data Carrier Detect (DCD) signal can be sent to the same places
+%C%# The Data Carrier Detect (DCD) signal can be sent to most of the same places
 %C%# as the PTT signal.  This could be used to light up an LED like a normal TNC.
 %C%
 %C%#DCD COM1 -DTR
@@ -374,7 +384,6 @@
 %C%#
 %C%#	0 - Don't try to repair.
 %C%#	1 - Attempt to fix single bit error.  (default)
-%C%#	... see User Guide for more values and in-depth discussion.
 %C%#
 %C%
 %C%#FIX_BITS 0
@@ -399,15 +408,21 @@
 %C%# Example:
 %C%#
 %C%# This results in a broadcast once every 10 minutes.
-%C%# Every half hour, it can travel via two digipeater hops.
+%C%# Every half hour, it can travel via one digipeater hop.
 %C%# The others are kept local.
 %C%#
 %C%
-%C%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1,WIDE2-1
+%C%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1
 %C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
 %C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
 %C%
-%C%
+%C%#
+%C%# Did you know that APRS comments and messages can contain UTF-8 characters, not only plain ASCII?
+%C%#
+%C%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xe0\xb8\xa7\xe0\xb8\xb4\xe0\xb8\x97\xe0\xb8\xa2\xe0\xb8\xb8\xe0\xb8\xaa\xe0\xb8\xa1\xe0\xb8\xb1\xe0\xb8\x84\xe0\xb8\xa3\xe0\xb9\x80\xe0\xb8\xa5\xe0\xb9\x88\xe0\xb8\x99"
+%C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xce\xa1\xce\xb1\xce\xb4\xce\xb9\xce\xbf\xce\xb5\xcf\x81\xce\xb1\xcf\x83\xce\xb9\xcf\x84\xce\xb5\xcf\x87\xce\xbd\xce\xb9\xcf\x83\xce\xbc\xcf\x8c\xcf\x82"
+%C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xe3\x82\xa2\xe3\x83\x9e\xe3\x83\x81\xe3\x83\xa5\xe3\x82\xa2\xe7\x84\xa1\xe7\xb7\x9a"
+%C%#
 %C%# With UTM coordinates instead of latitude and longitude.
 %C%
 %C%#PBEACON delay=1 every=10 overlay=S symbol="digi" zone=19T easting=307477 northing=4720178
@@ -448,12 +463,6 @@
 %C%# See User Guide for more explanation of what this means and how
 %C%# it can be customized for your particular needs.
 %C%
-%C%# Filtering can be used to limit was is digipeated.
-%C%# For example, only weather weather reports, received on channel 0,
-%C%# will be retransmitted on channel 1.
-%C%#
-%C%
-%C%#FILTER 0 1 t/wn
 %C%
 %C%# Traditional connected mode packet radio uses a different
 %C%# type of digipeating.  See User Guide for details.
@@ -487,6 +496,7 @@
 %C%# without sending it over the air and relying on someone else to
 %C%# forward it to an IGate server.  This is done by using sendto=IG rather
 %C%# than a radio channel number. Overlay R for receive only, T for two way.
+%C%# There is no need to send it as often as you would over the radio.
 %C%
 %C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=R lat=42^37.14N long=071^20.83W
 %C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=T lat=42^37.14N long=071^20.83W
@@ -502,6 +512,7 @@
 %C%# The IGate function will limit the number of packets transmitted
 %C%# during 1 minute and 5 minute intervals.   If a limit would
 %C%# be exceeded, the packet is dropped and message is displayed in red.
+%C%# This might be low for APRS Thursday when there is abnormally high activity.
 %C%
 %C%IGTXLIMIT 6 10
 %C%