[Asterisk-doc] modules instead of config-files

asterisk-doc@lists.digium.com asterisk-doc@lists.digium.com
Thu, 12 Aug 2004 00:53:13 -0400


--Alt-Boundary-2300.381990796
Content-type: text/plain; charset=ISO-8859-1
Content-transfer-encoding: Quoted-printable
Content-description: Mail message body

Nice!

I'm thinking the headings should probably be more descriptive, with perhap=
s the 
technical name in parenthesis. Like this:

6.Modules, or "Things that make Asterisk work." 
	6.1. Core Asterisk configuration 
		6.1.1. Defining file locations (asterisk.conf) 
		6.1.2. The Dialplan (extensions.conf) (see chapters 4 and 5)
		6.1.3. Mysterious Modules (modules.conf) :-=DE
	6.2. Modules 
		6.2.1. CAPI and Asterisk (chan_capi) 
		6.2.2. Configuring ENUM (app_enumlookup) 
		6.2.3. Define H.323 channels and connections (chan_h323) 
(deprecated?)	6.2.4. Define IAX Channels and connections (chan_iax) 
		6.2.5. Define IAX Channels and connections (chan_iax2) 
		6.2.6. Creating Conference Rooms (app_meetme) 
		6.2.7. ISDN4Linux and Asterisk (chan_mISDN) 
(deprecated?)	6.2.8. (chan_oh323) 
		6.2.9. Configuring call parking (app_parkandannounce) 
		6.2.10. SIP accounts and devices (chan_sip) 
		6.2.11. Voicemail (app_voicemail) 
		6.2.12. Voicetronix Cards (chan_vpb) 
(move up?)	6.2.13. Digium Zaptel Cards (chan_zap) 

Also, I figure we should order the modules in some sort of rank based on w=
hat's 
used most (what interests people most). So perhaps:

6.2.1 Digium's Zaptel
6.2.2 Inter Asterisk eXchange (both new and deprecated)
6.2.3 SIP
6.2.4 H.323
6.2.5 Conference Rooms
etc.

Anyhow, I vote to check it in. This is a much more logical foundation to b=
uild from!



On 11 Aug 2004 at 3:04, Martin List-Petersen wrote:

> Hi,
> 
> i've finally taken myself together and made the modifications to chapter
> 6, that i suggested a couple of weeks (months :( ) ago.
> 
> But before i now commit these and start a big flamewar, i want you guys
> to have a look at this first and see, if my suggestion is acceptable.
> 
> I've compiled tonights cvs checkout with my modifications at
> http://loke.home.marlow.dk/~marlow/hgta.pdf and
> http://loke.home.marlow.dk/~marlow/hgta/ (html version). Don't expect
> grand speed on this, it's my adsl at home and there is only 128 kbit
> upstream.
> 
> You will see, that i have made minor modifications to Introductions and
> the "other hardware" appendix (Appendix I) because i feel that this
> information should reside in the rewritten chapter (which is chapter 6,
> originally configuration files, now: Modules, or "Things that make
> Asterisk work.") I have not modified much of the old information from
> the conf-files.xml yet, just moved it to the positions where is should
> reside in the rewritten chapter. chan_zap and the description of
> zaptel.conf was completely written from scratch tonight. zapata.conf
> will follow tomorrow, if this can be accepted in the form it is. If not,
> i will have to move it into the original chapter.
> 
> The "other hardware" appendix should not deal with the different ISDN
> channels drivers etc. but much more concentrate how to implement the
> hardware at the driver level, what i will improve a lot more in the
> following days (for chan_capi, zaphfc/qozap and chan_mISDN).
> 
> The new chapter is called modules.xml, so it will not overwrite the old
> file conf-files.xml, which of course will be marked for deletion from
> the cvs if the changes are accepted and commited, since this new chapter
> has all the information that was in the original one.
> 
> As I have expressed earlier, I feel that describing channel,
> application, etc. and their related config files is the better way to
> go, since one channel driver can have more than one configuration file
> and you usually want to configure one service and everything that is
> related to it.
> 
> Kind regards,
> Martin List-Petersen
> 
> 
> _______________________________________________
> Asterisk-Doc mailing list
> Asterisk-Doc@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-doc
> 
> 


-- 
Jim Van Meggelen
DigitAlchemy
416-574-3164
www.digitalchemy.ca
jim@digitalchemy.ca



--Alt-Boundary-2300.381990796
Content-type: text/html; charset=ISO-8859-1
Content-transfer-encoding: Quoted-printable
Content-description: Mail message body

<?xml  version=3D"1.0" ?><html>
<head>
<title></title>
</head>
<body>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">Ni=
ce!</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">I'=
m thinking the headings should probably be more descriptive, with perhaps =
the 
technical name in parenthesis. Like this:</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
Modules, or &quot;Things that make Asterisk work.&quot; </span></font></di=
v>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.1.=
 Core Asterisk configuration </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.1.1.=
 
Defining file locations (asterisk.conf) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.1.2.=
 
The Dialplan (extensions.conf) (see chapters 4 and 5)</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.1.3.=
 
Mysterious Modules (modules.conf) :-&#222;</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.=
 Modules </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.1.=
 
CAPI and Asterisk (chan_capi) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.2.=
 
Configuring ENUM (app_enumlookup) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.3.=
 
Define H.323 channels and connections (chan_h323) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">(d=
eprecated?)&#160;&#160;&#160;6.2.4. Define IAX Channels and connections (c=
han_iax) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.5.=
 
