reftable: technical documentation link fixes
PATCH 1/1 reftable: technical documentation link fixes
Showing as broken links in the html version (when using asciidoc 8.6.10) because some of the characters in the url need encoding.
Change them to use a explicit "link" and URL encode the problematic charecters (ex: +, =, @). While at it, change the base URL to use lore.kernel.org as has been suggested since 56e6c16394 (Merge branch 'dl/lore-is-the-archive', 2019-12-06)
--- Documentation/technical/reftable.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
Documentation/technical/reftable.txt +3 -3
@@ -1028,7 +1028,7 @@ Michael Haggerty's alternate format ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Michael Haggerty proposed -https://public-inbox.org/git/CAMy9T_HCnyc1g8XWOOWhe7nN0aEFyyBskV2aOMb_fe+wGvEJ7A@mail.gmail.com/[an +link:https://lore.kernel.org/git/CAMy9T_HCnyc1g8XWOOWhe7nN0aEFyyBskV2aOMb_fe%2BwGvEJ7A%40mail.gmail.com/[an alternate] format to reftable on the Git mailing list. This format uses smaller chunks, without the restart table, and avoids block alignment with padding. Reflog entries immediately follow each ref, and are thus
@@ -1050,7 +1050,7 @@ JGit Ketch RefTree https://dev.eclipse.org/mhonarc/lists/jgit-dev/msg03073.html[JGit Ketch] proposed -https://public-inbox.org/git/CAJo=hJvnAPNAdDcAAwAvU9C4RVeQdoS3Ev9WTguHx4fD0V_nOg@mail.gmail.com/[RefTree], +link:https://lore.kernel.org/git/CAJo%3DhJvnAPNAdDcAAwAvU9C4RVeQdoS3Ev9WTguHx4fD0V_nOg%40mail.gmail.com/[RefTree], an encoding of references inside Git tree objects stored as part of the repository's object database.
@@ -1070,7 +1070,7 @@ LMDB ^^^^ David Turner proposed -https://public-inbox.org/git/[email protected]/[using +https://lore.kernel.org/git/[email protected]/[using LMDB], as LMDB is lightweight (64k of runtime code) and GPL-compatible license.
Signature · 1 line
2.27.0.rc1.264.g59ed0186f2
Forgot to mention, the third URL wasn't updated since it was somehow not affected, while the first one wasn't affected when using Asciidoctor 2.0.10.
The middle one always breaks (even with Asciidoctor) because of the "=" character, so the "minimal" change needed will be to URL encode that as %3D or use "link" as proposed in the patch.
Carlo
Quoted 4 lines · Carlo Marcelo Arenas Belón
Showing as broken links in the html version (when using asciidoc 8.6.10) because some of the characters in the url need encoding.
Thanks, looks good to me.
What do I do now? Does Junio fold this in, or do I have to send an updated patch series?
Signature · 11 lines
Han-Wen Nienhuys - Google Munich I work 80%. Don't expect answers from me on Fridays. -- Google Germany GmbH, Erika-Mann-Strasse 33, 80636 Munich Registergericht und -nummer: Hamburg, HRB 86891 Sitz der Gesellschaft: Hamburg Geschäftsführer: Paul Manicle, Halimah DeLaine Prado
Quoted 3 lines · Han-Wen Nienhuys
What do I do now? Does Junio fold this in, or do I have to send an updated patch series?
since the issue was introduced with 27eede2922 (reftable: file format documentation, 2020-05-20) which is already in next, then Junio might just add it to the tip of either hn/reftable or hn/refs-cleanup and include it with the reroll that would come after the 2.27 release.
if you have other fixes and are planning a reroll on those branches then it might be better if you squash it in and therefore avoid both the bug and my typo in the commit message.
Carlo
Quoted 1 line · Carlo Marcelo Arenas Belón
Subject: reftable: technical documentation link fixes
For next time, try to make the subject line summarize what specific improvement the patch makes. For example:
reftable doc: use link: and urlencode to avoid dead links
Quoted 8 lines
Showing as broken links in the html version (when using asciidoc 8.6.10) because some of the characters in the url need encoding.
Change them to use a explicit "link" and URL encode the problematic charecters (ex: +, =, @). While at it, change the base URL to use lore.kernel.org as has been suggested since
56e6c16394(Merge branch 'dl/lore-is-the-archive', 2019-12-06)
Quoted 4 lines
Signed-off-by Carlo Marcelo Arenas Belón <[email protected]>--- Documentation/technical/reftable.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
Thanks.
Quoted 17 lines · Jonathan Nieder
Quoted 1 line · Carlo Marcelo Arenas Belón
Subject: reftable: technical documentation link fixes
For next time, try to make the subject line summarize what specific improvement the patch makes. For example:
reftable doc: use link: and urlencode to avoid dead links
Quoted 8 lines
Showing as broken links in the html version (when using asciidoc 8.6.10) because some of the characters in the url need encoding.
Change them to use a explicit "link" and URL encode the problematic charecters (ex: +, =, @). While at it, change the base URL to use lore.kernel.org as has been suggested since
56e6c16394(Merge branch 'dl/lore-is-the-archive', 2019-12-06)
Quoted 6 lines
Quoted 4 lines
Signed-off-by Carlo Marcelo Arenas Belón <[email protected]>--- Documentation/technical/reftable.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)Reviewed-by Jonathan Nieder <[email protected]>
Will queue at the tip of hn/reftable for now, but post 2.27-final, we should tentatively eject hn/refs-cleanup out of 'next' and squash this fix in to the step that originally introduced the problem (and of course, new version of hn/reftable need to be based on the updated hn/refs-cleanup topic when it happens).
Thanks, both.