public inbox for git@vger.kernel.org 
 help / color / mirror / Atom feed
From: Junio C Hamano <gitster@pobox•com>
To: Jeff S <acornblue@gmail•com>
Cc: git@vger•kernel.org
Subject: Re* OS X Yosemite make all doc fails
Date: Wed, 26 Aug 2015 10:42:15 -0700	[thread overview]
Message-ID: <xmqqmvxe2bgo.fsf_-_@gitster.dls.corp.google.com> (raw)
In-Reply-To: <CAJD5XBze8S23umS5enPaOKF6RFKwqkY-ZyuAfLG4SBp8CbCeRg@mail.gmail.com> (Jeff S.'s message of "Tue, 25 Aug 2015 17:20:02 -0700")

Jeff S <acornblue@gmail•com> writes:

> Brian thanks for responding! I'm finally able to build git completely.
> Would it be possible to add the OS X dependency to the git/INSTALL
> file?
>
> OSX Yosemite 10.10.5
> Xcode 6.4 (6E35b)
> …
> $ brew install autoconf
> $ brew install asciidoc
> $ brew install xmlto
> $ brew install docbook
> $ export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
> $ brew install docbook-xsl

It may not be a bad idea to add a whole section at the end of the
document to list the prerequisite packages for various common
platforms, whose beginning perhaps would look like this?

diff --git a/INSTALL b/INSTALL
index ffb071e..84fa5cf 100644
--- a/INSTALL
+++ b/INSTALL
@@ -221,3 +221,23 @@ Issues of note:
          http://www.oasis-open.org/docbook/xml/4.5/xsl/current \
          /usr/share/sgml/docbook/xml-dtd-4.5 \
      /etc/xml/catalog
+
+
+Platform specific hints:
+
+You would need to install prerequiste tools and libraries to compile
+and use Git from the source.
+
+ - OSX needs the following packages installed with 'brew install'
+   (in addition to the usual make and C compiler suite):
+
+   autoconf, asciidoc, xmlto, docbook, docbook-xsl
+
+ - Linux distributions derived from Debian need the following packages
+   instaslled via 'apt-get install' or similar (in addition to the
+   usual 'make' and C compiler suite that come as part of
+   build-essential):
+
+   autoconf, asciidoc, xmlto, docbook, libz-dev, livcurl4-openssl-dev,
+   ...
+

  reply	other threads:[~2015-08-26 17:42 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <CAJD5XByPQASzYpyTFdKo83RJ0QwPFHg-nPWyusDCucMRFbor4g@mail.gmail.com>
     [not found] ` <CAJD5XBy=skwogN+kbqHipa3poUt-EjSxMABxRZKoEk0J+2TM3w@mail.gmail.com>
2015-08-24  9:30   ` OS X Yosemite make all doc fails Jeff S
2015-08-25  1:04     ` brian m. carlson
2015-08-26  0:20       ` Jeff S
2015-08-26 17:42         ` Junio C Hamano [this message]
2015-08-26 19:40           ` Re* " Torsten Bögershausen

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=xmqqmvxe2bgo.fsf_-_@gitster.dls.corp.google.com \
    --to=gitster@pobox$(echo .)com \
    --cc=acornblue@gmail$(echo .)com \
    --cc=git@vger$(echo .)kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox