From 8a376262447f8858d83d07e0d98e8e4ea5c50865 Mon Sep 17 00:00:00 2001
From: ewy <ewy0@protonmail.com>
Date: Sat, 6 Jun 2026 16:55:11 +0200
Subject: add more shit to the manpage

---
 man/manview/templates/pik.1.man.tmpl | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

(limited to 'man/manview/templates')

diff --git a/man/manview/templates/pik.1.man.tmpl b/man/manview/templates/pik.1.man.tmpl
index 53f1cfd..e4361b0 100644
--- a/man/manview/templates/pik.1.man.tmpl
+++ b/man/manview/templates/pik.1.man.tmpl
@@ -1,4 +1,4 @@
-{{- /*gotype: github.com/ewy1/pik/man.ManData*/ -}}
+{{- /*gotype: git.sr.ht/~ewy/pik/man/manview.ManData*/ -}}
 .TH PIK 1 {{.Version}} {{.Runtime}}
 .sh NAME
 pik \- file based task runner
@@ -9,21 +9,46 @@ pik \- file based task runner
 .B pik
 executes scripts from the .pik folder or external runners.
 .SH EXAMPLES
+.PP
+Invoke
+.B pik
+without arguments to open the tui.
+.PP
 Given a .pik folder in your current working directory containing "script.sh", calling
 .B pik script
 will start that script.
 .PP To start a script from another location, pass that as the SOURCE before the TARGET.
 Example:
 .B pik project build
-will start ../../.pik/build.py if it exists.
+from \fI/project/src/dir\fR (and similar paths)
+will start \fI/project/.pik/build.py\fR if it exists.
 .SH OPTIONS
 {{ range .Flags -}}
 .TP
 .BR \-\-{{.Name }} {{ if .Shorthand }}, \-{{ .Shorthand }}{{ end }} = {{ .Value.Type }} {{ if .DefValue }} ({{.DefValue}}) {{- end }}
 {{ .Usage }}
 {{ end }}
+.SH TARGET CONFIGURATION
+Targets can be configured with tags. Tags are put in filenames, and should have a \. before and after the tag.
+.PP
+.B EXAMPLE:
+test.here.single.sh has the 'here' and 'single' tag.
+{{ range $t, $v := .TagMap }}
+.TP
+.BR {{ $t}}
+{{ $v.Description }}
+{{ end }}
+.SH SOURCE CONFIGURATION
+Most source configuration files can contain multiple lines, including blank lines. "#" and "//" will be interpreted as comments.
+{{ range $f, $v := .MetaFiles -}}
+{{- if $v.Description }}
+.TP
+.BR .pik/{{$f}}
+{{ $v.Description }}
+{{- end -}}
+{{- end}}
 .SH EXIT CODES
-If the target runs and returns a non-zero error code, we pass that forward instead.
+If the target runs and returns a non-zero error code, we pass that back to the user instead.
 {{ range .ExitCodes -}}
 .TP
 .BR {{ .Value }}
-- 
cgit v1.3.1