)]}'
{"doc/source/command-options.rst":[{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"b14579afb994995780d2aebbe19fef1aafcb1401","unresolved":false,"context_lines":[{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argumenr --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_a374a8ce","line":224,"range":{"start_line":224,"start_character":23,"end_line":224,"end_character":31},"updated":"2016-07-27 12:19:13.000000000","message":"argument*","commit_id":"05f066f7ae1f6193a77ffd8fa003b5e16d13a547"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"c8a86b43c408bc8c2afe3e8fc7032223bc1ff31d","unresolved":false,"context_lines":[{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argumenr --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bacf61ea_e63b059b","line":224,"range":{"start_line":224,"start_character":23,"end_line":224,"end_character":31},"in_reply_to":"dada55a8_a374a8ce","updated":"2016-07-28 01:39:51.000000000","message":"Done. Thanks!","commit_id":"05f066f7ae1f6193a77ffd8fa003b5e16d13a547"},{"author":{"_account_id":8276,"name":"kiwik","email":"chenrui.momo@gmail.com","username":"kiwik"},"change_message_id":"0d0852f64a9e2c588df7c24583ba6a9103fa41ec","unresolved":false,"context_lines":[{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bacf61ea_90ffc600","line":222,"range":{"start_line":222,"start_character":31,"end_line":222,"end_character":38},"updated":"2016-07-28 11:35:11.000000000","message":"an error","commit_id":"bb9214496e5aaa5c0bd0afa1c1ef04ffa1aabfe8"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"f2392c8c40fdec5d8fc987c4229ffa18fec6e64a","unresolved":false,"context_lines":[{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bacf61ea_f0928256","line":222,"range":{"start_line":222,"start_character":31,"end_line":222,"end_character":38},"in_reply_to":"bacf61ea_90ffc600","updated":"2016-07-28 11:44:07.000000000","message":"Done","commit_id":"bb9214496e5aaa5c0bd0afa1c1ef04ffa1aabfe8"},{"author":{"_account_id":8276,"name":"kiwik","email":"chenrui.momo@gmail.com","username":"kiwik"},"change_message_id":"0d0852f64a9e2c588df7c24583ba6a9103fa41ec","unresolved":false,"context_lines":[{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bacf61ea_657ed6e5","line":223,"range":{"start_line":223,"start_character":14,"end_line":223,"end_character":19},"updated":"2016-07-28 11:35:11.000000000","message":"\"specified\" sounds more exact, but not a big deal.","commit_id":"bb9214496e5aaa5c0bd0afa1c1ef04ffa1aabfe8"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"f2392c8c40fdec5d8fc987c4229ffa18fec6e64a","unresolved":false,"context_lines":[{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide a error message for the user if a required"},{"line_number":223,"context_line":"option is not used."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bacf61ea_d0993e70","line":223,"range":{"start_line":223,"start_character":14,"end_line":223,"end_character":19},"in_reply_to":"bacf61ea_657ed6e5","updated":"2016-07-28 11:44:07.000000000","message":"Yea, \"specified\" sounds better, Thanks :)","commit_id":"bb9214496e5aaa5c0bd0afa1c1ef04ffa1aabfe8"},{"author":{"_account_id":8410,"name":"Richard Theis","email":"rtheis@us.ibm.com","username":"rtheis"},"change_message_id":"674350cad844bbbe59464bb8e8cba07f0040c6b5","unresolved":false,"context_lines":[{"line_number":214,"context_line":"Required Options"},{"line_number":215,"context_line":"----------------"},{"line_number":216,"context_line":""},{"line_number":217,"context_line":"Some options have no default value and the API does not allow they are"},{"line_number":218,"context_line":"`None`, then these options are always required when users use the command"},{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_452d4f45","line":217,"range":{"start_line":217,"start_character":62,"end_line":217,"end_character":69},"updated":"2016-07-29 13:05:15.000000000","message":"them to be","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"cb9770884756b314552250ab91099614dcaa48a7","unresolved":false,"context_lines":[{"line_number":214,"context_line":"Required Options"},{"line_number":215,"context_line":"----------------"},{"line_number":216,"context_line":""},{"line_number":217,"context_line":"Some options have no default value and the API does not allow they are"},{"line_number":218,"context_line":"`None`, then these options are always required when users use the command"},{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_59adc8e7","line":217,"range":{"start_line":217,"start_character":62,"end_line":217,"end_character":69},"in_reply_to":"bacf61ea_452d4f45","updated":"2016-08-02 02:12:13.000000000","message":"Done","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":8410,"name":"Richard Theis","email":"rtheis@us.ibm.com","username":"rtheis"},"change_message_id":"674350cad844bbbe59464bb8e8cba07f0040c6b5","unresolved":false,"context_lines":[{"line_number":218,"context_line":"`None`, then these options are always required when users use the command"},{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide an error message for the user if a required"},{"line_number":223,"context_line":"option is not specified."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_c5213f4f","line":221,"range":{"start_line":221,"start_character":22,"end_line":221,"end_character":24},"updated":"2016-07-29 13:05:15.000000000","message":"this can be removed","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"cb9770884756b314552250ab91099614dcaa48a7","unresolved":false,"context_lines":[{"line_number":218,"context_line":"`None`, then these options are always required when users use the command"},{"line_number":219,"context_line":"to which these options belong."},{"line_number":220,"context_line":""},{"line_number":221,"context_line":"Required options must to be validated by the CLI to aviod omissions."},{"line_number":222,"context_line":"The CLI validation may provide an error message for the user if a required"},{"line_number":223,"context_line":"option is not specified."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_b9b8442b","line":221,"range":{"start_line":221,"start_character":22,"end_line":221,"end_character":24},"in_reply_to":"bacf61ea_c5213f4f","updated":"2016-08-02 02:12:13.000000000","message":"Done","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":970,"name":"Dean Troyer","email":"dtroyer@gmail.com","username":"dtroyer"},"change_message_id":"a6ae1fb19d63921f8fc6c262e7558c0b69c169e6","unresolved":false,"context_lines":[{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"    Test option (required)"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"Implementation"},{"line_number":231,"context_line":"~~~~~~~~~~~~~~"},{"line_number":232,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_0f78908e","line":229,"updated":"2016-07-29 14:42:17.000000000","message":"Maybe put a note here that the docs can (or should!) have additional explanation here.  The first line should match the help output.","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"cb9770884756b314552250ab91099614dcaa48a7","unresolved":false,"context_lines":[{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"    Test option (required)"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"Implementation"},{"line_number":231,"context_line":"~~~~~~~~~~~~~~"},{"line_number":232,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_79b24c4d","line":229,"in_reply_to":"bacf61ea_0f78908e","updated":"2016-08-02 02:12:13.000000000","message":"Yea, I will keep the first line match the help message. And do you mean that there should be a additional explanation in the second line?","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":8410,"name":"Richard Theis","email":"rtheis@us.ibm.com","username":"rtheis"},"change_message_id":"674350cad844bbbe59464bb8e8cba07f0040c6b5","unresolved":false,"context_lines":[{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"},{"line_number":241,"context_line":"            help\u003d_(\u0027Test option\u0027),"},{"line_number":242,"context_line":"        )"},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"List Command Options"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_25a5bbb4","line":241,"updated":"2016-07-29 13:05:15.000000000","message":"Shouldn\u0027t this include \"(required)\"?  I see it used in OSC today for required options.","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":970,"name":"Dean Troyer","email":"dtroyer@gmail.com","username":"dtroyer"},"change_message_id":"a6ae1fb19d63921f8fc6c262e7558c0b69c169e6","unresolved":false,"context_lines":[{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"},{"line_number":241,"context_line":"            help\u003d_(\u0027Test option\u0027),"},{"line_number":242,"context_line":"        )"},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"List Command Options"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_2f4e346f","line":241,"in_reply_to":"bacf61ea_25a5bbb4","updated":"2016-07-29 14:42:17.000000000","message":"The help text should match the first line of the documentation description.  Of course the docs can have additional text.","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"cb9770884756b314552250ab91099614dcaa48a7","unresolved":false,"context_lines":[{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"},{"line_number":241,"context_line":"            help\u003d_(\u0027Test option\u0027),"},{"line_number":242,"context_line":"        )"},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"List Command Options"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_79e08c29","line":241,"in_reply_to":"bacf61ea_25a5bbb4","updated":"2016-08-02 02:12:13.000000000","message":"Yes, I also think \"(required)\" being included in this is better.","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"cb9770884756b314552250ab91099614dcaa48a7","unresolved":false,"context_lines":[{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"},{"line_number":241,"context_line":"            help\u003d_(\u0027Test option\u0027),"},{"line_number":242,"context_line":"        )"},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"List Command Options"}],"source_content_type":"text/x-rst","patch_set":3,"id":"bacf61ea_f9d2bc5a","line":241,"in_reply_to":"bacf61ea_2f4e346f","updated":"2016-08-02 02:12:13.000000000","message":"Done","commit_id":"9e5a7ab11c36bcb651db1330f230e20a2358b337"},{"author":{"_account_id":14937,"name":"Tang Chen","email":"imtangchen@163.com","username":"tangchen"},"change_message_id":"c34c3f89eb955edb6355dc5dd8164ac826aabe43","unresolved":false,"context_lines":[{"line_number":221,"context_line":"Required options must be validated by the CLI to aviod omissions. The CLI"},{"line_number":222,"context_line":"validation may provide an error message for the user if a required option"},{"line_number":223,"context_line":"is not specified."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"bacf61ea_6448d1b3","line":224,"range":{"start_line":224,"start_character":23,"end_line":224,"end_character":31},"updated":"2016-08-02 11:24:56.000000000","message":"nit: argument -\u003e option ?","commit_id":"f5290dcfcbe1d14a5b4a9f74d06a9feeb52aff72"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"29fd0bb3618f2216a778888cdb43947097cfd369","unresolved":false,"context_lines":[{"line_number":221,"context_line":"Required options must be validated by the CLI to aviod omissions. The CLI"},{"line_number":222,"context_line":"validation may provide an error message for the user if a required option"},{"line_number":223,"context_line":"is not specified."},{"line_number":224,"context_line":"(for example: ``error: argument --test is required``)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":".. option:: --test"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"bacf61ea_5f43d6ae","line":224,"range":{"start_line":224,"start_character":23,"end_line":224,"end_character":31},"in_reply_to":"bacf61ea_6448d1b3","updated":"2016-08-02 11:54:14.000000000","message":"This is the error message in the real case, we shouldn\u0027t modify it.","commit_id":"f5290dcfcbe1d14a5b4a9f74d06a9feeb52aff72"},{"author":{"_account_id":14937,"name":"Tang Chen","email":"imtangchen@163.com","username":"tangchen"},"change_message_id":"c34c3f89eb955edb6355dc5dd8164ac826aabe43","unresolved":false,"context_lines":[{"line_number":234,"context_line":""},{"line_number":235,"context_line":".. code-block:: python"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"        required_option.add_argument("},{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bacf61ea_e4e96180","line":237,"range":{"start_line":237,"start_character":8,"end_line":237,"end_character":23},"updated":"2016-08-02 11:24:56.000000000","message":"parser.add_argument","commit_id":"f5290dcfcbe1d14a5b4a9f74d06a9feeb52aff72"},{"author":{"_account_id":21514,"name":"Huanxuan Ao","email":"aohuanxuan@163.com","username":"aohuanxuan"},"change_message_id":"29fd0bb3618f2216a778888cdb43947097cfd369","unresolved":false,"context_lines":[{"line_number":234,"context_line":""},{"line_number":235,"context_line":".. code-block:: python"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"        required_option.add_argument("},{"line_number":238,"context_line":"            \u0027--test\u0027,"},{"line_number":239,"context_line":"            metavar\u003d\u0027\u003ctest\u003e\u0027,"},{"line_number":240,"context_line":"            required\u003dTrue,"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bacf61ea_7f921af7","line":237,"range":{"start_line":237,"start_character":8,"end_line":237,"end_character":23},"in_reply_to":"bacf61ea_e4e96180","updated":"2016-08-02 11:54:14.000000000","message":"Actually the name \"parser\" is changeable, but to match the most of other codes, I will modify it. Thanks :)","commit_id":"f5290dcfcbe1d14a5b4a9f74d06a9feeb52aff72"}]}