From: Richard W.M. Jones <rjones@redhat.com>
Date: Tue, 7 Jan 2020 20:36:56 +0000 (+0000)
Subject: docs: Expand the basic man page.
X-Git-Tag: v'0.2'~63
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=476aebb63c9fa21d4e591684a3f5181169a6e66f;p=goals.git

docs: Expand the basic man page.
---

diff --git a/docs/goals.pod b/docs/goals.pod
index eca8876..c94cadb 100644
--- a/docs/goals.pod
+++ b/docs/goals.pod
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-goals - an experimental tool that generalizes "make"
+goals - an experimental tool that generalizes “make”
 
 =head1 SUMMARY
 
@@ -16,7 +16,19 @@ goals - an experimental tool that generalizes "make"
 
 =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