{"thread":{"id":"4864","subject":"[PATCH] Documentation: Fix ssh:// URLs in generated documentation","startedAt":"2006-07-12T21:55:21Z","lastAt":"2006-07-13T05:48:58Z","messageCount":3,"participants":["Alp Toker","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"23726","messageId":"11527413212127-git-send-email-alp@atoker.com","threadId":"4864","inReplyTo":null,"subject":"[PATCH] Documentation: Fix ssh:// URLs in generated documentation","fromName":"Alp Toker","fromEmail":"alp@atoker.com","sentAt":"2006-07-12T21:55:21Z","receivedAt":"2006-07-12T21:55:21Z","isPatch":true,"sender":{"key":"alp@atoker.com","avatar":"https://gravatar.com/avatar/5367b73f1bb2598314e084847e4f45c303514c7fd192cfa9aa3c3437511567cd?d=mp&s=160"},"body":"Commit c3f17061be95de3498449a548e93883aebff23d6 was causing warnings\nduring doc generation due to bad asciidoc markup.\n\nThis resulted in \"ssh://[user@]host.xz/path/to/repo.git/\" being rendered\nas \"host.xz/path/to/repo.git/\" in the man pages and html output.\n\nThis patch converts sections listing URL formats to verbatim.\n\nIt also changes a minor capitalization inconsistency which ended up\nappearing in several man pages by inclusion.\n\nSigned-off-by: Alp Toker <alp@atoker.com>\n---\n Documentation/urls.txt |   34 ++++++++++++++--------------------\n 1 files changed, 14 insertions(+), 20 deletions(-)\n\ndiff --git a/Documentation/urls.txt b/Documentation/urls.txt\nindex 9abec80..2b5a7f8 100644\n--- a/Documentation/urls.txt\n+++ b/Documentation/urls.txt\n@@ -4,33 +4,27 @@ GIT URLS[[URLS]]\n One of the following notations can be used\n to name the remote repository:\n \n-===============================================================\n-- rsync://host.xz/path/to/repo.git/\n-- http://host.xz/path/to/repo.git/\n-- https://host.xz/path/to/repo.git/\n-- git://host.xz/path/to/repo.git/\n-- git://host.xz/~user/path/to/repo.git/\n-- ssh://[user@]host.xz/path/to/repo.git/\n-- ssh://[user@]host.xz/~user/path/to/repo.git/\n-- ssh://[user@]host.xz/~/path/to/repo.git\n-===============================================================\n-\n-SSH Is the default transport protocol and also supports an\n+\trsync://host.xz/path/to/repo.git/\n+\thttp://host.xz/path/to/repo.git/\n+\thttps://host.xz/path/to/repo.git/\n+\tgit://host.xz/path/to/repo.git/\n+\tgit://host.xz/~user/path/to/repo.git/\n+\tssh://[user@]host.xz/path/to/repo.git/\n+\tssh://[user@]host.xz/~user/path/to/repo.git/\n+\tssh://[user@]host.xz/~/path/to/repo.git\n+\n+SSH is the default transport protocol and also supports an\n scp-like syntax.  Both syntaxes support username expansion,\n as does the native git protocol. The following three are\n identical to the last three above, respectively:\n \n-===============================================================\n-- host.xz:/path/to/repo.git/\n-- host.xz:~user/path/to/repo.git/\n-- host.xz:path/to/repo.git\n-===============================================================\n+\thost.xz:/path/to/repo.git/\n+\thost.xz:~user/path/to/repo.git/\n+\thost.xz:path/to/repo.git\n \n To sync with a local directory, use:\n \n-===============================================================\n-- /path/to/repo.git/\n-===============================================================\n+\t/path/to/repo.git/\n \n REMOTES\n -------\n-- \n1.4.1.g2fca1\n"},{"id":"23739","messageId":"7vpsgaw16d.fsf@assigned-by-dhcp.cox.net","threadId":"4864","inReplyTo":"11527413212127-git-send-email-alp@atoker.com","subject":"Re: [PATCH] Documentation: Fix ssh:// URLs in generated documentation","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2006-07-13T04:58:50Z","receivedAt":"2006-07-13T04:58:50Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Alp Toker <alp@atoker.com> writes:\n\n> Commit c3f17061be95de3498449a548e93883aebff23d6 was causing warnings\n> during doc generation due to bad asciidoc markup.\n>\n> This resulted in \"ssh://[user@]host.xz/path/to/repo.git/\" being rendered\n> as \"host.xz/path/to/repo.git/\" in the man pages and html output.\n\nI wonder if this is with less formatting impact then.\n\ndiff --git a/Documentation/urls.txt b/Documentation/urls.txt\nindex 9abec80..93378d2 100644\n--- a/Documentation/urls.txt\n+++ b/Documentation/urls.txt\n@@ -10,9 +10,9 @@ to name the remote repository:\n - https://host.xz/path/to/repo.git/\n - git://host.xz/path/to/repo.git/\n - git://host.xz/~user/path/to/repo.git/\n-- ssh://[user@]host.xz/path/to/repo.git/\n-- ssh://[user@]host.xz/~user/path/to/repo.git/\n-- ssh://[user@]host.xz/~/path/to/repo.git\n+- ssh://+++[user@+++]host.xz/path/to/repo.git/\n+- ssh://+++[user@+++]host.xz/~user/path/to/repo.git/\n+- ssh://+++[user@+++]host.xz/~/path/to/repo.git\n ===============================================================\n \n SSH Is the default transport protocol and also supports an\n"},{"id":"23745","messageId":"44B5DECA.8040401@atoker.com","threadId":"4864","inReplyTo":"7vpsgaw16d.fsf@assigned-by-dhcp.cox.net","subject":"Re: [PATCH] Documentation: Fix ssh:// URLs in generated documentation","fromName":"Alp Toker","fromEmail":"alp@atoker.com","sentAt":"2006-07-13T05:48:58Z","receivedAt":"2006-07-13T05:48:58Z","isPatch":true,"sender":{"key":"alp@atoker.com","avatar":"https://gravatar.com/avatar/5367b73f1bb2598314e084847e4f45c303514c7fd192cfa9aa3c3437511567cd?d=mp&s=160"},"body":"Junio C Hamano wrote:\n> I wonder if this is with less formatting impact then.\n> \n> diff --git a/Documentation/urls.txt b/Documentation/urls.txt\n> index 9abec80..93378d2 100644\n> --- a/Documentation/urls.txt\n> +++ b/Documentation/urls.txt\n> @@ -10,9 +10,9 @@ to name the remote repository:\n>  - https://host.xz/path/to/repo.git/\n>  - git://host.xz/path/to/repo.git/\n>  - git://host.xz/~user/path/to/repo.git/\n> -- ssh://[user@]host.xz/path/to/repo.git/\n> -- ssh://[user@]host.xz/~user/path/to/repo.git/\n> -- ssh://[user@]host.xz/~/path/to/repo.git\n> +- ssh://+++[user@+++]host.xz/path/to/repo.git/\n> +- ssh://+++[user@+++]host.xz/~user/path/to/repo.git/\n> +- ssh://+++[user@+++]host.xz/~/path/to/repo.git\n>  ===============================================================\n>  \n>  SSH Is the default transport protocol and also supports an\n\nYour call. I almost went that way but decided the more invasive patch \nleft the source a bit more readable as it didn't need escaping. As long \nas the output gets fixed, nobody will be losing sleep over this one.\n"}]}