{"action":"created","issue":{"url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/17","repository_url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc","labels_url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/17/labels{/name}","comments_url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/17/comments","events_url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/17/events","html_url":"https://github.com/riboseinc/rfc-asciidoc-rfc/issues/17","id":313939549,"number":17,"title":"Folding script problem: latest '07' version contains many \"lines too long\"","user":{"login":"ronaldtse","id":11865,"avatar_url":"https://avatars1.githubusercontent.com/u/11865?v=4","gravatar_id":"","url":"https://api.github.com/users/ronaldtse","html_url":"https://github.com/ronaldtse","followers_url":"https://api.github.com/users/ronaldtse/followers","following_url":"https://api.github.com/users/ronaldtse/following{/other_user}","gists_url":"https://api.github.com/users/ronaldtse/gists{/gist_id}","starred_url":"https://api.github.com/users/ronaldtse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ronaldtse/subscriptions","organizations_url":"https://api.github.com/users/ronaldtse/orgs","repos_url":"https://api.github.com/users/ronaldtse/repos","events_url":"https://api.github.com/users/ronaldtse/events{/privacy}","received_events_url":"https://api.github.com/users/ronaldtse/received_events","type":"User","site_admin":false},"labels":[{"id":715871029,"url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/labels/bug","name":"bug","color":"ee0701","default":true}],"state":"open","locked":false,"assignee":{"login":"opoudjis","id":1911039,"avatar_url":"https://avatars3.githubusercontent.com/u/1911039?v=4","gravatar_id":"","url":"https://api.github.com/users/opoudjis","html_url":"https://github.com/opoudjis","followers_url":"https://api.github.com/users/opoudjis/followers","following_url":"https://api.github.com/users/opoudjis/following{/other_user}","gists_url":"https://api.github.com/users/opoudjis/gists{/gist_id}","starred_url":"https://api.github.com/users/opoudjis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opoudjis/subscriptions","organizations_url":"https://api.github.com/users/opoudjis/orgs","repos_url":"https://api.github.com/users/opoudjis/repos","events_url":"https://api.github.com/users/opoudjis/events{/privacy}","received_events_url":"https://api.github.com/users/opoudjis/received_events","type":"User","site_admin":false},"assignees":[{"login":"opoudjis","id":1911039,"avatar_url":"https://avatars3.githubusercontent.com/u/1911039?v=4","gravatar_id":"","url":"https://api.github.com/users/opoudjis","html_url":"https://github.com/opoudjis","followers_url":"https://api.github.com/users/opoudjis/followers","following_url":"https://api.github.com/users/opoudjis/following{/other_user}","gists_url":"https://api.github.com/users/opoudjis/gists{/gist_id}","starred_url":"https://api.github.com/users/opoudjis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opoudjis/subscriptions","organizations_url":"https://api.github.com/users/opoudjis/orgs","repos_url":"https://api.github.com/users/opoudjis/repos","events_url":"https://api.github.com/users/opoudjis/events{/privacy}","received_events_url":"https://api.github.com/users/opoudjis/received_events","type":"User","site_admin":false}],"milestone":null,"comments":0,"created_at":"2018-04-13T01:28:40Z","updated_at":"2018-04-13T01:31:07Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"This seems like a folding script problem.\r\n\r\nIn `examples/rfc-asciirfc-minimal/xml2/draft-asciirfc-minimal.xml` (the \"folded\" version), it contains these lines which are not correctly folded:\r\n\r\n```xml\r\n<section anchor=\"conventions\" title=\"Terms and Definitions\"><t>The key words \"<spanx style=\"strong\">MUST</spanx>\", \"<spanx style=\"strong\">MUST NOT</spanx>\", \"<spanx style=\"strong\">REQUIRED</spanx>\", \"<spanx style=\"strong\">SHALL</spanx>\",\r\n```\r\n\r\n```xml\r\n  <section anchor=\"_example_1\" title=\"Example 1\"><t>Here&#8217;s an example of a properly wrapped code snippet in\r\naccordance with rules specified in <xref target=\"code-snippets\"/>.</t>\r\n```\r\n\r\nIn fact, the lines are hardly folded.\r\n"},"comment":{"url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/comments/380993080","html_url":"https://github.com/riboseinc/rfc-asciidoc-rfc/issues/17#issuecomment-380993080","issue_url":"https://api.github.com/repos/riboseinc/rfc-asciidoc-rfc/issues/17","id":380993080,"user":{"login":"ronaldtse","id":11865,"avatar_url":"https://avatars1.githubusercontent.com/u/11865?v=4","gravatar_id":"","url":"https://api.github.com/users/ronaldtse","html_url":"https://github.com/ronaldtse","followers_url":"https://api.github.com/users/ronaldtse/followers","following_url":"https://api.github.com/users/ronaldtse/following{/other_user}","gists_url":"https://api.github.com/users/ronaldtse/gists{/gist_id}","starred_url":"https://api.github.com/users/ronaldtse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ronaldtse/subscriptions","organizations_url":"https://api.github.com/users/ronaldtse/orgs","repos_url":"https://api.github.com/users/ronaldtse/repos","events_url":"https://api.github.com/users/ronaldtse/events{/privacy}","received_events_url":"https://api.github.com/users/ronaldtse/received_events","type":"User","site_admin":false},"created_at":"2018-04-13T01:31:07Z","updated_at":"2018-04-13T01:31:07Z","author_association":"CONTRIBUTOR","body":"Tips from Adrian:\r\n\r\n> Yes, the 72 character problem exists for all examples of code. That is,\r\nthings that would normally be allowed to continue wider that 72 characters\r\nwithout a line break have to be represented in 72 characters with an\r\nartificial line break.\r\n\r\n> We're currently looking at a solution for YANG\r\n(https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/).\r\nNot that that helps you, but it lets you know that the problem is not\r\nunique. What is done in these cases is to define (and explain) a\r\ndocumentation convention to handle the line breaks.\r\n\r\n>> 1. XML elements that are shown in code blocks, like this:\r\n>> `\"<!ENTITY I-D.ribose-asciirfc SYSTEM \"https://xml2rfc.tools.ietf.org/public/rfc/bibxml3//reference.I-D.draft-ribose-asciirfc-04.xml\">\"`\r\n\r\n> I think a URL may safely be split anywhere, but it is usually done at a\r\nforward slash. So you would end up with something like...\r\n\r\n> `<!ENTITY I-D.ribose-asciirfc SYSTEM\r\n  https://xml2rfc.tools.ietf.org/public/rfc/\r\n  bibxml3//reference.I-D.draft-ribose-asciirfc-04.xml\">`\r\n\r\n>> 2. We've inserted a line of Hebrew to demonstrate UTF-8 but xml2rfc is\r\nrendering it like this:\r\n\r\n>> \".&#1499;&#1488;&#1503; &#1488;&#1493;&#1500;&#1497;\r\n&#1497;&#1502;&#1510;&#1488;&#1493;\r\n&#1492;&#1502;&#1497;&#1500;&#1497;&#1501;â?â?¦\r\n\r\n> Yeah, and I think the next revision of xml2rfc will do the same thing.\r\nThe question, I suppose is, does the line break matter in the example?\r\nIf it does, is it possible to come up with an even shorter snippet of Hebrew?\r\n\r\n> The final escape on this would be to use a non-ASCII attachment (e.g.,\r\nSVG) to include the snippet. That can be done (as it can be done for\r\nfigures), but it is a really ugly solution.\r\n\r\n> If push comes to shove, post a revision with lines that are too long, and\r\nwe'll discuss the problem with the RFC Production Team."}}
{"actor":{"display_login":"ronaldtse"}}