[jira] [Commented] (KAFKA-1276) Provide a list of config overrides available when running kafka.topics

["Jay Kreps (JIRA)" <ji...@apache.org>]

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

Jay Kreps commented on KAFKA-1276:
----------------------------------

Good idea! This is actually pretty easy to do. The idea would be that the --help option (or running with no args) would print something like

jkreps-mn:kafka jkreps$ bin/kafka-topics.sh 
Command must include exactly one action: --list, --describe, --create, --delete, or --alter
Option                                  Description                            
------                                  -----------                            
--alter                                 Alter the configuration for the topic. 
--config <name=value>     A topic configuration override for the 
                                          topic being created or altered. The following are valid topic configurations:
                                              segment.bytes
                                              segment.ms
                                              segment.index.bytes
                                          For details on these configs see http://kafka.apache.org/documentation.html#configuration
--create                                Create a new topic.                    
...

This can be done automatically off the code. I can't automatically include documentation on the configs (yet) hence the annoying link to the main docs. We could potentially improve this with the changes to the config code in 0.9 and I'd prefer to avoid trying to keep the docs in two places up to date in the interim.

Does this seem reasonable?

> Provide a list of config overrides available when running kafka.topics
> ----------------------------------------------------------------------
>
>                 Key: KAFKA-1276
>                 URL: https://issues.apache.org/jira/browse/KAFKA-1276
>             Project: Kafka
>          Issue Type: Bug
>          Components: tools
>            Reporter: Todd Palino
>
> It would be helpful to have the help for kafka-topics enumerate a list of the per-topic configuration overrides that are available with the --config option.



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)