[Asterisk-doc] nit picks

[Randy Resnick]

Hi folks,

I've been reading the latest version and I'm impressed by how clear and 
polished the book has become. I found a few things I question, though.
To be brief (I'll refer to the printed page number of the PDF from a few 
days ago):

p24 adding an FXO

channel => 2 (wrong)

but then next page, channel => 4 (correct)

If you're gonna mention switchtype it should be explained, and I believe 
a word on context should be there as well. I would recommend not using 
default as a context since it's um, the default. Suppose it was 
"context=POTS-incoming"

The line 'context=POTS-incoming' serves to route the call in the 
dialplan, sending it to the context of that name. In order for this to 
work, incoming calls on the FXO will need to have at least an 's' 
extension under [POTS-incoming] in our extensions.conf dialplan.

p25 IAX

Why do we see the 5036 port for IAX and not IAX2? This is a major source 
of confusion for newbies and I don't think they need to know about IAX1. 
Here, and in the SIP discussion, bindaddr is used but I've run asterisk 
for a year with iax.conf starting like this:

;port=5036
;port=4569
;bindaddr=192.168.0.5

Effectively I have none of these statements, so asterisk must use the 
right defaults, 4569 fo the port and 0.0.0.0 for the bindaddr. For a new 
learner, wouldn't it make sense to remove these? Won't asterisk work in 
most cases with the defaults?

p42 In the [prompts] context after introducing the use of authenticate, 
IMO the whole prompts context should be reshown, because we don't need 
to answer again and the extensions and the extensions and priorities 
will be different. Besides the needless answer(), the rest of [prompts] 
needs to be changed for the example to work. Eew, examples that don't 
work. Not good. :)

If I'm wrong, I stand corrected, if I'm right I hope this is useful.

rr