[ 
https://issues.apache.org/jira/browse/TS-2783?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13990818#comment-13990818
 ] 

Piotr Buliński commented on TS-2783:
------------------------------------

Ah, cool.

It's not 100% bulletproof, but definitely a good start.

Doesn't show that `proxy.config.http.keep_alive_enabled_in` is not OK, but it 
should:

{code}
g proxy.config.http.keep_alive_enabled_in .              
./doc/reference/api/TSHttpOverridableConfig.en.rst:    
proxy.config.http.keep_alive_enabled_in
./doc/reference/configuration/records.config.en.rst:.. ts:cv:: CONFIG 
proxy.config.http.keep_alive_enabled_in  INT 0
./lib/perl/lib/Apache/TS/AdminClient.pm: proxy.config.http.keep_alive_enabled_in
./mgmt/RecordsConfig.cc:  {RECT_CONFIG, 
"proxy.config.http.keep_alive_enabled_in", RECD_INT, "1", RECU_DYNAMIC, 
RR_NULL, RECC_NULL, NULL, RECA_NULL}
./proxy/config/records.config.default.in:CONFIG 
proxy.config.http.keep_alive_enabled_in INT 1
./proxy/http/HttpConfig.cc:  
HttpEstablishStaticConfigByte(c.oride.keep_alive_enabled_in, 
"proxy.config.http.keep_alive_enabled_in");
./proxy/InkAPI.cc:      if (!strncmp(name, 
"proxy.config.http.keep_alive_enabled_in", length))
./proxy/InkAPITest.cc:  "proxy.config.http.keep_alive_enabled_in",
{code}

I'll work on improving it (I'm actually a python developer) and post patch here 
whenever ready.

> Automated verification of defaults (config vs. code)
> ----------------------------------------------------
>
>                 Key: TS-2783
>                 URL: https://issues.apache.org/jira/browse/TS-2783
>             Project: Traffic Server
>          Issue Type: Improvement
>          Components: Configuration, Documentation
>            Reporter: Piotr Buliński
>
> There are cases where documentation states different defaults than they are 
> actually used in code. I will work on some automated mechanism verifying 
> that, so we can keep easily code and docs in sync with each release.
> Additionally it should show:
>  - missing configuration parameters in docs,
>  - unused configuration parameters in code.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to