)]}'
{"doc/manpages/container-sync-realms.conf.5":[{"author":{"_account_id":1179,"name":"Clay Gerrard","email":"clay.gerrard@gmail.com","username":"clay-gerrard"},"change_message_id":"327620b04943da859e514d3fc91c3c0eeef03150","unresolved":false,"context_lines":[{"line_number":1,"context_line":".\\\""},{"line_number":2,"context_line":".\\\" Author: Joao Marcelo Martins \u003cmarcelo.martins@rackspace.com\u003e or \u003cbtorch@gmail.com\u003e"},{"line_number":3,"context_line":".\\\" Copyright (c) 2010-2012 OpenStack Foundation."},{"line_number":4,"context_line":".\\\""},{"line_number":5,"context_line":".\\\" Licensed under the Apache License, Version 2.0 (the \"License\");"}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_e0b114e3","line":2,"updated":"2017-10-06 17:12:20.000000000","message":"this is probably copied from another file, maybe not correct.","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":1179,"name":"Clay Gerrard","email":"clay.gerrard@gmail.com","username":"clay-gerrard"},"change_message_id":"327620b04943da859e514d3fc91c3c0eeef03150","unresolved":false,"context_lines":[{"line_number":1,"context_line":".\\\""},{"line_number":2,"context_line":".\\\" Author: Joao Marcelo Martins \u003cmarcelo.martins@rackspace.com\u003e or \u003cbtorch@gmail.com\u003e"},{"line_number":3,"context_line":".\\\" Copyright (c) 2010-2012 OpenStack Foundation."},{"line_number":4,"context_line":".\\\""},{"line_number":5,"context_line":".\\\" Licensed under the Apache License, Version 2.0 (the \"License\");"},{"line_number":6,"context_line":".\\\" you may not use this file except in compliance with the License."}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_a0cb1c51","line":3,"updated":"2017-10-06 17:12:20.000000000","message":"probalby could update this to 2017","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":15,"context_line":".\\\" See the License for the specific language governing permissions and"},{"line_number":16,"context_line":".\\\" limitations under the License."},{"line_number":17,"context_line":".\\\""},{"line_number":18,"context_line":".TH container-sync-realms.conf 5 \"8/26/2011\" \"Linux\" \"OpenStack Swift\""},{"line_number":19,"context_line":""},{"line_number":20,"context_line":".SH NAME"},{"line_number":21,"context_line":".LP"}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_63e40ead","line":18,"range":{"start_line":18,"start_character":33,"end_line":18,"end_character":44},"updated":"2017-10-06 17:56:06.000000000","message":"maybe use current date","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":1179,"name":"Clay Gerrard","email":"clay.gerrard@gmail.com","username":"clay-gerrard"},"change_message_id":"327620b04943da859e514d3fc91c3c0eeef03150","unresolved":false,"context_lines":[{"line_number":38,"context_line":"to sync their container to along with a secret synchronization key."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"You can find more information about container to container synchronization at"},{"line_number":41,"context_line":"\\fIhttps://docs.openstack.org/swift/latest/overview_container_sync.html\\fR "},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"The configuration file follows the python-pastedeploy syntax. The file is divided"},{"line_number":44,"context_line":"into sections, which are enclosed by square brackets. Each section will contain a"}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_c0d3b8d4","line":41,"updated":"2017-10-06 17:12:20.000000000","message":"IME some people get up in arms about trailing whitespace - I think their editors are configured to punch them if they open a file with trailing whitespace.  There\u0027s some gerrit config option that makes them stand out in terrible terrible bright red.\n\nhttps://review.openstack.org/510190","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":65,"context_line":""},{"line_number":66,"context_line":""},{"line_number":67,"context_line":""},{"line_number":68,"context_line":".SH REALM1 SECTION"},{"line_number":69,"context_line":".PD 1"},{"line_number":70,"context_line":".RS 0"},{"line_number":71,"context_line":"This is indicated by section name [realm1]. Each section name is the name of a sync realm."}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_83cb8a48","line":68,"range":{"start_line":68,"start_character":0,"end_line":68,"end_character":18},"updated":"2017-10-06 17:56:06.000000000","message":"I think it is unhelpful to have these *two* sections specified - in the sample conf file [1] they are examples, not required sections. IMO the way this will render will make them appear to be mandatory section names, particularly because you repeat the same spec for a [realm2] section\n\nI suggest changing this heading to \"REALM SECTIONS\"\nand deleting REALM2 SECTION below\n\n[1] https://github.com/openstack/swift/blob/2f7d0f4a2ad2da7e6a35e5b054a47a2fafe5ed01/etc/container-sync-realms.conf-sample#L1-L47","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":68,"context_line":".SH REALM1 SECTION"},{"line_number":69,"context_line":".PD 1"},{"line_number":70,"context_line":".RS 0"},{"line_number":71,"context_line":"This is indicated by section name [realm1]. Each section name is the name of a sync realm."},{"line_number":72,"context_line":"A sync realm is a set of clusters that have agreed to allow container syncing with each other. "},{"line_number":73,"context_line":"Realm names will be considered case insensitive. Below are the parameters that are acceptable "},{"line_number":74,"context_line":"within this section."}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_431c72c0","line":71,"range":{"start_line":71,"start_character":79,"end_line":71,"end_character":90},"updated":"2017-10-06 17:56:06.000000000","message":"\"...sync realm, for example [realm1].\"","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":68,"context_line":".SH REALM1 SECTION"},{"line_number":69,"context_line":".PD 1"},{"line_number":70,"context_line":".RS 0"},{"line_number":71,"context_line":"This is indicated by section name [realm1]. Each section name is the name of a sync realm."},{"line_number":72,"context_line":"A sync realm is a set of clusters that have agreed to allow container syncing with each other. "},{"line_number":73,"context_line":"Realm names will be considered case insensitive. Below are the parameters that are acceptable "},{"line_number":74,"context_line":"within this section."}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_2314d69f","line":71,"range":{"start_line":71,"start_character":0,"end_line":71,"end_character":43},"updated":"2017-10-06 17:56:06.000000000","message":"delete","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":82,"context_line":"Any values in the realm section whose name begin with cluster_ will indicate the name and"},{"line_number":83,"context_line":"endpoint of a cluster and will be caused by external users in their container\u0027s"},{"line_number":84,"context_line":"X-Container-Sync-To metadata header values with the format as \"realm_name/cluster_name/container_name\"."},{"line_number":85,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":86,"context_line":".IP \"\\fBkey\\fR\""},{"line_number":87,"context_line":"The key is the overall cluster-to-cluster key used in combination with the external "},{"line_number":88,"context_line":"users\u0027 key that they set on their containers\u0027 X-Container-Sync-Key metadata header "}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_a3d0c6f8","line":85,"range":{"start_line":85,"start_character":0,"end_line":85,"end_character":66},"updated":"2017-10-06 17:56:06.000000000","message":"perhaps also include the text from the conf file:\n\nhttps://github.com/openstack/swift/blob/2f7d0f4a2ad2da7e6a35e5b054a47a2fafe5ed01/etc/container-sync-realms.conf-sample#L40-L44","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":97,"context_line":""},{"line_number":98,"context_line":""},{"line_number":99,"context_line":""},{"line_number":100,"context_line":".SH REALM2 SECTION"},{"line_number":101,"context_line":".PD 1"},{"line_number":102,"context_line":".RS 0"},{"line_number":103,"context_line":"This is indicated by section name [realm2]. Each section name is the name of a sync realm."},{"line_number":104,"context_line":"A sync realm is a set of clusters that have agreed to allow container syncing with each "},{"line_number":105,"context_line":"other. Realm names will be considered case insensitive. Below are the parameters that "},{"line_number":106,"context_line":"are acceptable within this section."},{"line_number":107,"context_line":""},{"line_number":108,"context_line":".IP \"\\fBcluster_clustername3\\fR\""},{"line_number":109,"context_line":"Any values in the realm section whose name begin with cluster_ will indicate the name and"},{"line_number":110,"context_line":"endpoint of a cluster and will be caused by external users in their container\u0027s"},{"line_number":111,"context_line":"X-Container-Sync-To metadata header values with the format as \"realm_name/cluster_name/container_name\"."},{"line_number":112,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":113,"context_line":".IP \"\\fBcluster_clustername4\\fR\""},{"line_number":114,"context_line":"Any values in the realm section whose name begin with cluster_ will indicate the name and"},{"line_number":115,"context_line":"endpoint of a cluster and will be caused by external users in their container\u0027s"},{"line_number":116,"context_line":"X-Container-Sync-To metadata header values with the format as \"realm_name/cluster_name/container_name\"."},{"line_number":117,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":118,"context_line":".IP \"\\fBkey\\fR\""},{"line_number":119,"context_line":"The key is the overall cluster-to-cluster key used in combination with the external "},{"line_number":120,"context_line":"users\u0027 key that they set on their containers\u0027 X-Container-Sync-Key metadata header "},{"line_number":121,"context_line":"values. These keys will be used to sign each request the container sync daemon makes "},{"line_number":122,"context_line":"and used to validate each incoming container sync request."},{"line_number":123,"context_line":".IP \"\\fBkey2\\fR\""},{"line_number":124,"context_line":"The key2 is optional and is an additional key incoming requests will be checked "},{"line_number":125,"context_line":"against. This is so you can rotate keys if you wish; you move the existing "},{"line_number":126,"context_line":"key to key2 and make a new key value."},{"line_number":127,"context_line":".RE"},{"line_number":128,"context_line":".PD"},{"line_number":129,"context_line":""},{"line_number":130,"context_line":""},{"line_number":131,"context_line":""}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_c38502d1","line":128,"range":{"start_line":100,"start_character":1,"end_line":128,"end_character":3},"updated":"2017-10-06 17:56:06.000000000","message":"delete - unnecessary and possibly confusing repetition","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"48b53e44d0edeff4a5c4b21ce8f75349acb058bf","unresolved":false,"context_lines":[{"line_number":134,"context_line":".LP"},{"line_number":135,"context_line":"More in depth documentation about the swift-container-sync and"},{"line_number":136,"context_line":"also OpenStack Swift as a whole can be found at"},{"line_number":137,"context_line":".BI https://docs.openstack.org/swift/latest/admin_guide.html"},{"line_number":138,"context_line":"and"},{"line_number":139,"context_line":".BI https://docs.openstack.org/swift/latest/"},{"line_number":140,"context_line":""}],"source_content_type":"text/troff","patch_set":1,"id":"7f515b1d_43eb52db","line":137,"range":{"start_line":137,"start_character":4,"end_line":137,"end_character":60},"updated":"2017-10-06 17:56:06.000000000","message":"this link doesn\u0027t appear to have specific info about container sync, the second link (line 139) would be sufficient, or copy the similar text from swift-container-sync man page","commit_id":"a86a594078693f86ce3481e1fcee3853876b3e9a"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"197c2a09f86ca10c3274da41b78962856f55e32f","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":".SH NAME"},{"line_number":21,"context_line":".LP"},{"line_number":22,"context_line":".B container-sync-relams.conf"},{"line_number":23,"context_line":"\\- configuration file for the OpenStack Swift container sync realms"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":""}],"source_content_type":"text/troff","patch_set":2,"id":"7f515b1d_de01376c","line":22,"range":{"start_line":22,"start_character":18,"end_line":22,"end_character":24},"updated":"2017-10-09 08:58:28.000000000","message":"s/relams/realms/","commit_id":"3b72e178d4af198d60b8568b40f031398957c901"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"197c2a09f86ca10c3274da41b78962856f55e32f","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":".SH SYNOPSIS"},{"line_number":28,"context_line":".LP"},{"line_number":29,"context_line":".B container-sync-relams.conf"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":""},{"line_number":32,"context_line":""}],"source_content_type":"text/troff","patch_set":2,"id":"7f515b1d_9ef73f8c","line":29,"range":{"start_line":29,"start_character":18,"end_line":29,"end_character":24},"updated":"2017-10-09 08:58:28.000000000","message":"s/relams/realms/","commit_id":"3b72e178d4af198d60b8568b40f031398957c901"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"197c2a09f86ca10c3274da41b78962856f55e32f","unresolved":false,"context_lines":[{"line_number":75,"context_line":""},{"line_number":76,"context_line":".IP \"\\fBcluster_clustername1\\fR\""},{"line_number":77,"context_line":"Any values in the realm section whose name begin with cluster_ will indicate the name and"},{"line_number":78,"context_line":"endpoint of a cluster and will be caused by external users in their container\u0027s"},{"line_number":79,"context_line":"X-Container-Sync-To metadata header values with the format as \"realm_name/cluster_name/container_name\"."},{"line_number":80,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":81,"context_line":".IP \"\\fBcluster_clustername2\\fR\""}],"source_content_type":"text/troff","patch_set":2,"id":"7f515b1d_9e3cdf2f","line":78,"range":{"start_line":78,"start_character":34,"end_line":78,"end_character":40},"updated":"2017-10-09 08:58:28.000000000","message":"used","commit_id":"3b72e178d4af198d60b8568b40f031398957c901"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"197c2a09f86ca10c3274da41b78962856f55e32f","unresolved":false,"context_lines":[{"line_number":80,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":81,"context_line":".IP \"\\fBcluster_clustername2\\fR\""},{"line_number":82,"context_line":"Any values in the realm section whose name begin with cluster_ will indicate the name and"},{"line_number":83,"context_line":"endpoint of a cluster and will be caused by external users in their container\u0027s"},{"line_number":84,"context_line":"X-Container-Sync-To metadata header values with the format as \"realm_name/cluster_name/container_name\"."},{"line_number":85,"context_line":"The Realm and cluster names are considered to be case insensitive."},{"line_number":86,"context_line":""}],"source_content_type":"text/troff","patch_set":2,"id":"7f515b1d_fe0ab376","line":83,"range":{"start_line":83,"start_character":34,"end_line":83,"end_character":40},"updated":"2017-10-09 08:58:28.000000000","message":"used","commit_id":"3b72e178d4af198d60b8568b40f031398957c901"}]}