Clean up sample direwolf.conf file.

Author: wb2osz

conf/generic.conf

@@ -12,7 +12,7 @@
 %R%	The sample config file was getting pretty messy
 %R%	with the Windows and Linux differences.
 %R%	It would be a maintenance burden to keep most of
-%R%	two different versions in sync.
+%R%	three different versions in sync.
 %R%	This common source is now used to generate the
 %R%	three different variations while having only a single
 %R%	copy of the common parts.
@@ -38,8 +38,12 @@
 %M%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
 %M%# Concise "man" pages are also available for Mac OSX.
 %C%#
-%C%# Recommended Reading for everyone:
-%C%# "Understanding APRS Packets"  in https://github.com/wb2osz/aprsspec
+%C%#########################################################################
+%C%#                                                                       #
+%C%# Recommended Reading for everyone:                                     #
+%C%# "Understanding APRS Packets"  in https://github.com/wb2osz/aprsspec   #
+%C%#                                                                       #
+%C%#########################################################################
 %C%#
 %C%#
 %C%# Questions???  Join the discussion forum:  https://groups.io/g/direwolf
@@ -54,19 +58,17 @@
 %C%#	(1)   	MYCALL 	-  call sign and SSID for your station.
 %C%#
 %C%#			Look for lines starting with MYCALL and
-%C%#			change NOCALL to your own.
+%C%#			change NOCALL to your own callsign and optional SSID.
 %C%#
 %C%#	(2)	PBEACON	-  enable position beaconing.
 %C%#
 %C%#			Look for lines starting with PBEACON and
-%C%#			modify for your call, location, etc.
+%C%#			modify for your location, symbol, comment, etc.
 %C%#
 %C%#	(3)	DIGIPEATER  -  configure digipeating rules.
 %C%#
 %C%#			Look for lines starting with DIGIPEATER.
-%C%#			Most people will probably use the given example.
-%C%#			Just remove the "#" from the start of the line
-%C%#			to enable it.
+%C%#			Most people will probably use of of the two examples.
 %C%#
 %C%#	(4)	IGSERVER, IGLOGIN  - IGate server and login
 %C%#
@@ -104,7 +106,7 @@
 %C%#
 %C%#
 %C%# Many examples of radio interfaces and PTT options can be found in: 
-%C%# https://github.com/wb2osz/direwolf-doc/blob/main/Radio-Interface-Guide.pdf
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf
 %C%#
 %C%#
 %R% ---------- Windows ----------
@@ -179,7 +181,7 @@
 %M%#
 %M%
 %C%# Many more details and examples can be found in: 
-%C%# https://github.com/wb2osz/direwolf-doc/blob/main/Radio-Interface-Guide.pdf
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf
 %C%
 %C%#############################################################
 %C%#                                                           #
@@ -193,7 +195,7 @@
 %C%# Station identifier for this channel.
 %C%# Multiple channels can have the same or different names.
 %C%#
-%C%# It can be up to 6 letters and digits with an optional ssid.
+%C%# It can be up to 6 letters and digits with an optional ssid in range of 1 to 15.
 %C%# The APRS specification requires that it be upper case.
 %C%#
 %C%# Example (don't use this unless you are me):  MYCALL WB2OSZ-5
@@ -223,7 +225,7 @@
 %C%#
 %C%
 %C%# Push to Talk (PTT) can be confusing because there are so many different cases.
-%C%# https://github.com/wb2osz/direwolf-doc/blob/main/Radio-Interface-Guide.pdf
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf
 %C%# goes into detail about the various options.
 %C%
 %C%# If using a C-Media CM108/CM119 or similar USB Audio Adapter,
@@ -236,7 +238,7 @@
 %C%
 %C%# There are other possibilities such as serial port RTS, Raspberry Pi GPIO pins,
 %C%# and hamlib for CAT control.   For more details see:
-%C%# https://github.com/wb2osz/direwolf-doc/blob/main/Radio-Interface-Guide.pdf
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf
 %C%
 %C%
 %C%#############################################################
@@ -271,17 +273,19 @@
 %C%# Each has a series of keywords and values for options.
 %C%# See User Guide for details.
 %C%#
-%C%# Example:  PLEASE change the latitude and longitude.  
-%C%#
+%C%# Example:  Change the latitude and longitude or your location
+%C%#           will show you about to go over Niagara Falls.
 %C%
-%C%#PBEACON overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
+%C%#PBEACON lat=43.077104 long=-79.075674 symbol="canoe" comment="Niagara Falls"
 %C%
+%C%# Run "direwolf -S" (upper case S) to get a list of symbols that can
+%C%# be used rather than "canoe."  Specify a unique substring of description.
 %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%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=43.077104 long=-79.075674 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=43.077104 long=-79.075674 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=43.077104 long=-79.075674 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%
 %C%#############################################################
@@ -291,14 +295,15 @@
 %C%#############################################################
 %C%
 %C%#
-%C%# For most common situations, use something like this by removing
-%C%# the "#" from the beginning of the line below.
-%C%#
+%C%# Remove the "#" from the beginning of the first digipeat below for short range fill-in digi
+%C%# or remove the "#" from the beginning of the second digipeat below for wide area digi.
 %C%
+%C%#DIGIPEAT 0 0 ^TEST$ ^WIDE1-1$
 %C%#DIGIPEAT 0 0 ^WIDE[3-7]-[1-7]$|^TEST$ ^WIDE[12]-[12]$
 %C%
-%C%# See User Guide and "APRS-Digipeaters.pdf" for more explanation of what
-%C%# this means and how it can be customized for your particular needs.
+%C%# See https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/APRS-Digipeaters.pdf
+%C%# and User Guide for more explanation of what this means and
+%C%# how it can be customized for your particular needs.
 %C%
 %C%
 %C%# Traditional connected mode packet radio uses a different
@@ -334,7 +339,8 @@
 %C%
 %C%#IGTXVIA 0 WIDE1-1,WIDE2-1
 %C%
-%C%# For more information see Successful-IGate-Operation.pdf.
+%C%# For more information see
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Successful-APRS-IGate-Operation.pdf
 %C%
 %C%
 %C%#############################################################
@@ -345,8 +351,8 @@
 %C%
 %C%#
 %C%# Dire Wolf can receive DTMF (commonly known as Touch Tone)
-%C%# messages and convert them to packet objects.
+%C%# messages and convert them to packet objects.  Details in:
 %C%#
-%C%# See separate "APRStt-Implementation-Notes" document for details.
+%C%# https://raw.githubusercontent.com/wb2osz/direwolf/master/doc/APRStt-Implementation-Notes.pdf
 %C%#