docs + fixes to Rill()

This commit is contained in:
Jeff Carr 2025-07-21 21:05:25 -05:00
parent 8c25ed19a3
commit 5b5d262ce4
5 changed files with 58 additions and 6 deletions

View File

@ -3,6 +3,8 @@
forge is a GUI front end for 'git' designed with the
intent of simplifying federated git development.
FORGE NEVER DOES ANYTHING BUT EXEC's 'git'
## Theory
* Software engineering is the art of making things work.

View File

@ -138,9 +138,9 @@ func (args) Version() string {
func (a args) Description() string {
return `
forge -- a tool to git repos at go.wit.com
forge -- a tool to manage lots of git repos. forge includes a GUI and TUI.
but you can probably use it for other things
forge only executes the 'git' command. Everything it does, you can run by hand with 'git'.
`
}

View File

@ -95,6 +95,7 @@ func doCommitRepo(repo *gitpb.Repo) error {
}
if err := shell.ExecCheck([]string{"git", "commit", "--all"}); err != nil {
shell.ExecCheck([]string{"git", "reset"})
return err
}
log.Info("git commit ok. forge done")

View File

@ -61,11 +61,12 @@ func doSyncClean() error {
}
func doSyncUser() error {
if count, err := me.forge.RillRepo(10, 20, syncDevelBranch); err != nil {
log.Info("RillFunc() failed", err)
return err
me.forge.ConfigRill(10, 20)
if allerr := me.forge.RillRepos(syncDevelBranch); len(allerr) != 0 {
log.Info("RillFunc() failed", allerr)
return fmt.Errorf("Rill doSyncUser() error count = %d", len(allerr))
} else {
log.Info("Rill syncDevelBranch() ok count =", count)
log.Info("Rill syncDevelBranch() ok count =", len(allerr))
}
argv.Force = true

48
doc.go Normal file
View File

@ -0,0 +1,48 @@
/*
forge -- a tool to git repos at go.wit.com
but you can probably use it for other things
A video demonstration of the terminal UI is available at:
https://mirrors.wit.com/guidemo/forge-gocui-demo.webm
forge v0.22.124-2-g8c25ed1 Built on 2025.07.21_1348
Usage: forge [--debugger] [--logger] [--no-gui] [--gui GUI] [--gui-file GUI-FILE] [--gui-test GUI-TEST] [--gui-verbose] [--connect CONNECT] [--all] [--build BUILD] [--install INSTALL] [--forge-rebuild] [--force] [--verbose] [--bash] [--auto-complete AUTO-COMPLETE] <command> [<args>]
Options:
--debugger open the debugger window
--logger open the log.* control window
--no-gui ignore all these gui problems
--gui GUI Use this gui toolkit [andlabs,gocui,nocui,stdin]
--gui-file GUI-FILE Use a specific plugin.so file
--gui-test GUI-TEST test a specific plugin.so will load
--gui-verbose enable all logging
--connect CONNECT forge url
--all git commit --all
--build BUILD build a repo
--install INSTALL install a repo
--forge-rebuild download and rebuild forge
--force try to strong arm things
--verbose show more output
--bash generate bash completion
--auto-complete AUTO-COMPLETE
todo: move this to go-arg
--help, -h display this help and exit
--version display version and exit
Commands:
checkout switch branches using 'git checkout'
clean start over at the beginning
commit 'git commit' but errors out if on wrong branch
config show your .config/forge/ settings
debug debug forge
dirty show dirty git repos
fetch run 'git fetch master'
list print a table of the current repos
merge merge branches
patch make patchsets
pull run 'git pull'
*/
package main