All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jeff King <peff@peff.net>
To: Jonathan Nieder <jrnieder@gmail.com>
Cc: Junio C Hamano <gitster@pobox.com>,
	"David E. Wheeler" <david@justatheory.com>,
	git@vger.kernel.org
Subject: Re: Bad Man Page URLs
Date: Fri, 6 Apr 2012 01:46:37 -0400	[thread overview]
Message-ID: <20120406054637.GA25301@sigill.intra.peff.net> (raw)
In-Reply-To: <20120406042215.GA3938@burratino>

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

  reply	other threads:[~2012-04-06  5:46 UTC|newest]

Thread overview: 21+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
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 [this message]
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

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20120406054637.GA25301@sigill.intra.peff.net \
    --to=peff@peff.net \
    --cc=david@justatheory.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=jrnieder@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
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.