#How to help with the Wifi renewal "branch" in hg
The wifi renewal project is trying to sync our sys/net80211 with FreeBSD as far as possible, to allow easier sharing of drivers.
## Why hg?
The project started with a traditional cvs branch, but as we will be moving to mercurial anyway (and this "branch" could live for quite some time, even accross the general repo switch), it is a good test case for the hg environment and also nice practice for the developers involved.
The developement uses a "topic", which is a kind of lightweight branch that goes away after the project finished. The hg documentation includes
an [introduction to topics](https://www.mercurial-scm.org/doc/evolution/tutorials/topic-tutorial.html).
## Helping with testing
** Note that this project is not ready for general testing yet! **
If you just want to check out the wifi project source and build your own test kernel for it, you simply start by cloning the repository from anonhg:
> hg clone https://anonhg.netbsd.org/src-draft
Now enable the 'topic' extension by adding
to the .hg/hgrc file in your clone dir and then update to the 'wifi' topic:
> hg up wifi
## Helping with developement
As a developer, you should start with an annonhg clone as well, as that uses 'clonebundles' and the CDN to get your clone faster.
The developement happens using the topic and evolve extensions, which unfortunately slows down some hg operations.
After initial cloning (see above) you will have to edit your global ~/.hgrc and the clone local .hg/hgrc files. Here is my ~/.hgrc:
user=Martin Husemann <martin@NetBSD.org>
color = no
ignore = ~/.hgignore
default:pushrev = .
The .hgignore file referened there tells hg to leave editor backups and compiled kernels alone. Mine looks like:
Finaly the clone local config (.hg/hgrc) looks like this:
default = ssh://hgmaster.netbsd.org//repo/src-draft
final = ssh://hgmaster.netbsd.org//repo/src-public
This directs normal pushes to the src-draft repository and prevents publishing (that is what "merging the branch to HEAD" would have been in cvs). When it is time to do that, a "final" push will be done that moves the changes to the src-pulbic repository (and empties the topic, which will make it vanish on next update).
CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb