summaryrefslogtreecommitdiff
path: root/cmd
diff options
context:
space:
mode:
authorNick White <git@njw.name>2020-04-14 10:45:12 +0100
committerNick White <git@njw.name>2020-04-14 10:45:12 +0100
commitdacb5cf28e3ede3b9f1bbf2d9d80b5a9d0d1bc56 (patch)
tree2554ae2317619a92934013e0b66b7595bfc47f84 /cmd
parent036f5c6bb155772aba9b3408413dcda631eb00a1 (diff)
Briefly document each of the commands in a godoc friendly way, and improve the cloudsettings documentation slightly
Diffstat (limited to 'cmd')
-rw-r--r--cmd/addtoqueue/main.go2
-rw-r--r--cmd/bookpipeline/main.go3
-rw-r--r--cmd/booktopipeline/main.go2
-rw-r--r--cmd/confgraph/main.go2
-rw-r--r--cmd/getpipelinebook/main.go1
-rw-r--r--cmd/lspipeline/main.go1
-rw-r--r--cmd/mkpipeline/main.go2
-rw-r--r--cmd/pagegraph/main.go2
-rw-r--r--cmd/pdfbook/main.go2
-rw-r--r--cmd/spotme/main.go1
10 files changed, 18 insertions, 0 deletions
diff --git a/cmd/addtoqueue/main.go b/cmd/addtoqueue/main.go
index c3284e9..8e4ecd2 100644
--- a/cmd/addtoqueue/main.go
+++ b/cmd/addtoqueue/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// addtoqueue adds a message to a queue. This is handy to work
+// around bugs in the book pipeline when things are misbehaving.
package main
import (
diff --git a/cmd/bookpipeline/main.go b/cmd/bookpipeline/main.go
index 9059167..3b9befb 100644
--- a/cmd/bookpipeline/main.go
+++ b/cmd/bookpipeline/main.go
@@ -2,6 +2,9 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// bookpipeline is the core command of the bookpipeline package, which
+// watches queues for messages and does various OCR related tasks when
+// it receives them, saving the results in cloud storage.
package main
import (
diff --git a/cmd/booktopipeline/main.go b/cmd/booktopipeline/main.go
index cb40eb4..2e7064e 100644
--- a/cmd/booktopipeline/main.go
+++ b/cmd/booktopipeline/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// booktopipeline uploads a book to cloud storage and adds the name
+// to a queue ready to be processed by the bookpipeline tool.
package main
import (
diff --git a/cmd/confgraph/main.go b/cmd/confgraph/main.go
index 55d2fd5..864e44b 100644
--- a/cmd/confgraph/main.go
+++ b/cmd/confgraph/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// confgraph creates a graph showing the average word confidence
+// of each page of hOCR in a directory.
package main
import (
diff --git a/cmd/getpipelinebook/main.go b/cmd/getpipelinebook/main.go
index fe2af89..dc9387f 100644
--- a/cmd/getpipelinebook/main.go
+++ b/cmd/getpipelinebook/main.go
@@ -2,6 +2,7 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// getpipelinebook downloads the pipeline results for a book.
package main
import (
diff --git a/cmd/lspipeline/main.go b/cmd/lspipeline/main.go
index ab2f8b1..b649778 100644
--- a/cmd/lspipeline/main.go
+++ b/cmd/lspipeline/main.go
@@ -2,6 +2,7 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// lspipeline lists useful things related to the book pipeline.
package main
import (
diff --git a/cmd/mkpipeline/main.go b/cmd/mkpipeline/main.go
index b15e9ef..f3e1258 100644
--- a/cmd/mkpipeline/main.go
+++ b/cmd/mkpipeline/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// mkpipeline sets up the necessary buckets and queues for the book
+// pipeline.
package main
import (
diff --git a/cmd/pagegraph/main.go b/cmd/pagegraph/main.go
index 5750892..e6f8f54 100644
--- a/cmd/pagegraph/main.go
+++ b/cmd/pagegraph/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// pagegraph creates a graph showing the average confidence of each
+// word in a page of hOCR.
package main
import (
diff --git a/cmd/pdfbook/main.go b/cmd/pdfbook/main.go
index 923d97e..0f72ecb 100644
--- a/cmd/pdfbook/main.go
+++ b/cmd/pdfbook/main.go
@@ -2,6 +2,8 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// pdfbook creates a searchable PDF from a directory of hOCR and
+// image files.
package main
import (
diff --git a/cmd/spotme/main.go b/cmd/spotme/main.go
index 3a6fe6f..1f7969d 100644
--- a/cmd/spotme/main.go
+++ b/cmd/spotme/main.go
@@ -2,6 +2,7 @@
// Use of this source code is governed by the GPLv3
// license that can be found in the LICENSE file.
+// spotme creates new spot instances for the book pipeline.
package main
import (