Define IAX Channels and connections (chan_iax2) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.6.=
 
Creating Conference Rooms (app_meetme) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.7.=
 
ISDN4Linux and Asterisk (chan_mISDN) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">(d=
eprecated?)&#160;&#160;&#160;6.2.8. (chan_oh323) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.9.=
 
Configuring call parking (app_parkandannounce) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.10=
. 
SIP accounts and devices (chan_sip) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.11=
. 
Voicemail (app_voicemail) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">&#=
160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16=
0;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.12=
. 
Voicetronix Cards (chan_vpb) </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">(m=
ove up?)&#160;&#160;&#160;&#160;&#160;&#160;&#160;6.2.13. Digium Zaptel Ca=
rds (chan_zap) </span></font></div>
<div align=3D"left"><br/></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">Al=
so, I figure we should order the modules in some sort of rank based on wha=
t's 
used most (what interests people most). So perhaps:</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
2.1 Digium's Zaptel</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
2.2 Inter Asterisk eXchange (both new and deprecated)</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
2.3 SIP</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
2.4 H.323</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">6.=
2.5 Conference Rooms</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">et=
c.</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">An=
yhow, I vote to check it in. This is a much more logical foundation to bui=
ld from!</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><br/></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">On=
 11 Aug 2004 at 3:04, Martin List-Petersen wrote:</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Hi,</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; i've finally taken myself together and made the modif=
ications to chapter</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; 6, that i suggested a couple of weeks (months :( ) ag=
o.</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; But before i now commit these and start a big flamewa=
r, i want you guys</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; to have a look at this first and see, if my suggestio=
n is acceptable.</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; I've compiled tonights cvs checkout with my modificat=
ions at</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; http://loke.home.marlow.dk/~marlow/hgta.pdf and</span=
></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; http://loke.home.marlow.dk/~marlow/hgta/ (html versio=
n). Don't expect</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; grand speed on this, it's my adsl at home and there i=
s only 128 kbit</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; upstream.</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; You will see, that i have made minor modifications to=
 Introductions and</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; the &quot;other hardware&quot; appendix (Appendix I) =
because i feel that this</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; information should reside in the rewritten chapter (w=
hich is chapter 6,</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; originally configuration files, now: Modules, or &quo=
t;Things that make</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Asterisk work.&quot;) I have not modified much of the=
 old information from</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; the conf-files.xml yet, just moved it to the position=
s where is should</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; reside in the rewritten chapter. chan_zap and the des=
cription of</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; zaptel.conf was completely written from scratch tonig=
ht. zapata.conf</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; will follow tomorrow, if this can be accepted in the =
form it is. If not,</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; i will have to move it into the original chapter.</sp=
an></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; The &quot;other hardware&quot; appendix should not de=
al with the different ISDN</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; channels drivers etc. but much more concentrate how t=
o implement the</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; hardware at the driver level, what i will improve a l=
ot more in the</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; following days (for chan_capi, zaphfc/qozap and chan_=
mISDN).</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; The new chapter is called modules.xml, so it will not=
 overwrite the old</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; file conf-files.xml, which of course will be marked f=
or deletion from</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; the cvs if the changes are accepted and commited, sin=
ce this new chapter</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; has all the information that was in the original one.=
</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; As I have expressed earlier, I feel that describing c=
hannel,</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; application, etc. and their related config files is t=
he better way to</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; go, since one channel driver can have more than one c=
onfiguration file</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; and you usually want to configure one service and eve=
rything that is</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; related to it.</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Kind regards,</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Martin List-Petersen</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; _______________________________________________</span=
></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Asterisk-Doc mailing list</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; Asterisk-Doc@lists.digium.com</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; http://lists.digium.com/mailman/listinfo/asterisk-doc=
</span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><font face=3D"Arial" color=3D"#7f0000"><span style=3D"=
font-size:10pt">&gt; </span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">--=
 </span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">Ji=
m Van Meggelen</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">Di=
gitAlchemy</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">41=
6-574-3164</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">ww=
w.digitalchemy.ca</span></font></div>
<div align=3D"left"><font face=3D"Arial"><span style=3D"font-size:10pt">ji=
m@digitalchemy.ca</span></font></div>
<div align=3D"left"><br/>
</div>
<div align=3D"left"></div>
</body>
</html>

--Alt-Boundary-2300.381990796--