* Bad Man Page URLs
@ 2012-04-06 1:48 David E. Wheeler
2012-04-06 2:32 ` Jeff King
0 siblings, 1 reply; 21+ messages in thread
From: David E. Wheeler @ 2012-04-06 1:48 UTC (permalink / raw)
To: git
Hello,
I noticed this in 1.7.7.3, but just rebuilt 1.7.9.6 from source on OS X Lion and am still seeing it. These are the links at the end of `man git`:
> NOTES
> 1. Everyday Git
> file:///home/junio/share/doc/git-doc/everyday.html
>
> 2. Git User's Manual
> file:///home/junio/share/doc/git-doc/user-manual.html
>
> 3. git concepts chapter of the user-manual
> file:///home/junio/share/doc/git-doc/user-manual.html#git-concepts
>
> 4. howto
> file:///home/junio/share/doc/git-doc/howto-index.html
>
> 5. GIT API documentation
> file:///home/junio/share/doc/git-doc/technical/api-index.html
>
> 6. git@vger.kernel.org
> mailto:git@vger.kernel.org
Those URLs are sadly not useful. :-( FYI, here’s the script I use to build Git:
https://github.com/theory/my-cap/blob/master/bin/git.sh
Note that the man pages are installed with these two lines:
curl -O http://git-core.googlecode.com/files/git-manpages-$VERSION.tar.gz
sudo tar xzv -C /usr/local/share/man -f git-manpages-$VERSION.tar.gz
Is there a bug reporting system I should report this to?
Thanks,
David
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 1:48 Bad Man Page URLs David E. Wheeler @ 2012-04-06 2:32 ` Jeff King 2012-04-06 2:54 ` Jeff King 0 siblings, 1 reply; 21+ messages in thread From: Jeff King @ 2012-04-06 2:32 UTC (permalink / raw) To: David E. Wheeler; +Cc: git On Thu, Apr 05, 2012 at 06:48:19PM -0700, David E. Wheeler wrote: > I noticed this in 1.7.7.3, but just rebuilt 1.7.9.6 from source on OS > X Lion and am still seeing it. These are the links at the end of `man > git`: > [...] > > 1. Everyday Git > > file:///home/junio/share/doc/git-doc/everyday.html The problem is that you are not really rebuilding the manpages at all, but rather just untarring prebuilt copies. If you built them yourself, they would have the proper prefix for your system. That being said, it would be nice for the prebuilt manpages to have something more location-agnostic in them. These links are generated by asciidoc's "link:" directive. The HTML versions properly use relative links, but the links are expanded into full URLs for the manpages. Which makes sense, since there's no concept of a relative link here. So we can tweak it by using a custom link macro (we already have "linkgit" for linking to actual commands). But what should the agnostic version say? Just saying "look at everday.html in the git documentation" is not as nice as a real URL, but we really don't have any more information than that. Maybe they should be pointing to some canonical version on the web? > Is there a bug reporting system I should report this to? This list, and you just did. :) -Peff ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 2:32 ` Jeff King @ 2012-04-06 2:54 ` Jeff King 2012-04-06 4:22 ` Jonathan Nieder 0 siblings, 1 reply; 21+ messages in thread From: Jeff King @ 2012-04-06 2:54 UTC (permalink / raw) To: David E. Wheeler; +Cc: git On Thu, Apr 05, 2012 at 10:32:23PM -0400, Jeff King wrote: > That being said, it would be nice for the prebuilt manpages to have > something more location-agnostic in them. These links are generated by > asciidoc's "link:" directive. The HTML versions properly use relative > links, but the links are expanded into full URLs for the manpages. Which > makes sense, since there's no concept of a relative link here. > > So we can tweak it by using a custom link macro (we already have > "linkgit" for linking to actual commands). But what should the agnostic > version say? Just saying "look at everday.html in the git documentation" > is not as nice as a real URL, but we really don't have any more > information than that. Maybe they should be pointing to some canonical > version on the web? I dug on this a little more. It seems that the "link" macro in asciidoc is overridable, so we could just redefine it as appropriate. However, the existing implementation actually generates a reasonable-looking docbook <ulink>, and it is docbook that is responsible for turning it into an absolute URL. So I think technically the docbook part of the toolchain would be the right place to fix this. But it may be easier to hack around it at the asciidoc level. Something like the code below would work: diff --git a/Documentation/asciidoc.conf b/Documentation/asciidoc.conf index aea8627..1edbabe 100644 --- a/Documentation/asciidoc.conf +++ b/Documentation/asciidoc.conf @@ -93,3 +93,10 @@ ifdef::backend-xhtml11[] [linkgit-inlinemacro] <a href="{target}.html">{target}{0?({0})}</a> endif::backend-xhtml11[] + +ifdef::generic-location[] +ifdef::backend-docbook[] +[link-inlinemacro] +<ulink url="http://official-location/{target}">{0={target}}</ulink> +endif::backend-docbook[] +endif::generic-location[] though it assumes that link targets are relative. There are a handful of instances where that is not the case (we can either introduce a linkabs for them, or leave them and switch most of the existing link: macros over to linkrel: or something). -Peff ^ permalink raw reply related [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 2:54 ` Jeff King @ 2012-04-06 4:22 ` Jonathan Nieder 2012-04-06 5:46 ` Jeff King 0 siblings, 1 reply; 21+ messages in thread From: Jonathan Nieder @ 2012-04-06 4:22 UTC (permalink / raw) To: Jeff King; +Cc: David E. Wheeler, git Jeff King wrote: > So I think technically the docbook part of the toolchain would be the > right place to fix this. But it may be easier to hack around it at the > asciidoc level. Isn't this what MAN_BASE_URL in Documentation/Makefile is for? I don't think a lower level fix is needed. ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 4:22 ` Jonathan Nieder @ 2012-04-06 5:46 ` Jeff King 2012-04-06 6:17 ` Jonathan Nieder 2012-04-06 7:15 ` Junio C Hamano 0 siblings, 2 replies; 21+ messages in thread From: Jeff King @ 2012-04-06 5:46 UTC (permalink / raw) To: Jonathan Nieder; +Cc: Junio C Hamano, David E. Wheeler, git On Thu, Apr 05, 2012 at 11:22:15PM -0500, Jonathan Nieder wrote: > Jeff King wrote: > > > So I think technically the docbook part of the toolchain would be the > > right place to fix this. But it may be easier to hack around it at the > > asciidoc level. > > Isn't this what MAN_BASE_URL in Documentation/Makefile is for? I > don't think a lower level fix is needed. Thanks for a dose of sanity. Having been here so long, I sometimes think that if something exists in git, I would already know about it. But sometimes that is not true. :) Junio, what do you think of building the git-manpages-* tarballs (and the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"? As of now, they mention "file:///home/junio/...". We could need to have an official place, of course. I'd rather not use http://schacon.github.com/git/docs because these links will be embedded in release tarballs. Maybe it is time to make http://git-scm.com/docs happen. -Peff ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 5:46 ` Jeff King @ 2012-04-06 6:17 ` Jonathan Nieder 2012-04-06 7:15 ` Junio C Hamano 1 sibling, 0 replies; 21+ messages in thread From: Jonathan Nieder @ 2012-04-06 6:17 UTC (permalink / raw) To: Jeff King; +Cc: Junio C Hamano, David E. Wheeler, git Jeff King wrote: > Junio, what do you think of building the git-manpages-* tarballs (and > the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"? > As of now, they mention "file:///home/junio/...". Could be as simple as this, no? Signed-off-by: Jonathan Nieder <jrnieder@gmail.com> --- Documentation/Makefile | 10 ++++++++-- Makefile | 1 + 2 files changed, 9 insertions(+), 2 deletions(-) diff --git i/Documentation/Makefile w/Documentation/Makefile index d40e211f..0edad3a2 100644 --- i/Documentation/Makefile +++ w/Documentation/Makefile @@ -248,8 +248,14 @@ $(MAN_HTML): %.html : %.txt $(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \ mv $@+ $@ -manpage-base-url.xsl: manpage-base-url.xsl.in - sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@ +manpage-base-url.xsl: manpage-base-url.xsl.in FORCE + $(QUIET_GEN)$(RM) $@+ && \ + sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@+ && \ + if test -e $@ && cmp -s $@+ $@; then \ + $(RM) $@+; \ + else \ + mv $@+ $@; \ + fi %.1 %.5 %.7 : %.xml manpage-base-url.xsl $(QUIET_XMLTO)$(RM) $@ && \ diff --git i/Makefile w/Makefile index be1957a5..ce6f805c 100644 --- i/Makefile +++ w/Makefile @@ -2623,6 +2623,7 @@ dist-doc: $(RM) -r .doc-tmp-dir mkdir -p .doc-tmp-dir/man1 .doc-tmp-dir/man5 .doc-tmp-dir/man7 $(MAKE) -C Documentation DESTDIR=./ \ + MAN_BASE_URL=git-htmldocs/ \ man1dir=../.doc-tmp-dir/man1 \ man5dir=../.doc-tmp-dir/man5 \ man7dir=../.doc-tmp-dir/man7 \ -- ^ permalink raw reply related [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 5:46 ` Jeff King 2012-04-06 6:17 ` Jonathan Nieder @ 2012-04-06 7:15 ` Junio C Hamano 2012-04-06 7:23 ` Jeff King 2012-04-26 20:12 ` David E. Wheeler 1 sibling, 2 replies; 21+ messages in thread From: Junio C Hamano @ 2012-04-06 7:15 UTC (permalink / raw) To: Jeff King; +Cc: Jonathan Nieder, David E. Wheeler, git Jeff King <peff@peff.net> writes: > Junio, what do you think of building the git-manpages-* tarballs (and > the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"? > As of now, they mention "file:///home/junio/...". I think git-manpages repo already sets the base to the old k.org location (see dodoc.sh in the 'todo' branch), but I forgot about that setting when I cobbled together the tarball releasing script to be run on my home box in a hurry. The releases used to be cut on a k.org machine and I initially planned to stop generating the manpage/html tarballs when we lost shell access to it, but some distro people demanded it, so... I do not know how well things would behave if we set it to "git-htmldocs/" as Jonathan suggests, but we will see what happens. I think there is no need to patch any Makefile; the make variable is designed to be overridable by the callers of make, so patches should go to either 'dodoc.sh' or the tarball release scripts, which are not checked in to the 'todo' branch yet, but I will do so if I remember ;-). FWIW, here is the (updated) 'RelBuild' script. -- >8 -- #!/bin/sh version=$(git describe --exact) && label=$(echo "$version" | sed -e 's|^v||') && version=$(echo "$label" | sed -e 's|-|.|g') || exit make clean && make dist && ASCIIDOC_NO_ROFF=YesPlease \ ASCIIDOC8=YesPlease \ MAN_BASE_URL="git-htmldocs/" \ make dist-doc || exit # The above used to be # MAN_BASE_URL="http://www.kernel.org/pub/software/scm/git/docs/" files=" git-$version.tar.gz git-htmldocs-$version.tar.gz git-manpages-$version.tar.gz " for file in $files do test -f $file || exit done sha1sum $files | gpg --clearsign >git-$version.sign ls -l git-$version.sign $files ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 7:15 ` Junio C Hamano @ 2012-04-06 7:23 ` Jeff King 2012-04-26 20:12 ` David E. Wheeler 1 sibling, 0 replies; 21+ messages in thread From: Jeff King @ 2012-04-06 7:23 UTC (permalink / raw) To: Junio C Hamano; +Cc: Scott Chacon, Jonathan Nieder, David E. Wheeler, git On Fri, Apr 06, 2012 at 12:15:07AM -0700, Junio C Hamano wrote: > > Junio, what do you think of building the git-manpages-* tarballs (and > > the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"? > > As of now, they mention "file:///home/junio/...". > > I think git-manpages repo already sets the base to the old k.org location > (see dodoc.sh in the 'todo' branch), but I forgot about that setting when > I cobbled together the tarball releasing script to be run on my home box > in a hurry. Ah, I didn't notice that. The k.org location is dead, of course, but I hope we will eventually turn it into at least a redirect to the official location. Scott, I know you've been working hard on the git-scm.com redesign. Any word on when that will be ready, or whether it will contain a mirror of the reference docs? > I do not know how well things would behave if we set it to "git-htmldocs/" > as Jonathan suggests, but we will see what happens. Users will see reference to "git-htmldocs/everyday.html" in their manpage. Not quite as nice as a real URL, but at least not entirely misleading. -Peff ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-06 7:15 ` Junio C Hamano 2012-04-06 7:23 ` Jeff King @ 2012-04-26 20:12 ` David E. Wheeler 2012-04-26 20:19 ` Jonathan Nieder 1 sibling, 1 reply; 21+ messages in thread From: David E. Wheeler @ 2012-04-26 20:12 UTC (permalink / raw) To: Junio C Hamano; +Cc: Jeff King, Jonathan Nieder, git On Apr 6, 2012, at 12:15 AM, Junio C Hamano wrote: >> Junio, what do you think of building the git-manpages-* tarballs (and >> the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"? >> As of now, they mention "file:///home/junio/...". > > I think git-manpages repo already sets the base to the old k.org location > (see dodoc.sh in the 'todo' branch), but I forgot about that setting when > I cobbled together the tarball releasing script to be run on my home box > in a hurry. The releases used to be cut on a k.org machine and I initially > planned to stop generating the manpage/html tarballs when we lost shell > access to it, but some distro people demanded it, so... > > I do not know how well things would behave if we set it to "git-htmldocs/" > as Jonathan suggests, but we will see what happens. > > I think there is no need to patch any Makefile; the make variable is > designed to be overridable by the callers of make, so patches should go to > either 'dodoc.sh' or the tarball release scripts, which are not checked in > to the 'todo' branch yet, but I will do so if I remember ;-). > > FWIW, here is the (updated) 'RelBuild' script. Don't know if you've applied this fix, but I just downloaded the 1.7.10 man pages, and they URLs are now: 1. Everyday Git git-htmldocs/everyday.html 2. Git User's Manual git-htmldocs/user-manual.html 3. git concepts chapter of the user-manual git-htmldocs/user-manual.html#git-concepts 4. howto git-htmldocs/howto-index.html 5. GIT API documentation git-htmldocs/technical/api-index.html Which also aren't very useful. :-( David ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:12 ` David E. Wheeler @ 2012-04-26 20:19 ` Jonathan Nieder 2012-04-26 20:24 ` David E. Wheeler 2012-04-26 21:02 ` Jeff King 0 siblings, 2 replies; 21+ messages in thread From: Jonathan Nieder @ 2012-04-26 20:19 UTC (permalink / raw) To: David E. Wheeler; +Cc: Junio C Hamano, Jeff King, git David E. Wheeler wrote: > 5. GIT API documentation > git-htmldocs/technical/api-index.html > > Which also aren't very useful. :-( Sure they are --- they tell you where in the git-htmldocs tarball from [1] to find the relevant pages. Do you know of a public webpage we can count on to continue to serve the docs? I agree that that would be even better. Hope that helps, Jonathan [1] http://code.google.com/p/git-core/downloads/list ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:19 ` Jonathan Nieder @ 2012-04-26 20:24 ` David E. Wheeler 2012-04-26 20:29 ` Jonathan Nieder 2012-04-26 21:02 ` Jeff King 1 sibling, 1 reply; 21+ messages in thread From: David E. Wheeler @ 2012-04-26 20:24 UTC (permalink / raw) To: Jonathan Nieder; +Cc: Junio C Hamano, Jeff King, git On Apr 26, 2012, at 1:19 PM, Jonathan Nieder wrote: > Sure they are --- they tell you where in the git-htmldocs tarball > from [1] to find the relevant pages. > > Do you know of a public webpage we can count on to continue to serve > the docs? I agree that that would be even better. All of those titles have links on gitmanual.org: http://www.gitmanual.org/ Although it looks like the “GIT API documentation” link is broken (404). Best, David ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:24 ` David E. Wheeler @ 2012-04-26 20:29 ` Jonathan Nieder 2012-04-26 20:34 ` David E. Wheeler 0 siblings, 1 reply; 21+ messages in thread From: Jonathan Nieder @ 2012-04-26 20:29 UTC (permalink / raw) To: David E. Wheeler; +Cc: Junio C Hamano, Jeff King, git David E. Wheeler wrote: > On Apr 26, 2012, at 1:19 PM, Jonathan Nieder wrote: >> Do you know of a public webpage we can count on to continue to serve >> the docs? I agree that that would be even better. > > All of those titles have links on gitmanual.org: > > http://www.gitmanual.org/ Who runs that webpage? Would they mind the increased traffic? Can we count on them to continue to serve the docs? ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:29 ` Jonathan Nieder @ 2012-04-26 20:34 ` David E. Wheeler 2012-05-02 21:46 ` Jakub Narebski 0 siblings, 1 reply; 21+ messages in thread From: David E. Wheeler @ 2012-04-26 20:34 UTC (permalink / raw) To: Jonathan Nieder; +Cc: Junio C Hamano, Jeff King, git On Apr 26, 2012, at 1:29 PM, Jonathan Nieder wrote: >> All of those titles have links on gitmanual.org: >> >> http://www.gitmanual.org/ > > Who runs that webpage? Would they mind the increased traffic? Can we > count on them to continue to serve the docs? Oh, not an official Git site? Seems to me that the project ought to have something like that. Many of the same links are on http://git-scm.com/documentation. As for gitmanual.org, whois says: Registrant Name:Loic d'Anterroches Registrant Organization:Ceondo Ltd Registrant City:London Registrant Email:pnwr10o0vs6u6a82ixx9@o.o-w-o.info Best, David ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:34 ` David E. Wheeler @ 2012-05-02 21:46 ` Jakub Narebski 0 siblings, 0 replies; 21+ messages in thread From: Jakub Narebski @ 2012-05-02 21:46 UTC (permalink / raw) To: David E. Wheeler; +Cc: Jonathan Nieder, Junio C Hamano, Jeff King, git "David E. Wheeler" <david@justatheory.com> writes: > On Apr 26, 2012, at 1:29 PM, Jonathan Nieder wrote: >>> >>> All of those titles have links on gitmanual.org: >>> >>> http://www.gitmanual.org/ >> >> Who runs that webpage? Would they mind the increased traffic? Can we >> count on them to continue to serve the docs? > > Oh, not an official Git site? Seems to me that the project ought to > have something like that. Many of the same links are on > http://git-scm.com/documentation. > > As for gitmanual.org, whois says: > > Registrant Name:Loic d'Anterroches > Registrant Organization:Ceondo Ltd > Registrant City:London > Registrant Email:pnwr10o0vs6u6a82ixx9@o.o-w-o.info If I am not mistaken this is the person behind InDefero git hosting site (http://www.indefero.net) and git hosting software powering it (http://projects.ceondo.com/p/indefero) in PHP. I don't remember it being announced on git mailing list... -- Jakub Narebski ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 20:19 ` Jonathan Nieder 2012-04-26 20:24 ` David E. Wheeler @ 2012-04-26 21:02 ` Jeff King 2012-04-26 21:58 ` Scott Chacon 1 sibling, 1 reply; 21+ messages in thread From: Jeff King @ 2012-04-26 21:02 UTC (permalink / raw) To: Jonathan Nieder; +Cc: Scott Chacon, David E. Wheeler, Junio C Hamano, git On Thu, Apr 26, 2012 at 03:19:22PM -0500, Jonathan Nieder wrote: > David E. Wheeler wrote: > > > 5. GIT API documentation > > git-htmldocs/technical/api-index.html > > > > Which also aren't very useful. :-( > > Sure they are --- they tell you where in the git-htmldocs tarball > from [1] to find the relevant pages. > > Do you know of a public webpage we can count on to continue to serve > the docs? I agree that that would be even better. I think http://git-scm.com/ would be the ideal place. My understanding is that the re-work of the site is nearing completion. Scott, ETA? -Peff ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 21:02 ` Jeff King @ 2012-04-26 21:58 ` Scott Chacon 2012-04-26 22:11 ` David E. Wheeler ` (2 more replies) 0 siblings, 3 replies; 21+ messages in thread From: Scott Chacon @ 2012-04-26 21:58 UTC (permalink / raw) To: Jeff King; +Cc: Jonathan Nieder, David E. Wheeler, Junio C Hamano, git Hey, On Thu, Apr 26, 2012 at 2:02 PM, Jeff King <peff@peff.net> wrote: >> >> Do you know of a public webpage we can count on to continue to serve >> the docs? I agree that that would be even better. > > I think http://git-scm.com/ would be the ideal place. My understanding > is that the re-work of the site is nearing completion. Scott, ETA? Yes, we are very close to launching a big redesign of git-scm.com. The manpages will be automatically updated on that site, you can certainly link to them there. If you want to preview what it's going to look like and the URL structure, you can check out the current working version here: http://git-scm.herokuapp.com/docs/git-fetch There are a number of known bugs and I want to make it much faster before I officially launch it and redirect DNS, but you can get an idea of how it will be structured and what it will look like. If you want to start generating docs with static urls for man pages, they can be of the form: http://git-scm.com/docs/git-command You can also put a version number after them to permalink them at a certain version: http://git-scm.herokuapp.com/docs/git-fetch/1.7.3.2 When it's close to what I think is ready, I'll do a post to this list looking for feedback and bugs, etc. Scott > > -Peff ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 21:58 ` Scott Chacon @ 2012-04-26 22:11 ` David E. Wheeler 2012-04-26 22:12 ` Jonathan Nieder 2012-04-26 22:16 ` Junio C Hamano 2 siblings, 0 replies; 21+ messages in thread From: David E. Wheeler @ 2012-04-26 22:11 UTC (permalink / raw) To: Scott Chacon; +Cc: Jeff King, Jonathan Nieder, Junio C Hamano, git On Apr 26, 2012, at 2:58 PM, Scott Chacon wrote: > Yes, we are very close to launching a big redesign of git-scm.com. > The manpages will be automatically updated on that site, you can > certainly link to them there. > > If you want to preview what it's going to look like and the URL > structure, you can check out the current working version here: > > http://git-scm.herokuapp.com/docs/git-fetch Wow, the new site looks *awesome*! :-) > There are a number of known bugs and I want to make it much faster > before I officially launch it and redirect DNS, but you can get an > idea of how it will be structured and what it will look like. If you > want to start generating docs with static urls for man pages, they can > be of the form: http://git-scm.com/docs/git-command > > You can also put a version number after them to permalink them at a > certain version: > > http://git-scm.herokuapp.com/docs/git-fetch/1.7.3.2 Very nice. I only found one of the links from the manpage there, though: Everyday Git http://git-scm.herokuapp.com/docs/everyday.html Here are the others on gitmanual.org (maybe I just couldn't find them on the new site?): User Manual http://www.gitmanual.org/user-manual.html git concepts chapter of the user-manual http://www.gitmanual.org/user-manual.html#git-concepts howto http://www.gitmanual.org/howto-index.html And this one is a broken link on gitmanual.org and other places on the internetz. GIT API documentation ???? Best, David ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 21:58 ` Scott Chacon 2012-04-26 22:11 ` David E. Wheeler @ 2012-04-26 22:12 ` Jonathan Nieder 2012-04-26 22:16 ` Junio C Hamano 2 siblings, 0 replies; 21+ messages in thread From: Jonathan Nieder @ 2012-04-26 22:12 UTC (permalink / raw) To: Scott Chacon; +Cc: Jeff King, David E. Wheeler, Junio C Hamano, git Scott Chacon wrote: > On Thu, Apr 26, 2012 at 2:02 PM, Jeff King <peff@peff.net> wrote: >>> Do you know of a public webpage we can count on to continue to serve >>> the docs? I agree that that would be even better. >> >> I think http://git-scm.com/ would be the ideal place. My understanding >> is that the re-work of the site is nearing completion. Scott, ETA? [...] > If you want to preview what it's going to look like and the URL > structure, you can check out the current working version here: > > http://git-scm.herokuapp.com/docs/git-fetch Is it intended to include documents such as "technical/api-credentials"? I ask because David was looking for some permanent place for the references section of pages like gitcredentials(7) to link to. Curious, Jonathan ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 21:58 ` Scott Chacon 2012-04-26 22:11 ` David E. Wheeler 2012-04-26 22:12 ` Jonathan Nieder @ 2012-04-26 22:16 ` Junio C Hamano 2012-04-26 22:25 ` Scott Chacon 2 siblings, 1 reply; 21+ messages in thread From: Junio C Hamano @ 2012-04-26 22:16 UTC (permalink / raw) To: Scott Chacon; +Cc: Jeff King, Jonathan Nieder, David E. Wheeler, git Scott Chacon <schacon@gmail.com> writes: > If you want to preview what it's going to look like and the URL > structure, you can check out the current working version here: > > http://git-scm.herokuapp.com/docs/git-fetch Nicely done. Is it possible to have a link to Release Notes (not manual pages, which you already have links to) for each release from "http://site/docs/git" like we used to have at k.org site? It is not a big deal, but that is one thing I miss the most. ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 22:16 ` Junio C Hamano @ 2012-04-26 22:25 ` Scott Chacon 2012-04-26 22:34 ` Jonathan Nieder 0 siblings, 1 reply; 21+ messages in thread From: Scott Chacon @ 2012-04-26 22:25 UTC (permalink / raw) To: Junio C Hamano; +Cc: Jeff King, Jonathan Nieder, David E. Wheeler, git On Thu, Apr 26, 2012 at 3:16 PM, Junio C Hamano <gitster@pobox.com> wrote: > Is it possible to have a link to Release Notes (not manual pages, which > you already have links to) for each release from "http://site/docs/git" > like we used to have at k.org site? It is not a big deal, but that is > one thing I miss the most. Yes, this is pretty easy to do - just about everything in Documentation/ will eventually be rendered - including the user-manual that is currently missing and the release notes. Scott ^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: Bad Man Page URLs 2012-04-26 22:25 ` Scott Chacon @ 2012-04-26 22:34 ` Jonathan Nieder 0 siblings, 0 replies; 21+ messages in thread From: Jonathan Nieder @ 2012-04-26 22:34 UTC (permalink / raw) To: Scott Chacon; +Cc: Junio C Hamano, Jeff King, David E. Wheeler, git Scott Chacon wrote: > Yes, this is pretty easy to do - just about everything in > Documentation/ will eventually be rendered - including the user-manual > that is currently missing and the release notes. Nice. :) Thanks much for doing this. It seems from adaa3caf that to add the links to release notes, the appropriate incantation is ASCIIDOC_EXTRA='-a stalenotes'. Jonathan ^ permalink raw reply [flat|nested] 21+ messages in thread
end of thread, other threads:[~2012-05-02 21:46 UTC | newest] Thread overview: 21+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2012-04-06 1:48 Bad Man Page URLs David E. Wheeler 2012-04-06 2:32 ` Jeff King 2012-04-06 2:54 ` Jeff King 2012-04-06 4:22 ` Jonathan Nieder 2012-04-06 5:46 ` Jeff King 2012-04-06 6:17 ` Jonathan Nieder 2012-04-06 7:15 ` Junio C Hamano 2012-04-06 7:23 ` Jeff King 2012-04-26 20:12 ` David E. Wheeler 2012-04-26 20:19 ` Jonathan Nieder 2012-04-26 20:24 ` David E. Wheeler 2012-04-26 20:29 ` Jonathan Nieder 2012-04-26 20:34 ` David E. Wheeler 2012-05-02 21:46 ` Jakub Narebski 2012-04-26 21:02 ` Jeff King 2012-04-26 21:58 ` Scott Chacon 2012-04-26 22:11 ` David E. Wheeler 2012-04-26 22:12 ` Jonathan Nieder 2012-04-26 22:16 ` Junio C Hamano 2012-04-26 22:25 ` Scott Chacon 2012-04-26 22:34 ` Jonathan Nieder
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.