[Frugalware-darcs] pacman-tools: repoman.1: updated for git
vmiklos at frugalware.org
Sun Jul 1 01:01:31 CEST 2007
[repoman.1: updated for git
VMiklos <vmiklos at frugalware.org>**20070630225843
it no longer mentions the darcs commands, but they are still supported. this is
because this manpage is mainly for new developers and repoman supports darcs
only for backward compatibility
hunk ./repoman.1 1
-.TH "REPOMAN" "1" "January 2007" "Frugalware 0.6" "pacman-tools"
+.TH "REPOMAN" "1" "June 2007" "Frugalware 0.7" "pacman-tools"
hunk ./repoman.1 8
-is meant for Frugalware developers to upload or delete source
-tarballs, fpm packages and generate changelogs.
+is meant for Frugalware developers to upload, delete or register source
+tarballs or fpm packages.
hunk ./repoman.1 13
-Note: \fBrepoman\fR only runs \fIinside\fR a darcs repository.
+.SH INSTALLING PACKAGES
+This section is for users. If you're a developer, just skip it.
+Here is a reference comparing pacman-g2 and repoman
+pacman-g2 -Sy repoman upd
+pacman-g2 -S pkg repoman merge pkg
+pacman-g2 -Ss foo repoman search foo
hunk ./repoman.1 27
+This section is for developers. If you're a user, just skip it.
hunk ./repoman.1 35
-echo 'current_servers=("vmiklos at darcs.frugalware.org:/home/ftp/pub/frugalware/frugalware-current")' > ~/.repoman.conf
+echo 'current_servers=("foo at git.frugalware.org:/home/ftp/pub/frugalware/\\
+frugalware-current")' > ~/.repoman.conf
+echo 'fst_root=~/git' >> ~/.repoman.conf
hunk ./repoman.1 41
-echo 'fst_root=~/darcs' >> ~/.repoman.conf
+Replace foo with your nick and make sure about you have the git tree in
hunk ./repoman.1 44
-Replace my nick (vmiklos) with your nick and make sure about you have the darcs tree in ~/darcs/current.
-If you want to use more than one (conflicting, ie.: current and stable) trees, then please add the <reponame>_pushonly=y option to each repo except one. Example: if the host system is -current and you want to enabled current and stable, then add stable_pushonly="y" to your config.
+If you want to use more than one (conflicting, ie.: current and stable) trees,
+then please add the <reponame>_pushonly=y option to each repo except one.
+Example: if the host system is -current and you want to enabled current and
+stable, then add stable_pushonly="y" to your config.
hunk ./repoman.1 52
-We recommend you to use a mirror server and the --partial option!
hunk ./repoman.1 54
-darcs get --partial http://ftp5.frugalware.org/packages/frugalware/pub/frugalware/frugalware-current/
+git clone foo at git.frugalware.org:/home/ftp/pub/frugalware/frugalware-current \\
hunk ./repoman.1 59
-Example for the pacman-tools repo:
+( Example for the pacman-tools repo:
hunk ./repoman.1 61
-darcs get --partial http://ftp5.frugalware.org/packages/frugalware/pub/other/pacman-tools/pacman-tools
-mv frugalware-current current
+git clone foo at git.frugalware.org:/home/ftp/pub/other/pacman-tools/pacman-tools )
hunk ./repoman.1 65
-echo "yourname <email at addr.ess>" > _darcs/prefs/author
-echo 'username at darcs.frugalware.org:/home/ftp/pub/frugalware/frugalware-current' > _darcs/prefs/defaultrepo
-Or, for the pacman-tools repo:
+git config user.name yourname
+git config user.email email at addr.ess
hunk ./repoman.1 68
-echo 'username at darcs.frugalware.org:/home/ftp/pub/other/pacman-tools/pacman-tools' > _darcs/prefs/defaultrepo
+git config remote.origin.receivepack "sudo -u foo git-receive-pack"
hunk ./repoman.1 70
-echo 'push apply-as vmiklos' >> _darcs/prefs/defaults
-Note: Here do not substituate my nick (vmiklos) with you nick!
+Here you sould substituate foo with the nick of the repo owner, current vmiklos.
hunk ./repoman.1 75
-If you already got the repo a simple 'darcs pull' should be enough.
+If you already got the repo a simple 'git pull' should be enough.
hunk ./repoman.1 82
-If you would like to add new file(s) to the source, run this:
+Build the package with 'sudo makepkg -c'.
+Then if you would like to add new file(s) to the source, run this:
hunk ./repoman.1 86
-darcs add glibc.install
+git add glibc.install
hunk ./repoman.1 90
+git rm at-3.1.8r11-makefile.patch
hunk ./repoman.1 94
-darcs mv glibc-2.5-foo.patch glibc-2.5-bar.patch
-Then build the packages with 'sudo makepkg -c'.
+git mv glibc-2.5-foo.patch glibc-2.5-bar.patch
hunk ./repoman.1 99
-Simply run 'darcs record'.
+Simply run 'git commit'.
hunk ./repoman.1 101
-When recording the patch (if this is a package upgrade), its name must be $pkgname-$pkgver-$pkgrel-$arch (when answering to 'What is the patch name?').
+When recording the patch (if this is a package upgrade), the first line must be
+$pkgname-$pkgver-$pkgrel-$arch. You can use repoman rec which will fill in this
+first line automatically for you.
hunk ./repoman.1 121
-Here you only have to do a simple 'darcs push'.
+Here you only have to do a simple 'git push'.
hunk ./repoman.1 137
-(see later) will download the sources for you.
+(see later) will download the sources for you. If the mirror is slower than
+your upload bandwidth then it worth to upload it now or you'll have to wait
+till the server downloads it!
hunk ./repoman.1 156
-10) Generate a Changelog, update the .fdb and sql database and download the
+10) Generate a Changelog, update the .fdb and sql database, download the
+missing sources and update documentation:
+repoman cl perl
+11) Once you understand this procedure, you can do all this at once:
hunk ./repoman.1 168
-repoman cl base/perl
+repoman -k push
+Will be interactive only in case there is some unrecorded change.
+Usuall I (vmiklos) use the following:
+repoman -k push
+But you should not use repoman push till you don't understand what it does!
hunk ./repoman.1 184
-Generate a Changelog file from darcs patch comments.
+Generate a Changelog file from git log.
hunk ./repoman.1 211
-A frontend to darcs record. If parameters are given then it won't be
-interactive and the parameters are appended to the history as a long comment.
+A frontend to git commit. If parameters are given then it won't be interactive
+and the parameters are appended to the history as a long comment.
hunk ./repoman.1 259
-.BR darcs (1),
+.BR git (7),
More information about the Frugalware-darcs