From 8561c2fedae26aecd8ba758a5e7ef686ba1243f3 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Tue, 27 Oct 2015 09:57:26 +0100 Subject: revamp all tools help messages The general idea is: A small paragraph on the tool itself as a description, a list of the most used (!= all) commands available in the tool, a remark where to find more information on the tool and its commands (aka: in the manpage) and finally a common block referring to even more manpages. In exchange options are completely omitted from the output as well as deprecated or obscure commands. (Better) Information about them is available in the manpages anyway and the few options which were listed before were also the least interesting ones (-o -c -q and co are hardly of interest for someone totally new looking to find info by asking for help and anyone with a bit of experience doesn't need this short list. Those would need a list of options applying to the command they call, but they are too numerous and command specific to list them sanely in this context. --- ftparchive/apt-ftparchive.cc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'ftparchive') diff --git a/ftparchive/apt-ftparchive.cc b/ftparchive/apt-ftparchive.cc index 99d5627f0..b31c92845 100644 --- a/ftparchive/apt-ftparchive.cc +++ b/ftparchive/apt-ftparchive.cc @@ -604,7 +604,7 @@ static void LoadBinDir(vector &PkgList,Configuration &Setup) } /*}}}*/ -bool ShowHelp(CommandLine &, aptDispatchWithHelp const *) /*{{{*/ +bool ShowHelp(CommandLine &) /*{{{*/ { std::cout << _("Usage: apt-ftparchive [options] command\n" @@ -654,7 +654,7 @@ bool ShowHelp(CommandLine &, aptDispatchWithHelp const *) /*{{{*/ static bool SimpleGenPackages(CommandLine &CmdL) { if (CmdL.FileSize() < 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); string Override; if (CmdL.FileSize() >= 3) @@ -686,7 +686,7 @@ static bool SimpleGenPackages(CommandLine &CmdL) static bool SimpleGenContents(CommandLine &CmdL) { if (CmdL.FileSize() < 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); // Create a package writer object. ContentsWriter Contents(NULL, _config->Find("APT::FTPArchive::DB"), _config->Find("APT::FTPArchive::Architecture")); @@ -708,7 +708,7 @@ static bool SimpleGenContents(CommandLine &CmdL) static bool SimpleGenSources(CommandLine &CmdL) { if (CmdL.FileSize() < 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); string Override; if (CmdL.FileSize() >= 3) @@ -745,7 +745,7 @@ static bool SimpleGenSources(CommandLine &CmdL) static bool SimpleGenRelease(CommandLine &CmdL) { if (CmdL.FileSize() < 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); string Dir = CmdL.FileList[1]; @@ -913,7 +913,7 @@ static bool Generate(CommandLine &CmdL) { struct CacheDB::Stats SrcStats; if (CmdL.FileSize() < 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); struct timeval StartTime; gettimeofday(&StartTime,0); @@ -971,7 +971,7 @@ static bool Generate(CommandLine &CmdL) static bool Clean(CommandLine &CmdL) { if (CmdL.FileSize() != 2) - return ShowHelp(CmdL, nullptr); + return ShowHelp(CmdL); // Read the configuration file. Configuration Setup; -- cgit v1.2.3