Installazione Guida HTML Git su OSX

Question

Ho provato ad installare le pagine di aiuto Git HTML su OSX in base alle istruzioni fornite dai seguenti link:

• http://help.github.com/install-git-html-help/
• http://www.railsatwork.com/2010/12/installing-git-html-documentation-on.html

Ma quando arrivo alla fase di verifica finale che comporta l'esecuzione:

git help --web commit 

ottengo il seguente errore:

Ho verificato che la cartella,/usr/local/git/share/doc/git-doc nasce infatti quando mi sono imbattuto "git clone", e che è pieno di file che sembrano git file di documentazione.

Qualcuno può farmi sapere cosa mi manca? Grazie!

Ecco un breve elenco di alcuni dei file che sono stati creati nella cartella git-doc:

• exec_cmd.c
• exec_cmd.h
• fast-import.c
• fetch-pack.h
• fixup-builtins
• fmt-merge-msg.h
• fsck.c
• fsck.h
• generate-cmdlist.sh
• gettext.c
• gettext.h
• git-add - interactive.perl
• git-am.sh
• git- archimport.perl
• git-bisect.sh
• git-compat-util.h
• git-cvsexportcommit.perl
• git-cvsimport.perl
• git-cvsserver.perl
• git-difftool--helper.sh
• git-difftool.perl
• git-filtro-ramo.sh

EDIT: appena dato un'occhiata a risultati git clone e abbiamo trovato questo avvertimento, non so se si fa la differenza: "html ramo remoto non si trovano in origine a monte, tramite testa invece"

Answer 1

Modificare l'indirizzo di comando clone dalla

$ sudo git clone git://git.kernel.org/pub/scm/git/git.git git-doc --branch html 

a

$ sudo git clone git://git.kernel.org/pub/scm/git/git-htmldocs.git git-doc 

Spero che questo sarà cambiato in Github esercitazione presto.

UPDATE:

Se siete uno di quelli che pensa che sia sufficiente avere la distribuzione di Apple Git fornito con Xcode 4:

# create directory to keep Git documentation html-files 
$ sudo mkdir -p /usr/local/git/share/doC# or whatever directory you choose 

# change to that directory 
$ cd /usr/local/git/share/doc 

# clone repo with documentation 
$ sudo git clone git://git.kernel.org/pub/scm/git/git-htmldocs.git git-doc 

# point your Git explicitly to a new documentation directory 
$ git config --global help.htmlpath /usr/local/git/share/doc/git-doc 

# tell Git to use html-formatted help by default 
$ git config --global help.format html 

Questo creerà una voce nel tuo .gitconfig come:

[help] 
    format = html 
    htmlpath = /usr/local/git/share/doc/git-doc 

Answer 2

Il il codice è (builtin/help.c):

static void get_html_page_path(struct strbuf *page_path, const char *page) 
{ 
    struct stat st; 
    const char *html_path = system_path(GIT_HTML_PATH); 

    /* Check that we have a git documentation directory. */ 
    if (stat(mkpath("%s/git.html", html_path), &st) 
     || !S_ISREG(st.st_mode)) 
    die("'%s': not a documentation directory.", html_path); 

    strbuf_init(page_path, 0); 
    strbuf_addf(page_path, "%s/%s.html", html_path, page); 
} 

Quindi ci potrebbe essere qualche problema con GIT_HTML_PATH variabile d'ambiente (come in quello old issue), o non avere qualsiasi tipo di file git.html nel Destinati sulla directory della guida.