More suggestions for TODO.

[goals.git] / docs / goals.pod

diff --git a/docs/goals.pod b/docs/goals.pod
index f21ae21..ffea303 100644 (file)
--- a/docs/goals.pod
+++ b/docs/goals.pod
@@ -9,7 +9,7 @@ goals - an experimental tool that generalizes “make”
  goals ['TARGET'] ['VAR=VALUE']
        [-C|--directory DIRECTORY] [-d] [-f|--file Goalfile]
        [-I|--include DIRECTORY] [-j|--jobs JOBS] [--no-prelude]
  goals ['TARGET'] ['VAR=VALUE']
        [-C|--directory DIRECTORY] [-d] [-f|--file Goalfile]
        [-I|--include DIRECTORY] [-j|--jobs JOBS] [--no-prelude]

-       [-s|--silent|--quiet]
+       [-k|--keep-going] [-s|--silent|--quiet]

 
  goals --help
 
 
  goals --help
 


@@ -26,10 +26,8 @@ problems that make suffers from.
 
 This manual page documents the command line tool and options.
 
 
 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)>.
+There is an introduction to and tutorial on writing goal files, as
+well as a reference manual in L<Goalfile(5)>.

 
 =head1 OPTIONS
 
 
 =head1 OPTIONS
 


@@ -70,8 +68,7 @@ if I<-C> was not used.
 Specify an include directory, used when including goal files using the
 C<include> directive.  You can use this option multiple times.  Later
 directories have priority over earlier ones.  There is also an
 Specify an include directory, used when including goal files using the
 C<include> directive.  You can use this option multiple times.  Later
 directories have priority over earlier ones.  There is also an

-implicit C<%stdlib> directory which is used for prelude files (see
-L<goals-reference(5)>).
+implicit C<%stdlib> directory which is used for prelude files.

 
 Note that if a relative path is given here, it is relative to the
 directory specified with the I<-C> option, or to the current directory
 
 Note that if a relative path is given here, it is relative to the
 directory specified with the I<-C> option, or to the current directory


@@ -93,6 +90,15 @@ prelude is always loaded automatically before any initial goal file
 (but you can redefine prelude definitions in your goal file if you
 want).
 
 (but you can redefine prelude definitions in your goal file if you
 want).
 

+=item B<-k>
+
+=item B<--keep-going>
+
+Continue as much as possible after an error.  The target that failed
+and anything that depends on that target (recursively) will fail and
+the program as a whole will still exit with an error, but as many
+targets as can be built will be built.
+

 =item B<-s>
 
 =item B<--silent>
 =item B<-s>
 
 =item B<--silent>


@@ -106,7 +112,7 @@ turning all S<C<{ CODE }>> sections into S<C<@{ CODE }>> sections.
 
 =head1 SEE ALSO
 
 
 =head1 SEE ALSO
 

-L<Goalfile(5)>, L<goals-reference(5)>, L<make(1)>.
+L<Goalfile(5)>, L<make(1)>.

 
 =head1 AUTHORS
 
 
 =head1 AUTHORS