summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md43
1 files changed, 37 insertions, 6 deletions
diff --git a/README.md b/README.md
index 2d40bac..1e5ed17 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,41 @@
-forge
+# forge
+This can be used to maintain git repositories
expiremental work on federated git
-/usr/share/git-gui/lib/tools/
-.git/config settings for gitgui
-[gui]
- wmstate = normal
- geometry = 931x515+450+130 197 234
+* Scans directories looking for git repositories
+* The default behavior is to use 3 branches. 'master or main', 'devel', '<username>'
+* shows tags and dirty state
+* uses a GUI or the console(console display needs work)
+* always wrap around 'git' -- it basically just types 'git' commands really fast
+## Notes & Goals:
+
+* use a GUI that also works on the command line
+* andlabs GTK gui plugin starts breaking around 200 repos
+
+## Install:
+
+* go install go.wit.com/apps/forge@latest
+
+## building from sources (may work Jan 2026)
+
+```
+go install go.wit.com/apps/go-clone@latest # this tool makes it easier to 'git clone' repos and recursively 'git clone' the dependancies
+go install go.wit.com/apps/autogenpb@latest # this tool will generate the protobuf *pb.go files (also Marshal(), Sort(), etc.)
+
+go-clone --recursive go.wit.com/apps/forge # this will 'git clone' about 20 repos into ~/go/src (or where your go.work file is)
+
+cd go.wit.com/lib/protobuf/forgepb
+make # autogenpb will make .pb.go, marshal.pb.go and sort.pb.go files
+cd go.wit.com/lib/protobuf/gitpb
+make # autogenpb will make .pb.go, marshal.pb.go and sort.pb.go files
+
+cd go.wit.com/apps/forge
+make # this runs GO111MODULE=off go build insuring that your using only your git sources
+
+```
+
+## Debian packages:
+
+Instructions are on https://mirrors.wit.com/