Re: git faq : draft and rfc

On 2/16/06, Petr Baudis [off-list ref] wrote:

Dear diary, on Thu, Feb 16, 2006 at 01:36:20AM CET, I got a letter
where Thomas Riboulet [off-list ref] said that...

quoted

. Git commit is dying telling me "fatal : empty ident <user@myhost>
not allowed", what's wrong ?
Make sure your Full Name is not empty in chsh or the 5th field of your
user line in /etc/passwd isn't empty. If you @myhost is empty make sure
your hostname is correctly set.

Please also mention GIT_AUTHOR_NAME; chsh may be frequently unavailable.

ok

quoted

. What's the difference between fetch and pull ?
Fetch : download objects and a head from another repository.
Pull : pull and merge from another repository.
See man git-fetch and git-pull for more.

This could do with a little more elaboration as well. Nice inspiration
might be [ref].

ok, I'll as soon as I manage to get it :/

quoted

. Can I tell git to ignore files ?
Yes. Put the files path in the repository in the .git/info/exclude file.

Or .gitignore in the tree itself. .git/info/exclude is only for your
particular checkout while .gitignore is what matters for all and
everyone's checkouts of the project.

ok, added

quoted

. What can I use to setup a public repository ?
A ssh server, an http server, or the git-daemon.
See the tutorial for more details.

Well this is about how to make it available, not how to use it.

The repository should be set up by cg-admin-setuprepo or git-init-db
--shared and normally does not have a working tree attached. You can
fetch from such a repository either over:

        * the GIT protocol (you need to run git-daemon)
        * SSH (you can set up a git-use-only account using git-shell)
        * rsync (has important disadvantages but it is currently the
          fastest way to do the initial checkout)
        * or the HTTP protocol (any reasonable webhosting will do, but
          you need to run git-update-server-info after each repository
          update; if you used cg-admin-setuprepo to set it up, this
          will be done automatically, otherwise you may enable it in
          the post-update hook - see .git/hooks/post-update).

You can push to such a repository over:

        * SSH
        * HTTP DAV (you will need to specially configure your HTTP
          server for this)

Obviously, you can also fetch/push from/to a repository locally if it
is available in the local filesystem structure.

the initial aim of that question was simply to tell svn people (and
others) what can be used to setup a public repos.
isn't it a bit too much for a faq ? maybe add some things to the
present answer and put this question in the "general questions"
section (see below), and add more details in the "usage" section ?

--
                                Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
Of the 3 great composers Mozart tells us what it's like to be human,
Beethoven tells us what it's like to be Beethoven and Bach tells us
what it's like to be the universe.  -- Douglas Adams

ok added (and pushed) the :
- taylor qa
- the git import bk qa
- GIT_AUTHOR_NAME

I'll separate the questions between the following sections :
- general questions (who, when, where, ...)
- usage : commands, errors ...

I'm planning on removing the text format faq and handle it as I handle
the html one  : through the docbook. ok ?

--
Thom/ange