[asterisk-bugs] [Asterisk 0016855]: Template examples in documentation imply well defined overriding semantics, but this is not true

[Asterisk Bug Tracker]

A NOTE has been added to this issue. 
====================================================================== 
https://issues.asterisk.org/view.php?id=16855 
====================================================================== 
Reported By:                davidw
Assigned To:                lmadsen
====================================================================== 
Project:                    Asterisk
Issue ID:                   16855
Category:                   Documentation
Reproducibility:            N/A
Severity:                   text
Priority:                   normal
Status:                     closed
Asterisk Version:           SVN 
JIRA:                       SWP-922 
Regression:                 No 
Reviewboard Link:            
SVN Branch (only for SVN checkouts, not tarball releases):  trunk 
SVN Revision (number only!): 247248 
Request Review:              
Resolution:                 fixed
Fixed in Version:           
====================================================================== 
Date Submitted:             2010-02-17 13:12 CST
Last Modified:              2010-03-02 14:38 CST
====================================================================== 
Summary:                    Template examples in documentation imply well
defined overriding semantics, but this is not true
Description: 
tex/configuration.tex includes an example of template use that only makes
sense if there are guaranteed semantics for overriding of template
definitions by the definitions in the template user (specifically host is
overridden in a sip.conf example).  However,
https://issues.asterisk.org/view.php?id=15410 was rejected on the
grounds that no such semantics exist.  The documentation needs to be
changed to remove these overriding examples and to give positive warnings
that there are no guaranteed overriding semantics.

======================================================================
Relationships       ID      Summary
----------------------------------------------------------------------
related to          0015410 Template system overriding
====================================================================== 

---------------------------------------------------------------------- 
 (0118777) svnbot (reporter) - 2010-03-02 14:38
 https://issues.asterisk.org/view.php?id=16855#c118777 
---------------------------------------------------------------------- 
Repository: asterisk
Revision: 250039

_U  branches/1.6.1/
U   branches/1.6.1/doc/tex/configuration.tex

------------------------------------------------------------------------
r250039 | lmadsen | 2010-03-02 14:38:22 -0600 (Tue, 02 Mar 2010) | 12
lines

Merged revisions 250037 via svnmerge from 
https://origsvn.digium.com/svn/asterisk/trunk

........
  r250037 | lmadsen | 2010-03-02 15:36:10 -0500 (Tue, 02 Mar 2010) | 4
lines
  
  Update documentation to not imply we support overriding options.
  
  (closes issue https://issues.asterisk.org/view.php?id=16855)
  Reported by: davidw
........

------------------------------------------------------------------------

http://svn.digium.com/view/asterisk?view=rev&revision=250039 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2010-03-02 14:38 svnbot         Checkin                                      
2010-03-02 14:38 svnbot         Note Added: 0118777                          
======================================================================