File:  [NetBSD Developer Wiki] / wikisrc / gitsofar.mdwn
Revision 1.1: download - view: text, annotated - select for diffs
Sun Feb 1 02:25:27 2015 UTC (5 years ago) by mspo
Branches: MAIN
CVS tags: HEAD
start answering the core@ email about using git

== NetBSD with git so far

http://mail-index.netbsd.org/tech-repository/2015/01/04/msg000497.html

=== Low memory hosts:
* http://mail-index.netbsd.org/tech-repository/2015/01/08/msg000520.html

git appears to have slightly different memory characteristics depending on the
protocol used.  Over http I am able to get a full clone with all history on a
256 + 256 raspberri pi.  If you bump up the memory to 512 + 256 it makes ssh
possible, which means writes are possible.

The link above has some tuning I used to get memory requirements way down.

It should be noted that git support a "shallow" clone (--depth 1) which ignores
most history but allows commits and full development.
A shallow clone works on very small systems; I would guess 128MB + a little swap
is enough.

git is slow during 'status' by default since it searches the entire tree for a
change.  It will produce a warning with tunable options if the command runs
slowly.

=== CVS in parallel
I do not think this is a good idea and do not plan to advocate for it.
Git does have a cvs server built-in but I have not taken the time to set it up
for testing because it is slightly involved and I don't see the purpose.

=== Conversion
One-shot to create the new True Source.  I don't think there will be many cvs
hold-outs.

See above for CVS server provided if ongoing conversion is really desired.

=== existing cvs dependencies
TBD

=== How should NetBSD be setup
High level- private box for write master using ssh, any number of additional
systems with read-only mirrors over http:// and git://

Also see a great description of how DragonflyBSD is setup:
http://lists.dragonflybsd.org/pipermail/users/2015-January/207421.html
http://lists.dragonflybsd.org/pipermail/users/2015-January/207422.html
http://lists.dragonflybsd.org/pipermail/users/2015-January/207424.html

=== how to install
git should fit into NetBSD src/tools easily.  I have not personally tested
cross compilation.

=== workflows
See DragonflyBSD examples given above

There are many many workflows supported in git.  For the most part I think
NetBSD developers would follow the "feature branch" workflow from the main repo
(or private/semi-private clones before merge).

Public collaboration is a big feature of git since it can format patches into
at least two different email formats and they can be submitted to a bug report
or to a mailing list, which should allow clean apply.

A non-developer could also post a pull request to github or host his git repo
for a friendly developer to add as an origin and pull his branch.

(git origin add future-developer http://example.com/~greatguy/src.git)


=== log message formats
Try to references named branches instead of sha-1's
Also using the dates for commits instead of commit id's

=== how to convert
ESR?

=== No lock-in
I am unable to anticipate the next generation of SCM.
Don't do anything weird like change history and we should be fine.

Maybe when we have 30 years of project history it will be time to consider
restructuring the project.  :)

=== Who, When, and How Long?
* ESR/Joerg - convert
* sometime, eventually, maybe
* unknown

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb