git.annexia.org
/
goals.git
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (parent:
d2a50cd
)
docs: Expand the basic man page.
author
Richard W.M. Jones
<rjones@redhat.com>
Tue, 7 Jan 2020 20:36:56 +0000
(20:36 +0000)
committer
Richard W.M. Jones
<rjones@redhat.com>
Tue, 7 Jan 2020 20:36:56 +0000
(20:36 +0000)
docs/goals.pod
patch
|
blob
|
history
diff --git
a/docs/goals.pod
b/docs/goals.pod
index
eca8876
..
c94cadb
100644
(file)
--- a/
docs/goals.pod
+++ b/
docs/goals.pod
@@
-2,7
+2,7
@@
=head1 NAME
=head1 NAME
-goals - an experimental tool that generalizes
"make"
+goals - an experimental tool that generalizes
“make”
=head1 SUMMARY
=head1 SUMMARY
@@
-16,7
+16,19
@@
goals - an experimental tool that generalizes "make"
=head1 DESCRIPTION
=head1 DESCRIPTION
+Goals is a command line tool similar in concept to L<make(1)> — a way
+to express dependencies between tasks that need to be done. Goals
+generalizes make so it can express dependencies between not just files
+but anything such as URLs, remote files, remote builds and more. It
+is also very extensible using only shell scripting, and it fixes many
+problems that make suffers from.
+This manual page documents the command line tool and options.
+
+There is an introduction and tutorial on writing goal files:
+L<Goalfile(5)>.
+
+There is also a reference manual: L<goals-reference(5)>.
=head1 OPTIONS
=head1 OPTIONS