From 873c4085c824da90a1d3f89d7b9e4198376bfa49 Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Mon, 26 Jan 2015 23:45:27 +0100 Subject: doc: Expound a bit on 'guix lint'. * doc/guix.texi (Invoking guix lint): Give examples of checkers. --- doc/guix.texi | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 7eed637c26..754aae9626 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3212,8 +3212,25 @@ Use @var{host} as the OpenPGP key server when importing a public key. @node Invoking guix lint @section Invoking @command{guix lint} The @command{guix lint} is meant to help package developers avoid common -errors and use a consistent style. It runs a few checks on a given set of -packages in order to find common mistakes in their definitions. +errors and use a consistent style. It runs a number of checks on a +given set of packages in order to find common mistakes in their +definitions. Available @dfn{checkers} include (see +@code{--list-checkers} for a complete list): + +@table @code +@item synopsis +@itemx description +Validate certain typographical and stylistic rules about package +descriptions and synopses. + +@item inputs-should-be-native +Identify inputs that should most likely be native inputs. + +@item source +@itemx home-page +Probe @code{home-page} and @code{source} URLs and report those that are +invalid. +@end table The general syntax is: -- cgit v1.2.3